[Node.js]NET模块

前端之家收集整理的这篇文章主要介绍了[Node.js]NET模块前端之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。

摘要

net模块提供了一些用于底层的网络通信的小工具,包含了创建服务器和客户端的方法。可以使用该模块模拟请求等操作。

net模块

引入net模块

net=require();

方法

net.createServer([options][,connectionListener])
创建一个 TCP 服务器。参数 connectionListener 自动给 'connection' 事件创建监听器。</tr>
<tr>
<td>2</td>
<td>
net.connect(options[,connectionListener])
返回一个新的 'net.Socket',并连接到指定的地址和端口。
当 socket 建立的时候,将会触发 'connect' 事件。</td>

</tr>
<tr>
<td>3</td>
<td>
net.createConnection(options[,connectionListener])
创建一个到端口 port 和 主机 host的 TCP 连接。 host 默认为 'localhost'。</td>

</tr>
<tr>
<td>4</td>
<td>
net.connect(port[,host][,connectListener])
创建一个端口为 port 和主机为 host的 TCP 连接 。host 默认为 'localhost'。参数 connectListener 将会作为监听器添加到 'connect' 事件。返回 'net.Socket'。</td>

</tr>
<tr>
<td>5</td>
<td>
net.createConnection(port[,connectListener])
创建一个端口为 port 和主机为 host的 TCP 连接 。host 默认为 'localhost'。参数 connectListener 将会作为监听器添加到 'connect' 事件。返回 'net.Socket'。</td>

</tr>
<tr>
<td>6</td>
<td>
net.connect(path[,connectListener])
创建连接到 path 的 unix socket 。参数 connectListener 将会作为监听器添加到 'connect' 事件上。返回 'net.Socket'。</td>

</tr>
<tr>
<td>7</td>
<td>
net.createConnection(path[,connectListener])
创建连接到 path 的 unix socket 。参数 connectListener 将会作为监听器添加到 'connect' 事件。返回 'net.Socket'。</td>

</tr>
<tr>
<td>8</td>
<td>
net.isIP(input)
检测输入的是否为 IP 地址。 IPV4 返回 4, IPV6 返回 6,其他情况返回 0。</td>

</tr>
<tr>
<td>9</td>
<td>
net.isIPv4(input)
如果输入的地址为 IPV4, 返回 true,否则返回 false。</td>

</tr>
<tr>
<td>10</td>
<td>
net.isIPv6(input)
如果输入的地址为 IPV6, 返回 true,否则返回 false。</td>

</tr>

net Server

用于创建一个TCP或者本地服务器

server.listen(port[,backlog][,callback])
监听指定端口 port 和 主机 host ac连接。 默认情况下 host 接受任何 IPv4 地址(INADDR_ANY)的直接连接。端口 port 为 0 时,则会分配一个随机端口。</tr>
<tr>
<td>2</td>
<td>
server.listen(path[,callback])
通过指定 path 的连接,启动一个本地 socket 服务器。</td>

</tr>
<tr>
<td>3</td>
<td>
server.listen(handle[,callback])
通过指定句柄连接。</td>

</tr>
<tr>
<td>4</td>
<td>
server.listen(options[,callback])
options 的属性:端口 port,主机 host,和 backlog,以及可选参数 callback 函数,他们在一起调用server.listen(port,[host],[backlog],[callback])。还有,参数 path 可以用来指定 UNIX socket。</td>

</tr>
<tr>
<td>5</td>
<td>
server.close([callback])
服务器停止接收新的连接,保持现有连接。这是异步函数,当所有连接结束的时候服务器会关闭,并会触发 'close' 事件。</td>

</tr>
<tr>
<td>6</td>
<td>
server.address()
操作系统返回绑定的地址,协议族名和服务器端口。</td>

</tr>
<tr>
<td>7</td>
<td>
server.unref()
如果这是事件系统中唯一一个活动的服务器,调用 unref 将允许程序退出。</td>

</tr>
<tr>
<td>8</td>
<td>
server.ref()
与 unref 相反,如果这是唯一的服务器,在之前被 unref 了的服务器上调用 ref 将不会让程序退出(默认行为)。如果服务器已经被 ref,则再次调用 ref 并不会产生影响。</td>

</tr>
<tr>
<td>9</td>
<td>
server.getConnections(callback)
异步获取服务器当前活跃连接的数量。当 socket 发送给子进程后才有效;回调函数有 2 个参数 err 和 count。</td>

</tr>

事件

listening
当服务器调用 server.listen 绑定后会触发。</tr>
<tr>
<td>2</td>
<td>
connection
当新连接创建后会被触发。socket 是 net.Socket实例。</td>

</tr>
<tr>
<td>3</td>
<td>
close
服务器关闭时会触发。注意,如果存在连接,这个事件不会被触发直到所有的连接关闭。</td>

</tr>
<tr>
<td>4</td>
<td>
error
发生错误时触发。'close' 事件将被下列事件直接调用。</td>

</tr>

net.Socket

net.Socket对象是TCP或者UNIX Socket的抽象。net.Socket实例实现了一双工流接口。它们可以在用户创建客户端(使用connect())时使用,或者有Node创建它们,并通过connection服务器事件传递给用户

net.Socket的事件

lookup
在解析域名后,但在连接前,触发这个事件。对 UNIX sokcet 不适用。</tr>
<tr>
<td>2</td>
<td>
connect
成功建立 socket 连接时触发。</td>

</tr>
<tr>
<td>3</td>
<td>
data
当接收到数据时触发。</td>

</tr>
<tr>
<td>4</td>
<td>
end
当 socket 另一端发送 FIN 包时,触发该事件。</td>

</tr>
<tr>
<td>5</td>
<td>
timeout
当 socket 空闲超时时触发,仅是表明 socket 已经空闲。用户必须手动关闭连接。</td>

</tr>
<tr>
<td>6</td>
<td>
drain
当写缓存为空得时候触发。可用来控制上传。</td>

</tr>
<tr>
<td>7</td>
<td>
error
错误发生时触发。</td>

</tr>
<tr>
<td>8</td>
<td>
close
当 socket 完全关闭时触发。参数 had_error 是布尔值,它表示是否因为传输错误导致 socket 关闭。</td>

</tr>

另外,net.Socket提供了很多有用的属性,便于控制socket的交互。

socket.bufferSize
属性显示了要写入缓冲区的字节数。</tr>
<tr>
<td>2</td>
<td>
socket.remoteAddress
远程的 IP 地址字符串,例如:'74.125.127.100' or '2001:4860:a005::68'。</td>

</tr>
<tr>
<td>3</td>
<td>
socket.remoteFamily
远程IP协议族字符串,比如 'IPv4' or 'IPv6'。</td>

</tr>
<tr>
<td>4</td>
<td>
socket.remotePort
远程端口,数字表示,例如:80 or 21。</td>

</tr>
<tr>
<td>5</td>
<td>
socket.localAddress
网络连接绑定的本地接口 远程客户端正在连接的本地 IP 地址,字符串表示。例如,如果你在监听'0.0.0.0'而客户端连接在'192.168.1.1',这个值就会是 '192.168.1.1'。</td>

</tr>
<tr>
<td>6</td>
<td>
socket.localPort
本地端口地址,数字表示。例如:80 or 21。</td>

</tr>
<tr>
<td>7</td>
<td>
socket.bytesRead
接收到得字节数。</td>

</tr>
<tr>
<td>8</td>
<td>
socket.bytesWritten
发送的字节数。</td>

</tr>

net.Socket方法

 

new net.Socket([options])
构造一个新的 socket 对象。</tr>
<tr>
<td>2</td>
<td>
socket.connect(port[,connectListener])
指定端口 port 和 主机 host,创建 socket 连接 。参数 host 默认为 localhost。通常情况不需要使用 net.createConnection 打开 socket。只有你实现了自己的 socket 时才会用到。</td>

</tr>
<tr>
<td>3</td>
<td>
socket.connect(path[,connectListener])
打开指定路径的 unix socket。通常情况不需要使用 net.createConnection 打开 socket。只有你实现了自己的 socket 时才会用到。</td>

</tr>
<tr>
<td>4</td>
<td>
socket.setEncoding([encoding])
设置编码</td>

</tr>
<tr>
<td>5</td>
<td>
socket.write(data[,encoding][,callback])
在 socket 上发送数据。第二个参数指定了字符串的编码,默认是 UTF8 编码。</td>

</tr>
<tr>
<td>6</td>
<td>
socket.end([data][,encoding])
关闭 socket。例如,它发送一个 FIN 包。可能服务器仍在发送数据。</td>

</tr>
<tr>
<td>7</td>
<td>
socket.destroy()
确保没有 I/O 活动在这个套接字上。只有在错误发生情况下才需要。(处理错误等等)。</td>

</tr>
<tr>
<td>8</td>
<td>
socket.pause()
暂停读取数据。就是说,不会再触发 data 事件。对于控制上传非常有用。</td>

</tr>
<tr>
<td>9</td>
<td>
socket.resume()
调用 pause() 后想恢复读取数据。</td>

</tr>
<tr>
<td>10</td>
<td>
socket.setTimeout(timeout[,callback])
socket 闲置时间超过 timeout 毫秒后 ,将 socket 设置为超时。</td>

</tr>
<tr>
<td>11</td>
<td>
socket.setNoDelay([noDelay])
禁用纳格(Nagle)算法。默认情况下 TCP 连接使用纳格算法,在发送前他们会缓冲数据。将 noDelay 设置为 true 将会在调用 socket.write() 时立即发送数据。noDelay 默认值为 true。</td>

</tr>
<tr>
<td>12</td>
<td>
socket.setKeepAlive([enable][,initialDelay])
禁用/启用长连接功能,并在发送第一个在闲置 socket 上的长连接 probe 之前,可选地设定初始延时。默认为 false。 设定 initialDelay (毫秒),来设定收到的最后一个数据包和第一个长连接probe之间的延时。将 initialDelay 设为0,将会保留默认(或者之前)的值。默认值为0.</td>

</tr>
<tr>
<td>13</td>
<td>
socket.address()
操作系统返回绑定的地址,协议族名和服务器端口。返回的对象有 3 个属性,比如{ port: 12346,family: 'IPv4',address: '127.0.0.1' }。</td>

</tr>
<tr>
<td>14</td>
<td>
socket.unref()
如果这是事件系统中唯一一个活动的服务器,调用 unref 将允许程序退出。如果服务器已被 unref,则再次调用 unref 并不会产生影响。</td>

</tr>
<tr>
<td>15</td>
<td>
socket.ref()
与 unref 相反,如果这是唯一的服务器,在之前被 unref 了的服务器上调用 ref 将不会让程序退出(默认行为)。如果服务器已经被 ref,则再次调用 ref 并不会产生影响。</td>

</tr>

一个例子

server.js代码

执行

创建client.js

执行

30134bc.png" alt="">

资料来源

猜你在找的Node.js相关文章