com.noelios.restlet.http
Class PreferenceUtils

java.lang.Object
  com.noelios.restlet.http.PreferenceUtils

public class PreferenceUtils
extends Object

Preference manipulation utilities.

Author:

Jerome Louvel

Constructor Summary

PreferenceUtils()

Method Summary

static String	format(List<? extends Preference<?>> prefs) Formats a list of preferences with a comma separator.
static void	format(Preference pref, Appendable destination) Formats a preference.
static void	formatQuality(float quality, Appendable destination) Formats a quality value. If the quality is invalid, an IllegalArgumentException is thrown.
static boolean	isQuality(float quality) Indicates if the quality value is valid.
static void	parseCharacterSets(String acceptCharsetHeader, ClientInfo client) Parses character set preferences from a header.
static void	parseEncodings(String acceptEncodingHeader, ClientInfo preference) Parses encoding preferences from a header.
static void	parseLanguages(String acceptLanguageHeader, ClientInfo preference) Parses language preferences from a header.
static void	parseMediaTypes(String acceptMediaTypeHeader, ClientInfo preference) Parses media type preferences from a header.
static float	parseQuality(String quality) Parses a quality value. If the quality is invalid, an IllegalArgumentException is thrown.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PreferenceUtils

public PreferenceUtils()

Method Detail

format

public static String format(List<? extends Preference<?>> prefs)
                     throws IOException

Formats a list of preferences with a comma separator.

Parameters:

prefs - The list of preferences.

Returns:

The formatted list of preferences.

Throws:

IOException

format

public static void format(Preference pref,
                          Appendable destination)
                   throws IOException

Formats a preference.

Parameters:

pref - The preference to format.

destination - The appendable destination.

Throws:

IOException

formatQuality

public static void formatQuality(float quality,
                                 Appendable destination)
                          throws IOException

Formats a quality value.
If the quality is invalid, an IllegalArgumentException is thrown.

Parameters:

quality - The quality value as a float.

destination - The appendable destination;

Throws:

IOException

isQuality

public static boolean isQuality(float quality)

Indicates if the quality value is valid.

Parameters:

quality - The quality value.

Returns:

True if the quality value is valid.

parseCharacterSets

public static void parseCharacterSets(String acceptCharsetHeader,
                                      ClientInfo client)

Parses character set preferences from a header.

Parameters:

acceptCharsetHeader - The header to parse.

client - The client preferences to update.

parseEncodings

public static void parseEncodings(String acceptEncodingHeader,
                                  ClientInfo preference)

Parses encoding preferences from a header.

Parameters:

acceptEncodingHeader - The header to parse.

preference - The client preferences to update.

parseLanguages

public static void parseLanguages(String acceptLanguageHeader,
                                  ClientInfo preference)

Parses language preferences from a header.

Parameters:

acceptLanguageHeader - The header to parse.

preference - The client preferences to update.

parseMediaTypes

public static void parseMediaTypes(String acceptMediaTypeHeader,
                                   ClientInfo preference)

Parses media type preferences from a header.

Parameters:

acceptMediaTypeHeader - The header to parse.

preference - The client preferences to update.

parseQuality

public static float parseQuality(String quality)

Parses a quality value.
If the quality is invalid, an IllegalArgumentException is thrown.

Parameters:

quality - The quality value as a string.

Returns:

The parsed quality value as a float.