Package org.minidns.dnslabel

Class DnsLabel

java.lang.Object

org.minidns.util.SafeCharSequence

org.minidns.dnslabel.DnsLabel

All Implemented Interfaces:

CharSequence, Comparable<DnsLabel>

Direct Known Subclasses:

LdhLabel, NonLdhLabel

public abstract class DnsLabel
extends SafeCharSequence
implements Comparable<DnsLabel>

A DNS label is an individual component of a DNS name. Labels are usually shown separated by dots.

This class implements Comparable which compares DNS labels according to the Canonical DNS Name Order as specified in RFC 4034 § 6.1.

Note that as per RFC 2181 § 11 DNS labels may contain any byte.

See Also:

• RFC 5890 § 2.2. DNS-Related Terminology

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	DnsLabel.LabelToLongException

Field Summary

Fields

Modifier and Type	Field	Description
final String	label
static final int	MAX_LABEL_LENGTH_IN_OCTETS	The maximum length of a DNS label in octets.
static boolean	VALIDATE	Whether or not the DNS label is validated on construction.
static final DnsLabel	WILDCARD_LABEL

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	DnsLabel(String label)

Method Summary

Modifier and Type	Method	Description
final DnsLabel	asLowercaseVariant()
final int	compareTo(DnsLabel other)
static boolean	consistsOnlyOfLettersDigitsAndHypen(String string)
static boolean	consistsOnlyOfLettersDigitsHypenAndUnderscore(String string)
final boolean	equals(Object other)
static DnsLabel	from(String label)
static DnsLabel[]	from(String[] labels)
final String	getInternationalizedRepresentation()
protected String	getInternationalizedRepresentationInternal()
final String	getLabelType()
final String	getRawLabel()	Get the raw label.
final int	hashCode()
static boolean	isIdnAcePrefixed(String string)
static String	toSafeRepesentation(String dnsLabel)
final String	toString()
final void	writeToBoas(ByteArrayOutputStream byteArrayOutputStream)

Methods inherited from class org.minidns.util.SafeCharSequence

charAt, length, subSequence, toSafeString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.CharSequence

chars, codePoints

Field Details

MAX_LABEL_LENGTH_IN_OCTETS

public static final int MAX_LABEL_LENGTH_IN_OCTETS

The maximum length of a DNS label in octets.

See Also:

• RFC 1035 § 2.3.4.
• Constant Field Values

WILDCARD_LABEL

public static final DnsLabel WILDCARD_LABEL

VALIDATE

public static boolean VALIDATE

Whether or not the DNS label is validated on construction.

label

public final String label

Constructor Details

DnsLabel

protected DnsLabel(String label)

Method Details

getInternationalizedRepresentation

public final String getInternationalizedRepresentation()

getInternationalizedRepresentationInternal

protected String getInternationalizedRepresentationInternal()

getLabelType

public final String getLabelType()

toString

public final String toString()

Specified by:

toString in interface CharSequence

Overrides:

toString in class Object

getRawLabel

public final String getRawLabel()

Get the raw label. Note that this may return a String containing null bytes. Those Strings are notoriously difficult to handle from a security perspective. Therefore it is recommended to use toString() instead, which will return a sanitized String.

Returns:

the raw label.

Since:

1.1.0

equals

public final boolean equals(Object other)

Overrides:

equals in class Object

hashCode

public final int hashCode()

Overrides:

hashCode in class Object

asLowercaseVariant

public final DnsLabel asLowercaseVariant()

writeToBoas

public final void writeToBoas(ByteArrayOutputStream byteArrayOutputStream)

compareTo

public final int compareTo(DnsLabel other)

Specified by:

compareTo in interface Comparable<DnsLabel>

from

public static DnsLabel from(String label)

from

public static DnsLabel[] from(String[] labels)

isIdnAcePrefixed

public static boolean isIdnAcePrefixed(String string)

toSafeRepesentation

public static String toSafeRepesentation(String dnsLabel)

consistsOnlyOfLettersDigitsAndHypen

public static boolean consistsOnlyOfLettersDigitsAndHypen(String string)

consistsOnlyOfLettersDigitsHypenAndUnderscore

public static boolean consistsOnlyOfLettersDigitsHypenAndUnderscore(String string)