org.dvb.user
Class GeneralPreference

java.lang.Object
  extended byorg.dvb.user.Preference
      extended byorg.dvb.user.GeneralPreference

public final class GeneralPreference
extends Preference

This class defines a set of general preferences. These preferences are read from the receiver and each application (downloaded or not) can access them through the UserPreferenceManager.read method. The standardized preferences are "User Language", "Parental Rating", "User Name", "User Address", "User @", "Country Code", "Default Font Size".

When constructed, objects of this class are empty and have no values defined. Values may be added using the add methods inherited from the Preference class or by calling UserPreferenceManager.read.

The encodings of these standardized preferences are as follows.

The preference names are treated as case-insensitive. The preference names shall be considered equal at least when the method java.lang.String.equalsIgnoreCase() returns true for the strings when the locale "EN.UK" is used. Depending on the locale used in the implementation, implementations are allowed to consider equal also other upper and lower case character pairs in addition to those defined by the "EN.UK" locale.

The standardized preference names in the present document shall only use such letters where the upper and lower case characters are recognized by the "EN.UK" locale.


Constructor Summary
GeneralPreference(java.lang.String name)
          Constructs a GeneralPreference object.
 
Methods inherited from class org.dvb.user.Preference
add, add, add, getFavourites, getMostFavourite, getName, getPosition, hasValue, remove, removeAll, setMostFavourite, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

GeneralPreference

public GeneralPreference(java.lang.String name)
                  throws java.lang.IllegalArgumentException
Constructs a GeneralPreference object. A general preference maps a preference name to a list of strings.

Parameters:
name - the general preference name.
Throws:
java.lang.IllegalArgumentException - if the preference's name is not supported.