Module com.aoapps.net.types

Package com.aoapps.net

Class DomainLabel

java.lang.Object

com.aoapps.net.DomainLabel

All Implemented Interfaces:

DtoFactory<DomainLabel>, FastExternalizable, Internable<DomainLabel>, Externalizable, Serializable, Comparable<DomainLabel>

public final class DomainLabel
extends Object
implements Comparable<DomainLabel>, FastExternalizable, DtoFactory<DomainLabel>, Internable<DomainLabel>

Represents a DNS domain label (a single part of a domain name between dots). Domain labels must:

• Be non-null
• Be non-empty
• Conforms to definition in https://wikipedia.org/wiki/DNS_label#Parts_of_a_domain_name
• Conforms to RFC 2181
• And allow all numeric as described in RFC 1123

Author:

AO Industries, Inc.

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final int	MAX_LENGTH

Constructor Summary

Constructors

Constructor	Description
DomainLabel()	Deprecated. Only required for implementation, do not use directly.

Method Summary

Modifier and Type	Method	Description
int	compareTo(DomainLabel other)
boolean	equals(Object obj)
DomainLabel	getDto()
long	getSerialVersionUID()
int	hashCode()
DomainLabel	intern()	Interns this label much in the same fashion as String.intern().
void	readExternal(ObjectInput in)
String	toLowerCase()	Gets the lower-case form of the label.
String	toString()
static ValidationResult	validate(String label)	Validates a domain name label.
static ValidationResult	validate(String label, int beginIndex, int endIndex)
static DomainLabel	valueOf(String label)
void	writeExternal(ObjectOutput out)

Methods inherited from class java.lang.Object

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

Field Details

MAX_LENGTH

public static final int MAX_LENGTH

See Also:

• Constant Field Values

Constructor Details

DomainLabel

@Deprecated(forRemoval=false)
public DomainLabel()

Deprecated.

Only required for implementation, do not use directly.

See Also:

• FastExternalizable

Method Details

validate

public static ValidationResult validate(String label)

Validates a domain name label.

validate

public static ValidationResult validate(String label,
 int beginIndex,
 int endIndex)

valueOf

public static DomainLabel valueOf(String label)
                           throws ValidationException

Parameters:

label - when null, returns null

Throws:

ValidationException

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

compareTo

public int compareTo(DomainLabel other)

Specified by:

compareTo in interface Comparable<DomainLabel>

toString

public String toString()

Overrides:

toString in class Object

toLowerCase

public String toLowerCase()

Gets the lower-case form of the label. If two different domain labels are interned and their toLowerCase is the same String instance, then they are equal in case-insensitive manner.

intern

public DomainLabel intern()

Interns this label much in the same fashion as String.intern().

Specified by:

intern in interface Internable<DomainLabel>

See Also:

• String.intern()

getDto

public DomainLabel getDto()

Specified by:

getDto in interface DtoFactory<DomainLabel>

getSerialVersionUID

public long getSerialVersionUID()

Specified by:

getSerialVersionUID in interface FastExternalizable

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException

Specified by:

writeExternal in interface Externalizable

Throws:

IOException

readExternal

public void readExternal(ObjectInput in)
                  throws IOException,
ClassNotFoundException

Specified by:

readExternal in interface Externalizable

Throws:

IOException

ClassNotFoundException