Use is subject to License Terms. Your use of this web site or any of its content or software indicates your agreement to be bound by these License Terms.

Copyright © 2006 Sun Microsystems, Inc. All rights reserved.

javax.tv.service
Interface RatingDimension

public interface RatingDimension

The RatingDimension interface represents an individual content rating scheme against which program events are rated. Each rating region may support multiple rating dimensions. One dimension in the U.S. rating region, for example, is used to describe the MPAA list. The dimension name for such a case may be defined as "MPAA". Another example of a rating dimension may be an age-based DVB rating.

See Also:

ProgramEvent, ContentRatingAdvisory

Method Summary

java.lang.String	getDimensionName() Returns a string which represents the dimension name being described by this object.
short	getNumberOfLevels() Returns the number of levels defined for this dimension.
java.lang.String[]	getRatingLevelDescription(short ratingLevel) Returns a pair of strings describing the specified rating level for this dimension.

Method Detail

getDimensionName

public java.lang.String getDimensionName()

Returns a string which represents the dimension name being described by this object. One dimension in the U.S. rating region, for example, is used to describe the MPAA list. The dimension name for such a case may be defined as "MPAA".

Returns:

A string representing the name of this rating dimension.

getNumberOfLevels

public short getNumberOfLevels()

Returns the number of levels defined for this dimension.

Returns:

The number of levels in this dimension.

getRatingLevelDescription

public java.lang.String[] getRatingLevelDescription(short ratingLevel)
                                             throws SIException

Returns a pair of strings describing the specified rating level for this dimension.

Parameters:

ratingLevel - The rating level for which to retrieve the textual description.

Returns:

A pair of strings representing the names for the specified rating level. The first string represents the abbreviated name for the rating level. The second string represents the full name for the rating level.

Throws:

SIException - If ratingLevel is not valid for this RatingDimension.

See Also:

ContentRatingAdvisory.getRatingLevel(java.lang.String)