org.springframework.http

Class RequestEntity<T>

java.lang.Object

org.springframework.http.HttpEntity<T>

org.springframework.http.RequestEntity<T>

public class RequestEntity<T>
extends HttpEntity<T>

Extension of HttpEntity that adds a method and uri. Used in RestTemplate and @Controller methods.

In RestTemplate, this class is used as parameter in exchange():

 MyRequest body = ...
 RequestEntity<MyRequest> request = RequestEntity.post("http://example.com/{foo}", "bar").accept(MediaType.APPLICATION_JSON).body(body);
 ResponseEntity<MyResponse> response = template.exchange(request, MyResponse.class);
 

Can also be used in Spring MVC, as a parameter in a @Controller method:

 @RequestMapping("/handle")
 public void handle(RequestEntity<String> request) {
   HttpMethod method = request.getMethod();
   URI url = request.getUrl();
   String body = request.getBody();
 }
 

Since:

4.1

Author:

Arjen Poutsma

See Also:

getMethod(), getUrl()

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	RequestEntity.BodyBuilder Defines a builder that adds a body to the response entity.
static interface	RequestEntity.HeadersBuilder<B extends RequestEntity.HeadersBuilder<B>> Defines a builder that adds headers to the request entity.

Field Summary

Fields inherited from class org.springframework.http.HttpEntity

EMPTY

Constructor Summary

Constructors

Constructor and Description
RequestEntity(HttpMethod method, URI url) Constructor with method and URL but without body nor headers.
RequestEntity(MultiValueMap<String,String> headers, HttpMethod method, URI url) Constructor with method, URL and headers but without body.
RequestEntity(T body, HttpMethod method, URI url) Constructor with method, URL and body but without headers.
RequestEntity(T body, MultiValueMap<String,String> headers, HttpMethod method, URI url) Constructor with method, URL, headers and body.

Method Summary

Modifier and Type	Method and Description
static RequestEntity.HeadersBuilder<?>	delete(String url, Map<String,?> uriVariables) Create an HTTP DELETE builder with the given url and uri variables.
static RequestEntity.HeadersBuilder<?>	delete(String url, Object... uriVariables) Create an HTTP DELETE builder with the given url and uri variables.
static RequestEntity.HeadersBuilder<?>	delete(URI url) Create an HTTP DELETE builder with the given url.
boolean	equals(Object other)
static RequestEntity.HeadersBuilder<?>	get(String url, Map<String,?> uriVariables) Create an HTTP GET builder with the given url and uri variables.
static RequestEntity.HeadersBuilder<?>	get(String url, Object... uriVariables) Create a GET builder with the given url and uri variables.
static RequestEntity.HeadersBuilder<?>	get(URI url) Create an HTTP GET builder with the given url.
HttpMethod	getMethod() Return the HTTP method of the request.
URI	getUrl() Return the URL of the request.
int	hashCode()
static RequestEntity.HeadersBuilder<?>	head(String url, Map<String,?> uriVariables) Create an HTTP HEAD builder with the given url and uri variables.
static RequestEntity.HeadersBuilder<?>	head(String url, Object... uriVariables) Create an HTTP HEAD builder with the given url and uri variables.
static RequestEntity.HeadersBuilder<?>	head(URI url) Create an HTTP HEAD builder with the given url.
static RequestEntity.BodyBuilder	method(HttpMethod method, String url, Map<String,?> uriVariables) Create a builder with the given method, url, and uri variables.
static RequestEntity.BodyBuilder	method(HttpMethod method, String url, Object... uriVariables) Create a builder with the given method, url, and uri variables.
static RequestEntity.BodyBuilder	method(HttpMethod method, URI url) Create a builder with the given method and url.
static RequestEntity.HeadersBuilder<?>	options(String url, Map<String,?> uriVariables) Creates an HTTP OPTIONS builder with the given url and uri variables.
static RequestEntity.HeadersBuilder<?>	options(String url, Object... uriVariables) Create an HTTP OPTIONS builder with the given url and uri variables.
static RequestEntity.HeadersBuilder<?>	options(URI url) Creates an HTTP OPTIONS builder with the given url.
static RequestEntity.BodyBuilder	patch(String url, Map<String,?> uriVariables) Create an HTTP PATCH builder with the given url and uri variables.
static RequestEntity.BodyBuilder	patch(String url, Object... uriVariables) Create an HTTP PATCH builder with the given url and uri variables.
static RequestEntity.BodyBuilder	patch(URI url) Create an HTTP PATCH builder with the given url.
static RequestEntity.BodyBuilder	post(String url, Map<String,?> uriVariables) Create an HTTP POST builder with the given url and uri variables.
static RequestEntity.BodyBuilder	post(String url, Object... uriVariables) Create an HTTP POST builder with the given url and uri variables.
static RequestEntity.BodyBuilder	post(URI url) Create an HTTP POST builder with the given url.
static RequestEntity.BodyBuilder	put(String url, Map<String,?> uriVariables) Create an HTTP PUT builder with the given url and uri variables.
static RequestEntity.BodyBuilder	put(String url, Object... uriVariables) Create an HTTP PUT builder with the given url and uri variables.
static RequestEntity.BodyBuilder	put(URI url) Create an HTTP PUT builder with the given url.
String	toString()

Methods inherited from class org.springframework.http.HttpEntity

getBody, getHeaders, hasBody

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

RequestEntity

public RequestEntity(HttpMethod method,
                     URI url)

Constructor with method and URL but without body nor headers.

Parameters:

method - the method

url - the URL

RequestEntity

public RequestEntity(T body,
                     HttpMethod method,
                     URI url)

Constructor with method, URL and body but without headers.

Parameters:

body - the body

method - the method

url - the URL

RequestEntity

public RequestEntity(MultiValueMap<String,String> headers,
                     HttpMethod method,
                     URI url)

Constructor with method, URL and headers but without body.

Parameters:

headers - the headers

method - the method

url - the URL

RequestEntity

public RequestEntity(T body,
                     MultiValueMap<String,String> headers,
                     HttpMethod method,
                     URI url)

Constructor with method, URL, headers and body.

Parameters:

body - the body

headers - the headers

method - the method

url - the URL

Method Detail

getMethod

public HttpMethod getMethod()

Return the HTTP method of the request.

Returns:

the HTTP method as an HttpMethod enum value

getUrl

public URI getUrl()

Return the URL of the request.

Returns:

the URL as a URI

equals

public boolean equals(Object other)

Overrides:

equals in class HttpEntity<T>

hashCode

public int hashCode()

Overrides:

hashCode in class HttpEntity<T>

toString

public String toString()

Overrides:

toString in class HttpEntity<T>

method

public static RequestEntity.BodyBuilder method(HttpMethod method,
                                               String url,
                                               Object... uriVariables)

Create a builder with the given method, url, and uri variables.

URI Template variables are expanded using the given URI variables, if any.

Parameters:

method - the HTTP method (GET, POST, etc)

url - the URL

uriVariables - the variables to expand in the template

Returns:

the created builder

method

public static RequestEntity.BodyBuilder method(HttpMethod method,
                                               String url,
                                               Map<String,?> uriVariables)

Create a builder with the given method, url, and uri variables.

URI Template variables are expanded using the given URI variables, if any.

Parameters:

method - the HTTP method (GET, POST, etc)

url - the URL

uriVariables - the variables to expand in the template

Returns:

the created builder

method

public static RequestEntity.BodyBuilder method(HttpMethod method,
                                               URI url)

Create a builder with the given method and url.

Parameters:

method - the HTTP method (GET, POST, etc)

url - the URL

Returns:

the created builder

get

public static RequestEntity.HeadersBuilder<?> get(String url,
                                                  Object... uriVariables)

Create a GET builder with the given url and uri variables.

URI Template variables are expanded using the given URI variables, if any.

Parameters:

url - the URL

uriVariables - the variables to expand in the template

Returns:

the created builder

get

public static RequestEntity.HeadersBuilder<?> get(String url,
                                                  Map<String,?> uriVariables)

Create an HTTP GET builder with the given url and uri variables.

URI Template variables are expanded using the given URI variables, if any.

Parameters:

url - the URL

uriVariables - the variables to expand in the template

Returns:

the created builder

get

public static RequestEntity.HeadersBuilder<?> get(URI url)

Create an HTTP GET builder with the given url.

URI Template variables are expanded using the given URI variables, if any.

Parameters:

url - the URL

Returns:

the created builder

head

public static RequestEntity.HeadersBuilder<?> head(String url,
                                                   Object... uriVariables)

Create an HTTP HEAD builder with the given url and uri variables.

URI Template variables are expanded using the given URI variables, if any.

Parameters:

url - the URL

uriVariables - the variables to expand in the template

Returns:

the created builder

head

public static RequestEntity.HeadersBuilder<?> head(String url,
                                                   Map<String,?> uriVariables)

Create an HTTP HEAD builder with the given url and uri variables.

URI Template variables are expanded using the given URI variables, if any.

Parameters:

url - the URL

uriVariables - the variables to expand in the template

Returns:

the created builder

head

public static RequestEntity.HeadersBuilder<?> head(URI url)

Create an HTTP HEAD builder with the given url.

Parameters:

url - the URL

Returns:

the created builder

post

public static RequestEntity.BodyBuilder post(String url,
                                             Object... uriVariables)

Create an HTTP POST builder with the given url and uri variables.

URI Template variables are expanded using the given URI variables, if any.

Parameters:

url - the URL

uriVariables - the variables to expand in the template

Returns:

the created builder

post

public static RequestEntity.BodyBuilder post(String url,
                                             Map<String,?> uriVariables)

Create an HTTP POST builder with the given url and uri variables.

URI Template variables are expanded using the given URI variables, if any.

Parameters:

url - the URL

uriVariables - the variables to expand in the template

Returns:

the created builder

post

public static RequestEntity.BodyBuilder post(URI url)

Create an HTTP POST builder with the given url.

Parameters:

url - the URL

Returns:

the created builder

put

public static RequestEntity.BodyBuilder put(String url,
                                            Object... uriVariables)

Create an HTTP PUT builder with the given url and uri variables.

URI Template variables are expanded using the given URI variables, if any.

Parameters:

url - the URL

uriVariables - the variables to expand in the template

Returns:

the created builder

put

public static RequestEntity.BodyBuilder put(String url,
                                            Map<String,?> uriVariables)

Create an HTTP PUT builder with the given url and uri variables.

URI Template variables are expanded using the given URI variables, if any.

Parameters:

url - the URL

uriVariables - the variables to expand in the template

Returns:

the created builder

put

public static RequestEntity.BodyBuilder put(URI url)

Create an HTTP PUT builder with the given url.

Parameters:

url - the URL

Returns:

the created builder

patch

public static RequestEntity.BodyBuilder patch(String url,
                                              Object... uriVariables)

Create an HTTP PATCH builder with the given url and uri variables.

URI Template variables are expanded using the given URI variables, if any.

Parameters:

url - the URL

uriVariables - the variables to expand in the template

Returns:

the created builder

patch

public static RequestEntity.BodyBuilder patch(String url,
                                              Map<String,?> uriVariables)

Create an HTTP PATCH builder with the given url and uri variables.

URI Template variables are expanded using the given URI variables, if any.

Parameters:

url - the URL

uriVariables - the variables to expand in the template

Returns:

the created builder

patch

public static RequestEntity.BodyBuilder patch(URI url)

Create an HTTP PATCH builder with the given url.

Parameters:

url - the URL

Returns:

the created builder

delete

public static RequestEntity.HeadersBuilder<?> delete(String url,
                                                     Object... uriVariables)

Create an HTTP DELETE builder with the given url and uri variables.

URI Template variables are expanded using the given URI variables, if any.

Parameters:

url - the URL

uriVariables - the variables to expand in the template

Returns:

the created builder

delete

public static RequestEntity.HeadersBuilder<?> delete(String url,
                                                     Map<String,?> uriVariables)

Create an HTTP DELETE builder with the given url and uri variables.

URI Template variables are expanded using the given URI variables, if any.

Parameters:

url - the URL

uriVariables - the variables to expand in the template

Returns:

the created builder

delete

public static RequestEntity.HeadersBuilder<?> delete(URI url)

Create an HTTP DELETE builder with the given url.

Parameters:

url - the URL

Returns:

the created builder

options

public static RequestEntity.HeadersBuilder<?> options(String url,
                                                      Object... uriVariables)

Create an HTTP OPTIONS builder with the given url and uri variables.

URI Template variables are expanded using the given URI variables, if any.

Parameters:

url - the URL

uriVariables - the variables to expand in the template

Returns:

the created builder

options

public static RequestEntity.HeadersBuilder<?> options(String url,
                                                      Map<String,?> uriVariables)

Creates an HTTP OPTIONS builder with the given url and uri variables.

URI Template variables are expanded using the given URI variables, if any.

Parameters:

url - the URL

uriVariables - the variables to expand in the template

Returns:

the created builder

options

public static RequestEntity.HeadersBuilder<?> options(URI url)

Creates an HTTP OPTIONS builder with the given url.

Parameters:

url - the URL

Returns:

the created builder