public final class HostSpecifier
extends java.lang.Object
Because this class is intended to represent host specifiers which can reasonably be used in a
URI, the domain name case is further restricted to include only those domain names which end in a
recognized public suffix; see InternetDomainName.isPublicSuffix() for details.
Note that no network lookups are performed by any HostSpecifier methods. No attempt is
made to verify that a provided specifier corresponds to a real or accessible host. Only syntactic
and pattern-based checks are performed.
If you know that a given string represents a numeric IP address, use InetAddresses to
obtain and manipulate a InetAddress instance from it rather than using this
class. Similarly, if you know that a given string represents a domain name, use InternetDomainName rather than this class.
| Modifier and Type | Field and Description |
|---|---|
private java.lang.String |
canonicalForm |
| Modifier | Constructor and Description |
|---|---|
private |
HostSpecifier(java.lang.String canonicalForm) |
| Modifier and Type | Method and Description |
|---|---|
boolean |
equals(java.lang.Object other) |
static HostSpecifier |
from(java.lang.String specifier)
Attempts to return a
HostSpecifier for the given string, throwing an exception if
parsing fails. |
static HostSpecifier |
fromValid(java.lang.String specifier)
Returns a
HostSpecifier built from the provided specifier, which is already
known to be valid. |
int |
hashCode() |
static boolean |
isValid(java.lang.String specifier)
Determines whether
specifier represents a valid HostSpecifier as described in
the documentation for fromValid(String). |
java.lang.String |
toString()
Returns a string representation of the host specifier suitable for inclusion in a URI.
|
public static HostSpecifier fromValid(java.lang.String specifier)
HostSpecifier built from the provided specifier, which is already
known to be valid. If the specifier might be invalid, use from(String)
instead.
The specifier must be in one of these formats:
google.com
127.0.0.1
[2001:db8::1] or 2001:db8::1
java.lang.IllegalArgumentException - if the specifier is not valid.public static HostSpecifier from(java.lang.String specifier) throws java.text.ParseException
HostSpecifier for the given string, throwing an exception if
parsing fails. Always use this method in preference to fromValid(String) for a
specifier that is not already known to be valid.java.text.ParseException - if the specifier is not valid.public static boolean isValid(java.lang.String specifier)
specifier represents a valid HostSpecifier as described in
the documentation for fromValid(String).public boolean equals(@CheckForNull
java.lang.Object other)
equals in class java.lang.Objectpublic int hashCode()
hashCode in class java.lang.Objectpublic java.lang.String toString()
toString in class java.lang.Object