# UDP / 數(shù)據(jù)報套接字
~~~
穩(wěn)定度: 3 - 穩(wěn)定
~~~
數(shù)據(jù)報套接字通過 `require('dgram')` 提供。
重要提醒：`dgram.Socket#bind()` 的行為在 v0.10 中已改變，并且現(xiàn)在它總是異步的。如果您的代碼看起來像這樣：
~~~
var s = dgram.createSocket('udp4');
s.bind(1234);
s.addMembership('224.0.0.114');
~~~
您需要將它改成這樣：
~~~
var s = dgram.createSocket('udp4');
s.bind(1234, function() {
s.addMembership('224.0.0.114');
});
~~~
### dgram.createSocket(type, [callback])
- `type` String 可以是 'udp4' 或 'udp6'
- `callback` Function 可選，會被作為 `message` 事件的監(jiān)聽器。
- 返回：Socket 對象
創(chuàng)建一個指定類型的數(shù)據(jù)報 Socket。有效類型包括 `udp4` 和 `udp6`。
接受一個可選的回調(diào)，會被添加為 `message` 事件的監(jiān)聽器。
如果您想接收數(shù)據(jù)報則可調(diào)用 `socket.bind`。`socket.bind()` 會綁定到“所有網(wǎng)絡(luò)接口”地址的一個隨機端口（`udp4` 和 `udp6` 皆是如此）。然后您可以通過 `socket.address().address` 和 `socket.address().port` 來取得地址和端口。
### 類: dgram.Socket
dgram Socket 類封裝了數(shù)據(jù)報功能，可以通過 `dgram.createSocket(type, [callback])` 創(chuàng)建。
### 事件: 'message'
- `msg` Buffer 對象，消息
- `rinfo` Object，遠程地址信息
當套接字中有新的數(shù)據(jù)報時發(fā)生。`msg` 是一個 `Buffer`，`rinfo` 是一個包含了發(fā)送者地址信息的對象：
~~~
socket.on('message', function(msg, rinfo) {
console.log('收到 %d 字節(jié)，來自 %s:%d\n',
msg.length, rinfo.address, rinfo.port);
});
~~~
### 事件: 'listening'
當一個套接字開始監(jiān)聽數(shù)據(jù)報時產(chǎn)生。它會在 UDP 套接字被創(chuàng)建時發(fā)生。
### 事件: 'close'
當一個套接字被 `close()` 關(guān)閉時產(chǎn)生。之后這個套接字上不會再有 `message` 事件發(fā)生。
### 事件: 'error'
- `exception` Error 對象
當發(fā)生錯誤時產(chǎn)生。
### socket.send(buf, offset, length, port, address, [callback])
- `buf` Buffer 對象，要發(fā)送的消息
- `offset` Integer，Buffer 中消息起始偏移值。
- `length` Integer，消息的字節(jié)數(shù)。
- `port` Integer，目標端口
- `address` String，目標 IP
- `callback` Function，可選，當消息被投遞后的回調(diào)。
對于 UDP 套接字，必須指定目標端口和 IP 地址。`address` 參數(shù)可以是一個字符串，它會被 DNS 解析。可選地可以指定一個回調(diào)以用于發(fā)現(xiàn)任何 DNS 錯誤或當 `buf` 可被重用。請注意 DNS 查詢會將發(fā)送的時間推遲到至少下一個事件循環(huán)。確認發(fā)送完畢的唯一已知方法是使用回調(diào)。
如果套接字之前并未被調(diào)用 `bind` 綁定，則它會被分配一個隨機端口并綁定到“所有網(wǎng)絡(luò)接口”地址（`udp4` 套接字是 0.0.0.0；`udp6` 套接字是 ::0）。
向 `localhost` 隨機端口發(fā)送 UDP 報文的例子：
~~~
var dgram = require('dgram');
var message = new Buffer("Some bytes");
var client = dgram.createSocket("udp4");
client.send(message, 0, message.length, 41234, "localhost", function(err) {
client.close();
});
~~~
**關(guān)于 UDP 數(shù)據(jù)報大小的注意事項**
一個 `IPv4/v6` 數(shù)據(jù)報的最大大小取決與 `MTU`（*最大傳輸單位*）和 `Payload Length` 字段大小。
- `Payload Length` 字段寬 `16 bits`，意味著正常負載包括網(wǎng)絡(luò)頭和數(shù)據(jù)不能大于 64K（65,507 字節(jié) = 65,535 ? 8 字節(jié) UDP 頭 ? 20 字節(jié) IP 頭）；這對環(huán)回接口通常是真的，但如此大的數(shù)據(jù)報對大多數(shù)主機和網(wǎng)絡(luò)來說是不切實際的。
- `MTU` 是一個給定的數(shù)據(jù)鏈路層技術(shù)能為數(shù)據(jù)報提供支持的最大大小。對于任何連接，`IPv4` 允許最小 `68` 字節(jié)的 `MTU`，而 IPv4 所推薦的 `MTU` 為 `576`（通常作為撥號類應(yīng)用的推薦 `MTU`），無論它們是完整接收還是分片。
對于 `IPv6`，最小的 `MTU` 為 `1280` 字節(jié)，但所允許的最小碎片重組緩沖大小為 `1500` 字節(jié)。 `68` 的值是非常小的，因為現(xiàn)在大多數(shù)數(shù)據(jù)鏈路層技術(shù)有都具有 `1500` 的最小 `MTU`（比如以太網(wǎng)）。
請注意我們不可能提前得知一個報文可能經(jīng)過的每一個連接 MTU，因此通常情況下不能發(fā)送一個大于（接收者的）`MTU` 的數(shù)據(jù)報（報文會被悄悄地丟掉，而不會將數(shù)據(jù)沒有到達它意圖的接收者的消息告知來源）。
### socket.bind(port, [address], [callback])
- `port` Integer
- `address` String，可選
- `callback` 沒有參數(shù)的 Function，可選，當綁定完成時被調(diào)用。
對于 UDP 套接字，在一個具名端口 `port` 和可選的地址 `address` 上監(jiān)聽數(shù)據(jù)報。如果 `address` 未指定，則操作系統(tǒng)會嘗試監(jiān)聽所有地址。當綁定完成后，一個 "listening" 事件會發(fā)生，并且回調(diào) `callback`（如果指定）會被調(diào)用。同時指定 "listening" 事件監(jiān)聽器和 `callback` 并不會產(chǎn)生副作用，但也沒什么用。
一個綁定了的數(shù)據(jù)報套接字會保持 node 進程運行來接收數(shù)據(jù)報。
如果綁定失敗，則一個 "error" 事件會被產(chǎn)生。在極少情況下（比如綁定一個已關(guān)閉的套接字），該方法會拋出一個 `Error`。
一個監(jiān)聽端口 41234 的 UDP 服務(wù)器的例子：
~~~
server.bind(41234);
// 服務(wù)器正在監(jiān)聽 0.0.0.0:41234
~~~
### socket.close()
關(guān)閉底層套接字并停止監(jiān)聽數(shù)據(jù)。
### socket.address()
返回一個包含了套接字地址信息的對象。對于 UDP 套接字，該對象會包含地址 `address`、地址族 `family` 和端口號 `port`。
### socket.setBroadcast(flag)
- `flag` Boolean
設(shè)置或清除 `SO_BROADCAST` 套接字選項。當該選項被設(shè)置，則 UDP 報文可能被發(fā)送到一個本地接口的廣播地址。
### socket.setTTL(ttl)
- `ttl` Integer
設(shè)置 `IP_TTL` 套接字選項。TTL 表示“Time to Live”（生存時間），但在此上下文中它指的是報文允許通過的 IP 躍點數(shù)。各個轉(zhuǎn)發(fā)報文的路由器或網(wǎng)關(guān)都會遞減 TTL。如果 TTL 被一個路由器遞減到 0，則它將不會被轉(zhuǎn)發(fā)。改變 TTL 值通常被用于網(wǎng)絡(luò)探測器或多播。
`setTTL()` 的參數(shù)為介于 1 至 255 的躍點數(shù)。在大多數(shù)系統(tǒng)上缺省值為 64。
### socket.setMulticastTTL(ttl)
- `ttl` Integer
設(shè)置 `IP_MULTICAST_TTL` 套接字選項。TTL 表示“Time to Live”（生存時間），但在此上下文中它指的是報文允許通過的 IP 躍點數(shù)，特別是組播流量。各個轉(zhuǎn)發(fā)報文的路由器或網(wǎng)關(guān)都會遞減 TTL。如果 TTL 被一個路由器遞減到 0，則它將不會被轉(zhuǎn)發(fā)。
`setMulticastTTL()` 的參數(shù)為介于 1 至 255 的躍點數(shù)。在大多數(shù)系統(tǒng)上缺省值為 1。
### socket.setMulticastLoopback(flag)
- `flag` Boolean
設(shè)置或清除 `IP_MULTICAST_LOOP` 套接字選項。當該選項被設(shè)置時，組播報文也會被本地接口收到。
### socket.addMembership(multicastAddress, [multicastInterface])
- `multicastAddress` String
- `multicastInterface` String，可選
以 `IP_ADD_MEMBERSHIP` 套接字選項告訴內(nèi)核加入一個組播分組。
如果未指定 `multicastInterface`，則操作系統(tǒng)會嘗試向所有有效接口添加關(guān)系。
### socket.dropMembership(multicastAddress, [multicastInterface])
- `multicastAddress` String
- `multicastInterface` String，可選
