@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(@Nullable Object other)
Indicates whether some other object is "equal to" this one.
|
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()
Returns a hash code value for the object.
|
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 boolean equals(@Nullable Object other)
java.lang.Object
The equals
method implements an equivalence relation
on non-null object references:
x
, x.equals(x)
should return
true
.
x
and y
, x.equals(y)
should return true
if and only if
y.equals(x)
returns true
.
x
, y
, and z
, if
x.equals(y)
returns true
and
y.equals(z)
returns true
, then
x.equals(z)
should return true
.
x
and y
, multiple invocations of
x.equals(y)
consistently return true
or consistently return false
, provided no
information used in equals
comparisons on the
objects is modified.
x
,
x.equals(null)
should return false
.
The equals
method for class Object
implements
the most discriminating possible equivalence relation on objects;
that is, for any non-null reference values x
and
y
, this method returns true
if and only
if x
and y
refer to the same object
(x == y
has the value true
).
Note that it is generally necessary to override the hashCode
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.
equals
in class Object
other
- the reference object with which to compare.true
if this object is the same as the obj
argument; false
otherwise.Object.hashCode()
,
HashMap
public int hashCode()
java.lang.Object
HashMap
.
The general contract of hashCode
is:
hashCode
method
must consistently return the same integer, provided no information
used in equals
comparisons 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 hashCode
method on each of
the two objects must produce the same integer result.
Object.equals(java.lang.Object)
method, then calling the hashCode
method 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
class 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
Java™ programming language.)
hashCode
in class Object
Object.equals(java.lang.Object)
,
System.identityHashCode(java.lang.Object)
public String toString()
Copyright © 2010–2019. All rights reserved.