java/net/URI.java

71  * [<i>scheme</i><b>{@code :}</b>]<i>scheme-specific-part</i>[<b>{@code #}</b><i>fragment</i>]
106  * [<i>scheme</i><b>{@code :}</b>][<b>{@code //}</b><i>authority</i>][<i>path</i>][<b>{@code ?}</b><i>query</i>][<b>{@code #}</b><i>fragment</i>]
112  * between the scheme and fragment components.
135  * <caption style="display:none">Describes the components of a URI:scheme,scheme-specific-part,authority,user-info,host,port,path,query,fragment</caption>
148  * <tr><th scope="row">fragment</th><td>{@code String}</td></tr>
162  * possibly a fragment, but has no other components.  A hierarchical URI always
302  * fragment components.  Escaping serves two purposes in URIs:
311  *   component.  The user-info, path, query, and fragment components differ
489     // Components of all URIs: [<scheme>:]<scheme-specific-part>[#<fragment>]
491     private transient String fragment;
541      *   followed by a non-empty path, a query component, or a fragment
550      *   primary consequence of this deviation is that a standalone fragment
552      *   and the given fragment, and can be usefully <a
583      *   user-information, path, query, and fragment components, as well as in
651      *   <li><p> Finally, if a fragment is given then a hash character
652      *   ({@code '#'}) is appended, followed by the fragment.  Any character
668      * @param   fragment  Fragment
678                String path, String query, String fragment)
683                             path, query, fragment);
726      *   <li><p> Finally, if a fragment is given then a hash character
727      *   ({@code '#'}) is appended, followed by the fragment.  Any character
741      * @param   fragment   Fragment
751                String path, String query, String fragment)
756                             path, query, fragment);
771      * URI}{@code (scheme, null, host, -1, path, null, fragment);}
777      * @param   fragment  Fragment
783     public URI(String scheme, String host, String path, String fragment)
786         this(scheme, null, host, -1, path, null, fragment);
808      *   <li><p> Finally, if a fragment is given then a hash character
809      *   ({@code '#'}) is appended to the string, followed by the fragment.
820      * @param   fragment  Fragment
826     public URI(String scheme, String ssp, String fragment)
831                             null, null, fragment))
996      * <p><a id="resolve-frag"></a> If the given URI's fragment component is
998      * query components are undefined, then a URI with the given fragment but
1000      * allows a URI representing a standalone fragment reference, such as
1011      *   URI's query and fragment components. </p></li>
1083      *   query and fragment components taken from the given URI and with a path
1155      * a fragment; all other components are undefined. </p>
1187             if (fragment != null) {
1188                 end -= fragment.length() + 1;
1408      * Returns the raw fragment component of this URI.
1410      * <p> The fragment component of a URI, if defined, only contains legal URI
1413      * @return  The raw fragment component of this URI,
1414      *          or {@code null} if the fragment is undefined
1417         return fragment;
1421      * Returns the decoded fragment component of this URI.
1427      * @return  The decoded fragment component of this URI,
1428      *          or {@code null} if the fragment is undefined
1432         if ((decoded == null) && (fragment != null)) {
1433             decodedFragment = decoded = decode(fragment, false);
1464      * <p> When testing the user-information, path, query, fragment, authority,
1486         if (!equal(this.fragment, that.fragment)) return false;
1524             h = hash(h, fragment);
1625                 return compare(this.fragment, that.fragment);
1653         return compare(this.fragment, that.fragment);
1719         if (fragment != null) {
1721             sb.append(fragment);
2037     private void appendFragment(StringBuilder sb, String fragment) {
2038         if (fragment != null) {
2040             sb.append(quote(fragment, L_URIC, H_URIC));
2052                             String fragment)
2062         appendFragment(sb, fragment);
2106         // 5.2 (2): Reference to current document (lone fragment)
2108             && child.path.isEmpty() && (child.fragment != null)
2110             if ((base.fragment != null)
2111                 && child.fragment.equals(base.fragment)) {
2121             ru.fragment = child.fragment;
2133         ru.fragment = child.fragment;
2176         v.fragment = u.fragment;
2212         v.fragment = child.fragment;
3102         // [<scheme>:]<scheme-specific-part>[#<fragment>]
3130                 checkChars(p + 1, n, L_URIC, H_URIC, "fragment");
3131                 fragment = input.substring(p + 1, n);
3142         // fragment component.  This is so that URIs such as "file:///foo/bar"
3163                     // path, query component or fragment identifier