public class

URIUtils

extends Object
java.lang.Object
   ↳ org.apache.http.client.utils.URIUtils

Class Overview

A collection of utilities for URIs, to workaround bugs within the class or for ease-of-use features.

Summary

Public Methods
static URI createURI(String scheme, String host, int port, String path, String query, String fragment)
Constructs a URI using all the parameters.
static URI resolve(URI baseURI, URI reference)
Resolves a URI reference against a base URI.
static URI resolve(URI baseURI, String reference)
Resolves a URI reference against a base URI.
static URI rewriteURI(URI uri, HttpHost target)
A convenience method for rewriteURI(URI, HttpHost, boolean) that always keeps the fragment.
static URI rewriteURI(URI uri, HttpHost target, boolean dropFragment)
A convenience method for creating a new URI whose scheme, host and port are taken from the target host, but whose path, query and fragment are taken from the existing URI.
[Expand]
Inherited Methods
From class java.lang.Object

Public Methods

public static URI createURI (String scheme, String host, int port, String path, String query, String fragment)

Since: API Level 1

Constructs a URI using all the parameters. This should be used instead of URI(String, String, String, int, String, String, String) or any of the other URI multi-argument URI constructors. See HTTPCLIENT-730 for more information.

Parameters
scheme Scheme name
host Host name
port Port number
path Path
query Query
fragment Fragment
Throws
URISyntaxException If both a scheme and a path are given but the path is relative, if the URI string constructed from the given components violates RFC 2396, or if the authority component of the string is present but cannot be parsed as a server-based authority

public static URI resolve (URI baseURI, URI reference)

Since: API Level 1

Resolves a URI reference against a base URI. Work-around for bug in java.net.URI ()

Parameters
baseURI the base URI
reference the URI reference
Returns
  • the resulting URI

public static URI resolve (URI baseURI, String reference)

Since: API Level 1

Resolves a URI reference against a base URI. Work-around for bug in java.net.URI ()

Parameters
baseURI the base URI
reference the URI reference
Returns
  • the resulting URI

public static URI rewriteURI (URI uri, HttpHost target)

Since: API Level 1

A convenience method for rewriteURI(URI, HttpHost, boolean) that always keeps the fragment.

Throws
URISyntaxException

public static URI rewriteURI (URI uri, HttpHost target, boolean dropFragment)

Since: API Level 1

A convenience method for creating a new URI whose scheme, host and port are taken from the target host, but whose path, query and fragment are taken from the existing URI. The fragment is only used if dropFragment is false.

Parameters
uri Contains the path, query and fragment to use.
target Contains the scheme, host and port to use.
dropFragment True if the fragment should not be copied.
Throws
URISyntaxException If the resulting URI is invalid.