Class DnsName
- All Implemented Interfaces:
Serializable
,CharSequence
,Comparable<DnsName>
Instances of this class can be created by using from(String)
.
This class holds three representations of a DNS name: ACE, raw ACE and IDN. ACE (ASCII Compatible Encoding), which
can be accessed via ace
, represents mostly the data that got send over the wire. But since DNS names are
case insensitive, the ACE value is normalized to lower case. You can use getRawAce()
to get the raw ACE data
that was received, which possibly includes upper case characters. The IDN (Internationalized Domain Name), that is
the DNS name as it should be shown to the user, can be retrieved using asIdn()
.
- Author:
- Florian Schmaus
- See Also:
-
Field Summary
-
Method Summary
Modifier and TypeMethodDescriptionasIdn()
char
charAt
(int index) int
boolean
static DnsName
from
(CharSequence name) static DnsName
static DnsName
static DnsName
static DnsName
static DnsName
static DnsName
Create a DNS name by "concatenating" the child under the parent name.byte[]
getBytes()
Serialize a domain name under IDN rules.Domainpart in ACE representation.Hostpart in ACE representation.getLabel
(int labelNum) int
DnsLabel[]
Get a copy of the labels of this DNS name.Return the parent of this DNS label.byte[]
DnsLabel[]
Get a copy of the raw labels of this DNS name.int
hashCode()
boolean
boolean
isDirectChildOf
(DnsName parent) boolean
int
length()
static DnsName
parse
(DataInputStream dis, byte[] data) Parse a domain name starting at the current offset and moving the input stream pointer past this domain name (even if cross references occure).int
size()
stripToLabels
(int labelCount) subSequence
(int start, int end) toString()
void
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
Methods inherited from interface java.lang.CharSequence
chars, codePoints, isEmpty
-
Field Details
-
MAX_DNSNAME_LENGTH_IN_OCTETS
static final int MAX_DNSNAME_LENGTH_IN_OCTETS- See Also:
-
MAX_LABELS
public static final int MAX_LABELS- See Also:
-
ROOT
-
IN_ADDR_ARPA
-
IP6_ARPA
-
VALIDATE
public static boolean VALIDATEWhether or not the DNS name is validated on construction. -
ace
The DNS name in ASCII Compatible Encoding (ACE).
-
-
Method Details
-
writeToStream
- Throws:
IOException
-
getBytes
public byte[] getBytes()Serialize a domain name under IDN rules.- Returns:
- The binary domain name representation.
-
getRawBytes
public byte[] getRawBytes() -
getRawAce
-
asIdn
-
getDomainpart
Domainpart in ACE representation.- Returns:
- the domainpart in ACE representation.
-
getHostpart
Hostpart in ACE representation.- Returns:
- the hostpart in ACE representation.
-
getHostpartLabel
-
size
public int size() -
length
public int length()- Specified by:
length
in interfaceCharSequence
-
charAt
public char charAt(int index) - Specified by:
charAt
in interfaceCharSequence
-
subSequence
- Specified by:
subSequence
in interfaceCharSequence
-
toString
- Specified by:
toString
in interfaceCharSequence
- Overrides:
toString
in classObject
-
from
-
from
-
from
Create a DNS name by "concatenating" the child under the parent name. The child can also be seen as the "left" part of the resulting DNS name and the parent is the "right" part.For example using "i.am.the.child" as child and "of.this.parent.example" as parent, will result in a DNS name: "i.am.the.child.of.this.parent.example".
- Parameters:
child
- the child DNS name.parent
- the parent DNS name.- Returns:
- the resulting of DNS name.
-
from
-
from
-
from
-
from
-
parse
Parse a domain name starting at the current offset and moving the input stream pointer past this domain name (even if cross references occure).- Parameters:
dis
- The input stream.data
- The raw data (for cross references).- Returns:
- The domain name string.
- Throws:
IOException
- Should never happen.
-
compareTo
- Specified by:
compareTo
in interfaceComparable<DnsName>
-
equals
-
hashCode
public int hashCode() -
isDirectChildOf
-
isChildOf
-
getLabelCount
public int getLabelCount() -
getLabels
Get a copy of the labels of this DNS name. The resulting array will contain the labels in reverse order, that is, the top-level domain will be at res[0].- Returns:
- an array of the labels in reverse order.
-
getLabel
-
getRawLabels
Get a copy of the raw labels of this DNS name. The resulting array will contain the labels in reverse order, that is, the top-level domain will be at res[0].- Returns:
- an array of the raw labels in reverse order.
-
stripToLabels
-
getParent
Return the parent of this DNS label. Will return the root label if this label itself is the root label (because there is no parent of root).For example:
"foo.bar.org".getParent() == "bar.org"
".".getParent() == "."
- Returns:
- the parent of this DNS label.
-
isRootLabel
public boolean isRootLabel()
-