@Beta @GwtIncompatible public final class HostSpecifier extends 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 | Method and Description |
---|---|
boolean |
equals(Object other) |
static HostSpecifier |
from(String specifier)
Attempts to return a
HostSpecifier for the given string, throwing an exception if
parsing fails. |
static HostSpecifier |
fromValid(String specifier)
Returns a
HostSpecifier built from the provided specifier , which is already
known to be valid. |
int |
hashCode() |
static boolean |
isValid(String specifier)
Determines whether
specifier represents a valid HostSpecifier as described in
the documentation for fromValid(String) . |
String |
toString()
Returns a string representation of the host specifier suitable for inclusion in a URI.
|
public static HostSpecifier fromValid(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
IllegalArgumentException
- if the specifier is not valid.public static HostSpecifier from(String specifier) throws 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.ParseException
- if the specifier is not valid.public static boolean isValid(String specifier)
specifier
represents a valid HostSpecifier
as described in
the documentation for fromValid(String)
.public String toString()
Copyright © 2010-2017. All Rights Reserved.