com.sun.tv.media.protocol.file

Class DataSource

java.lang.Object

javax.media.protocol.DataSource

javax.media.protocol.PullDataSource

com.sun.tv.media.protocol.file.DataSource

All Implemented Interfaces:

Duration, Controls

public class DataSource
extends PullDataSource

This class is a part of the porting layer implementation for JavaTV. This class implements a pull data source for file protocol. A new DataSource has to be provided for each new protocol.

Field Summary

Fields

Modifier and Type	Field and Description
protected long	length
protected RandomAccessFile	raf

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.
protected String	getCorrectedContentType(String contentType)
Time	getDuration() Get the duration of the media represented by this object.
PullSourceStream[]	getStreams() Get the collection of streams that this source manages.
void	setLocator(MediaLocator ml) Set the connection source for this DataSource.
void	start() Initiate data-transfer.
void	stop() Stop the data-transfer.

Methods inherited from class javax.media.protocol.DataSource

getLocator, initCheck

Methods inherited from class java.lang.Object

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

Field Detail

raf

protected RandomAccessFile raf

length

protected long length

Constructor Detail

DataSource

public DataSource()

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

Description copied from class: DataSource

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

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

setLocator

public void setLocator(MediaLocator ml)

Description copied from class: DataSource

Set the connection source for this DataSource. This method should only be called once; an error is thrown if the locator has already been set.

Overrides:

setLocator in class DataSource

Parameters:

ml - The MediaLocator that describes the media source.

getStreams

public PullSourceStream[] getStreams()

Description copied from class: PullDataSource

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

Specified by:

getStreams in class PullDataSource

Returns:

The collection of streams for this source.

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.

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

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.

getCorrectedContentType

protected String getCorrectedContentType(String contentType)