org.dvb.user
Class GeneralPreference
java.lang.Object
org.dvb.user.Preference
org.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.
- User Language: 3 letter ISO 639 language codes;
- Parental Rating: string using the same encoding as returned by
javax.tv.service.guide.ContentRatingAdvisory.getDisplayText
;
- User Name: Name of the user. This shall be in an order that is appropriate for
presentation directly to the user, e.g. in Western Europe, listing the first name first
and the family name last is recommended as being culturally appropriate in many locales.
- User Address: postal address of the user, may contain multiple lines separated by
carriage return characters (as defined in table D-4).
- User @: e-mail address of the user in the SMTP form as defined in RFC821;
- Country Code: two letter ISO 3166-1 country code;
- Default Font Size: preferred font size for normal body text expressed in points,
decimal integer value encoded as a string (26 is the default; differing size indicates a
preference of different font size than usual)
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 |
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.