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.

Often used in combination with the RestTemplate, like so: 

HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.TEXT_PLAIN);
HttpEntity<String> entity = new HttpEntity<>("Hello World", 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: 
@GetMapping("/handle")
public HttpEntity<String> handle() {
  HttpHeaders responseHeaders = new HttpHeaders();
  responseHeaders.set("MyResponseHeader", "MyValue");
  return new HttpEntity<>("Hello World", responseHeaders);
}
Since:
3.0.2
Author:
Arjen Poutsma, Juergen Hoeller
See Also:

  • Field Details

  • Constructor Details

    • 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(HttpHeaders headers)
      Create a new HttpEntity with the given headers and no body.
      Parameters:
      headers - the entity headers
      Since:
      7.0

    • HttpEntity

      public HttpEntity(@Nullable T body, @Nullable HttpHeaders headers)
      Create a new HttpEntity with the given body and headers.
      Parameters:
      body - the entity body
      headers - the entity headers
      Since:
      7.0

    • HttpEntity

      @Deprecated(since="7.0", forRemoval=true) public HttpEntity(MultiValueMap<String,String> headers)
      Deprecated, for removal: This API element is subject to removal in a future version.
      in favor of HttpEntity(HttpHeaders)
      Create a new HttpEntity with the given headers and no body.
      Parameters:
      headers - the entity headers

    • HttpEntity

      @Deprecated(since="7.0", forRemoval=true) public HttpEntity(@Nullable T body, @Nullable MultiValueMap<String,String> headers)
      Deprecated, for removal: This API element is subject to removal in a future version.
      in favor of HttpEntity(Object, HttpHeaders)
      Create a new HttpEntity with the given body and headers.
      Parameters:
      body - the entity body
      headers - the entity headers

  • Method Details

    • getHeaders

      public HttpHeaders getHeaders()
      Returns the headers of this entity.

    • getBody

      public @Nullable 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