HttpRequest

Value Members

final def !=(arg0: Any): Boolean

Definition Classes
AnyRef → Any
final def ##(): Int

Definition Classes
AnyRef → Any
final def ==(arg0: Any): Boolean

Definition Classes
AnyRef → Any
final def asInstanceOf[T0]: T0

Definition Classes
Any
def clone(): AnyRef

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws( ... )
final def eq(arg0: AnyRef): Boolean

Definition Classes
AnyRef
def equals(arg0: Any): Boolean

Definition Classes
AnyRef → Any
def finalize(): Unit

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws( classOf[java.lang.Throwable] )
final def getClass(): Class[_]

Definition Classes
AnyRef → Any
def hashCode(): Int

Definition Classes
AnyRef → Any
val headers: HeaderMap[String]
val host: String
final def isInstanceOf[T0]: Boolean

Definition Classes
Any
val longPath: String

The path with the query string or just the path if there is no query string
val method: Method
final def ne(arg0: AnyRef): Boolean

Definition Classes
AnyRef
final def notify(): Unit

Definition Classes
AnyRef
final def notifyAll(): Unit

Definition Classes
AnyRef
val path: String
val port: Int
val protocol: Protocol
val queryString: Option[String]
def send(): Future[HttpResponse]

Sends this request.
Sends this request.
A request can be sent multiple times. When a request is sent, it returns a Future[HttpResponse] which either succeeds with an HttpResponse or fails with an HttpNetworkError.
Possible reasons for the future failing are: - A status code >= 400 - A network error
Note that in some cases the response body can still be obtained after a failure through the HttpNetworkError.
returns
A future of HttpResponse which may fail with an HttpNetworkError
final def synchronized[T0](arg0: ⇒ T0): T0

Definition Classes
AnyRef
def toString(): String

Definition Classes
AnyRef → Any
val url: String

The target url for this request
final def wait(): Unit

Definition Classes
AnyRef
Annotations
@throws( ... )
final def wait(arg0: Long, arg1: Int): Unit

Definition Classes
AnyRef
Annotations
@throws( ... )
final def wait(arg0: Long): Unit

Definition Classes
AnyRef
Annotations
@throws( ... )
def withHeader(key: String, value: String): HttpRequest

Adds or updates a header to the current set of headers.
Adds or updates a header to the current set of headers.
key
The header key (case insensitive)
value
The header value
returns
A copy of this HttpRequest with an updated header set.
def withHeaders(newHeaders: Map[String, String]): HttpRequest

Adds or updates multiple headers to the current set of headers.
Adds or updates multiple headers to the current set of headers.
newHeaders
The headers to add.
returns
A copy of this HttpRequest with an updated header set.
def withHost(host: String): HttpRequest

Sets the host used in the request URI.
Sets the host used in the request URI.
host
The new host
returns
A copy of this HttpRequest with an updated host
def withPath(path: String): HttpRequest

Sets the path used in the request URI.
Sets the path used in the request URI.
The path is the part that lies between the host (or port if present) and the query string or the end of the request. Note that the query string is not part of the path.
path
The new path, including the leading '/' and excluding any '?' or '#' and subsequent characters
returns
A copy of this HttpRequest with an updated path
def withPort(port: Int): HttpRequest

Sets the port used in the request URI.
Sets the port used in the request URI.
port
The new port
returns
A copy of this HttpRequest with an updated port
def withProtocol(protocol: Protocol): HttpRequest

Sets the protocol used in the request URL.
Sets the protocol used in the request URL.
At the moment, only HTTP is supported.
protocol
The HTTP protocol
returns
A copy of this HttpRequest with an updated protocol

Exceptions thrown
IllegalArgumentException when something else than HTTP is passed as argument
def withQueryParameter(key: String, values: Map[String, String]): HttpRequest

Adds a query map parameter or updates it if it already exists.
Adds a query map parameter or updates it if it already exists.
Although this is not part of a spec, most servers recognize bracket indices in a query string as array indices or object keys.
example: ?obj[foo]=bar&obj[baz]=42
This method formats map values according to the above example.
key
The unescaped parameter key
values
The unescaped parameter map values
returns
A copy of this HttpRequest with an updated query string.

See also
withQueryParameter(String,String)
def withQueryParameter(key: String, values: List[String]): HttpRequest

Adds a query array parameter or updates it if it already exists.
Adds a query array parameter or updates it if it already exists.
Although this is not part of a spec, most servers recognize bracket indices in a query string as array indices or object keys.
example: ?list[0]=foo&list[1]=bar
This method formats array values according to the above example.
key
The unescaped parameter key
values
The unescaped parameter array values
returns
A copy of this HttpRequest with an updated query string.

See also
withQueryParameter(String,String)
def withQueryParameter(key: String, value: String): HttpRequest

Adds a query parameter or updates it if it already exists.
Adds a query parameter or updates it if it already exists.
Query parameters end up in the query string as key=value pairs separated by ampersands. Both the key and parameter are escaped to ensure proper query string format.
key
The unescaped parameter key
value
The unescaped parameter value
returns
A copy of this HttpRequest with an updated query string.
def withQueryParameters(parameters: Map[String, String]): HttpRequest

Adds multiple query parameters and updates those already existing.
Adds multiple query parameters and updates those already existing.
parameters
A map of new parameters.
returns
A copy of this HttpRequest with an updated query string.

See also
withQueryParameter(String,String)
def withQueryString(queryString: String): HttpRequest

Sets the query string.
Sets the query string.
The argument is escaped by this method. If you want to bypass the escaping, use withQueryStringRaw.
Escaping also means that the queryString property will generally not be equal to what you passed as argument to withQueryString.
For instance: request.withQueryString("äéuô").queryString.get != "%C3%A4%C3%A9u%C3%B4"
queryString
The unescaped query string.
returns
A copy of this HttpRequest with an updated queryString
def withQueryStringRaw(queryString: String): HttpRequest

Sets the query string without escaping.
Sets the query string without escaping.
Raw query strings must only contain legal characters as per rfc3986. Adding special characters yields undefined behaviour.
In most cases, withQueryString should be preferred.
queryString
The raw, escaped query string
returns
A copy of this HttpRequest with an updated queryString
def withURL(url: String): HttpRequest

Updates request protocol, host, port, path and queryString according to a url.
Updates request protocol, host, port, path and queryString according to a url.
url
A valid HTTP url
returns
A copy of this HttpRequest with updated URL-related attributes.
def withoutQueryString(): HttpRequest

Removes the query string.
Removes the query string.
returns
A copy of this HttpRequest without query string

Related Docs: object HttpRequest | package client

final class HttpRequest extends AnyRef

Value Members

final def !=(arg0: Any): Boolean

final def ##(): Int

final def ==(arg0: Any): Boolean

final def asInstanceOf[T0]: T0

def clone(): AnyRef

final def eq(arg0: AnyRef): Boolean

def equals(arg0: Any): Boolean

def finalize(): Unit

final def getClass(): Class[_]

def hashCode(): Int

val headers: HeaderMap[String]

val host: String

final def isInstanceOf[T0]: Boolean

val longPath: String

val method: Method

final def ne(arg0: AnyRef): Boolean

final def notify(): Unit

final def notifyAll(): Unit

val path: String

val port: Int

val protocol: Protocol

val queryString: Option[String]

def send(): Future[HttpResponse]

final def synchronized[T0](arg0: ⇒ T0): T0

def toString(): String

val url: String

final def wait(): Unit

final def wait(arg0: Long, arg1: Int): Unit

final def wait(arg0: Long): Unit

def withHeader(key: String, value: String): HttpRequest

def withHeaders(newHeaders: Map[String, String]): HttpRequest

def withHost(host: String): HttpRequest

def withPath(path: String): HttpRequest

def withPort(port: Int): HttpRequest

def withProtocol(protocol: Protocol): HttpRequest

def withQueryParameter(key: String, values: Map[String, String]): HttpRequest

def withQueryParameter(key: String, values: List[String]): HttpRequest

def withQueryParameter(key: String, value: String): HttpRequest

def withQueryParameters(parameters: Map[String, String]): HttpRequest

def withQueryString(queryString: String): HttpRequest

def withQueryStringRaw(queryString: String): HttpRequest

def withURL(url: String): HttpRequest

def withoutQueryString(): HttpRequest

Inherited from AnyRef

Inherited from Any

Ungrouped