com.sun.tv.net

Class EncapIPDataSource

java.lang.Object

javax.media.protocol.DataSource

javax.media.protocol.PushDataSource

com.sun.tv.net.EncapIPDataSource

All Implemented Interfaces:

Duration, Controls

public class EncapIPDataSource
extends PushDataSource

Field Summary

Fields inherited from interface javax.media.Duration

DURATION_UNBOUNDED, DURATION_UNKNOWN

Constructor Summary

Constructors

Constructor and Description
EncapIPDataSource(MediaLocator mediaLoc) Will create a stream for the locator

Method Summary

Methods

Modifier and Type	Method and Description
void	connect() Since EncapIPStream reads from a file, connect() is simulated by starting the StreamReadingThread in EncapIPStream (calling setOpen() on stream, if one doesn't exist (signalled by open=false).
void	disconnect() Close the connection to the source described by the locator.
String	getContentType() Get a string that describes the content-type of the media that the source is providing.
Object	getControl(String control) Obtain the object that implements the specified Class or Interface The full class or interface name must be used.
Object[]	getControls() Obtain the collection of objects that control the object that implements this interface.
Time	getDuration() Get the duration of the media represented by this object.
PushSourceStream[]	getStreams() Get the collection of streams that this source manages.
void	start() Initiate data-transfer.
void	stop() Stop the data-transfer.

Methods inherited from class javax.media.protocol.DataSource

getLocator, initCheck, setLocator

Methods inherited from class java.lang.Object

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

Constructor Detail

EncapIPDataSource

public EncapIPDataSource(MediaLocator mediaLoc)
                  throws MalformedLocatorException

Will create a stream for the locator

Throws:

MalformedLocatorException

Method Detail

getContentType

public String getContentType()

Description copied from class: DataSource

Get a string that describes the content-type of the media that the source is providing.

It is an error to call getContentType if the source is not connected.

Specified by:

getContentType in class DataSource

Returns:

The name that describes the media content.

connect

public void connect()
             throws IOException

Since EncapIPStream reads from a file, connect() is simulated by starting the StreamReadingThread in EncapIPStream (calling setOpen() on stream, if one doesn't exist (signalled by open=false). This thread will wait till start() is called to start reading from a file (related to locator), and will stop reading on stop(). Disconnect() will stop the reading thread (by calling setOpen(false). Another connect() will start the thread again, meaning it'll read the file from the beginning.

Specified by:

connect in class DataSource

Throws:

IOException - Thrown if there are IO problems when connect is called.

disconnect

public void disconnect()

Description copied from class: DataSource

Close the connection to the source described by the locator.

The disconnect method frees resources used to maintain a connection to the source. If no resources are in use, disconnect is ignored. If stop hasn't already been called, calling disconnect implies a stop.

Specified by:

disconnect in class DataSource

start

public void start()
           throws IOException

Description copied from class: DataSource

Initiate data-transfer. The start method must be called before data is available. (You must call connect before calling start.)

Specified by:

start in class DataSource

Throws:

IOException - Thrown if there are IO problems with the source when start is called.

stop

public void stop()
          throws IOException

Description copied from class: DataSource

Stop the data-transfer. If the source has not been connected and started, stop does nothing.

Specified by:

stop in class DataSource

Throws:

IOException

getControls

public Object[] getControls()

Description copied from interface: Controls

Obtain the collection of objects that control the object that implements this interface.

If no controls are supported, a zero length array is returned.

Returns:

the collection of object controls

getControl

public Object getControl(String control)

Description copied from interface: Controls

Obtain the object that implements the specified Class or Interface The full class or interface name must be used.

If the control is not supported then null is returned.

Returns:

the object that implements the control, or null.

getDuration

public Time getDuration()

Description copied from interface: Duration

Get the duration of the media represented by this object. The value returned is the media's duration when played at the default rate. If the duration can't be determined (for example, the media object is presenting live video) getDuration returns DURATION_UNKNOWN.

Returns:

A Time object representing the duration or DURATION_UNKNOWN.

getStreams

public PushSourceStream[] getStreams()

Description copied from class: PushDataSource

Get the collection of streams that this source manages. The collection of streams is entirely content dependent. The ContentDescriptor of this DataSource provides the only indication of what streams can be available on this connection.

Specified by:

getStreams in class PushDataSource

Returns:

The collection of streams for this source.