In this context, "URI" is used in the general sense, and {@code HostSpecifier} does not + * guarantee that every URI or URL parser will accept the original input without additional + * normalization. {@code HostSpecifier} follows the syntactic rules of {@link InetAddresses} and + * {@link InternetDomainName}, including their documented acceptance of some inputs that particular + * URI implementations may reject, such as non-ASCII digits, non-ASCII domain names, or domain + * labels containing underscores. + * *
Note that no network lookups are performed by any {@code 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. diff --git a/guava/src/com/google/common/net/HostSpecifier.java b/guava/src/com/google/common/net/HostSpecifier.java index 51d80fbcc218..4be093e6ae0b 100644 --- a/guava/src/com/google/common/net/HostSpecifier.java +++ b/guava/src/com/google/common/net/HostSpecifier.java @@ -30,6 +30,13 @@ * URI, the domain name case is further restricted to include only those domain names which end in a * recognized public suffix; see {@link InternetDomainName#isPublicSuffix()} for details. * + *
In this context, "URI" is used in the general sense, and {@code HostSpecifier} does not + * guarantee that every URI or URL parser will accept the original input without additional + * normalization. {@code HostSpecifier} follows the syntactic rules of {@link InetAddresses} and + * {@link InternetDomainName}, including their documented acceptance of some inputs that particular + * URI implementations may reject, such as non-ASCII digits, non-ASCII domain names, or domain + * labels containing underscores. + * *
Note that no network lookups are performed by any {@code 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.