com.mattunderscore.http.headers.language

Class QLanguage

java.lang.Object

com.mattunderscore.http.headers.language.QLanguage

All Implemented Interfaces:

HeaderFieldElement, ILanguage, Qualified, Cloneable

public final class QLanguage
extends Object
implements Cloneable, ILanguage

A parsed accept-language header field value with a qualification value.

The to string value is calculated when first accessed and cached subsequently. The value is checked and set atomically. Concurrent access may cause different String objects to be cached and returned but they will be equal. A happens before relationship is not established by calls to toString().

Since:

0.0.13

Author:

Matt Champion

Constructor Summary

Constructors

Constructor and Description
QLanguage(String language, String subLanguage, double qualifier) Constructor for qualified languages.

Method Summary

Modifier and Type	Method and Description
QLanguage	clone() Deprecated. There is not real value in cloning this object, the only mutable value is the cached toString value
boolean	equals(Object object)
double	getQualifier() The qualified weighting.
static List<ILanguage>	getRequestLanguages(HttpServletRequest request) Parser for HttpServletRequest to QLanguage.
int	hashCode()
boolean	sameLangauge(ILanguage lang) Test to see if two accept-language header values match.
String	toString() Returns a string representation of the object.

Methods inherited from class java.lang.Object

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

Constructor Detail

QLanguage

public QLanguage(String language,
                 String subLanguage,
                 double qualifier)

Constructor for qualified languages.

Parameters:

language - The language

subLanguage - The sublanguage

qualifier - The qualifier of the language

Throws:

IllegalArgumentException - If the language or sublanguage is null or if the qualifier is less than zero or greater than one

Method Detail

getRequestLanguages

public static List<ILanguage> getRequestLanguages(HttpServletRequest request)
                                           throws UnParsableHeaderException

Parser for HttpServletRequest to QLanguage.

Parameters:

request - The HTTP request to parse

Returns:

The list of languages in the accept-language header

Throws:

UnParsableHeaderException

Since:

0.0.13

toString

public String toString()

Returns a string representation of the object.

The string representation of the object is constructed lazily, it may be initialised multiple times and may not be aware of other threads setting it. The objects returned will be equal regardless of the thread returning the value.

Overrides:

toString in class Object

Returns:

A string representation of this object

See Also:

Object.toString()

getQualifier

public final double getQualifier()

Description copied from interface: Qualified

The qualified weighting.

Specified by:

getQualifier in interface Qualified

Returns:

Weighting

sameLangauge

public final boolean sameLangauge(ILanguage lang)

Description copied from interface: ILanguage

Test to see if two accept-language header values match. Supports wildcard matches.

Specified by:

sameLangauge in interface ILanguage

Parameters:

lang - The language

Returns:

true if the same language

See Also:

ILanguage.sameLangauge(ILanguage)

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object object)

Overrides:

equals in class Object

clone

@Deprecated
public QLanguage clone()

Deprecated. There is not real value in cloning this object, the only mutable value is the cached toString value

Overrides:

clone in class Object

Returns:

Clone object

See Also:

Object.clone()