io.netty.handler.codec.dns.DnsResponseHeader Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of netty-all Show documentation
The newest version!
/*
 * Copyright 2013 The Netty Project
 *
 * The Netty Project licenses this file to you under the Apache License,
 * version 2.0 (the "License"); you may not use this file except in compliance
 * with the License. You may obtain a copy of the License at:
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations
 * under the License.
 */
package io.netty.handler.codec.dns;

/**
 * The DNS response header class which is used when receiving data from a DNS
 * server. Contains information contained in a DNS response header, such as
 * recursion availability, and response codes.
 */
public final class DnsResponseHeader extends DnsHeader {

    private boolean authoritativeAnswer;
    private boolean truncated;
    private boolean recursionAvailable;

    private DnsResponseCode responseCode;

    /**
     * Constructor for a DNS packet response header. The id is received by
     * reading a {@link DnsQuery} and is sent back to the client.
     *
     * @param parent
     *            the {@link DnsMessage} this header belongs to
     * @param id
     *            a 2 bit unsigned identification number received from client
     */
    public DnsResponseHeader(DnsMessage parent, int id) {
        super(parent);
        setId(id);
    }

    /**
     * Returns {@code true} if responding server is authoritative for the domain
     * name in the query message.
     */
    public boolean isAuthoritativeAnswer() {
        return authoritativeAnswer;
    }

    /**
     * Returns {@code true} if response has been truncated, usually if it is
     * over 512 bytes.
     */
    public boolean isTruncated() {
        return truncated;
    }

    /**
     * Returns {@code true} if DNS server can handle recursive queries.
     */
    public boolean isRecursionAvailable() {
        return recursionAvailable;
    }

    /**
     * Returns the 4 bit return code.
     */
    public DnsResponseCode responseCode() {
        return responseCode;
    }

    /**
     * Returns the {@link DnsMessage} type. This will always return
     * {@code TYPE_RESPONSE}.
     */
    @Override
    public int type() {
        return TYPE_RESPONSE;
    }

    /**
     * Set to {@code true} if responding server is authoritative for the domain
     * name in the query message.
     *
     * @param authoritativeAnswer
     *            flag for authoritative answer
     */
    public DnsResponseHeader setAuthoritativeAnswer(boolean authoritativeAnswer) {
        this.authoritativeAnswer = authoritativeAnswer;
        return this;
    }

    /**
     * Set to {@code true} if response has been truncated (usually happens for
     * responses over 512 bytes).
     *
     * @param truncated
     *            flag for truncation
     */
    public DnsResponseHeader setTruncated(boolean truncated) {
        this.truncated = truncated;
        return this;
    }

    /**
     * Set to {@code true} if DNS server can handle recursive queries.
     *
     * @param recursionAvailable
     *            flag for recursion availability
     */
    public DnsResponseHeader setRecursionAvailable(boolean recursionAvailable) {
        this.recursionAvailable = recursionAvailable;
        return this;
    }

    /**
     * Sets the response code for this message.
     *
     * @param responseCode
     *            the response code
     */
    public DnsResponseHeader setResponseCode(DnsResponseCode responseCode) {
        this.responseCode = responseCode;
        return this;
    }

    /**
     * Sets the {@link DnsHeader} type. Must be {@code TYPE_RESPONSE}.
     *
     * @param type
     *            message type
     * @return the header to allow method chaining
     */
    @Override
    public DnsResponseHeader setType(int type) {
        if (type != TYPE_RESPONSE) {
            throw new IllegalArgumentException("type cannot be anything but TYPE_RESPONSE (1) for a response header.");
        }
        super.setType(type);
        return this;
    }

    @Override
    public DnsResponseHeader setId(int id) {
        super.setId(id);
        return this;
    }

    @Override
    public DnsHeader setRecursionDesired(boolean recursionDesired) {
        return super.setRecursionDesired(recursionDesired);
    }

    @Override
    public DnsResponseHeader setOpcode(int opcode) {
        super.setOpcode(opcode);
        return this;
    }

    @Override
    public DnsResponseHeader setZ(int z) {
        super.setZ(z);
        return this;
    }
}