Module bus.http
Package org.miaixz.bus.http

Class Address

java.lang.Object
org.miaixz.bus.http.Address
public class Address extends Object
到源服务器的连接规范

定义了连接源服务器的配置，包括主机名、端口、代理、协议和安全设置。 共享相同 Address 的 HTTP 请求可能复用相同的 Connection。

Since:
Java 17+
Author:
Kimi Liu

  • Constructor Details

    • Address

      public Address(String uriHost, int uriPort, DnsX dns, SocketFactory socketFactory, SSLSocketFactory sslSocketFactory, HostnameVerifier hostnameVerifier, CertificatePinner certificatePinner, Authenticator proxyAuthenticator, Proxy proxy, List<org.miaixz.bus.core.net.Protocol> protocols, List<ConnectionSuite> connectionSuites, ProxySelector proxySelector)
      构造函数，初始化 Address 实例
      Parameters:
      uriHost - 主机名
      uriPort - 端口
      dns - DNS 解析服务
      socketFactory - 套接字工厂
      sslSocketFactory - SSL 套接字工厂
      hostnameVerifier - 主机名验证器
      certificatePinner - 证书固定器
      proxyAuthenticator - 代理身份验证器
      proxy - 显式代理
      protocols - 支持的协议列表
      connectionSuites - 支持的连接套件列表
      proxySelector - 代理选择器
      Throws:
      NullPointerException - 如果必需参数为 null

  • Method Details

    • url

      public UnoUrl url()
      获取服务器 URL
      Returns:
      服务器的 URL（路径、查询和片段为空）

    • dns

      public DnsX dns()
      获取 DNS 解析服务
      Returns:
      DNS 解析服务

    • socketFactory

      public SocketFactory socketFactory()
      获取套接字工厂
      Returns:
      套接字工厂

    • proxyAuthenticator

      public Authenticator proxyAuthenticator()
      获取代理身份验证器
      Returns:
      代理身份验证器

    • protocols

      public List<org.miaixz.bus.core.net.Protocol> protocols()
      获取支持的协议列表
      Returns:
      不可修改的协议列表（至少包含 HTTP/1.1）

    • connectionSpecs

      public List<ConnectionSuite> connectionSpecs()
      获取支持的连接套件列表
      Returns:
      不可修改的连接套件列表

    • proxySelector

      public ProxySelector proxySelector()
      获取代理选择器
      Returns:
      代理选择器

    • proxy

      public Proxy proxy()
      获取显式指定的代理
      Returns:
      显式代理（可能为 null）

    • sslSocketFactory

      public SSLSocketFactory sslSocketFactory()
      获取 SSL 套接字工厂
      Returns:
      SSL 套接字工厂（非 HTTPS 时为 null）

    • hostnameVerifier

      public HostnameVerifier hostnameVerifier()
      获取主机名验证器
      Returns:
      主机名验证器（非 HTTPS 时为 null）

    • certificatePinner

      public CertificatePinner certificatePinner()
      获取证书固定器
      Returns:
      证书固定器（非 HTTPS 时为 null）

    • equals

      public boolean equals(Object other)
      比较两个 Address 对象是否相等
      Overrides:
      equals in class Object
      Parameters:
      other - 另一个对象
      Returns:
      true 如果两个 Address 对象相等

    • hashCode

      public int hashCode()
      计算 Address 对象的哈希码
      Overrides:
      hashCode in class Object
      Returns:
      哈希码值

    • toString

      public String toString()
      返回 Address 的字符串表示
      Overrides:
      toString in class Object
      Returns:
      包含主机名、端口和代理信息的字符串