Package org.eclipse.jetty.http

Class HttpURI

java.lang.Object

org.eclipse.jetty.http.HttpURI

public class HttpURI
extends Object

Http URI. Parse a HTTP URI from a string or byte array. Given a URI http://user@host:port/path/info;param?query#fragment this class will split it into the following undecoded optional elements:

• getScheme() - http:
• getAuthority() - //name@host:port
• getHost() - host
• getPort() - port
• getPath() - /path/info
• getParam() - param
• getQuery() - query
• getFragment() - fragment

Any parameters will be returned from getPath(), but are excluded from the return value of getDecodedPath(). If there are multiple parameters, the getParam() method returns only the last one.

Constructor Summary

Constructors

Constructor	Description
HttpURI()
HttpURI(String uri)
HttpURI(String scheme, String host, int port, String pathQuery)
HttpURI(String scheme, String host, int port, String path, String param, String query, String fragment)
HttpURI(URI uri)
HttpURI(HttpURI uri)

Method Summary

Modifier and Type	Method	Description
void	clear()
static HttpURI	createHttpURI(String scheme, String host, int port, String path, String param, String query, String fragment)	Construct a normalized URI.
void	decodeQueryTo(org.eclipse.jetty.util.MultiMap<String> parameters)
void	decodeQueryTo(org.eclipse.jetty.util.MultiMap<String> parameters, String encoding)
void	decodeQueryTo(org.eclipse.jetty.util.MultiMap<String> parameters, Charset encoding)
boolean	equals(Object o)
String	getAuthority()
String	getDecodedPath()
String	getFragment()
String	getHost()
String	getParam()
String	getPath()	The parsed Path.
String	getPathQuery()
int	getPort()
String	getQuery()
String	getScheme()
String	getUser()
boolean	hasQuery()
boolean	isAbsolute()
void	parse(String uri)
void	parse(String uri, int offset, int length)
void	parseConnect(String uri)	Deprecated.
void	parseRequestTarget(String method, String uri)	Parse according to https://tools.ietf.org/html/rfc7230#section-5.3
void	setAuthority(String host, int port)
void	setPath(String path)
void	setPathQuery(String path)
void	setQuery(String query)
void	setScheme(String scheme)
String	toString()
URI	toURI()

Methods inherited from class java.lang.Object

clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

HttpURI

public HttpURI()

HttpURI

public HttpURI(String scheme,
               String host,
               int port,
               String path,
               String param,
               String query,
               String fragment)

HttpURI

public HttpURI(HttpURI uri)

HttpURI

public HttpURI(String uri)

HttpURI

public HttpURI(URI uri)

HttpURI

public HttpURI(String scheme,
               String host,
               int port,
               String pathQuery)

Method Detail

createHttpURI

public static HttpURI createHttpURI(String scheme,
                                    String host,
                                    int port,
                                    String path,
                                    String param,
                                    String query,
                                    String fragment)

Construct a normalized URI. Port is not set if it is the default port.

Parameters:

scheme - the URI scheme

host - the URI hose

port - the URI port

path - the URI path

param - the URI param

query - the URI query

fragment - the URI fragment

Returns:

the normalized URI

parse

public void parse(String uri)

parseRequestTarget

public void parseRequestTarget(String method,
                               String uri)

Parse according to https://tools.ietf.org/html/rfc7230#section-5.3

Parameters:

method - the request method

uri - the request uri

parseConnect

@Deprecated
public void parseConnect(String uri)

Deprecated.

parse

public void parse(String uri,
                  int offset,
                  int length)

getScheme

public String getScheme()

getHost

public String getHost()

getPort

public int getPort()

getPath

public String getPath()

The parsed Path.

Returns:

the path as parsed on valid URI. null for invalid URI.

getDecodedPath

public String getDecodedPath()

getParam

public String getParam()

getQuery

public String getQuery()

hasQuery

public boolean hasQuery()

getFragment

public String getFragment()

decodeQueryTo

public void decodeQueryTo(org.eclipse.jetty.util.MultiMap<String> parameters)

decodeQueryTo

public void decodeQueryTo(org.eclipse.jetty.util.MultiMap<String> parameters,
                          String encoding)
                   throws UnsupportedEncodingException

Throws:

UnsupportedEncodingException

decodeQueryTo

public void decodeQueryTo(org.eclipse.jetty.util.MultiMap<String> parameters,
                          Charset encoding)
                   throws UnsupportedEncodingException

Throws:

UnsupportedEncodingException

clear

public void clear()

isAbsolute

public boolean isAbsolute()

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

setScheme

public void setScheme(String scheme)

setAuthority

public void setAuthority(String host,
                         int port)

Parameters:

host - the host

port - the port

setPath

public void setPath(String path)

Parameters:

path - the path

setPathQuery

public void setPathQuery(String path)

setQuery

public void setQuery(String query)

toURI

public URI toURI()
          throws URISyntaxException

Throws:

URISyntaxException

getPathQuery

public String getPathQuery()

getAuthority

public String getAuthority()

getUser

public String getUser()