org.springframework.http

Class HttpEntity<T>

java.lang.Object

org.springframework.http.HttpEntity<T>

Type Parameters:

T - the body type

Direct Known Subclasses:

RequestEntity, ResponseEntity

public class HttpEntity<T>
extends Object

Represents an HTTP request or response entity, consisting of headers and body.

Typically used in combination with the RestTemplate, like so:

 HttpHeaders headers = new HttpHeaders();
 headers.setContentType(MediaType.TEXT_PLAIN);
 HttpEntity<String> entity = new HttpEntity<String>(helloWorld, headers);
 URI location = template.postForLocation("https://example.com", entity);
 

or

 HttpEntity<String> entity = template.getForEntity("https://example.com", String.class);
 String body = entity.getBody();
 MediaType contentType = entity.getHeaders().getContentType();
 

Can also be used in Spring MVC, as a return value from a @Controller method:

 @RequestMapping("/handle")
 public HttpEntity<String> handle() {
   HttpHeaders responseHeaders = new HttpHeaders();
   responseHeaders.set("MyResponseHeader", "MyValue");
   return new HttpEntity<String>("Hello World", responseHeaders);
 }
 

Since:

3.0.2

Author:

Arjen Poutsma, Juergen Hoeller

See Also:

RestTemplate, getBody(), getHeaders()

Field Summary

Fields

Modifier and Type	Field and Description
static HttpEntity<?>	EMPTY The empty HttpEntity, with no body or headers.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	HttpEntity() Create a new, empty HttpEntity.
	HttpEntity(MultiValueMap<String,String> headers) Create a new HttpEntity with the given headers and no body.
	HttpEntity(T body) Create a new HttpEntity with the given body and no headers.
	HttpEntity(T body, MultiValueMap<String,String> headers) Create a new HttpEntity with the given body and headers.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object other)
T	getBody() Returns the body of this entity.
HttpHeaders	getHeaders() Returns the headers of this entity.
boolean	hasBody() Indicates whether this entity has a body.
int	hashCode()
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY

public static final HttpEntity<?> EMPTY

The empty HttpEntity, with no body or headers.

Constructor Detail

HttpEntity

protected HttpEntity()

Create a new, empty HttpEntity.

HttpEntity

public HttpEntity(T body)

Create a new HttpEntity with the given body and no headers.

Parameters:

body - the entity body

HttpEntity

public HttpEntity(MultiValueMap<String,String> headers)

Create a new HttpEntity with the given headers and no body.

Parameters:

headers - the entity headers

HttpEntity

public HttpEntity(@Nullable
                  T body,
                  @Nullable
                  MultiValueMap<String,String> headers)

Create a new HttpEntity with the given body and headers.

Parameters:

body - the entity body

headers - the entity headers

Method Detail

getHeaders

public HttpHeaders getHeaders()

Returns the headers of this entity.

getBody

@Nullable
public T getBody()

Returns the body of this entity.

hasBody

public boolean hasBody()

Indicates whether this entity has a body.

equals

public boolean equals(@Nullable
                      Object other)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object