javax.tv.service.navigation

Class PreferenceFilter

java.lang.Object

javax.tv.service.navigation.ServiceFilter

javax.tv.service.navigation.PreferenceFilter

public final class PreferenceFilter
extends ServiceFilter

PreferenceFilter represents a ServiceFilter based on a user preference for favorite services. A ServiceList resulting from this filter will include only user favorite services contained in the specified preference.

See Also:

FavoriteServicesName, ServiceList

Constructor Summary

Constructors

Constructor and Description
PreferenceFilter(FavoriteServicesName preference) Constructs the filter based on a particular user preference for favorite services.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	accept(Service service) Tests if the given service passes the filter.
FavoriteServicesName	getFilterValue() Reports the user preference used to create this filter.
static FavoriteServicesName[]	listPreferences() Reports the available favorite service preferences which can be used to create this filter.

Methods inherited from class java.lang.Object

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

Constructor Detail

PreferenceFilter

public PreferenceFilter(FavoriteServicesName preference)

Constructs the filter based on a particular user preference for favorite services.

Parameters:

preference - A named user preference, obtained from the listPreferences() method, representing favorite Services to be included in a resulting service list.

Throws:

IllegalArgumentException - If the specified preference is not obtainable from the listPreferences() method.

See Also:

listPreferences()

Method Detail

listPreferences

public static FavoriteServicesName[] listPreferences()

Reports the available favorite service preferences which can be used to create this filter.

Returns:

An array of preferences for favorite services.

getFilterValue

public FavoriteServicesName getFilterValue()

Reports the user preference used to create this filter.

Returns:

The user preference representing the favorite Services by which the filter was constructed.

accept

public boolean accept(Service service)

Tests if the given service passes the filter.

Specified by:

accept in class ServiceFilter

Parameters:

service - An individual Service to be evaluated against the filtering algorithm.

Returns:

true if service is part of the favorite services indicated by the filter value; false otherwise.