20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package java.net;
  27 
  28 import java.io.IOException;
  29 import java.io.InvalidObjectException;
  30 import java.io.ObjectInputStream;
  31 import java.io.ObjectOutputStream;
  32 import java.io.Serializable;
  33 import java.nio.ByteBuffer;
  34 import java.nio.CharBuffer;
  35 import java.nio.charset.CharsetDecoder;
  36 import java.nio.charset.CoderResult;
  37 import java.nio.charset.CodingErrorAction;
  38 import java.nio.charset.CharacterCodingException;
  39 import java.text.Normalizer;
  40 import jdk.internal.misc.JavaNetUriAccess;
  41 import jdk.internal.misc.SharedSecrets;
  42 import sun.nio.cs.ThreadLocalCoders;
  43 
  44 import java.lang.Character;             // for javadoc
  45 import java.lang.NullPointerException;  // for javadoc
  46 
  47 
  48 /**
  49  * Represents a Uniform Resource Identifier (URI) reference.
  50  *
  51  * <p> Aside from some minor deviations noted below, an instance of this
  52  * class represents a URI reference as defined by
  53  * <a href="http://www.ietf.org/rfc/rfc2396.txt"><i>RFC&nbsp;2396: Uniform
  54  * Resource Identifiers (URI): Generic Syntax</i></a>, amended by <a
  55  * href="http://www.ietf.org/rfc/rfc2732.txt"><i>RFC&nbsp;2732: Format for
  56  * Literal IPv6 Addresses in URLs</i></a>. The Literal IPv6 address format
  57  * also supports scope_ids. The syntax and usage of scope_ids is described
  58  * <a href="Inet6Address.html#scoped">here</a>.
  59  * This class provides constructors for creating URI instances from
  60  * their components or by parsing their string forms, methods for accessing the
  61  * various components of an instance, and methods for normalizing, resolving,

  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package java.net;
  27 
  28 import java.io.IOException;
  29 import java.io.InvalidObjectException;
  30 import java.io.ObjectInputStream;
  31 import java.io.ObjectOutputStream;
  32 import java.io.Serializable;
  33 import java.nio.ByteBuffer;
  34 import java.nio.CharBuffer;
  35 import java.nio.charset.CharsetDecoder;
  36 import java.nio.charset.CoderResult;
  37 import java.nio.charset.CodingErrorAction;
  38 import java.nio.charset.CharacterCodingException;
  39 import java.text.Normalizer;
  40 import jdk.internal.access.JavaNetUriAccess;
  41 import jdk.internal.access.SharedSecrets;
  42 import sun.nio.cs.ThreadLocalCoders;
  43 
  44 import java.lang.Character;             // for javadoc
  45 import java.lang.NullPointerException;  // for javadoc
  46 
  47 
  48 /**
  49  * Represents a Uniform Resource Identifier (URI) reference.
  50  *
  51  * <p> Aside from some minor deviations noted below, an instance of this
  52  * class represents a URI reference as defined by
  53  * <a href="http://www.ietf.org/rfc/rfc2396.txt"><i>RFC&nbsp;2396: Uniform
  54  * Resource Identifiers (URI): Generic Syntax</i></a>, amended by <a
  55  * href="http://www.ietf.org/rfc/rfc2732.txt"><i>RFC&nbsp;2732: Format for
  56  * Literal IPv6 Addresses in URLs</i></a>. The Literal IPv6 address format
  57  * also supports scope_ids. The syntax and usage of scope_ids is described
  58  * <a href="Inet6Address.html#scoped">here</a>.
  59  * This class provides constructors for creating URI instances from
  60  * their components or by parsing their string forms, methods for accessing the
  61  * various components of an instance, and methods for normalizing, resolving,