com.sun.tv.si

Class ServiceListImpl

java.lang.Object

com.sun.tv.si.ServiceListImpl

All Implemented Interfaces:

ServiceList

public class ServiceListImpl
extends Object
implements ServiceList

Constructor Summary

Constructors

Constructor and Description
ServiceListImpl(Service[] list)
ServiceListImpl(Vector list)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	contains(Service service) Tests if the indicated Service object is contained in the list.
ServiceIterator	createServiceIterator() Generates an iterator on the Services in this list.
boolean	equals(Object o) Compares the specified object with this ServiceList for equality.
ServiceList	filterServices(ServiceFilter filter) Creates a new ServiceList object that is a subset of this list, based on the conditions specified by a ServiceFilter object.
Service	findService(Locator locator) Reports the Service corresponding to the specified locator if it is a member of this list.
Service	getService(int index) Reports the service at the specified index position.
int	hashCode() Provides the hash code value for this ServiceList.
int	indexOf(Service service) Reports the position of the first occurrence of the indicated Service object in the list.
int	size() Reports the number of Service objects in the list.
ServiceList	sortByName() This method performs a toBeginning operation on the iterator.
ServiceList	sortByNumber() Sorts the contents of the list by service number, in ascending order.

Methods inherited from class java.lang.Object

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

Constructor Detail

ServiceListImpl

public ServiceListImpl(Service[] list)

ServiceListImpl

public ServiceListImpl(Vector list)

Method Detail

sortByName

public ServiceList sortByName()

This method performs a toBeginning operation on the iterator.

Specified by:

sortByName in interface ServiceList

Returns:

A ServiceList sorted by service name.

See Also:

Service.getName()

sortByNumber

public ServiceList sortByNumber()
                         throws SortNotAvailableException

Sorts the contents of the list by service number, in ascending order.

Specified by:

sortByNumber in interface ServiceList

Returns:

A ServiceList sorted by service number.

Throws:

SortNotAvailableException - If the contents cannot be sorted by service number. If this method is successful, it performs a toBeginning operation on the iterator.

See Also:

ServiceIterator.toBeginning()

findService

public Service findService(Locator locator)
                    throws InvalidLocatorException

Reports the Service corresponding to the specified locator if it is a member of this list.

Specified by:

findService in interface ServiceList

Parameters:

locator - Specifies the Service to be searched for.

Returns:

Service The Service corresponding to locator, or null if the Service is not a member of this list.

Throws:

InvalidLocatorException - If locator does not reference a valid Service.

filterServices

public ServiceList filterServices(ServiceFilter filter)

Creates a new ServiceList object that is a subset of this list, based on the conditions specified by a ServiceFilter object. This method may be used to generate increasingly specialized lists of Service objects based on multiple filtering criteria. If the filter is null, the resulting ServiceList will be a duplicate of this list.

Note that the accept method of the given ServiceFilter will be invoked for each Service to be filtered using the same application thread that invokes createServiceList.

Specified by:

filterServices in interface ServiceList

Parameters:

filter - A filter constraining the requested service list, or null.

Returns:

A ServiceList object created based on the specified filtering rules.

See Also:

ServiceFilter.accept(javax.tv.service.Service)

createServiceIterator

public ServiceIterator createServiceIterator()

Generates an iterator on the Services in this list.

Specified by:

createServiceIterator in interface ServiceList

Returns:

An iterator on the Services in this list.

contains

public boolean contains(Service service)

Tests if the indicated Service object is contained in the list.

Specified by:

contains in interface ServiceList

Parameters:

service - The Service object for which to search.

Returns:

true if the specified Service is member of the list; false otherwise.

indexOf

public int indexOf(Service service)

Reports the position of the first occurrence of the indicated Service object in the list.

Specified by:

indexOf in interface ServiceList

Parameters:

service - The Service object for which to search.

Returns:

The index of the first occurrence of the service, or -1 if service is not contained in the list.

size

public int size()

Reports the number of Service objects in the list.

Specified by:

size in interface ServiceList

Returns:

The number of Service objects in the list.

getService

public Service getService(int index)

Reports the service at the specified index position.

Specified by:

getService in interface ServiceList

Parameters:

index - A position in the ServiceList.

Returns:

The service at the specified index.

Throws:

IndexOutOfBoundsException - If index &< 0 or index &> size()-1.

equals

public boolean equals(Object o)

Compares the specified object with this ServiceList for equality. Returns true if and only if the specified object is also a ServiceList, both lists have the same size, and all corresponding pairs of elements in the two lists are equal. (Two elements e1 and e2 are equal if (e1==null ? e2==null : e1.equals(e2)).) In other words, two lists are defined to be equal if they contain the same elements in the same order.

Specified by:

equals in interface ServiceList

Overrides:

equals in class Object

Parameters:

o - The object to be compared for equality with this list.

Returns:

true if the specified object is equal to this list; false otherwise.

hashCode

public int hashCode()

Provides the hash code value for this ServiceList. Two ServiceList objects that are equal will have the same hash code.

Specified by:

hashCode in interface ServiceList

Overrides:

hashCode in class Object

Returns:

The hash code value of this ServiceList.