Programme einigen sich auf Typen, nicht Sprachen
Eine WebAssembly-Komponente ist ein Modul mit einer typisierten Beschreibung dessen, was es importiert und exportiert. Diese Beschreibung steht in WIT, der WebAssembly Interface Type language. So kann eine Komponente in Rust einer Komponente in Python einen String oder eine Liste übergeben.
Heute lesen Sie eine WIT-Datei und rufen eine Komponente über sie auf.
Am Ende dieser Lektion
Notiz
Ich kann eine WIT-Welt lesen und sagen, was eine Komponente importiert und exportiert.
Schlüsselwörter
| Begriff | Was er bedeutet | Beispiel |
|---|---|---|
| Komponente | ein Modul mit typisierten Importen und Exporten | |
| WIT | die Sprache, die diese Typen beschreibt | calc.wit |
| Schnittstelle | eine benannte Gruppe von Funktionen und Typen | math |
| Welt | alles, was eine Komponente importiert und exportiert | |
| Paket | Name und Version einer Sammlung von Schnittstellen | demo:[email protected] |
| Heben (lift) | aus einer Kernfunktion eine typisierte Funktion machen |
Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.
Ein Kernmodul spricht nur in Zahlen
Ein einfaches Modul, ein Kernmodul, kennt vier Arten von Werten: i32, i64, f32 und f64. Ein String muss als Stelle im Speicher und Länge reisen, und beide Seiten müssen sich einig sein, wie.
Das Component Model legt diese Einigung einmal fest, in der Canonical ABI. WIT sagt string, list oder record, und die Laufzeitumgebung bewegt die Bytes. Zwei Komponenten teilen sich nie Speicher.
Die WIT-Datei des Labs lesen
docker exec tools cat calc.witHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Beispiel: die Teile von calc.wit
| Zeile | Art | Was sie sagt |
|---|---|---|
| package demo:[email protected]; | package | Namensraum demo, Name calc, Version 0.1.0 |
| interface math { ... } | interface | Eine Funktion, add: func(a: u32, b: u32) -> u32 |
| world calculator { export math; } | world | Eine Komponente, die math anbietet |
| world doubler { import math; export double: ... } | world | Braucht math, bietet double |
Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.
Eine Komponente ist ein Modul plus Typen
Öffnen Sie calc.wat mit docker exec tools cat calc.wat. Darin steht ein gewöhnliches Kernmodul, dessen add zwei i32 nimmt und eines zurückgibt.
Eine Zeile mit canon lift macht daraus add: func(a: u32, b: u32) -> u32, also den Typ, den WIT versprochen hat. Die Komponente exportiert die Funktion in der Instanz demo:calc/[email protected]. Wasmtime ruft sie mit --invoke beim Namen auf.
add der Komponente aufrufen
docker exec wasm wasmtime run --invoke 'add(2, 3)' calc.watHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Zwei zu große Zahlen addieren
docker exec wasm wasmtime run --invoke 'add(4000000000, 500000000)' calc.watHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Eine Welt ist ein Vertrag mit dem Host
Eine Welt listet, was eine Komponente braucht und was sie anbietet. Der Host muss jeden Import liefern, bevor die Komponente startet. Die Welt ist also alles, was sie überhaupt anfassen darf.
Auch WASI ist als WIT-Welten geschrieben. Eine Komponente für die Kommandozeile importiert Schnittstellen wie wasi:filesystem und wasi:cli/environment und exportiert wasi:cli/run. Ein Host kann diese Liste lesen, bevor er irgendetwas ausführt.
Ein häufiger Fehler
Warnung
Viele halten eine WIT-Datei für Code, der läuft. WIT beschreibt nur Typen und Funktionen, wie ein Vertrag. Der Code steckt in der Komponente, und dieselbe WIT-Datei können Komponenten in jeder Sprache erfüllen.
Probieren Sie es: woher kommt 205032704?
MASKE = 2 ** 32
def addiere_u32(a, b):
# Ein i32.add im Kernmodul behält nur die unteren 32 Bits der Summe.
return (a + b) % MASKE
def mit_vorzeichen(n):
# Dieselben 32 Bits, als Zahl mit Vorzeichen gelesen.
if n >= 2 ** 31:
return n - MASKE
return n
for paar in [[2, 3], [4000000000, 500000000], [3000000000, 0]]:
summe = addiere_u32(paar[0], paar[1])
print(paar[0], "+", paar[1], "=", summe, "als u32 und", mit_vorzeichen(summe), "als s32")
# Nehmen Sie [4294967295, 1] dazu. Worauf läuft die Summe über?