com.sun.tv.media.protocol.component

Class DataSource

java.lang.Object

javax.media.protocol.DataSource

javax.media.protocol.PushDataSource

com.sun.tv.media.protocol.component.DataSource

All Implemented Interfaces:

Duration, Controls

public class DataSource
extends PushDataSource

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	connected
protected ContentDescriptor	contentType
protected PushSourceStream2Impl[]	sources
protected boolean	started
protected URL	url
protected URLConnection	urlConnection

Fields inherited from interface javax.media.Duration

DURATION_UNBOUNDED, DURATION_UNKNOWN

Constructor Summary

Constructors

Constructor and Description
DataSource()

Method Summary

Methods

Modifier and Type	Method and Description
void	connect() Open a connection to the source described by the MediaLocator.
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 controlType) 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

Field Detail

connected

protected boolean connected

started

protected boolean started

url

protected URL url

urlConnection

protected URLConnection urlConnection

contentType

protected ContentDescriptor contentType

sources

protected PushSourceStream2Impl[] sources

Constructor Detail

DataSource

public DataSource()

Method Detail

getStreams

public PushSourceStream[] getStreams()

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.

getContentType

public String getContentType()

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

Open a connection to the source described by the MediaLocator.

The connect method initiates communication with the source.

Specified by:

connect in class DataSource

Throws:

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

disconnect

public void disconnect()

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

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

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()

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 controlType)

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()

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.