de.malkusch.whoisServerList.publicSuffixList

Class PublicSuffixList

java.lang.Object

de.malkusch.whoisServerList.publicSuffixList.PublicSuffixList

All Implemented Interfaces:

Iterable<Rule>

public class PublicSuffixList
extends Object
implements Iterable<Rule>

API for the Public Suffix List. Use PublicSuffixListFactory for building this api. You can use the API's methods with UTF-8 domain names or Punnycode encoded ASCII domain names. The API will return the results in the same format as the input was. I.e. if you use an UTF-8 string the result will be an UTF-8 String as well. Same for Punnycode.

Author:

markus@malkusch.de

See Also:

Donations, https://publicsuffix.org/, PublicSuffixListFactory

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	PublicSuffixList(Index index, URL url, Charset charset)

Method Summary

Methods

Modifier and Type	Method and Description
Charset	getCharset() Returns the charset of the public suffix list
String	getPublicSuffix(String domain) Returns the public suffix from a domain or null.
String	getRegistrableDomain(String domain) Gets the registrable domain or null.
List<Rule>	getRules() Returns a list with all rules
URL	getURL() The URL of the public suffix list
boolean	isPublicSuffix(String domain) Returns whether a domain is a public suffix or not.
boolean	isRegistrable(String domain) Returns whether a domain is registrable.
Iterator<Rule>	iterator()

Methods inherited from class java.lang.Object

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

Constructor Detail

PublicSuffixList

protected PublicSuffixList(Index index,
                URL url,
                Charset charset)

See Also:

PublicSuffixListFactory.build()

Method Detail

getRegistrableDomain

public String getRegistrableDomain(String domain)

Gets the registrable domain or null. E.g. "www.example.net" and "example.net" will return "example.net". Domains with a leading dot will return null as well.

isRegistrable

public boolean isRegistrable(String domain)

Returns whether a domain is registrable. E.g. example.net is registrable, www.example.net and net are not.

Throws:

NullPointerException - if domain is null.

getPublicSuffix

public String getPublicSuffix(String domain)

Returns the public suffix from a domain or null. If the domain is already a public suffix, it will be returned unchanged.

isPublicSuffix

public boolean isPublicSuffix(String domain)

Returns whether a domain is a public suffix or not. Example: "com" is a public suffix, "example.com" isn't.

Throws:

NullPointerException - is domain is null.

getCharset

public Charset getCharset()

Returns the charset of the public suffix list

getURL

public URL getURL()

The URL of the public suffix list

getRules

public List<Rule> getRules()

Returns a list with all rules

iterator

public Iterator<Rule> iterator()

Specified by:

iterator in interface Iterable<Rule>