com.noelios.restlet.http
Class PreferenceUtils

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

public class PreferenceUtils
extends java.lang.Object

Preference manipulation utilities.

Author:
Jerome Louvel

Constructor Summary
PreferenceUtils()
           
 
Method Summary
static java.lang.String format(java.util.List<? extends Preference<?>> prefs)
          Formats a list of preferences with a comma separator.
static void format(Preference pref, java.lang.Appendable destination)
          Formats a preference.
static void formatQuality(float quality, java.lang.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(java.lang.String acceptCharsetHeader, ClientInfo client)
          Parses character set preferences from a header.
static void parseEncodings(java.lang.String acceptEncodingHeader, ClientInfo preference)
          Parses encoding preferences from a header.
static void parseLanguages(java.lang.String acceptLanguageHeader, ClientInfo preference)
          Parses language preferences from a header.
static void parseMediaTypes(java.lang.String acceptMediaTypeHeader, ClientInfo preference)
          Parses media type preferences from a header.
static float parseQuality(java.lang.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 java.lang.String format(java.util.List<? extends Preference<?>> prefs)
                               throws java.io.IOException
Formats a list of preferences with a comma separator.

Parameters:
prefs - The list of preferences.
Returns:
The formatted list of preferences.
Throws:
java.io.IOException

format

public static void format(Preference pref,
                          java.lang.Appendable destination)
                   throws java.io.IOException
Formats a preference.

Parameters:
pref - The preference to format.
destination - The appendable destination.
Throws:
java.io.IOException

formatQuality

public static void formatQuality(float quality,
                                 java.lang.Appendable destination)
                          throws java.io.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:
java.io.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(java.lang.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(java.lang.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(java.lang.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(java.lang.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(java.lang.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.


Copyright © 2005-2008 Noelios Technologies.