鸿蒙OS开发文档 鸿蒙OS DatagramSocketImpl

2024-02-25 开发教程 鸿蒙OS开发文档 匿名 2

DatagramSocketImpl

java.lang.Object
|---java.net.DatagramSocketImpl

public abstract class DatagramSocketImpl
extends Object
implements SocketOptions

抽象数据报和多播套接字实现基类。

字段摘要

修饰符和类型方法描述
protected FileDescriptorfd文件描述符对象。
protected intlocalPort本地端口号。
从接口 java.net.SocketOptions 继承的字段
IP_MULTICAST_IF, IP_MULTICAST_IF2, IP_MULTICAST_LOOP, IP_TOS, SO_BINDADDR, SO_BROADCAST, SO_KEEPALIVE, SO_LINGER, SO_OOBINLINE, SO_RCVBUF, SO_REUSEADDR, SO_SNDBUF, SO_TIMEOUT, TCP_NODELAY

构造函数摘要

构造函数描述
DatagramSocketImpl()

方法总结

修饰符和类型方法描述
protected abstract voidbind(int lport, InetAddress laddr)将数据报套接字绑定到本地端口和地址。
protected abstract voidclose()关闭插座。
protected voidconnect(InetAddress address, int port)将数据报套接字连接到远程目标。
protected abstract voidcreate()创建一个数据报套接字。
protected voiddisconnect()断开数据报套接字与其远程目标的连接。
protected FileDescriptorgetFileDescriptor()获取数据报套接字文件描述符。
protected intgetLocalPort()获取本地端口。
protected abstract intgetTimeToLive()检索 TTL(time-to-live)选项。
protected abstract bytegetTTL()已弃用。 改用 getTimeToLive。
protected abstract voidjoin(InetAddress inetaddr)加入多播组。
protected abstract voidjoinGroup(SocketAddress mcastaddr, NetworkInterface netIf)加入多播组。
protected abstract voidleave(InetAddress inetaddr)离开多播组。
protected abstract voidleaveGroup(SocketAddress mcastaddr, NetworkInterface netIf)离开多播组。
protected abstract intpeek(InetAddress i)偷看包裹,看看它来自谁。
protected abstract intpeekData(DatagramPacket p)偷看包裹,看看它来自谁。
protected abstract voidreceive(DatagramPacket p)接收数据报包。
protected abstract voidsend(DatagramPacket p)发送一个数据报包。
protected abstract voidsetTimeToLive(int ttl)设置 TTL(time-to-live)选项。
protected abstract voidsetTTL(byte ttl)已弃用。 改用 setTimeToLive。
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
从接口 java.net.SocketOptions 继承的方法
getOption, setOption

字段详细信息

fd

protected FileDescriptor fd

文件描述符对象。

localPort

protected int localPort

本地端口号。

构造函数详细信息

DatagramSocketImpl

public DatagramSocketImpl()

方法详情

create

protected abstract void create() throws SocketException

创建一个数据报套接字。

Throws:

Throw名称Throw描述
SocketException如果底层协议有错误,例如 TCP 错误。

bind

protected abstract void bind(int lport, InetAddress laddr) throws SocketException

将数据报套接字绑定到本地端口和地址。

参数:

参数名称参数描述
lport本地端口
laddr本地地址

Throws:

Throw名称Throw描述
SocketException如果底层协议有错误,例如 TCP 错误。

send

protected abstract void send(DatagramPacket p) throws IOException

发送一个数据报包。 数据包包含数据和要将数据包发送到的目标地址。

参数:

参数名称参数描述
p要发送的数据包。

Throws:

Throw名称Throw描述
IOException如果在发送数据报包时发生 I/O 异常。
PortUnreachableException如果套接字连接到当前无法到达的目的地,则可能会抛出。 请注意,不能保证会引发异常。

connect

protected void connect(InetAddress address, int port) throws SocketException

将数据报套接字连接到远程目标。 这将远程地址与本地套接字相关联,以便数据报只能发送到该目的地并从该目的地接收。 这可能会被覆盖以调用本机系统连接。

如果套接字连接到的远程目标不存在,或者无法到达,并且如果已接收到该地址的 ICMP 目标无法到达数据包,则后续调用 send 或 receive 可能会抛出 PortUnreachableException。 请注意,不能保证会引发异常。

参数:

参数名称参数描述
address要连接的远程 InetAddress
port远程端口号

Throws:

Throw名称Throw Description
SocketException如果套接字无法连接到远程目标,可能会抛出

disconnect

protected void disconnect()

断开数据报套接字与其远程目标的连接。

peek

protected abstract int peek(InetAddress i) throws IOException

偷看包裹,看看它来自谁。 将指定的 InetAddress 更新为数据包的来源地址。

参数:

参数名称参数描述
i一个 InetAddress 对象

返回:

数据包来自的端口号。

Throws:

Throw名称Throw描述
IOException如果发生 I/O 异常
PortUnreachableException如果套接字连接到当前无法到达的目的地,则可能会抛出。 请注意,不能保证会引发异常。

peekData

protected abstract int peekData(DatagramPacket p) throws IOException

偷看包裹,看看它来自谁。 数据被复制到指定的 DatagramPacket 中。 数据被返回,但不被消费,因此后续的 peekData/receive 操作将看到相同的数据。

参数:

参数名称参数描述
p收到的数据包。

返回:

数据包来自的端口号。

Throws:

Throw名称Throw描述
IOException如果发生 I/O 异常
PortUnreachableException如果套接字连接到当前无法到达的目的地,则可能会抛出。 请注意,不能保证会引发异常。

receive

protected abstract void receive(DatagramPacket p) throws IOException

接收数据报包。

参数:

参数名称参数描述
p收到的数据包。

Throws:

Throw名称Throw描述
IOException如果在接收数据报包时发生 I/O 异常。
PortUnreachableException如果套接字连接到当前无法到达的目的地,则可能会抛出。 请注意,不能保证会引发异常。

setTTL

@Deprecated protected abstract void setTTL(byte ttl) throws IOException

已弃用。 改用 setTimeToLive。

设置 TTL (time-to-live) 选项。

参数:

参数名称参数描述
ttl指定 TTL 值的字节

Throws:

Throw名称Throw描述
IOException如果在设置生存时间选项时发生 I/O 异常。

getTTL

@Deprecated protected abstract byte getTTL() throws IOException

已弃用。 改用 getTimeToLive。

检索 TTL (time-to-live) 选项。

返回:

表示 TTL 值的字节

Throws:

Throw名称Throw描述
IOException如果在检索生存时间选项时发生 I/O 异常

setTimeToLive

protected abstract void setTimeToLive(int ttl) throws IOException

设置 TTL (time-to-live) 选项。

参数:

参数名称参数描述
ttl指定 time-to-live 值的 int

Throws:

Throw名称Throw描述
IOException如果在设置 time-to-live 选项时发生 I/O 异常。

getTimeToLive

protected abstract int getTimeToLive() throws IOException

检索 TTL (time-to-live) 选项。

返回:

表示生存时间值的 int

Throws:

Throw名称Throw描述
IOException如果在检索生存时间选项时发生 I/O 异常

join

protected abstract void join(InetAddress inetaddr) throws IOException

加入多播组。

参数:

参数名称参数描述
inetaddr多播地址加入。

Throws:

Throw名称Throw描述
IOException如果加入多播组时发生 I/O 异常。

leave

protected abstract void leave(InetAddress inetaddr) throws IOException

离开多播组。

参数:

参数名称参数描述
inetaddr离开的多播地址。

Throws:

Throw名称Throw描述
IOException如果在离开多播组时发生 I/O 异常。

joinGroup

protected abstract void joinGroup(SocketAddress mcastaddr, NetworkInterface netIf) throws IOException

加入多播组。

参数:

参数名称参数描述
mcastaddr加入地址。
netIf指定接收多播数据报包的本地接口

Throws:

Throw名称Throw描述
IOException如果加入多播组时发生 I/O 异常

leaveGroup

protected abstract void leaveGroup(SocketAddress mcastaddr, NetworkInterface netIf) throws IOException

离开多播组。

参数:

参数名称参数描述
mcastaddr离开的地址。
netIf指定离开组的本地接口

Throws:

Throw名称Throw描述
IOException如果在离开多播组时发生 I/O 异常

close

protected abstract void close()

关闭套接字。

getLocalPort

protected int getLocalPort()

获取本地端口。

返回:

表示本地端口值的 int

getFileDescriptor

protected FileDescriptor getFileDescriptor()

获取数据报套接字文件描述符。

返回:

表示数据报套接字文件描述符的 FileDescriptor 对象