Module com.aoapps.tlds

Package com.aoapps.tlds

Class TopLevelDomain

java.lang.Object

com.aoapps.tlds.TopLevelDomain

public final class TopLevelDomain
extends Object

Provides access to the current top level domains. As a fall-back, a copy of the top-level domain list is bundled within this API. The list is self-updated from data.iana.org. Updates are persisted via the Java Preferences API.

Author:

AO Industries, Inc.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	TopLevelDomain.Snapshot	One snapshot of the data, representing the state at one moment in time.

Method Summary

Modifier and Type	Method	Description
static String	getByLabel(String label)	Provides a way to get the top level domain based on label (case-insensitive).
static List<String>	getComments()	Gets an unmodifiable list of the comments contained within tlds-alpha-by-domain.txt.
static long	getLastSuccessfulUpdateTime()	Gets the last time the list was successfully updated.
static long	getLastUpdatedTime()	Gets the last time the list was updated, whether successful or not.
static boolean	getLastUpdateSuccessful()	Gets whether the last update was successful.
static TopLevelDomain.Snapshot	getSnapshot()	Gets a snapshot of the current set of top-level domains, in the case and order contained within tlds-alpha-by-domain.txt.
static List<String>	getTopLevelDomains()	Gets an unmodifiable list of the most recently retrieved top-level domains, in the case and order contained within tlds-alpha-by-domain.txt.
static boolean	isBootstrap()	Gets whether or not this is the bundled bootstrap data.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

getSnapshot

public static TopLevelDomain.Snapshot getSnapshot()

Gets a snapshot of the current set of top-level domains, in the case and order contained within tlds-alpha-by-domain.txt. Will trigger asynchronous background update if it is time to to so, but will use the currently available data and not wait for the update to complete.

getTopLevelDomains

public static List<String> getTopLevelDomains()

Gets an unmodifiable list of the most recently retrieved top-level domains, in the case and order contained within tlds-alpha-by-domain.txt.

Each element is interned.

See Also:

• TopLevelDomain.Snapshot.getTopLevelDomains()
• getSnapshot()

getComments

public static List<String> getComments()

Gets an unmodifiable list of the comments contained within tlds-alpha-by-domain.txt. All lines starting with "#" are considered to be comments.

See Also:

• TopLevelDomain.Snapshot.getComments()
• getSnapshot()

getLastUpdatedTime

public static long getLastUpdatedTime()

Gets the last time the list was updated, whether successful or not.

See Also:

• TopLevelDomain.Snapshot.getLastUpdatedTime()
• getSnapshot()

isBootstrap

public static boolean isBootstrap()

Gets whether or not this is the bundled bootstrap data.

Returns:

true if this is the included bootstrap data, or false is this is auto-updated

See Also:

• TopLevelDomain.Snapshot.isBootstrap()
• getSnapshot()

getLastUpdateSuccessful

public static boolean getLastUpdateSuccessful()

Gets whether the last update was successful.

See Also:

• TopLevelDomain.Snapshot.getLastUpdateSuccessful()
• getSnapshot()

getLastSuccessfulUpdateTime

public static long getLastSuccessfulUpdateTime()

Gets the last time the list was successfully updated.

See Also:

• TopLevelDomain.Snapshot.getLastSuccessfulUpdateTime()
• getSnapshot()

getByLabel

public static String getByLabel(String label)

Provides a way to get the top level domain based on label (case-insensitive).

Any non-null returned value is interned.

Returns:

The top level domain based on label (case-insensitive) or null if no match.

See Also:

• TopLevelDomain.Snapshot.getByLabel(java.lang.String)
• getSnapshot()