Http.RequestBuilder (Play 2.5.0)

java.lang.Object
- play.mvc.Http.RequestBuilder

Enclosing class:: Http

public static class Http.RequestBuilder
extends java.lang.Object

The builder for building a request.

Field Summary

Fields
Modifier and Type	Field and Description
`protected Http.RequestBody`	`body`
`protected java.util.Optional<java.util.List<java.security.cert.X509Certificate>>`	`clientCertificateChain`
`protected java.util.Map<java.lang.String,java.lang.String[]>`	`headers`
`protected java.lang.Long`	`id`
`protected java.lang.String`	`method`
`protected java.lang.String`	`remoteAddress`
`protected boolean`	`secure`
`protected java.util.Map<java.lang.String,java.lang.String>`	`tags`
`protected java.net.URI`	`uri`
`protected java.lang.String`	`username`
`protected java.lang.String`	`version`

Constructor Summary

Constructors
Constructor and Description

RequestBuilder()
Returns a simple request builder, based on get and local address.

Constructors
Constructor and Description
`RequestBuilder()` Returns a simple request builder, based on get and local address.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Http.RequestBody`	`body()`
`protected Http.RequestBuilder`	`body(Http.RequestBody body)` Set the body of the request.
`protected Http.RequestBuilder`	`body(Http.RequestBody body, java.lang.String contentType)` Set the body of the request.
`Http.RequestBuilder`	`bodyForm(java.util.Map<java.lang.String,java.lang.String> data)` Set a Form url encoded body to this request.
`Http.RequestBuilder`	`bodyFormArrayValues(java.util.Map<java.lang.String,java.lang.String[]> data)` Set a Form url encoded body to this request.
`Http.RequestBuilder`	`bodyJson(com.fasterxml.jackson.databind.JsonNode node)` Set a Json Body to this request.
`Http.RequestBuilder`	`bodyJson(play.api.libs.json.JsValue json)` Set a Json Body to this request.
`Http.RequestBuilder`	`bodyRaw(byte[] data)` Set a Binary Data to this request.
`Http.RequestBuilder`	`bodyRaw(akka.util.ByteString data)` Set a Binary Data to this request.
`Http.RequestBuilder`	`bodyText(java.lang.String text)` Set a Text to this request.
`Http.RequestBuilder`	`bodyXml(org.w3c.dom.Document xml)` Set a XML to this request.
`Http.RequestBuilder`	`bodyXml(org.xml.sax.InputSource xml)` Set a XML to this request.
`Http.RequestImpl`	`build()` Builds the request.
`protected play.api.mvc.Headers`	`buildHeaders()`
`java.util.Optional<java.util.List<java.security.cert.X509Certificate>>`	`clientCertificateChain()`
`Http.RequestBuilder`	`clientCertificateChain(java.util.List<java.security.cert.X509Certificate> clientCertificateChain)`
`Http.RequestBuilder`	`cookie(Http.Cookie cookie)` Sets one cookie.
`Http.Cookies`	`cookies()`
`java.util.Map<java.lang.String,java.lang.String>`	`flash()`
`Http.RequestBuilder`	`flash(java.util.Map<java.lang.String,java.lang.String> data)` Sets cookies in a request.
`Http.RequestBuilder`	`flash(java.lang.String key, java.lang.String value)` Sets a cookie in the request.
`java.lang.String`	`header(java.lang.String key)`
`Http.RequestBuilder`	`header(java.lang.String key, java.lang.String value)`
`Http.RequestBuilder`	`header(java.lang.String key, java.lang.String[] values)`
`java.util.Map<java.lang.String,java.lang.String[]>`	`headers()`
`Http.RequestBuilder`	`headers(java.util.Map<java.lang.String,java.lang.String[]> headers)`
`java.lang.String[]`	`headers(java.lang.String key)`
`java.lang.String`	`host()`
`Http.RequestBuilder`	`host(java.lang.String host)`
`java.lang.Long`	`id()`
`Http.RequestBuilder`	`id(java.lang.Long id)`
`protected static scala.collection.immutable.Map<java.lang.String,scala.collection.Seq<java.lang.String>>`	`mapListToScala(java.util.Map<java.lang.String,java.util.List<java.lang.String>> data)`
`java.lang.String`	`method()`
`Http.RequestBuilder`	`method(java.lang.String method)`
`java.lang.String`	`path()`
`Http.RequestBuilder`	`path(java.lang.String path)` This method sets the path of the uri.
`java.lang.String`	`remoteAddress()`
`Http.RequestBuilder`	`remoteAddress(java.lang.String remoteAddress)`
`boolean`	`secure()`
`Http.RequestBuilder`	`secure(boolean secure)`
`java.util.Map<java.lang.String,java.lang.String>`	`session()`
`Http.RequestBuilder`	`session(java.util.Map<java.lang.String,java.lang.String> data)` Sets all parameters for the session.
`Http.RequestBuilder`	`session(java.lang.String key, java.lang.String value)` Sets a session.
`protected java.util.Map<java.lang.String,java.util.List<java.lang.String>>`	`splitQuery()`
`Http.RequestBuilder`	`tag(java.lang.String key, java.lang.String value)` Puts an extra tag.
`java.util.Map<java.lang.String,java.lang.String>`	`tags()`
`Http.RequestBuilder`	`tags(java.util.Map<java.lang.String,java.lang.String> tags)`
`java.lang.String`	`uri()`
`Http.RequestBuilder`	`uri(java.lang.String str)` Sets the uri.
`Http.RequestBuilder`	`uri(java.net.URI uri)`
`java.lang.String`	`username()`
`Http.RequestBuilder`	`username(java.lang.String username)`
`java.lang.String`	`version()`
`Http.RequestBuilder`	`version(java.lang.String version)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - body
```
protected Http.RequestBody body
```
  - username
```
protected java.lang.String username
```
  - id
```
protected java.lang.Long id
```
  - tags
```
protected java.util.Map<java.lang.String,java.lang.String> tags
```
  - method
```
protected java.lang.String method
```
  - secure
```
protected boolean secure
```
  - uri
```
protected java.net.URI uri
```
  - version
```
protected java.lang.String version
```
  - headers
```
protected java.util.Map<java.lang.String,java.lang.String[]> headers
```
  - remoteAddress
```
protected java.lang.String remoteAddress
```
  - clientCertificateChain
```
protected java.util.Optional<java.util.List<java.security.cert.X509Certificate>> clientCertificateChain
```
- Constructor Detail
  - RequestBuilder
```
public RequestBuilder()
```
    Returns a simple request builder, based on get and local address.
- Method Detail
  - body
```
public Http.RequestBody body()
```
    Returns:
    
    the request body, if a previously the body has been set
  - username
```
public java.lang.String username()
```
    Returns:
    
    the username
  - username
```
public Http.RequestBuilder username(java.lang.String username)
```
    Parameters:
    
    username - the username for the request
    
    Returns:
    
    the modified builder
  - body
```
protected Http.RequestBuilder body(Http.RequestBody body,
                                   java.lang.String contentType)
```
    Set the body of the request.
    
    Parameters:
    
    body - the body
    
    contentType - Content-Type header value
    
    Returns:
    
    the modified builder
  - body
```
protected Http.RequestBuilder body(Http.RequestBody body)
```
    Set the body of the request.
    
    Parameters:
    
    body - The body.
    
    Returns:
    
    the modified builder
  - bodyRaw
```
public Http.RequestBuilder bodyRaw(akka.util.ByteString data)
```
    Set a Binary Data to this request. The Content-Type header of the request is set to application/octet-stream.
    
    Parameters:
    
    data - the Binary Data
    
    Returns:
    
    the modified builder
  - bodyRaw
```
public Http.RequestBuilder bodyRaw(byte[] data)
```
    Set a Binary Data to this request. The Content-Type header of the request is set to application/octet-stream.
    
    Parameters:
    
    data - the Binary Data
    
    Returns:
    
    the modified builder
  - bodyFormArrayValues
```
public Http.RequestBuilder bodyFormArrayValues(java.util.Map<java.lang.String,java.lang.String[]> data)
```
    Set a Form url encoded body to this request.
    
    Parameters:
    
    data - the x-www-form-urlencoded parameters
    
    Returns:
    
    the modified builder
  - bodyForm
```
public Http.RequestBuilder bodyForm(java.util.Map<java.lang.String,java.lang.String> data)
```
    Set a Form url encoded body to this request.
    
    Parameters:
    
    data - the x-www-form-urlencoded parameters
    
    Returns:
    
    the modified builder
  - bodyJson
```
public Http.RequestBuilder bodyJson(com.fasterxml.jackson.databind.JsonNode node)
```
    Set a Json Body to this request. The Content-Type header of the request is set to application/json.
    
    Parameters:
    
    node - the Json Node
    
    Returns:
    
    this builder, updated
  - bodyJson
```
public Http.RequestBuilder bodyJson(play.api.libs.json.JsValue json)
```
    Set a Json Body to this request. The Content-Type header of the request is set to application/json.
    
    Parameters:
    
    json - the JsValue
    
    Returns:
    
    the modified builder
  - bodyXml
```
public Http.RequestBuilder bodyXml(org.xml.sax.InputSource xml)
```
    Set a XML to this request. The Content-Type header of the request is set to application/xml.
    
    Parameters:
    
    xml - the XML
    
    Returns:
    
    the modified builder
  - bodyXml
```
public Http.RequestBuilder bodyXml(org.w3c.dom.Document xml)
```
    Set a XML to this request. The Content-Type header of the request is set to application/xml.
    
    Parameters:
    
    xml - the XML
    
    Returns:
    
    the modified builder
  - bodyText
```
public Http.RequestBuilder bodyText(java.lang.String text)
```
    Set a Text to this request. The Content-Type header of the request is set to text/plain.
    
    Parameters:
    
    text - the text
    
    Returns:
    
    this builder, updated
  - build
```
public Http.RequestImpl build()
```
    Builds the request.
    
    Returns:
    
    a build of the given parameters
  - id
```
public java.lang.Long id()
```
    Returns:
    
    the id of the request
  - id
```
public Http.RequestBuilder id(java.lang.Long id)
```
    Parameters:
    
    id - the id to be used
    
    Returns:
    
    the builder instance
  - tags
```
public java.util.Map<java.lang.String,java.lang.String> tags()
```
    Returns:
    
    the tags for the request
  - tags
```
public Http.RequestBuilder tags(java.util.Map<java.lang.String,java.lang.String> tags)
```
    Parameters:
    
    tags - overwrites the tags for this request
    
    Returns:
    
    the builder instance
  - tag
```
public Http.RequestBuilder tag(java.lang.String key,
                               java.lang.String value)
```
    Puts an extra tag.
    
    Parameters:
    
    key - the key for the tag
    
    value - the value for the tag
    
    Returns:
    
    the builder
  - method
```
public java.lang.String method()
```
    Returns:
    
    the builder instance.
  - method
```
public Http.RequestBuilder method(java.lang.String method)
```
    Parameters:
    
    method - sets the method
    
    Returns:
    
    the builder instance
  - uri
```
public java.lang.String uri()
```
    Returns:
    
    gives the uri of the request
  - uri
```
public Http.RequestBuilder uri(java.net.URI uri)
```
  - uri
```
public Http.RequestBuilder uri(java.lang.String str)
```
    Sets the uri.
    
    Parameters:
    
    str - the uri
    
    Returns:
    
    the builder instance
  - secure
```
public Http.RequestBuilder secure(boolean secure)
```
    Parameters:
    
    secure - true if the request is secure
    
    Returns:
    
    the builder instance
  - secure
```
public boolean secure()
```
    Returns:
    
    the status if the request is secure
  - host
```
public java.lang.String host()
```
    Returns:
    
    the host name from the header
  - host
```
public Http.RequestBuilder host(java.lang.String host)
```
    Parameters:
    
    host - sets the host in the header
    
    Returns:
    
    the builder instance
  - path
```
public java.lang.String path()
```
    Returns:
    
    the raw path of the uri
  - path
```
public Http.RequestBuilder path(java.lang.String path)
```
    This method sets the path of the uri.
    
    Parameters:
    
    path - the path after the port and for the query in a uri
    
    Returns:
    
    the builder instance
  - version
```
public java.lang.String version()
```
    Returns:
    
    the version
  - version
```
public Http.RequestBuilder version(java.lang.String version)
```
    Parameters:
    
    version - the version
    
    Returns:
    
    the builder instance
  - header
```
public java.lang.String header(java.lang.String key)
```
    Parameters:
    
    key - the key to be used in the header
    
    Returns:
    
    the value associated with the key, if multiple, the first, if none returns null
  - headers
```
public java.lang.String[] headers(java.lang.String key)
```
    Parameters:
    
    key - the key to be used in the header
    
    Returns:
    
    all values (could be 0) associated with the key
  - headers
```
public java.util.Map<java.lang.String,java.lang.String[]> headers()
```
    Returns:
    
    the headers
  - headers
```
public Http.RequestBuilder headers(java.util.Map<java.lang.String,java.lang.String[]> headers)
```
    Parameters:
    
    headers - the headers to be replaced
    
    Returns:
    
    the builder instance
  - header
```
public Http.RequestBuilder header(java.lang.String key,
                                  java.lang.String[] values)
```
    Parameters:
    
    key - the key for in the header
    
    values - the values associated with the key
    
    Returns:
    
    the builder instance
  - header
```
public Http.RequestBuilder header(java.lang.String key,
                                  java.lang.String value)
```
    Parameters:
    
    key - the key for in the header
    
    value - the value (one) associated with the key
    
    Returns:
    
    the builder instance
  - cookies
```
public Http.Cookies cookies()
```
    Returns:
    
    the cookies in Java instances
  - cookie
```
public Http.RequestBuilder cookie(Http.Cookie cookie)
```
    Sets one cookie.
    
    Parameters:
    
    cookie - the cookie to be set
    
    Returns:
    
    the builder instance
  - flash
```
public java.util.Map<java.lang.String,java.lang.String> flash()
```
    Returns:
    
    the cookies in a Java map
  - flash
```
public Http.RequestBuilder flash(java.lang.String key,
                                 java.lang.String value)
```
    Sets a cookie in the request.
    
    Parameters:
    
    key - the key for the cookie
    
    value - the value for the cookie
    
    Returns:
    
    the builder instance
  - flash
```
public Http.RequestBuilder flash(java.util.Map<java.lang.String,java.lang.String> data)
```
    Sets cookies in a request.
    
    Parameters:
    
    data - a key value mapping of cookies
    
    Returns:
    
    the builder instance
  - session
```
public java.util.Map<java.lang.String,java.lang.String> session()
```
    Returns:
    
    the sessions in the request
  - session
```
public Http.RequestBuilder session(java.lang.String key,
                                   java.lang.String value)
```
    Sets a session.
    
    Parameters:
    
    key - the key for the session
    
    value - the value associated with the key for the session
    
    Returns:
    
    the builder instance
  - session
```
public Http.RequestBuilder session(java.util.Map<java.lang.String,java.lang.String> data)
```
    Sets all parameters for the session.
    
    Parameters:
    
    data - a key value mapping of the session data
    
    Returns:
    
    the builder instance
  - remoteAddress
```
public java.lang.String remoteAddress()
```
    Returns:
    
    the remote address
  - remoteAddress
```
public Http.RequestBuilder remoteAddress(java.lang.String remoteAddress)
```
    Parameters:
    
    remoteAddress - sets the remote address
    
    Returns:
    
    the builder instance
  - clientCertificateChain
```
public java.util.Optional<java.util.List<java.security.cert.X509Certificate>> clientCertificateChain()
```
    Returns:
    
    the client X509Certificates if they have been set
  - clientCertificateChain
```
public Http.RequestBuilder clientCertificateChain(java.util.List<java.security.cert.X509Certificate> clientCertificateChain)
```
    Parameters:
    
    clientCertificateChain - sets the X509Certificates to use
    
    Returns:
    
    the builder instance
  - splitQuery
```
protected java.util.Map<java.lang.String,java.util.List<java.lang.String>> splitQuery()
```
  - mapListToScala
```
protected static scala.collection.immutable.Map<java.lang.String,scala.collection.Seq<java.lang.String>> mapListToScala(java.util.Map<java.lang.String,java.util.List<java.lang.String>> data)
```
  - buildHeaders
```
protected play.api.mvc.Headers buildHeaders()
```

Class Http.RequestBuilder

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

body

username

id

tags

method

secure

uri

version

headers

remoteAddress

clientCertificateChain

Constructor Detail

RequestBuilder

Method Detail

body

username

username

body

body

bodyRaw

bodyRaw

bodyFormArrayValues

bodyForm

bodyJson

bodyJson

bodyXml

bodyXml

bodyText

build

id

id

tags

tags

tag

method

method

uri

uri

uri

secure

secure

host

host

path

path

version

version

header

headers

headers

headers

header

header

cookies

cookie

flash

flash

flash

session

session

session

remoteAddress

remoteAddress

clientCertificateChain

clientCertificateChain

splitQuery

mapListToScala

buildHeaders