Android 网络编程 API笔记 - java.net 包相关接口 api

Android 网络编程相关的包 : 9 包, 20 接口, 103 类, 6 枚举, 14异常;

-- Java包 : java.net 包 (6接口, 34类, 2枚举, 12异常);

-- Android包 : android.net 包 (1接口, 19类, 3枚举, 1异常), android.net.http 包 (6类), android.net.nsd 包 (3接口, 2类), android.net.rtp (4类), android.net.sip 包 (1接口, 9类, 1异常), android.net.wifi 包 (16类, 1枚举), android.net.wifi.p2p 包 (9接口, 7类), android.net.wifi.p2p.nsd 包 (6类);

ContentHandlerFactory : 该接口定义内容处理程序工厂;

DatagramSocketImplFactory : 该接口定义用户数据报实现工厂;

FileNameMap : 定义了 文件名和 MIME Type 字符串之间的映射机制 的接口;

SocketImplFactory : 定义套接字实现工厂;

SocketOptions : 定义 获取设置套接字选项的方法 的接口;

URLStreamHandlerFactory : 定义 URL 流协议处理程序工厂;

1. ContentHandlerFactory

作用 : 定义内容处理程序工厂, 该接口的实现类负责将 MIME 类型映射到 ContentHandler 实例对象中;

MIME 解析 :

-- 扩展名 : Multipurpose Internet Mail Extentions 多用途互联网邮件扩展类型;

-- 作用 : 设定 A 扩展名的文件使用 B 程序打开, 当 A 扩展名文件被访问到的时候, 浏览器会自动调用 B 程序打开这个 A 扩展名文件;

-- 使用形式 : 多用于关联自定义的文件后缀文件打开方式和媒体文件打开方式;

接口使用环境 : URLStreamHandler 使用此接口实现的方法创建 MIME Type 的 ContentHandler;

接口方法解析 :

ContentHandler createContentHandler(String mimetype)

-- 作用 : 创建新的ContentHandler, 该 ContentHandler 可以从 URLStreamHandler 中读取对象;

2. DatagramSocketImplFactory

作用 : 定义用于数据包套接字实现的工厂;

接口使用环境 : DatagramSocket 使用该接口的方法创建套接字实例;

接口方法解析 :

DatagramSocketImpl createDatagramSocketImpl()

-- 作用 : 创建 DatagramSocketImpl 实例对象;

3. FileNameMap

作用 : 文件名称 与 MIME Type 字符串 之间的映射所需的接口;

接口方法解析 :

String getContentTypeFor(String fileName)

-- 作用 : 获取指定文件名的 MIME Type 字符串;

4. SocketImplFactory

作用 : 用于定义套接字实现工厂;

使用环境 : Socket 和 ServerSocket 使用该接口定义的方法来创建套接字实例;

方法解析 :

SocketImpl createSocketImpl()

-- 作用 : 创建新的套接字实例;

5. SocketOptions

作用 : 定义了 设置获取 套接字选项的方法;

接口使用环境 : SocketImpl 和 DatagramSocketImpl 实现了该接口, 这两个类的子类应该重写该接口, 用以支持两个类的子类的选项;

(1) 常量字段解析

IP_MULTICAST_IF : 设置一个用于发送多播包的传出接口(eth0, eth1, wlan0 等);

-- 使用环境 : 可以在具有多个网络接口的主机上使用, 一般这种情况下应用程序不使用系统默认的接口, 而使用其它接口;

IP多播 : 一台主机 (多播源) 同时发送同一数据到多台主机;

IP-MULTICAST_IF2 : 与 IP_MULTICAST_IF 作用相同, 但是添加了对 IPv4 IPv6 的支持, 该常量从 1.4 版本 开始支持;

IF_MULTICAST_LOOP : 用于启动或禁用多播数据报会送, 默认状态是启动;

IP_TOS : 在 IP 地址头 中设置 TCP UDP 数据报的 服务类型 或者 流量字段;

TOS (Type Of Service) : 在网络中区分包的优先级, 单字节, 下面是常用的常量服务类型;

-- IPTOS_LOWDELAY : 延迟最小化;

-- IPTOS_THROUGHPUT : 优化吞吐量;

-- IPTOS_RELIABILITY : 可靠性优化;

-- IPTOS_MINCOST : 填充数据, 这些数据可以低速传送, 无关紧要;

SO_BINDADDR : 获取绑定套接字的本地地址;

-- 套接字本地地址不可更改 : 套接字在创建的时候绑定本地地址, 因此不可更改;

-- 套接字默认地址 : INADDR_ANY 表示多穴主机 (有多个IP地址的主机) 的任何地址;

SO_REUSEADDR : 仅用于 MulticastSocket, 默认情况下MulticastSocket 设置了该选项, 对 DatagramSocketImpl 有效;

SO_BROADCAST : 启动禁用发送广播消息的处理能力;

-- 使用场景 : 数据报套接字, 支持广播消息概念的网络;

-- 默认设置 : DatagramSocket 默认启动该选项;

SO_KEEPALIVE : TCP 套接字设置了该选项, 2小时内没有通过 Socket 传输数据, TCP 会将 keepalive 探头发送到同为体中;

-- 作用 : 检测同位体主机是否崩溃;

-- 适用情况 : 仅对 TCP 套接字有效;

-- 同位体通过期待的ACK响应 : 不通知应用程序, 在另外2小时没有数据传输之后, TCP 继续发送一个探头;

-- 同位体通过 RST 响应 : 通知本地 TCP 同位体主机崩溃, 关闭socket 重启主机;

-- 同位体无响应 : 直接关闭套接字;

SO_LINGER : 关闭逗留的超时值, 即在 TCP Socket 执行 close 之后, 等待的时间;

-- 启用非0 超时值 : close() 之后, 在传输和确认读写完毕之前一直阻塞, 如果超时就会通过 TCP RST 强制关闭;

-- 启用 0 超时值 : close() 之后会强制关闭, 不会进行任何等待;

SO_OOBINLINE : 是否丢弃 socket 接收的 tcp 紧急数据;

-- 启动选项 : socket 接收的 tcp 紧急数据都通过 socket 输入流接收;

-- 禁用选项 : 接收的 tcp 紧急数据直接丢弃;

SO_RCVBUF (receive) : 设置网络输入的缓冲区大小;

-- 设置方法使用 : 设置通过套接字 接收数据 时使用的缓冲区的大小;

-- 获取方法使用 : 获取套接字设置的 接收数据 缓冲区大小;

-- 适用情况 : SocketImpl , DatagramSocketImpl;

SO_SNDBUF (send): 设置网络输出的用到的基础的IO缓冲区大小提示;

-- 设置方法使用 : 设置通过套接字 发送数据 时使用的缓冲区的大小;

-- 获取方法使用 : 获取套接字设置的 发送数据 缓冲区大小;

-- 适用情况 : SocketImpl , DatagramSocketImpl;

SO_TIMEOUT : 设置 Socket 阻塞的超时值;

-- 超时的操作 : ServerSocket.accept(), SocketInputStream.read(), DatagramSocket.receive();

-- 设置时机 : 该选项必须在进入阻塞前设置才有效, 如果是阻塞的状态, 设置将不会对本次阻塞生效;

-- 超时处理 : 如果出现超时, 阻塞会继续执行, 但是会引发 InterruptedIOException 异常, Socket 不会关闭;

-- 适用情况 : 该设置对所有的套接字 ( SocketImpl, DatagramSocketImpl ) 有效;

TCP_NODELAY : 设置该参数的链接禁用 nagle 算法;

Nagle算法解析 : 减少发包个数, 用于增加网络软件的效率, 避免一个包只有 1字节, 却使用了 40个字节的头文件的情况;

(2) 接口方法详解

void setOption(int optID, Object value) throws SocketException

-- 作用 : 启用 / 禁用指定选项, 如果启用, 将会采用 value 选项;

-- 选项传入错误 : 如果传入的 value 格式不正确, 会发生错误;

-- 传入基本数据类型 : 使用 Integer Boolean 等封装;

-- 禁用选项 : 传入 new Boolean(false) 可以禁用任何选项, 如果传入其它内容都会启用该选项;

-- 异常 : 如果选项匹配错误, 或者 socket 关闭等错误, 就会报出 SocketException 异常;

Object getOption(int optID) throws SocketException

-- 作用 : 获取选项的值;

6. URLStreamHandlerFactory

接口作用 : 定义了 URL 流协议处理程序的工厂, URL 类实现该接口为特定的协议创建 URLStreamHandler;

createURLStreamHandler URLStreamHandler createURLStreamHandler(String protocol)

-- 作用 : 创建具有指定协议的新的 URLStreamHandler实例;