jodd.http

Class HttpRequest

java.lang.Object

jodd.http.HttpBase<HttpRequest>

jodd.http.HttpRequest

public class HttpRequest
extends HttpBase<HttpRequest>

HTTP request.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.String	host
protected HttpTransport	httpTransport
protected java.lang.String	method
protected java.lang.String	path
protected int	port
protected java.lang.String	protocol
protected HttpParamsMap	query
protected java.lang.String	queryEncoding

Fields inherited from class jodd.http.HttpBase

body, charset, form, formEncoding, HEADER_ACCEPT_ENCODING, HEADER_CONTENT_ENCODING, HEADER_CONTENT_LENGTH, HEADER_CONTENT_TYPE, HEADER_ETAG, HEADER_HOST, headers, httpVersion, mediaType

Constructor Summary

Constructors

Constructor and Description
HttpRequest()

Method Summary

Methods

Modifier and Type	Method and Description
HttpRequest	basicAuthentication(java.lang.String username, java.lang.String password) Enables basic authentication by adding required header.
HttpRequest	clearQueries() Clears all query parameters.
static HttpRequest	delete(java.lang.String destination) Builds a DELETE request.
static HttpRequest	get(java.lang.String destination) Builds a GET request.
static HttpRequest	head(java.lang.String destination) Builds a HEAD request.
java.lang.String	host() Returns request host name.
HttpRequest	host(java.lang.String host) Sets request host name.
java.lang.String	method() Returns request method.
HttpRequest	method(java.lang.String method) Specifies request method.
HttpTransport	open() Opens transport i.e. connection.
static HttpRequest	options(java.lang.String destination) Builds an OPTIONS request.
java.lang.String	path() Returns request path, without the query.
HttpRequest	path(java.lang.String path) Sets request path.
int	port() Returns request port number.
HttpRequest	port(int port) Sets request port number.
static HttpRequest	post(java.lang.String destination) Builds a POST request.
java.lang.String	protocol() Returns used protocol.
HttpRequest	protocol(java.lang.String protocol) Defines protocol.
static HttpRequest	put(java.lang.String destination) Builds a PUT request.
java.util.Map<java.lang.String,java.lang.Object>	query() Returns backend map of query parameters.
HttpRequest	query(java.util.Map<java.lang.String,java.lang.String> queryMap) Adds all parameters from the provided map.
HttpRequest	query(java.lang.String name1, java.lang.Object value1, java.lang.Object... parameters) Adds many query parameters at once.
HttpRequest	query(java.lang.String name, java.lang.String value) Adds query parameter.
HttpRequest	queryEncoding(java.lang.String encoding) Defines encoding for query parameters.
java.lang.String	queryString() Generates query string.
HttpRequest	queryString(java.lang.String queryString)
HttpRequest	queryString(java.lang.String queryString, boolean decode) Sets query from provided query string.
static HttpRequest	readFrom(java.io.InputStream in) Parses input stream and creates new HttpRequest object.
HttpRequest	removeQuery(java.lang.String name) Removes query parameters.
HttpResponse	send() Opens request if not already open, sends request, reads response and closes the request.
HttpRequest	set(java.lang.String destination) Sets the destination (method, host, port... ) at once.
HttpRequest	setHostHeader() Sets 'Host' header from current host and port.
java.lang.String	toString() Returns string representation of the HTTP request.
static HttpRequest	trace(java.lang.String destination) Builds a TRACE request.
java.lang.String	url() Returns full URL path.

Methods inherited from class jodd.http.HttpBase

_header, acceptEncoding, acceptEncoding, body, body, body, bodyBytes, bodyText, bodyText, bodyText, bodyText, charset, charset, contentEncoding, contentLength, contentLength, contentType, contentType, contentType, form, form, form, formEncoding, formString, header, header, header, header, httpVersion, httpVersion, initForm, isFormMultipart, mediaType, mediaType, readBody, readHeaders, removeHeader, sendTo, toByteArray

Methods inherited from class java.lang.Object

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

Field Detail

protocol

protected java.lang.String protocol

host

protected java.lang.String host

port

protected int port

method

protected java.lang.String method

path

protected java.lang.String path

query

protected HttpParamsMap query

queryEncoding

protected java.lang.String queryEncoding

httpTransport

protected HttpTransport httpTransport

Constructor Detail

HttpRequest

public HttpRequest()

Method Detail

host

public java.lang.String host()

Returns request host name.

host

public HttpRequest host(java.lang.String host)

Sets request host name.

protocol

public java.lang.String protocol()

Returns used protocol. By default it's "http".

protocol

public HttpRequest protocol(java.lang.String protocol)

Defines protocol.

port

public int port()

Returns request port number.

port

public HttpRequest port(int port)

Sets request port number.

set

public HttpRequest set(java.lang.String destination)

Sets the destination (method, host, port... ) at once.

get

public static HttpRequest get(java.lang.String destination)

Builds a GET request.

post

public static HttpRequest post(java.lang.String destination)

Builds a POST request.

put

public static HttpRequest put(java.lang.String destination)

Builds a PUT request.

delete

public static HttpRequest delete(java.lang.String destination)

Builds a DELETE request.

head

public static HttpRequest head(java.lang.String destination)

Builds a HEAD request.

trace

public static HttpRequest trace(java.lang.String destination)

Builds a TRACE request.

options

public static HttpRequest options(java.lang.String destination)

Builds an OPTIONS request.

method

public java.lang.String method()

Returns request method.

method

public HttpRequest method(java.lang.String method)

Specifies request method. It will be converted into uppercase.

path

public java.lang.String path()

Returns request path, without the query.

path

public HttpRequest path(java.lang.String path)

Sets request path. Query string is allowed. Adds a slash if path doesn't start with one. Query will be stripped out from the path. Previous query is discarded.

See Also:

query()

query

public HttpRequest query(java.lang.String name,
                java.lang.String value)

Adds query parameter.

query

public HttpRequest query(java.lang.String name1,
                java.lang.Object value1,
                java.lang.Object... parameters)

Adds many query parameters at once. Although it accepts objects, each value will be converted to string.

query

public HttpRequest query(java.util.Map<java.lang.String,java.lang.String> queryMap)

Adds all parameters from the provided map.

query

public java.util.Map<java.lang.String,java.lang.Object> query()

Returns backend map of query parameters. Values can be null, String or String[].

clearQueries

public HttpRequest clearQueries()

Clears all query parameters.

removeQuery

public HttpRequest removeQuery(java.lang.String name)

Removes query parameters.

queryString

public HttpRequest queryString(java.lang.String queryString)

See Also:

queryString(String, boolean)

queryString

public HttpRequest queryString(java.lang.String queryString,
                      boolean decode)

Sets query from provided query string. Previous query values are discarded.

queryString

public java.lang.String queryString()

Generates query string. All values are URL encoded.

queryEncoding

public HttpRequest queryEncoding(java.lang.String encoding)

Defines encoding for query parameters. Default value is copied from JoddHttp.defaultQueryEncoding.

url

public java.lang.String url()

Returns full URL path. Simply concatenates protocol, host, port, path and query string.

basicAuthentication

public HttpRequest basicAuthentication(java.lang.String username,
                              java.lang.String password)

Enables basic authentication by adding required header.

setHostHeader

public HttpRequest setHostHeader()

Sets 'Host' header from current host and port.

open

public HttpTransport open()

Opens transport i.e. connection. Returns used HttpTransport implementation.

send

public HttpResponse send()

Opens request if not already open, sends request, reads response and closes the request.

toString

public java.lang.String toString()

Returns string representation of the HTTP request. Important: some initialization is done here as well, before resulting string is created.

Overrides:

toString in class java.lang.Object

readFrom

public static HttpRequest readFrom(java.io.InputStream in)

Parses input stream and creates new HttpRequest object.