org.davic.net.tuning

Overview | Package | Class | Use | Tree | Deprecated | Index | Help

PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES

## Package org.davic.net.tuning

Provides access to tuning - MPEG multiplex selection.

See:
Description

Interface Summary
DeliverySystemType | An interface that defines constant values for delivery system types
NetworkInterfaceListener | The listener used to receive NetworkInterface related events.

Class Summary
NetworkInterface | Objects of this class represent physical network interfaces that can be used for receiving broadcast transport streams.
NetworkInterfaceController | NetworkInterfaceController represents a controller that can be used for tuning a network interface.
NetworkInterfaceEvent | Base class for events related to network interfaces.
NetworkInterfaceManager | A network interface manager is an object that keeps track of broadcast network interfaces that are connected to the receiver.
NetworkInterfaceReleasedEvent | This event informs that the NetworkInterface returned by the getNetworkInterface method has been released by an application or other entity in the system.
NetworkInterfaceReservedEvent | This event informs that a particular network interface has been reserved by an application or other entity in the system.
NetworkInterfaceTuningEvent | This event signals that a particular NetworkInterface has started to tune to another transport stream.
NetworkInterfaceTuningOverEvent | This event signals that a particular NetworkInterface has completed its tuning action.
StreamTable | A stream table containing information about transport streams known to the receiver

Exception Summary
IncorrectLocatorException | This exception is raised when a Locator given is of an inappropriate type.
NetworkInterfaceException | Base class for the NetworkInterfaceExceptions
NoFreeInterfaceException | This exception is raised when a NetworkInterface that could be reserved by the application, cannot be found.
NotOwnerException | This exception is raised when the application calls a method and has no control over the corresponding NetworkInterface.
NotTunedException | This exception is raised when a method that requires access to a transport stream is called on a network interface that is not tuned to any transport stream.
StreamNotFoundException | This exception is raised when a reference to a transport stream from a Locator can not be resolved because the transport stream does not exist in the database of known transport streams.

## Package org.davic.net.tuning Description

Provides access to tuning - MPEG multiplex selection. Note that in a digital TV system the role of tuning is different from its role in an analog TV system. The service selection API in MHP provides functionality closer to the role of tuning in an analog TV system.

This javadoc has been edited to match the contents of the MHP specification. The following errata agreed in DVB have been implemented with respect to the original DAVIC work.

- NetworkInterfaceController.reserve() (DVB issue #776)

  Change the reason why a NoFreeInterfaceException is thrown to be "raised if the requested network interface can not be reserved"

- NetworkInterfaceController.tune() (DVB issue #773)

  Replace "this NetworkInterface" with "the NetworkInterface reserved by this NetworkInterfaceController" in both signatures of this method.

- NetworkInterfaceController.reserve() (DVB issue #778)

  The following from the semantic of this method:

  If this NetworkInterfaceController has already reserved another NetworkInterface, then it will either release that NetworkInterface and reserve the specified one, or throw an exception. If the specified NetworkInterface has already been reserved by this NetworkInterfaceController, then this method does nothing.

  is replaced with the following:

  If this NetworkInterfaceController has currently reserved another NetworkInterface, then it will either release that NetworkInterface and reserve an appropriate one, or throw an exception. If a NetworkInterface that is able to tune to the specified transport stream is currently reserved by this NetworkInterfaceController, then this method does nothing.

- NetworkInterfaceController.reserveFor() (DVB issue #780)

  The following from the semantic of this method:

  If this NetworkInterfaceController has already reserved another NetworkInterface, then it will either release that NetworkInterface and reserve an appropriate one, or throw an exception. If NetworkInterfaceController has already reserved a NetworkInterface that is able to tune to the specified transport stream, then this method does nothing.

  is replaced with the following:

  If this NetworkInterfaceController has currently reserved another NetworkInterface, then it will either release that NetworkInterface and reserve an appropriate one, or throw an exception. If a NetworkInterface that is able to tune to the specified transport stream is currently reserved by this NetworkInterfaceController, then this method does nothing.

- NetworkInterface - Constructor (DVB issue #2554) This class is considered to have a no argument protected constructor with the following statement attached to it:

  This constructor is provided for the use of implementations and specifications which extend this specification. Applications shall not define sub-classes of this class. Implementations are not required to behave correctly if any such application defined sub-classes are used.

Overview | Package | Class | Use | Tree | Deprecated | Index | Help

PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES