org.jooby.spi

Interface NativeRequest

public interface NativeRequest

Minimal/basic implementation of HTTP request. A server implementor must provide an implementation of NativeRequest.

Since:

0.5.0

Author:

edgar

Method Summary

Modifier and Type	Method and Description
List<Cookie>	cookies()
List<NativeUpload>	files(String name) Get all the files for the provided name or an empty list.
Optional<String>	header(String name) Get the first header for the provided name or a empty list.
List<String>	headerNames()
List<String>	headers(String name) Get all the headers for the provided name or a empty list.
InputStream	in() Input stream that represent the body.
String	ip()
String	method()
List<String>	paramNames()
List<String>	params(String name) Get all the params for the provided name or a empty list.
String	path()
String	protocol()
boolean	secure()
<T> T	upgrade(Class<T> type) Upgrade the request to something else...like a web socket.

Method Detail

method

String method()

Returns:

The name of the HTTP method with which this request was made, for example, GET, POST, or PUT.

path

String path()

Returns:

The part of this request's URL from the protocol name up to the query string in the first line of the HTTP request

paramNames

List<String> paramNames()
                 throws Exception

Returns:

List with all the parameter names from query string plus any other form/multipart param names (excluding file uploads). This method should NOT returns null, absence of params is represented by an empty list.

Throws:

Exception - If param extraction fails.

params

List<String> params(String name)
             throws Exception

Get all the params for the provided name or a empty list.

Parameters:

name - Parameter name.

Returns:

Get all the params for the provided name or a empty list.

Throws:

Exception - If param parsing fails.

headers

List<String> headers(String name)

Get all the headers for the provided name or a empty list.

Parameters:

name - Header name.

Returns:

Get all the headers for the provided name or a empty list.

header

Optional<String> header(String name)

Get the first header for the provided name or a empty list.

Parameters:

name - Header name.

Returns:

The first header for the provided name or a empty list.

headerNames

List<String> headerNames()

Returns:

All the header names or an empty list.

cookies

List<Cookie> cookies()

Returns:

All the cookies or an empty list.

files

List<NativeUpload> files(String name)
                  throws IOException

Get all the files for the provided name or an empty list.

Parameters:

name - File name.

Returns:

All the files or an empty list.

Throws:

IOException - If file parsing fails.

in

InputStream in()
        throws IOException

Input stream that represent the body.

Returns:

Body as an input stream.

Throws:

IOException - If body read fails.

ip

String ip()

Returns:

The IP address of the client or last proxy that sent the request.

protocol

String protocol()

Returns:

The name and version of the protocol the request uses in the form protocol/majorVersion.minorVersion, for example, HTTP/1.1

secure

boolean secure()

Returns:

True if this request was made using a secure channel, such as HTTPS.

upgrade

<T> T upgrade(Class<T> type)
       throws Exception

Upgrade the request to something else...like a web socket.

Type Parameters:

T - Upgrade type.

Parameters:

type - Upgrade type.

Returns:

A instance of the upgrade.

Throws:

Exception - If the upgrade fails or it is un-supported.

See Also:

NativeWebSocket