Package javax.ws.rs.core
Class Variant
- java.lang.Object
-
- javax.ws.rs.core.Variant
-
public class Variant extends Object
Abstraction for a resource representation variant.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
Variant.VariantListBuilder
A builder for a list of representation variants.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static Variant.VariantListBuilder
encodings(String... encodings)
Create aVariant.VariantListBuilder
initialized with a set of supported encodings.boolean
equals(Object obj)
Compares obj to this variant to see if they are the same considering all property values.String
getEncoding()
Get the encoding of the variantLocale
getLanguage()
Get the language of the variantMediaType
getMediaType()
Get the media type of the variantint
hashCode()
Generate hash code from variant properties.static Variant.VariantListBuilder
languages(Locale... languages)
Create aVariant.VariantListBuilder
initialized with a set of supported languages.static Variant.VariantListBuilder
mediaTypes(MediaType... mediaTypes)
Create aVariant.VariantListBuilder
initialized with a set of supported media types.String
toString()
-
-
-
Constructor Detail
-
Variant
public Variant(MediaType mediaType, Locale language, String encoding)
Create a new instance of Variant- Parameters:
mediaType
- the media type of the variant - may be nulllanguage
- the language of the variant - may be nullencoding
- the content encoding of the variant - may be null- Throws:
IllegalArgumentException
- if all three parameters are null
-
-
Method Detail
-
getLanguage
public Locale getLanguage()
Get the language of the variant- Returns:
- the language or null if none set
-
getMediaType
public MediaType getMediaType()
Get the media type of the variant- Returns:
- the media type or null if none set
-
getEncoding
public String getEncoding()
Get the encoding of the variant- Returns:
- the encoding or null if none set
-
mediaTypes
public static Variant.VariantListBuilder mediaTypes(MediaType... mediaTypes)
Create aVariant.VariantListBuilder
initialized with a set of supported media types.- Parameters:
mediaTypes
- the available mediaTypes. If specific charsets are supported they should be included as parameters of the respective media type.- Returns:
- the initailized builder
- Throws:
IllegalArgumentException
- if mediaTypes is null or contains no elements.
-
languages
public static Variant.VariantListBuilder languages(Locale... languages)
Create aVariant.VariantListBuilder
initialized with a set of supported languages.- Parameters:
languages
- the available languages.- Returns:
- the initailized builder
- Throws:
IllegalArgumentException
- if languages is null or contains no elements.
-
encodings
public static Variant.VariantListBuilder encodings(String... encodings)
Create aVariant.VariantListBuilder
initialized with a set of supported encodings.- Parameters:
encodings
- the available encodings.- Returns:
- the initailized builder
- Throws:
IllegalArgumentException
- if encodings is null or contains no elements.
-
hashCode
public int hashCode()
Generate hash code from variant properties.
-
equals
public boolean equals(Object obj)
Compares obj to this variant to see if they are the same considering all property values.
-
-