com.sun.tv.si

Class NetworkImpl

java.lang.Object

com.sun.tv.si.NetworkImpl

All Implemented Interfaces:

SIElement, SIRetrievable, Network

public class NetworkImpl
extends Object
implements Network

This interface provides descriptive information about a network of transport streams.

Constructor Summary

Constructors

Constructor and Description
NetworkImpl(String name, int networkID, ServiceInformationType siType, Date updatedTime)

Method Summary

Methods

Modifier and Type	Method and Description
Locator	getLocator() Gets the complete Locator of this SI Element.
String	getName() This method returns the name of this network.
int	getNetworkID() This method returns the ID of this Network
ServiceInformationType	getServiceInformationType() Reports the service information format of this object.
Date	getUpdateTime() Returns the time when this object was last updated from data in the broadcast.
SIRequest	retrieveTransportStreams(SIRequestor requestor) Retrieves an array of TransportStream objects representing the transport streams carried in this Network.

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.tv.service.SIElement

equals, hashCode

Constructor Detail

NetworkImpl

public NetworkImpl(String name,
           int networkID,
           ServiceInformationType siType,
           Date updatedTime)

Method Detail

getNetworkID

public int getNetworkID()

This method returns the ID of this Network

Specified by:

getNetworkID in interface Network

Returns:

A number identifying this network

getName

public String getName()

This method returns the name of this network.

Specified by:

getName in interface Network

Returns:

A string representing the name of this network.

getLocator

public Locator getLocator()

Gets the complete Locator of this SI Element. Each SI Element (such as BroadcastService, ProgramEvent, etc.) in the MPEG-2 domain is identified by a Locator. This identification is encapsulated by the Locator object which may use a URL format, specific MPEG numbers, such as network ID, etc., or other mechanisms.

Specified by:

getLocator in interface SIElement

Returns:

Locator representing this SI Element

getUpdateTime

public Date getUpdateTime()

Returns the time when this object was last updated from data in the broadcast.

Specified by:

getUpdateTime in interface SIRetrievable

Returns:

The date of the last update in UTC format, or null if unknown.

getServiceInformationType

public ServiceInformationType getServiceInformationType()

Reports the service information format of this object.

Specified by:

getServiceInformationType in interface SIElement

Returns:

The service information format.

retrieveTransportStreams

public SIRequest retrieveTransportStreams(SIRequestor requestor)

Retrieves an array of TransportStream objects representing the transport streams carried in this Network. Only TransportStream instances for which the caller has javax.tv.service.ReadPermission on the underlying locator will be present in the array. If this Network does not aggregate transport streams, the result is a zero-length array.

This method delivers its results asynchronously.

Specified by:

retrieveTransportStreams in interface Network

Parameters:

locator - A locator referencing a Network from which to retrieve transport stream information.

requestor - The SIRequestor to be notified when this retrieval operation completes.

Returns:

An SIRequest object identifying this asynchronous retrieval request.

Throws:

InvalidLocatorException - If locator does not reference a valid Network on the Transport implementing this interface.

SecurityException - if the caller does not have javax.tv.service.ReadPermission(locator).

See Also:

TransportStream, ReadPermission