模块  java.base
软件包  java.net

Class InetSocketAddress

  • 实现的所有接口
    Serializable

    public class InetSocketAddress
    extends SocketAddress
    此类实现IP套接字地址(IP地址+端口号)它也可以是一对(主机名+端口号),在这种情况下,将尝试解析主机名。 如果解析失败,则说该地址未解析但仍可在某些情况下使用,例如通过代理连接。

    它提供了一个由套接字用于绑定,连接或作为返回值的不可变对象。

    通配符是一个特殊的本地IP地址。 它通常表示“任意”,只能用于bind操作。

    从以下版本开始:
    1.4
    另请参见:
    SocketServerSocketSerialized Form
    • 构造方法详细信息

      • InetSocketAddress

        public InetSocketAddress​(int port)
        创建一个套接字地址,其中IP地址是通配符地址,端口号是指定值。

        有效端口值介于0和65535之间。端口号zero将使系统在bind操作中bind临时端口。

        参数
        port - 端口号
        异常
        IllegalArgumentException - 如果port参数超出指定的有效端口值范围。
      • InetSocketAddress

        public InetSocketAddress​(InetAddress addr,
                                 int port)
        根据IP地址和端口号创建套接字地址。

        有效端口值介于0和65535之间。端口号zero将让系统在bind操作中bind临时端口。

        null地址将分配通配符地址。

        参数
        addr - IP地址
        port - 端口号
        异常
        IllegalArgumentException - 如果port参数超出指定的有效端口值范围。
      • InetSocketAddress

        public InetSocketAddress​(String hostname,
                                 int port)
        根据主机名和端口号创建套接字地址。

        将尝试将主机名解析为InetAddress。 如果该尝试失败,则该地址将被标记为未解析

        如果有安全管理器, checkConnect主机名作为参数调用其checkConnect方法,以检查解析权限。 这可能会导致SecurityException。

        有效端口值介于0和65535之间。端口号zero将允许系统在bind操作中bind临时端口。

        参数
        hostname - 主机名
        port - 端口号
        异常
        IllegalArgumentException - 如果port参数超出有效端口值的范围,或者hostname参数为 null
        SecurityException - 如果存在安全管理器,则拒绝解析主机名的权限。
        另请参见:
        isUnresolved()
    • 方法详细信息

      • createUnresolved

        public static InetSocketAddress createUnresolved​(String host,
                                                         int port)
        从主机名和端口号创建未解析的套接字地址。

        不会尝试将主机名解析为InetAddress。 该地址将被标记为未解决

        有效端口值介于0和65535之间。端口号zero将让系统在bind操作中选取一个临时端口。

        参数
        host - 主机名
        port - 端口号
        结果
        InetSocketAddress表示未解析的套接字地址
        异常
        IllegalArgumentException - 如果port参数超出有效端口值的范围,或者hostname参数为 null
        从以下版本开始:
        1.5
        另请参见:
        isUnresolved()
      • getPort

        public final int getPort()
        获取端口号。
        结果
        端口号。
      • getAddress

        public final InetAddress getAddress()
        获取 InetAddress
        结果
        如果未解析,则为InetAddress或 null
      • getHostName

        public final String getHostName()
        获取hostname 注意:如果地址是使用文字IP地址创建的,则此方法可能会触发名称服务反向查找。
        结果
        地址的主机名部分。
      • getHostString

        public final String getHostString()
        如果没有主机名(它是使用文字创建的),则返回主机名或地址的String形式。 这具有尝试反向查找的益处。
        结果
        主机名或地址的String表示形式。
        从以下版本开始:
        1.7
      • isUnresolved

        public final boolean isUnresolved()
        检查地址是否已解决。
        结果
        true如果无法将主机名解析为 InetAddress
      • toString

        public String toString()
        构造此InetSocketAddress的字符串表示形式。 通过在InetAddress上调用toString()并连接端口号(带冒号)来构造此String。 如果地址未解析,则冒号前的部分将仅包含主机名。
        重写:
        toString在类 Object
        结果
        此对象的字符串表示形式。
      • equals

        public final boolean equals​(Object obj)
        将此对象与指定的对象进行比较。 当且仅当参数不是null并且它表示与此对象相同的地址时,结果为true

        如果InetAddresses(或主机名,如果它未解析)和端口号相等,则InetSocketAddress两个实例表示相同的地址。 如果两个地址都未解析,则比较主机名和端口号。 注意:主机名不区分大小写。 例如,“FooBar”和“foobar”被认为是相同的。

        重写:
        equals在类 Object
        参数
        obj - 要比较的对象。
        结果
        true如果对象相同; 否则为false
        另请参见:
        InetAddress.equals(java.lang.Object)