@Beta 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
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
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|
Indicates whether some other object is "equal to" this one.
Attempts to return a
Returns a hash code value for the object.
Returns a string representation of the host specifier suitable for inclusion in a URI.
public static HostSpecifier fromValid(String specifier)
HostSpecifierbuilt from the provided
specifier, which is already known to be valid. If the
specifiermight be invalid, use
The specifier must be in one of these formats:
IllegalArgumentException- if the specifier is not valid.
public static HostSpecifier from(String specifier) throws ParseException
HostSpecifierfor 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)
specifierrepresents a valid
HostSpecifieras described in the documentation for
public boolean equals(@Nullable Object other)
equals method implements an equivalence relation
on non-null object references:
trueif and only if
y, multiple invocations of
trueor consistently return
false, provided no information used in
equalscomparisons on the objects is modified.
equals method for class
the most discriminating possible equivalence relation on objects;
that is, for any non-null reference values
y, this method returns
true if and only
y refer to the same object
x == y has the value
Note that it is generally necessary to override the
method whenever this method is overridden, so as to maintain the
general contract for the
hashCode method, which states
that equal objects must have equal hash codes.
other- the reference object with which to compare.
trueif this object is the same as the obj argument;
public int hashCode()
The general contract of
hashCodemethod must consistently return the same integer, provided no information used in
equalscomparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
equals(Object)method, then calling the
hashCodemethod on each of the two objects must produce the same integer result.
Object.equals(java.lang.Object)method, then calling the
hashCodemethod on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.
As much as is reasonably practical, the hashCode method defined by
Object does return distinct integers for distinct
objects. (This is typically implemented by converting the internal
address of the object into an integer, but this implementation
technique is not required by the
JavaTM programming language.)
public String toString()
Copyright © 2010-2013. All Rights Reserved.