Name
URI
Synopsis
The URI
class is an immutable representation of a
Uniform Resource Identifier or URI. A
URI is a generalization of the URLs or Uniform Resource Locators used
on the world wide web. The URI
supports parsing
and textual manipulation of URI strings, but does not have any direct
networking capabilities the way that the URL
class
does. The advantages of the URI
class over the
URL
class are that it provides more general
facilities for parsing and manipulating URLs than the
URL
class, that it can can represent relative URIs
which do not include a scheme (or protocol), and that it can
manipulate URIs that include unsupported or even unknown schemes.
Obtain a URI with one of the constructors, which allow a URI to be
parsed from a single string, or allow the specification of the
individual components of a URI. These constructors can throw
URISyntaxException
, which is a checked exception.
When using hard-coded URIs (rather than URIs based on user input) you
may prefer to use the static create(
)
method which does not throw any checked exceptions.
Once you have created a URI
, object you can use
the various get
methods to query the various
portions of the URI. The getRaw(
)
methods are like the get( )
methods except that
they do not decode hexadecimal escape sequences of the form
%xx
that appear in the URI. normalize(
)
returns a new URI object that has
“.” and unnecessary
“..” sequences removed from its
path component. resolve(
)
interprets its URI (or string) argument relative ...
Get Java in a Nutshell, 5th Edition now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.