Module org.eclipse.jetty.http

Package org.eclipse.jetty.http

Interface HttpURI

All Known Implementing Classes:

HttpURI.Immutable, HttpURI.Mutable

public interface HttpURI

Http URI. Both HttpURI.Mutable and HttpURI.Immutable implementations are available via the static methods such as build() and from(String). A URI such as http://user@host:port/path;ignored/info;param?query#ignored is split into the following undecoded 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.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	HttpURI.Immutable
static class	HttpURI.Mutable
static class	HttpURI.Violation

Method Summary

Modifier and Type	Method	Description
HttpURI.Immutable	asImmutable()
java.lang.String	asString()
static HttpURI.Mutable	build()
static HttpURI.Mutable	build(java.lang.String uri)
static HttpURI.Mutable	build(java.net.URI uri)
static HttpURI.Mutable	build(HttpURI uri)
static HttpURI.Mutable	build(HttpURI uri, java.lang.String pathQuery)
static HttpURI.Mutable	build(HttpURI uri, java.lang.String path, java.lang.String param, java.lang.String query)
static HttpURI.Immutable	from(java.lang.String uri)
static HttpURI.Immutable	from(java.lang.String method, java.lang.String uri)
static HttpURI.Immutable	from(java.lang.String scheme, java.lang.String host, int port, java.lang.String pathQuery)
static HttpURI.Immutable	from(java.net.URI uri)
java.lang.String	getAuthority()
java.lang.String	getDecodedPath()
java.lang.String	getFragment()
java.lang.String	getHost()
java.lang.String	getParam()
java.lang.String	getPath()
java.lang.String	getPathQuery()
int	getPort()
java.lang.String	getQuery()
java.lang.String	getScheme()
java.lang.String	getUser()
boolean	hasAmbiguousEmptySegment()
boolean	hasAmbiguousEncoding()
boolean	hasAmbiguousParameter()
boolean	hasAmbiguousSegment()
boolean	hasAmbiguousSeparator()
boolean	hasAuthority()
boolean	hasUtf16Encoding()
boolean	hasViolations()
boolean	isAbsolute()
boolean	isAmbiguous()
default java.net.URI	toURI()

Method Detail

build

static HttpURI.Mutable build()

build

static HttpURI.Mutable build(HttpURI uri)

build

static HttpURI.Mutable build(HttpURI uri,
                             java.lang.String pathQuery)

build

static HttpURI.Mutable build(HttpURI uri,
                             java.lang.String path,
                             java.lang.String param,
                             java.lang.String query)

build

static HttpURI.Mutable build(java.net.URI uri)

build

static HttpURI.Mutable build(java.lang.String uri)

from

static HttpURI.Immutable from(java.net.URI uri)

from

static HttpURI.Immutable from(java.lang.String uri)

from

static HttpURI.Immutable from(java.lang.String method,
                              java.lang.String uri)

from

static HttpURI.Immutable from(java.lang.String scheme,
                              java.lang.String host,
                              int port,
                              java.lang.String pathQuery)

asImmutable

HttpURI.Immutable asImmutable()

asString

java.lang.String asString()

getAuthority

java.lang.String getAuthority()

getDecodedPath

java.lang.String getDecodedPath()

getFragment

java.lang.String getFragment()

getHost

java.lang.String getHost()

getParam

java.lang.String getParam()

getPath

java.lang.String getPath()

getPathQuery

java.lang.String getPathQuery()

getPort

int getPort()

getQuery

java.lang.String getQuery()

getScheme

java.lang.String getScheme()

getUser

java.lang.String getUser()

hasAuthority

boolean hasAuthority()

isAbsolute

boolean isAbsolute()

isAmbiguous

boolean isAmbiguous()

Returns:

True if the URI has either an hasAmbiguousParameter(), hasAmbiguousSegment() or hasAmbiguousSeparator().

hasViolations

boolean hasViolations()

Returns:

True if the URI has any Violations.

hasAmbiguousSegment

boolean hasAmbiguousSegment()

Returns:

True if the URI has a possibly ambiguous segment like '..;' or '%2e%2e'

hasAmbiguousEmptySegment

boolean hasAmbiguousEmptySegment()

Returns:

True if the URI empty segment that is ambiguous like '//' or '/;param/'.

hasAmbiguousSeparator

boolean hasAmbiguousSeparator()

Returns:

True if the URI has a possibly ambiguous separator of %2f

hasAmbiguousParameter

boolean hasAmbiguousParameter()

Returns:

True if the URI has a possibly ambiguous path parameter like '..;'

hasAmbiguousEncoding

boolean hasAmbiguousEncoding()

Returns:

True if the URI has an encoded '%' character.

hasUtf16Encoding

boolean hasUtf16Encoding()

toURI

default java.net.URI toURI()