Package nl.basjes.parse.useragent.utils.publicsuffixlist

Class PublicSuffixMatcher

java.lang.Object

nl.basjes.parse.useragent.utils.publicsuffixlist.PublicSuffixMatcher

public final class PublicSuffixMatcher
extends Object

Utility class that can test if DNS names match the content of the Public Suffix List.

An up-to-date list of suffixes can be obtained from publicsuffix.org

Since:

4.4

See Also:

• PublicSuffixList

Constructor Summary

Constructors

Constructor	Description
PublicSuffixMatcher(Collection<PublicSuffixList> lists)
PublicSuffixMatcher(DomainType domainType, Collection<String> rules, Collection<String> exceptions)

Method Summary

Modifier and Type	Method	Description
String	getDomainRoot(String domain)	Returns registrable part of the domain for the given domain name or null if given domain represents a public suffix.
String	getDomainRoot(String domain, DomainType expectedType)	Returns registrable part of the domain for the given domain name or null if given domain represents a public suffix.
boolean	matches(String domain)	Tests whether the given domain matches any of entry from the public suffix list.
boolean	matches(String domain, DomainType expectedType)	Tests whether the given domain matches any of entry from the public suffix list.

Methods inherited from class java.lang.Object

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

Constructor Details

PublicSuffixMatcher

public PublicSuffixMatcher(@Nonnull
 DomainType domainType,
 @Nonnull
 Collection<String> rules,
 Collection<String> exceptions)

Since:

4.5

PublicSuffixMatcher

public PublicSuffixMatcher(@Nonnull
 Collection<PublicSuffixList> lists)

Since:

4.5

Method Details

getDomainRoot

public String getDomainRoot(String domain)

Returns registrable part of the domain for the given domain name or null if given domain represents a public suffix.

Parameters:

domain -

Returns:

domain root

getDomainRoot

public String getDomainRoot(String domain,
 DomainType expectedType)

Returns registrable part of the domain for the given domain name or null if given domain represents a public suffix.

Parameters:

domain -

expectedType - expected domain type or null if any.

Returns:

domain root

Since:

4.5

matches

public boolean matches(String domain)

Tests whether the given domain matches any of entry from the public suffix list.

matches

public boolean matches(String domain,
 DomainType expectedType)

Tests whether the given domain matches any of entry from the public suffix list.

Parameters:

domain -

expectedType - expected domain type or null if any.

Returns:

true if the given domain matches any of the public suffixes.

Since:

4.5