org.apache.abdera.i18n.rfc4646

Class Range

java.lang.Object

org.apache.abdera.i18n.rfc4646.Range

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, java.lang.Comparable<org.apache.abdera.i18n.rfc4646.SubtagSet>, java.lang.Iterable<Subtag>

public class Range
extends java.lang.Object

A language range used for matching language tags

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
Range(Lang lang) Create a Language-Range from a Lang tag
Range(Lang lang, boolean extended) Create a Language-Range from a Lang tag
Range(java.lang.String range) Create a Language-Range
Range(java.lang.String range, boolean extended) Create a Language-Range

Method Summary

Modifier and Type	Method and Description
Range	append(Subtag subtag) Append a subtag to the range
Range	appendWildcard() Append a wildcard subtag to the range
java.util.List<Subtag>	asList()
Range	clone() Copy this range
int	compareTo(org.apache.abdera.i18n.rfc4646.SubtagSet o)
boolean	contains(java.lang.String tag)
boolean	contains(java.lang.String tag, Subtag.Type type)
boolean	contains(Subtag subtag)
int	count()
boolean	equals(java.lang.Object obj)
Lang[]	filter(Lang... lang) Filter the given set of lang tags.
java.lang.String[]	filter(java.lang.String... lang) Filter the given set of lang tags.
static Lang[]	filter(java.lang.String range, Lang... lang) Filter the given set of lang tags.
static java.lang.String[]	filter(java.lang.String range, java.lang.String... lang) Filter the given set of lang tags.
Subtag	get(int index)
int	hashCode()
boolean	isBasic() True if this range is a basic range
boolean	isValid()
java.util.Iterator<Subtag>	iterator()
int	length()
boolean	matches(Lang lang) True if the lang tag matches this range
boolean	matches(Lang lang, boolean extended) True if the lang tag matches this range
boolean	matches(java.lang.String lang) True if the lang tag matches this range
boolean	matches(java.lang.String lang, boolean extended) True if the lang tag matches this range
static boolean	matches(java.lang.String range, Lang lang) True if the lang tag matches the range.
static boolean	matches(java.lang.String range, Lang lang, boolean extended) True if the lang tag matches the range.
static boolean	matches(java.lang.String range, java.lang.String lang) True if the lang tag matches the range.
static boolean	matches(java.lang.String range, java.lang.String lang, boolean extended) True if the lang tag matches the range.
static Range	parse(java.lang.String range) Parse the language-range
static Range	parse(java.lang.String range, boolean extended) Parse the language-range
Subtag[]	toArray()
Range	toBasicRange() Create a basic language-range from this range
java.lang.String	toString()

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

Range

public Range(java.lang.String range,
             boolean extended)

Create a Language-Range

Parameters:

range - The language-range

extended - true if this is an extended language range

Range

public Range(java.lang.String range)

Create a Language-Range

Range

public Range(Lang lang)

Create a Language-Range from a Lang tag

Range

public Range(Lang lang,
             boolean extended)

Create a Language-Range from a Lang tag

Parameters:

lang - The language tag

extended - true if this is an extended language-range

Method Detail

append

public Range append(Subtag subtag)

Append a subtag to the range

appendWildcard

public Range appendWildcard()

Append a wildcard subtag to the range

clone

public Range clone()

Copy this range

Overrides:

clone in class java.lang.Object

toBasicRange

public Range toBasicRange()

Create a basic language-range from this range

isBasic

public boolean isBasic()

True if this range is a basic range

matches

public boolean matches(java.lang.String lang)

True if the lang tag matches this range

matches

public boolean matches(java.lang.String lang,
                       boolean extended)

True if the lang tag matches this range

Parameters:

lang - The language tage

extended - True if extended matching rules should be used

matches

public boolean matches(Lang lang)

True if the lang tag matches this range

matches

public boolean matches(Lang lang,
                       boolean extended)

True if the lang tag matches this range

Parameters:

lang - The language tage

extended - True if extended matching rules should be used

filter

public Lang[] filter(Lang... lang)

Filter the given set of lang tags. Return an array of matching tags

filter

public java.lang.String[] filter(java.lang.String... lang)

Filter the given set of lang tags. Return an array of matching tags

filter

public static Lang[] filter(java.lang.String range,
                            Lang... lang)

Filter the given set of lang tags. Return an array of matching tags

filter

public static java.lang.String[] filter(java.lang.String range,
                                        java.lang.String... lang)

Filter the given set of lang tags. Return an array of matching tags

matches

public static boolean matches(java.lang.String range,
                              Lang lang,
                              boolean extended)

True if the lang tag matches the range.

Parameters:

range - The language-range

lang - The language tag

extended - true to use extended match rules

matches

public static boolean matches(java.lang.String range,
                              Lang lang)

True if the lang tag matches the range.

Parameters:

range - The language-range

lang - The language tag

extended - true to use extended match rules

matches

public static boolean matches(java.lang.String range,
                              java.lang.String lang,
                              boolean extended)

True if the lang tag matches the range.

Parameters:

range - The language-range

lang - The language tag

extended - true to use extended match rules

matches

public static boolean matches(java.lang.String range,
                              java.lang.String lang)

True if the lang tag matches the range.

Parameters:

range - The language-range

lang - The language tag

extended - true to use extended match rules

parse

public static Range parse(java.lang.String range)

Parse the language-range

parse

public static Range parse(java.lang.String range,
                          boolean extended)

Parse the language-range

Parameters:

range - The language-range

extended - true to use extended language rules

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

iterator

public java.util.Iterator<Subtag> iterator()

Specified by:

iterator in interface java.lang.Iterable<Subtag>

contains

public boolean contains(Subtag subtag)

contains

public boolean contains(java.lang.String tag)

contains

public boolean contains(java.lang.String tag,
                        Subtag.Type type)

length

public int length()

isValid

public boolean isValid()

count

public int count()

get

public Subtag get(int index)

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

toArray

public Subtag[] toArray()

asList

public java.util.List<Subtag> asList()

compareTo

public int compareTo(org.apache.abdera.i18n.rfc4646.SubtagSet o)

Specified by:

compareTo in interface java.lang.Comparable<org.apache.abdera.i18n.rfc4646.SubtagSet>