Moduldiagramm

dgram ist eines der Grundmodule, das hauptsächlich zur Implementierung der Socket-Kapselung von UDP-Datenpaketen verwendet wird.

Schritte zur Nutzung:

1. Führen Sie zunächst das Dgram-Modul durch die folgende Anweisung ein.

   1
   var dgram = require('dgram');
   

2. Erstellen Sie eine UDP-Paket-Socket-Instanz.

   1
   var sock = dgram.createSocket('udp4');
   

3. Registrieren Sie die Rückruffunktion für Datenempfangsereignisnachrichten für den UDP-Paket-Socket.

   1
   2
   3
   sock.on('message', function (msg, rinfo) {
   // process received message
   });
   

4. Sendet eine UDP-Paketnachricht an die angegebene Zieladresse.

   1
   2
   3
   4
   5
   var msg = ...; // message to send
   var port = ...; // destination port
   var host = ...; // destination host
   var bytes = sock.send(msg, 0, msg.length, port, host);
   console.log('UDP message sent to ' + host + ':' + port);
   

Objekt

Socket

dgram.SocketDas Objekt ist eine Paketfunktion, die die Funktion kapseltEventEmitter. SehenDgramSocket

1
DgramSocket dgram.Socket;

dgram.SocketDie Instanz ist gegeben durchdgram.createSocket() erstellt. erstellendgram.SocketInstanzen müssen das neue Schlüsselwort nicht verwenden.

statische Funktion

createSocket

Erstellendgram.SocketObjekt

1
static DgramSocket dgram.createSocket(Object opts);

Aufrufparameter:

• opts: Objekt,

Rückgabeergebnisse:

• DgramSocket, gibt das erstellte zurückSocketObjekt

Optionen, die von opts zugelassen werden, sind:

1
2
3
4
5
6
7
{
    "type": "udp4" | "udp6", // socket type
    "reuseAddr": true | false, // reuse address, default is false
    "ipv6Only": true | false, // only accept IPv6 packets, default is false
    "recvBufferSize": 1024, // specify the size of the receive buffer
    "sendBufferSize": 1024 // specify the size of the send buffer
}

---

Erstellendgram.SocketObjekt

1
2
static DgramSocket dgram.createSocket(Object opts,
    Function callback);

Aufrufparameter:

• opts: Objekt,
• callback: Funktion, fügt einen Listener für das Ereignis „message“ hinzu.

Rückgabeergebnisse:

• DgramSocket, gibt das erstellte zurückSocketObjekt

Optionen, die von opts zugelassen werden, sind:

1
2
3
4
5
6
7
{
    "type": "udp4" | "udp6", // socket type
    "reuseAddr": true | false, // reuse address, default is false
    "ipv6Only": true | false, // only accept IPv6 packets, default is false
    "recvBufferSize": 1024, // specify the size of the receive buffer
    "sendBufferSize": 1024 // specify the size of the send buffer
}

---

Erstellendgram.SocketObjekt

1
static DgramSocket dgram.createSocket(String type);

Aufrufparameter:

• type: String, Socket-Familie, „udp4“ oder „udp6“.

Rückgabeergebnisse:

• DgramSocket, gibt das erstellte zurückSocketObjekt

---

Erstellendgram.SocketObjekt

1
2
static DgramSocket dgram.createSocket(String type,
    Function callback);

Aufrufparameter:

• type: String, Socket-Familie, „udp4“ oder „udp6“.
• callback: Funktion, fügt einen Listener für das Ereignis „message“ hinzu.

Rückgabeergebnisse:

• DgramSocket, gibt das erstellte zurückSocketObjekt