public interface WSRequest
extends play.libs.ws.StandaloneWSRequest
Note that this interface does not expose properties that are only exposed after building the request: notably, the URL, headers and query parameters are shown before an OAuth signature is calculated.
Modifier and Type | Method and Description |
---|---|
WSRequest |
addCookie(Http.Cookie cookie)
Adds a cookie to the request
|
WSRequest |
addCookie(play.libs.ws.WSCookie cookie)
Adds a cookie to the request
|
WSRequest |
addCookies(play.libs.ws.WSCookie... cookies)
Sets several cookies on the request.
|
WSRequest |
addHeader(java.lang.String name,
java.lang.String value)
Adds a header to the request.
|
WSRequest |
addQueryParameter(java.lang.String name,
java.lang.String value)
Sets a query parameter with the given name, this can be called repeatedly.
|
java.util.concurrent.CompletionStage<WSResponse> |
delete()
Perform a DELETE on the request asynchronously.
|
java.util.concurrent.CompletionStage<WSResponse> |
execute()
Execute an arbitrary method on the request asynchronously.
|
java.util.concurrent.CompletionStage<WSResponse> |
execute(java.lang.String method)
Execute an arbitrary method on the request asynchronously.
|
java.util.concurrent.CompletionStage<WSResponse> |
get()
Perform a GET on the request asynchronously.
|
play.libs.ws.WSSignatureCalculator |
getCalculator() |
boolean |
getFollowRedirects()
If the
setFollowRedirects(boolean) method has been called, then returns true. |
java.util.Map<java.lang.String,java.util.List<java.lang.String>> |
getHeaders() |
java.lang.String |
getPassword() |
java.util.Map<java.lang.String,java.util.List<java.lang.String>> |
getQueryParameters() |
long |
getRequestTimeout()
Deprecated.
|
java.time.Duration |
getRequestTimeoutDuration()
Deprecated.
|
play.libs.ws.WSAuthScheme |
getScheme() |
java.lang.String |
getUrl() |
java.lang.String |
getUsername() |
java.util.concurrent.CompletionStage<WSResponse> |
head()
Perform a HEAD on the request asynchronously.
|
java.util.concurrent.CompletionStage<WSResponse> |
options()
Perform an OPTIONS on the request asynchronously.
|
java.util.concurrent.CompletionStage<WSResponse> |
patch(play.libs.ws.BodyWritable body)
Perform a PATCH on the request asynchronously.
|
java.util.concurrent.CompletionStage<WSResponse> |
patch(org.w3c.dom.Document body)
Perform a PATCH on the request asynchronously.
|
java.util.concurrent.CompletionStage<WSResponse> |
patch(java.io.File body)
Perform a PATCH on the request asynchronously.
|
java.util.concurrent.CompletionStage<WSResponse> |
patch(java.io.InputStream body)
Perform a PATCH on the request asynchronously.
|
java.util.concurrent.CompletionStage<WSResponse> |
patch(com.fasterxml.jackson.databind.JsonNode body)
Perform a PATCH on the request asynchronously.
|
java.util.concurrent.CompletionStage<WSResponse> |
patch(akka.stream.javadsl.Source<? super Http.MultipartFormData.Part<akka.stream.javadsl.Source<akka.util.ByteString,?>>,?> body)
Perform a PATCH on the request asynchronously.
|
java.util.concurrent.CompletionStage<WSResponse> |
patch(java.lang.String body)
Perform a PATCH on the request asynchronously.
|
java.util.concurrent.CompletionStage<WSResponse> |
post(play.libs.ws.BodyWritable body)
Perform a POST on the request asynchronously.
|
java.util.concurrent.CompletionStage<WSResponse> |
post(org.w3c.dom.Document body)
Perform a POST on the request asynchronously.
|
java.util.concurrent.CompletionStage<WSResponse> |
post(java.io.File body)
Perform a POST on the request asynchronously.
|
java.util.concurrent.CompletionStage<WSResponse> |
post(java.io.InputStream body)
Deprecated.
|
java.util.concurrent.CompletionStage<WSResponse> |
post(com.fasterxml.jackson.databind.JsonNode body)
Perform a POST on the request asynchronously.
|
java.util.concurrent.CompletionStage<WSResponse> |
post(akka.stream.javadsl.Source<? super Http.MultipartFormData.Part<akka.stream.javadsl.Source<akka.util.ByteString,?>>,?> body)
Perform a POST on the request asynchronously.
|
java.util.concurrent.CompletionStage<WSResponse> |
post(java.lang.String body)
Perform a POST on the request asynchronously.
|
java.util.concurrent.CompletionStage<WSResponse> |
put(play.libs.ws.BodyWritable body)
Perform a PUT on the request asynchronously.
|
java.util.concurrent.CompletionStage<WSResponse> |
put(org.w3c.dom.Document body)
Perform a PUT on the request asynchronously.
|
java.util.concurrent.CompletionStage<WSResponse> |
put(java.io.File body)
Perform a PUT on the request asynchronously.
|
java.util.concurrent.CompletionStage<WSResponse> |
put(java.io.InputStream body)
Perform a PUT on the request asynchronously.
|
java.util.concurrent.CompletionStage<WSResponse> |
put(com.fasterxml.jackson.databind.JsonNode body)
Perform a PUT on the request asynchronously.
|
java.util.concurrent.CompletionStage<WSResponse> |
put(akka.stream.javadsl.Source<? super Http.MultipartFormData.Part<akka.stream.javadsl.Source<akka.util.ByteString,?>>,?> body)
Perform a PUT on the request asynchronously.
|
java.util.concurrent.CompletionStage<WSResponse> |
put(java.lang.String body)
Perform a PUT on the request asynchronously.
|
WSRequest |
setAuth(java.lang.String userInfo)
Sets the authentication header for the current request using BASIC authentication.
|
WSRequest |
setAuth(java.lang.String username,
java.lang.String password)
Sets the authentication header for the current request using BASIC authentication.
|
WSRequest |
setAuth(java.lang.String username,
java.lang.String password,
play.libs.ws.WSAuthScheme scheme)
Sets the authentication header for the current request.
|
WSRequest |
setBody(play.libs.ws.BodyWritable body)
Set the body this request should use.
|
WSRequest |
setBody(java.io.File body)
Set the body this request should use.
|
WSRequest |
setBody(java.io.InputStream body)
Deprecated.
|
WSRequest |
setBody(com.fasterxml.jackson.databind.JsonNode body)
Set the body this request should use.
|
<U> WSRequest |
setBody(akka.stream.javadsl.Source<akka.util.ByteString,U> body)
Set the body this request should use.
|
WSRequest |
setBody(java.lang.String body)
Set the body this request should use.
|
WSRequest |
setContentType(java.lang.String contentType)
Set the content type.
|
WSRequest |
setCookies(java.util.List<play.libs.ws.WSCookie> cookies)
Sets all the cookies on the request.
|
WSRequest |
setFollowRedirects(boolean followRedirects)
Sets whether redirects (301, 302) should be followed automatically.
|
WSRequest |
setHeader(java.lang.String name,
java.lang.String value)
Deprecated.
|
WSRequest |
setHeaders(java.util.Map<java.lang.String,java.util.List<java.lang.String>> headers)
Sets all of the headers on the request.
|
WSRequest |
setMethod(java.lang.String method)
Sets the HTTP method this request should use, where the no args execute() method is invoked.
|
WSRequest |
setQueryParameter(java.lang.String name,
java.lang.String value)
Deprecated.
|
WSRequest |
setQueryString(java.util.Map<java.lang.String,java.util.List<java.lang.String>> params)
Sets the query string to query.
|
WSRequest |
setQueryString(java.lang.String query)
Sets the query string to query.
|
WSRequest |
setRequestFilter(play.libs.ws.WSRequestFilter filter)
Adds a request filter.
|
WSRequest |
setRequestTimeout(java.time.Duration timeout)
Sets the request timeout in milliseconds.
|
WSRequest |
setRequestTimeout(long timeout)
Deprecated.
|
WSRequest |
setVirtualHost(java.lang.String virtualHost)
Sets the virtual host as a "hostname:port" string.
|
WSRequest |
sign(play.libs.ws.WSSignatureCalculator calculator)
Sets an (OAuth) signature calculator.
|
java.util.concurrent.CompletionStage<WSResponse> |
stream()
Execute this request and stream the response body.
|
java.util.concurrent.CompletionStage<WSResponse> get()
get
in interface play.libs.ws.StandaloneWSRequest
java.util.concurrent.CompletionStage<WSResponse> patch(play.libs.ws.BodyWritable body)
patch
in interface play.libs.ws.StandaloneWSRequest
body
- represented as BodyWritablejava.util.concurrent.CompletionStage<WSResponse> patch(java.lang.String body)
body
- represented as Stringjava.util.concurrent.CompletionStage<WSResponse> patch(com.fasterxml.jackson.databind.JsonNode body)
body
- represented as JSONjava.util.concurrent.CompletionStage<WSResponse> patch(org.w3c.dom.Document body)
body
- represented as a Documentjava.util.concurrent.CompletionStage<WSResponse> patch(java.io.InputStream body)
body
- represented as an InputStreamjava.util.concurrent.CompletionStage<WSResponse> patch(java.io.File body)
body
- represented as a Filejava.util.concurrent.CompletionStage<WSResponse> patch(akka.stream.javadsl.Source<? super Http.MultipartFormData.Part<akka.stream.javadsl.Source<akka.util.ByteString,?>>,?> body)
body
- represented as a MultipartFormData.Partjava.util.concurrent.CompletionStage<WSResponse> post(play.libs.ws.BodyWritable body)
post
in interface play.libs.ws.StandaloneWSRequest
body
- represented as body writablejava.util.concurrent.CompletionStage<WSResponse> post(java.lang.String body)
body
- represented as Stringjava.util.concurrent.CompletionStage<WSResponse> post(com.fasterxml.jackson.databind.JsonNode body)
body
- represented as JSONjava.util.concurrent.CompletionStage<WSResponse> post(org.w3c.dom.Document body)
body
- represented as a Document@Deprecated java.util.concurrent.CompletionStage<WSResponse> post(java.io.InputStream body)
post(BodyWritable)
body
- represented as an InputStreamjava.util.concurrent.CompletionStage<WSResponse> post(java.io.File body)
body
- represented as a Filejava.util.concurrent.CompletionStage<WSResponse> post(akka.stream.javadsl.Source<? super Http.MultipartFormData.Part<akka.stream.javadsl.Source<akka.util.ByteString,?>>,?> body)
body
- represented as a MultipartFormData.Partjava.util.concurrent.CompletionStage<WSResponse> put(play.libs.ws.BodyWritable body)
put
in interface play.libs.ws.StandaloneWSRequest
body
- represented as BodyWritablejava.util.concurrent.CompletionStage<WSResponse> put(java.lang.String body)
body
- represented as Stringjava.util.concurrent.CompletionStage<WSResponse> put(com.fasterxml.jackson.databind.JsonNode body)
body
- represented as JSONjava.util.concurrent.CompletionStage<WSResponse> put(org.w3c.dom.Document body)
body
- represented as a Documentjava.util.concurrent.CompletionStage<WSResponse> put(java.io.InputStream body)
body
- represented as an InputStreamjava.util.concurrent.CompletionStage<WSResponse> put(java.io.File body)
body
- represented as a Filejava.util.concurrent.CompletionStage<WSResponse> put(akka.stream.javadsl.Source<? super Http.MultipartFormData.Part<akka.stream.javadsl.Source<akka.util.ByteString,?>>,?> body)
body
- represented as a MultipartFormData.Partjava.util.concurrent.CompletionStage<WSResponse> delete()
delete
in interface play.libs.ws.StandaloneWSRequest
java.util.concurrent.CompletionStage<WSResponse> head()
head
in interface play.libs.ws.StandaloneWSRequest
java.util.concurrent.CompletionStage<WSResponse> options()
options
in interface play.libs.ws.StandaloneWSRequest
java.util.concurrent.CompletionStage<WSResponse> execute(java.lang.String method)
execute
in interface play.libs.ws.StandaloneWSRequest
method
- The method to executejava.util.concurrent.CompletionStage<WSResponse> execute()
execute
in interface play.libs.ws.StandaloneWSRequest
java.util.concurrent.CompletionStage<WSResponse> stream()
stream
in interface play.libs.ws.StandaloneWSRequest
WSRequest setMethod(java.lang.String method)
setMethod
in interface play.libs.ws.StandaloneWSRequest
method
- the HTTP method.WSRequest setBody(play.libs.ws.BodyWritable body)
setBody
in interface play.libs.ws.StandaloneWSRequest
body
- the body of the request.WSRequest setBody(java.lang.String body)
body
- the body of the request.WSRequest setBody(com.fasterxml.jackson.databind.JsonNode body)
body
- the body of the request.@Deprecated WSRequest setBody(java.io.InputStream body)
setBody(BodyWritable)
body
- DeprecatedWSRequest setBody(java.io.File body)
body
- the body of the request.<U> WSRequest setBody(akka.stream.javadsl.Source<akka.util.ByteString,U> body)
body
- the body of the request.WSRequest addHeader(java.lang.String name, java.lang.String value)
addHeader
in interface play.libs.ws.StandaloneWSRequest
name
- the header namevalue
- the header value@Deprecated WSRequest setHeader(java.lang.String name, java.lang.String value)
addHeader(String, String)
name
- the header namevalue
- the header valueWSRequest setHeaders(java.util.Map<java.lang.String,java.util.List<java.lang.String>> headers)
setHeaders
in interface play.libs.ws.StandaloneWSRequest
headers
- the headersWSRequest setQueryString(java.lang.String query)
setQueryString
in interface play.libs.ws.StandaloneWSRequest
query
- the fully formed query stringWSRequest setQueryString(java.util.Map<java.lang.String,java.util.List<java.lang.String>> params)
setQueryString
in interface play.libs.ws.StandaloneWSRequest
params
- the query string parametersWSRequest addQueryParameter(java.lang.String name, java.lang.String value)
addQueryParameter
in interface play.libs.ws.StandaloneWSRequest
name
- the query parameter namevalue
- the query parameter value@Deprecated WSRequest setQueryParameter(java.lang.String name, java.lang.String value)
addQueryParameter(String, String)
name
- the query parameter namevalue
- the query parameter valueWSRequest addCookie(play.libs.ws.WSCookie cookie)
addCookie
in interface play.libs.ws.StandaloneWSRequest
cookie
- the cookie to add.WSRequest addCookie(Http.Cookie cookie)
cookie
- the cookie to add.WSRequest addCookies(play.libs.ws.WSCookie... cookies)
addCookies
in interface play.libs.ws.StandaloneWSRequest
cookies
- the cookies.WSRequest setCookies(java.util.List<play.libs.ws.WSCookie> cookies)
setCookies
in interface play.libs.ws.StandaloneWSRequest
cookies
- all the cookies.WSRequest setAuth(java.lang.String userInfo)
setAuth
in interface play.libs.ws.StandaloneWSRequest
userInfo
- a string formed as "username:password".WSRequest setAuth(java.lang.String username, java.lang.String password)
setAuth
in interface play.libs.ws.StandaloneWSRequest
username
- the basic auth usernamepassword
- the basic auth passwordWSRequest setAuth(java.lang.String username, java.lang.String password, play.libs.ws.WSAuthScheme scheme)
setAuth
in interface play.libs.ws.StandaloneWSRequest
username
- the usernamepassword
- the passwordscheme
- authentication schemeWSRequest sign(play.libs.ws.WSSignatureCalculator calculator)
sign
in interface play.libs.ws.StandaloneWSRequest
calculator
- the signature calculatorWSRequest setFollowRedirects(boolean followRedirects)
setFollowRedirects
in interface play.libs.ws.StandaloneWSRequest
followRedirects
- true if the request should follow redirectsWSRequest setVirtualHost(java.lang.String virtualHost)
setVirtualHost
in interface play.libs.ws.StandaloneWSRequest
virtualHost
- the virtual hostWSRequest setRequestTimeout(java.time.Duration timeout)
setRequestTimeout
in interface play.libs.ws.StandaloneWSRequest
timeout
- the request timeout in milliseconds. A value of -1 indicates an infinite request timeout.@Deprecated WSRequest setRequestTimeout(long timeout)
setRequestTimeout(Duration)
timeout
- the request timeout in milliseconds. A value of -1 indicates an infinite request timeout.WSRequest setRequestFilter(play.libs.ws.WSRequestFilter filter)
setRequestFilter
in interface play.libs.ws.StandaloneWSRequest
filter
- a transforming filter.WSRequest setContentType(java.lang.String contentType)
setContentType
in interface play.libs.ws.StandaloneWSRequest
contentType
- The content typejava.lang.String getUrl()
getUrl
in interface play.libs.ws.StandaloneWSRequest
java.util.Map<java.lang.String,java.util.List<java.lang.String>> getHeaders()
getHeaders
in interface play.libs.ws.StandaloneWSRequest
java.util.Map<java.lang.String,java.util.List<java.lang.String>> getQueryParameters()
getQueryParameters
in interface play.libs.ws.StandaloneWSRequest
java.lang.String getUsername()
getUsername
in interface play.libs.ws.StandaloneWSRequest
java.lang.String getPassword()
getPassword
in interface play.libs.ws.StandaloneWSRequest
play.libs.ws.WSAuthScheme getScheme()
getScheme
in interface play.libs.ws.StandaloneWSRequest
play.libs.ws.WSSignatureCalculator getCalculator()
getCalculator
in interface play.libs.ws.StandaloneWSRequest
@Deprecated java.time.Duration getRequestTimeoutDuration()
getRequestTimeoutDuration()
getRequestTimeoutDuration
in interface play.libs.ws.StandaloneWSRequest
@Deprecated long getRequestTimeout()
getRequestTimeoutDuration()
boolean getFollowRedirects()
setFollowRedirects(boolean)
method has been called, then returns true.getFollowRedirects
in interface play.libs.ws.StandaloneWSRequest