Package javax.ws.rs.client

Class Entity<T>

java.lang.Object
javax.ws.rs.client.Entity<T>
Type Parameters:
T - entity type.
public final class Entity<T> extends Object
Encapsulates message entity including the associated variant information.

  • Method Details

    • entity

      public static <T> Entity<T> entity(T entity, MediaType mediaType)
      Create an entity using a supplied content media type.
      Type Parameters:
      T - entity Java type.
      Parameters:
      entity - entity data.
      mediaType - entity content type.
      Returns:
      entity instance.

    • entity

      public static <T> Entity<T> entity(T entity, MediaType mediaType, Annotation[] annotations)
      Create an entity using a supplied content media type.
      Type Parameters:
      T - entity Java type.
      Parameters:
      entity - entity data.
      mediaType - entity content type.
      annotations - entity annotations.
      Returns:
      entity instance.

    • entity

      public static <T> Entity<T> entity(T entity, String mediaType)
      Create an entity using a supplied content media type.
      Type Parameters:
      T - entity Java type.
      Parameters:
      entity - entity data.
      mediaType - entity content type.
      Returns:
      entity instance.
      Throws:
      IllegalArgumentException - if the supplied string cannot be parsed or is null.

    • entity

      public static <T> Entity<T> entity(T entity, Variant variant)
      Create an entity using a supplied content media type.
      Type Parameters:
      T - entity Java type.
      Parameters:
      entity - entity data.
      variant - entity variant information.
      Returns:
      entity instance.

    • entity

      public static <T> Entity<T> entity(T entity, Variant variant, Annotation[] annotations)
      Create an entity using a supplied content media type.
      Type Parameters:
      T - entity Java type.
      Parameters:
      entity - entity data.
      variant - entity variant information.
      annotations - entity annotations.
      Returns:
      entity instance.

    • text

      public static <T> Entity<T> text(T entity)
      Create a "text/plain" entity.
      Type Parameters:
      T - entity Java type.
      Parameters:
      entity - entity data.
      Returns:
      "text/plain" entity instance.

    • xml

      public static <T> Entity<T> xml(T entity)
      Create an "application/xml" entity.
      Type Parameters:
      T - entity Java type.
      Parameters:
      entity - entity data.
      Returns:
      "application/xml" entity instance.

    • json

      public static <T> Entity<T> json(T entity)
      Create an "application/json" entity.
      Type Parameters:
      T - entity Java type.
      Parameters:
      entity - entity data.
      Returns:
      "application/json" entity instance.

    • html

      public static <T> Entity<T> html(T entity)
      Create a "text/html" entity.
      Type Parameters:
      T - entity Java type.
      Parameters:
      entity - entity data.
      Returns:
      "text/html" entity instance.

    • xhtml

      public static <T> Entity<T> xhtml(T entity)
      Create an "application/xhtml+xml" entity.
      Type Parameters:
      T - entity Java type.
      Parameters:
      entity - entity data.
      Returns:
      "application/xhtml+xml" entity instance.

    • form

      public static Entity<Form> form(Form form)
      Create an "application/x-www-form-urlencoded" form entity.
      Parameters:
      form - form data.
      Returns:
      "application/x-www-form-urlencoded" form entity instance.

    • form

      public static Entity<Form> form(MultivaluedMap<String,String> formData)
      Create an "application/x-www-form-urlencoded" form entity.
      Parameters:
      formData - multivalued map representing the form data.
      Returns:
      "application/x-www-form-urlencoded" form entity instance.

    • getVariant

      public Variant getVariant()
      Get entity variant information.
      Returns:
      entity variant information.

    • getMediaType

      public MediaType getMediaType()
      Get entity media type.
      Returns:
      entity media type.

    • getEncoding

      public String getEncoding()
      Get entity encoding.
      Returns:
      entity encoding.

    • getLanguage

      public Locale getLanguage()
      Get entity language.
      Returns:
      entity language.

    • getEntity

      public T getEntity()
      Get entity data.
      Returns:
      entity data.

    • getAnnotations

      public Annotation[] getAnnotations()
      Get the entity annotations.
      Returns:
      entity annotations if set, an empty annotation array if no entity annotations have been specified.