DnsMessage (Netty API Reference (4.1.22.Final))

All Superinterfaces:

ReferenceCounted

All Known Subinterfaces:

DnsQuery ， DnsResponse

所有已知实现类：

AbstractDnsMessage ， DatagramDnsQuery ， DatagramDnsResponse ， DefaultDnsQuery ， DefaultDnsResponse
```
@UnstableApi
public interface DnsMessage
extends ReferenceCounted
```
包含关于DnsQuery和DnsResponse的核心信息的超类。

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`DnsMessage`	`addRecord(DnsSection section, DnsRecord record)` 添加指定 `record`在指定的结束 `section`此DNS的消息。
`DnsMessage`	`addRecord(DnsSection section, int index, DnsRecord record)` 添加指定 `record`在指定 `index`指定的 `section`此DNS的消息。
`DnsMessage`	`clear()` 删除此DNS消息中的所有记录。
`DnsMessage`	`clear(DnsSection section)` 删除此DNS消息的指定 `section`的所有记录。
`int`	`count()` 返回此DNS消息中的记录数。
`int`	`count(DnsSection section)` 返回此DNS消息的指定 `section`中的记录数。
`int`	`id()` 返回此DNS消息的 `ID` 。
`boolean`	`isRecursionDesired()` 返回此DNS消息的 `RD` （期望递归）字段。
`DnsOpCode`	`opCode()` 返回此DNS消息的 `opCode` 。
`<T extends DnsRecord> T`	`recordAt(DnsSection section)` 返回此DNS消息的指定 `section`中的第一条记录。
`<T extends DnsRecord> T`	`recordAt(DnsSection section, int index)` 返回此DNS消息的指定 `index`的指定 `section`处的记录。
`<T extends DnsRecord> T`	`removeRecord(DnsSection section, int index)` 从此DNS消息中删除指定 `index`的指定 `section`处的记录。
`DnsMessage`	`retain()` 将引用计数增加 `1` 。
`DnsMessage`	`retain(int increment)` 将参考计数增加指定的 `increment` 。
`DnsMessage`	`setId(int id)` 设置此DNS消息的 `ID` 。
`DnsMessage`	`setOpCode(DnsOpCode opCode)` 设置此DNS消息的 `opCode` 。
`DnsMessage`	`setRecord(DnsSection section, DnsRecord record)` 设置指定的 `section`这个DNS消息到指定的 `record` ，使其成为一个单一的记录部分。
`<T extends DnsRecord> T`	`setRecord(DnsSection section, int index, DnsRecord record)` 设置指定的 `record`在指定的 `index`指定的 `section`这个DNS信息。
`DnsMessage`	`setRecursionDesired(boolean recursionDesired)` 设置此DNS消息的 `RD` （期望递归）字段。
`DnsMessage`	`setZ(int z)` 设置此DNS消息的 `Z` （保留供将来使用）字段。
`DnsMessage`	`touch()` 记录此对象的当前访问位置以进行调试。
`DnsMessage`	`touch(java.lang.Object hint)` 记录此对象的当前访问位置，并附加一些用于调试的任意信息。
`int`	`z()` 返回此DNS消息的 `Z` （保留供将来使用）字段。

Methods inherited from interface io.netty.util.ReferenceCounted
refCnt, release, release

- 方法详细信息
  - id
```
int id()
```
    返回此DNS消息的 ID 。
  - setId
```
DnsMessage setId(int id)
```
    设置此DNS消息的 ID 。
  - opCode
```
DnsOpCode opCode()
```
    返回此DNS消息的 opCode 。
  - setOpCode
```
DnsMessage setOpCode(DnsOpCode opCode)
```
    设置此DNS消息的 opCode 。
  - isRecursionDesired
```
boolean isRecursionDesired()
```
    返回此DNS消息的 RD （期望递归）字段。
  - setRecursionDesired
```
DnsMessage setRecursionDesired(boolean recursionDesired)
```
    设置此DNS消息的 RD （期望递归）字段。
  - z
```
int z()
```
    返回此DNS消息的 Z （保留供将来使用）字段。
  - setZ
```
DnsMessage setZ(int z)
```
    设置此DNS消息的 Z （保留供将来使用）字段。
  - count
```
int count(DnsSection section)
```
    返回此DNS消息的指定 section中的记录数。
  - count
```
int count()
```
    返回此DNS消息中的记录数。
  - recordAt
```
<T extends DnsRecord> T recordAt(DnsSection section)
```
    返回此DNS消息的指定section中的第一条记录。当指定的section是DnsSection.QUESTION时，返回记录的类型始终为DnsQuestion 。
    
    结果
    
    null如果此消息在指定的 section中没有任何记录
  - recordAt
```
<T extends DnsRecord> T recordAt(DnsSection section,
                                 int index)
```
    返回此DNS消息的指定index的指定section处的记录。当指定的section是DnsSection.QUESTION时，返回记录的类型始终为DnsQuestion 。
    
    异常
    
    java.lang.IndexOutOfBoundsException - 如果指定的 index超出范围
  - setRecord
```
DnsMessage setRecord(DnsSection section,
                     DnsRecord record)
```
    设置指定的section这个DNS消息到指定的record ，使其成为一个单一的记录部分。当指定的section是DnsSection.QUESTION时，指定的record必须是DnsQuestion 。
  - setRecord
```
<T extends DnsRecord> T setRecord(DnsSection section,
                                  int index,
                                  DnsRecord record)
```
    设置指定的record在指定的index指定的section这个DNS信息。当指定的section是DnsSection.QUESTION时，指定的record必须是DnsQuestion 。
    
    结果
    
    旧的纪录
    
    异常
    
    java.lang.IndexOutOfBoundsException - 如果指定的 index超出范围
  - addRecord
```
DnsMessage addRecord(DnsSection section,
                     DnsRecord record)
```
    添加指定record在指定的结束section此DNS的消息。当指定的section是DnsSection.QUESTION时，指定的record必须是DnsQuestion 。
  - addRecord
```
DnsMessage addRecord(DnsSection section,
                     int index,
                     DnsRecord record)
```
    添加指定record在指定index指定的section此DNS的消息。当指定的section是DnsSection.QUESTION时，指定的record必须是DnsQuestion 。
    
    异常
    
    java.lang.IndexOutOfBoundsException - 如果指定的 index超出范围
  - removeRecord
```
<T extends DnsRecord> T removeRecord(DnsSection section,
                                     int index)
```
    从此DNS消息中删除指定index的指定section处的记录。当指定的section是DnsSection.QUESTION时，返回记录的类型始终为DnsQuestion 。
    
    结果
    
    删除的记录
  - clear
```
DnsMessage clear(DnsSection section)
```
    删除此DNS消息的指定 section的所有记录。
  - clear
```
DnsMessage clear()
```
    删除此DNS消息中的所有记录。
  - touch
```
DnsMessage touch()
```
    从接口复制的描述： ReferenceCounted
    
    记录此对象的当前访问位置以进行调试。如果确定此物体泄漏，则通过此操作记录的信息将通过ResourceLeakDetector提供给您。此方法是touch(null)的快捷方式。
    
    Specified by:
    
    touch在界面 ReferenceCounted
  - touch
```
DnsMessage touch(java.lang.Object hint)
```
    从界面复制的描述： ReferenceCounted
    
    记录此对象的当前访问位置，并附加一些用于调试的任意信息。如果确定此物体泄漏，则通过此操作记录的信息将通过ResourceLeakDetector提供给您。
    
    Specified by:
    
    touch ，界面 ReferenceCounted
  - retain
```
DnsMessage retain()
```
    从界面复制的描述： ReferenceCounted
    
    将引用计数增加 1 。
    
    Specified by:
    
    retain在界面 ReferenceCounted
  - retain
```
DnsMessage retain(int increment)
```
    从接口复制的描述： ReferenceCounted
    
    将参考计数增加指定的 increment 。
    
    Specified by:
    
    retain在界面 ReferenceCounted

Interface DnsMessage

方法摘要

Methods inherited from interface io.netty.util.ReferenceCounted

方法详细信息

id

setId

opCode

setOpCode

isRecursionDesired

setRecursionDesired

z

setZ

count

count

recordAt

recordAt

setRecord

setRecord

addRecord

addRecord

removeRecord

clear

clear

touch

touch

retain

retain