DnsNameResolverBuilder (Netty API Reference (4.1.22.Final))

java.lang.Object
- io.netty.resolver.dns.DnsNameResolverBuilder

@UnstableApi
public final class DnsNameResolverBuilder
extends java.lang.Object

DnsNameResolver建造者。

构造方法摘要

构造方法
Constructor and Description
`DnsNameResolverBuilder(EventLoop eventLoop)` 创建一个新的构建器。

方法摘要

所有方法静态方法接口方法具体的方法
Modifier and Type	Method and Description
`DnsNameResolverBuilder`	`authoritativeDnsServerCache(DnsCache authoritativeDnsServerCache)` 设置权威NS服务器的缓存
`DnsNameResolver`	`build()` 返回一个新的`DnsNameResolver`实例。
`DnsNameResolverBuilder`	`channelFactory(ChannelFactory<? extends DatagramChannel> channelFactory)` 设置`ChannelFactory` ，这将创建一个`DatagramChannel` 。
`DnsNameResolverBuilder`	`channelType(java.lang.Class<? extends DatagramChannel> channelType)` 将`ChannelFactory`设置为此类型的`ReflectiveChannelFactory` 。
`static ResolvedAddressTypes`	`computeResolvedAddressTypes(InternetProtocolFamily... internetProtocolFamilies)` 计算`ResolvedAddressTypes`一些`InternetProtocolFamily`秒。
`DnsNameResolverBuilder`	`decodeIdn(boolean decodeIdn)` 设置域/主机名是否应在接收时解码为unicode。
`DnsNameResolverBuilder`	`dnsQueryLifecycleObserverFactory(DnsQueryLifecycleObserverFactory lifecycleObserverFactory)` 设置用于生成可以观察单个DNS查询的对象的工厂。
`DnsNameResolverBuilder`	`hostsFileEntriesResolver(HostsFileEntriesResolver hostsFileEntriesResolver)`
`DnsNameResolverBuilder`	`maxPayloadSize(int maxPayloadSize)` 设置数据报包缓冲区的容量（以字节为单位）。
`DnsNameResolverBuilder`	`maxQueriesPerResolve(int maxQueriesPerResolve)` 设置解析主机名时要发送的最大DNS查询数。
`DnsNameResolverBuilder`	`nameServerProvider(DnsServerAddressStreamProvider dnsServerAddressStreamProvider)` 设置用于确定哪个DNS服务器用于解析每个主机名的`DnsServerAddressStreamProvider` 。
`DnsNameResolverBuilder`	`ndots(int ndots)` 设置在进行初始绝对查询之前必须出现在名称中的点数。
`DnsNameResolverBuilder`	`negativeTtl(int negativeTtl)` 为失败的DNS查询设置缓存的TTL（以秒为单位）。
`DnsNameResolverBuilder`	`optResourceEnabled(boolean optResourceEnabled)` 启用自动包含的可选记录，该记录试图为远程DNS服务器提供解析器可以为每个响应读取多少数据的提示。
`DnsNameResolverBuilder`	`queryTimeoutMillis(long queryTimeoutMillis)` 设置此解析器执行的每个DNS查询的超时（以毫秒为单位）。
`DnsNameResolverBuilder`	`recursionDesired(boolean recursionDesired)` 设置此解析器是否必须发送带有RD（设置递归）标志的DNS查询。
`DnsNameResolverBuilder`	`resolveCache(DnsCache resolveCache)` 设置解析结果的缓存。
`DnsNameResolverBuilder`	`resolvedAddressTypes(ResolvedAddressTypes resolvedAddressTypes)` 设置解析地址的协议族列表。
`DnsNameResolverBuilder`	`searchDomains(java.lang.Iterable<java.lang.String> searchDomains)` 设置解析器的搜索域列表。
`DnsNameResolverBuilder`	`traceEnabled(boolean traceEnabled)` 设置此解析器是否应该在异常消息中生成详细的跟踪信息，以便更容易理解解决失败的原因。
`DnsNameResolverBuilder`	`ttl(int minTtl, int maxTtl)` 设置缓存的DNS资源记录的最小和最大TTL（以秒为单位）。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造方法详细信息
  - DnsNameResolverBuilder
```
public DnsNameResolverBuilder(EventLoop eventLoop)
```
    创建一个新的构建器。
    
    参数
    
    eventLoop - EventLoop EventLoop它将执行与DNS服务器的通信。
- 方法详细信息
  - channelFactory
```
public DnsNameResolverBuilder channelFactory(ChannelFactory<? extends DatagramChannel> channelFactory)
```
    设置ChannelFactory ，这将创建一个DatagramChannel 。
    
    参数
    
    channelFactory - ChannelFactory
    
    结果
    
    this
  - channelType
```
public DnsNameResolverBuilder channelType(java.lang.Class<? extends DatagramChannel> channelType)
```
    将ChannelFactory设置为此类型的ReflectiveChannelFactory 。用作channelFactory(ChannelFactory)的替代品。
    
    参数
    
    channelType - 类型
    
    结果
    
    this
  - resolveCache
```
public DnsNameResolverBuilder resolveCache(DnsCache resolveCache)
```
    设置解析结果的缓存。
    
    参数
    
    resolveCache - DNS解析结果缓存
    
    结果
    
    this
  - dnsQueryLifecycleObserverFactory
```
public DnsNameResolverBuilder dnsQueryLifecycleObserverFactory(DnsQueryLifecycleObserverFactory lifecycleObserverFactory)
```
    设置用于生成可以观察单个DNS查询的对象的工厂。
    
    参数
    
    lifecycleObserverFactory - 用于生成可以观察单个DNS查询的对象的工厂。
    
    结果
    
    this
  - authoritativeDnsServerCache
```
public DnsNameResolverBuilder authoritativeDnsServerCache(DnsCache authoritativeDnsServerCache)
```
    设置权威NS服务器的缓存
    
    参数
    
    authoritativeDnsServerCache - 权威NS服务器缓存
    
    结果
    
    this
  - ttl
```
public DnsNameResolverBuilder ttl(int minTtl,
                                  int maxTtl)
```
    设置缓存的DNS资源记录的最小和最大TTL（以秒为单位）。如果DNS服务器返回的DNS资源记录的TTL小于最小TTL或大于最大TTL，则该解析器将忽略来自DNS服务器的TTL，并分别使用最小TTL或最大TTL。默认值是0和Integer.MAX_VALUE ，它实际上告诉解析器遵守DNS服务器的TTL。
    
    参数
    
    minTtl - 最小TTL
    
    maxTtl - 最大TTL
    
    结果
    
    this
  - negativeTtl
```
public DnsNameResolverBuilder negativeTtl(int negativeTtl)
```
    为失败的DNS查询设置缓存的TTL（以秒为单位）。
    
    参数
    
    negativeTtl - 失败的缓存查询的TTL
    
    结果
    
    this
  - queryTimeoutMillis
```
public DnsNameResolverBuilder queryTimeoutMillis(long queryTimeoutMillis)
```
    设置此解析器执行的每个DNS查询的超时（以毫秒为单位）。
    
    参数
    
    queryTimeoutMillis - 查询超时
    
    结果
    
    this
  - computeResolvedAddressTypes
```
public static ResolvedAddressTypes computeResolvedAddressTypes(InternetProtocolFamily... internetProtocolFamilies)
```
    计算ResolvedAddressTypes一些InternetProtocolFamily秒。根据“java.net”系统属性，空输入将返回默认值。有效输入是（），（IPv4），（IPv6），（Ipv4，IPv6）和（IPv6，IPv4）。
    
    参数
    
    internetProtocolFamilies -的有效序列InternetProtocolFamily小号
    
    结果
    
    一个ResolvedAddressTypes
  - resolvedAddressTypes
```
public DnsNameResolverBuilder resolvedAddressTypes(ResolvedAddressTypes resolvedAddressTypes)
```
    设置解析地址的协议族列表。您可以使用computeResolvedAddressTypes(InternetProtocolFamily...)获得ResolvedAddressTypes出来的一些InternetProtocolFamily秒。
    
    参数
    
    resolvedAddressTypes - 地址类型
    
    结果
    
    this
  - recursionDesired
```
public DnsNameResolverBuilder recursionDesired(boolean recursionDesired)
```
    设置此解析器是否必须发送带有RD（设置递归）标志的DNS查询。
    
    参数
    
    recursionDesired - 如果需要递归，则为true
    
    结果
    
    this
  - maxQueriesPerResolve
```
public DnsNameResolverBuilder maxQueriesPerResolve(int maxQueriesPerResolve)
```
    设置解析主机名时要发送的最大DNS查询数。
    
    参数
    
    maxQueriesPerResolve - 查询的最大数量
    
    结果
    
    this
  - traceEnabled
```
public DnsNameResolverBuilder traceEnabled(boolean traceEnabled)
```
    设置此解析器是否应该在异常消息中生成详细的跟踪信息，以便更容易理解解决失败的原因。
    
    参数
    
    traceEnabled - 如果启用跟踪，则为true
    
    结果
    
    this
  - maxPayloadSize
```
public DnsNameResolverBuilder maxPayloadSize(int maxPayloadSize)
```
    设置数据报包缓冲区的容量（以字节为单位）。默认值是4096字节。
    
    参数
    
    maxPayloadSize - 数据报数据包缓冲区的容量
    
    结果
    
    this
  - optResourceEnabled
```
public DnsNameResolverBuilder optResourceEnabled(boolean optResourceEnabled)
```
    启用自动包含的可选记录，该记录试图为远程DNS服务器提供解析器可以为每个响应读取多少数据的提示。某些DNSServer可能不支持此功能，因此无法回答查询。如果你发现问题，你可能想禁用这个。
    
    参数
    
    optResourceEnabled - 如果可选记录包含已启用
    
    结果
    
    this
  - hostsFileEntriesResolver
```
public DnsNameResolverBuilder hostsFileEntriesResolver(HostsFileEntriesResolver hostsFileEntriesResolver)
```
    参数
    
    hostsFileEntriesResolver - HostsFileEntriesResolver用于首先检查主机名是否是本地别名。
    
    结果
    
    this
  - nameServerProvider
```
public DnsNameResolverBuilder nameServerProvider(DnsServerAddressStreamProvider dnsServerAddressStreamProvider)
```
    设置DnsServerAddressStreamProvider ，用于确定哪个DNS服务器用于解析每个主机名。
    
    结果
    
    this 。
  - searchDomains
```
public DnsNameResolverBuilder searchDomains(java.lang.Iterable<java.lang.String> searchDomains)
```
    设置解析器的搜索域列表。
    
    参数
    
    searchDomains - 搜索域
    
    结果
    
    this
  - ndots
```
public DnsNameResolverBuilder ndots(int ndots)
```
    设置在进行初始绝对查询之前必须出现在名称中的点数。默认值是1 。
    
    参数
    
    ndots - ndots价值
    
    结果
    
    this
  - decodeIdn
```
public DnsNameResolverBuilder decodeIdn(boolean decodeIdn)
```
    设置域/主机名是否应在接收时解码为unicode。见rfc3492 。
    
    参数
    
    decodeIdn - 如果应该解码
    
    结果
    
    this
  - build
```
public DnsNameResolver build()
```
    返回一个新的DnsNameResolver实例。
    
    结果
    
    a DnsNameResolver

Class DnsNameResolverBuilder

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

DnsNameResolverBuilder

方法详细信息

channelFactory

channelType

resolveCache

dnsQueryLifecycleObserverFactory

authoritativeDnsServerCache

ttl

negativeTtl

queryTimeoutMillis

computeResolvedAddressTypes

resolvedAddressTypes

recursionDesired

maxQueriesPerResolve

traceEnabled

maxPayloadSize

optResourceEnabled

hostsFileEntriesResolver

nameServerProvider

searchDomains

ndots

decodeIdn

build