This method sets the MIME media type of an HTTP request entity.

For the Java types available for an HTTP request entity, see 25.15.1 Combination of Java types and MIME media types available for an HTTP request entity. You can use the GenericEntity object to specify generics in the entity.

public WebResource.Builder entity(Object entity,

String type)

entity

This is an HTTP request entity.

type

This is a MIME media type.

The method returns a builder (WebResource.Builder object).

• If null or an empty string is set in the type parameter, the IllegalArgumentException exception is thrown.
• The non-null value specified in the type parameter is set in the Content-Type HTTP header.
• The value returned by the toString() method of the MediaType object is set in the Content-Type HTTP header. The JAX-RS engine does not validate the values returned by the toString() method. Specify the value according to the standard specifications.
• You can also use the following methods to change the value of the Content-Type HTTP header:
  
  • ClientRequest.Builder class
    entity(Object entity, MediaType type) method
    entity(Object entity, String type) method
    header(String name, Object value) method
    type(MediaType type) method
    type(String type) method
    
  • WebResource class
    entity(Object entity, MediaType type) method
    header(String name, Object value) method
    type(MediaType type) method
    type(String type) method
    
  • WebResource.Builder class
    entity(Object entity, MediaType type) method
    entity(Object entity, String type) method
    header(String name, Object value) method
    type(MediaType type) method
    type(String type) method
    
  The operation when the MIME media type is not set with these methods and the entity(Object entity, String type) method is the same as the operation when the Content-Type HTTP header is not set in the HttpURLConnection object before performing HTTP communication.