com.intertrust.wasabi.media

Interface MediaStreamInterface

All Known Implementing Classes:

MediaStream

public interface MediaStreamInterface

A generic Marlin protected data access interface, e.g. for ebooks.

Since:

1.6

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CONTENT_TYPE_AES128CBC
static java.lang.String	CONTENT_TYPE_AES128CTR
static java.lang.String	CONTENT_TYPE_DCF Media Stream content types of interest.

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Release any resource allocated by this object.
java.lang.String	getContentType() Get Media Stream content type.
long	getSize() Get Media Stream size.
int	read(byte[] buffer) Read data from a media stream object.
int	read(byte[] buffer, int offset, int length) Read data from a media stream object.
void	seek(long position) Change the current read position.
long	tell() Get the current read position.

Field Detail

CONTENT_TYPE_DCF

static final java.lang.String CONTENT_TYPE_DCF

Media Stream content types of interest.

See Also:

Constant Field Values

CONTENT_TYPE_AES128CBC

static final java.lang.String CONTENT_TYPE_AES128CBC

See Also:

Constant Field Values

CONTENT_TYPE_AES128CTR

static final java.lang.String CONTENT_TYPE_AES128CTR

See Also:

Constant Field Values

Method Detail

read

int read(byte[] buffer)
         throws ErrorCodeException

Read data from a media stream object. This call is identical to read(buffer, 0, buffer.length).

Parameters:

buffer - the data buffer to read into.

Returns:

the number of bytes read, or -1 at the end of the stream.

Throws:

ErrorCodeException

read

int read(byte[] buffer,
       int offset,
       int length)
         throws ErrorCodeException

Read data from a media stream object. The number of bytes actually read is never more than the smaller of 'length' and the size of the buffer starting from 'offset', i.e. at most MIN(length, buffer.length-offset).

Parameters:

buffer - the data buffer to read into.

offset - the number of buffer locations to skip

length - the number of bytes to read

Returns:

the number of bytes read, or -1 at the end of the stream.

Throws:

ErrorCodeException

seek

void seek(long position)
          throws ErrorCodeException

Change the current read position.

Parameters:

position - the number of bytes from the start of the media stream.

Throws:

ErrorCodeException

tell

long tell()
          throws ErrorCodeException

Get the current read position.

Returns:

the current media stream position as the number of bytes from the start of the media stream.

Throws:

ErrorCodeException

getSize

long getSize()
             throws ErrorCodeException

Get Media Stream size.

Returns:

the size of the media stream in bytes.

Throws:

ErrorCodeException

getContentType

java.lang.String getContentType()
                                throws ErrorCodeException

Get Media Stream content type.

Returns:

the content type of the data in the media stream.

Throws:

ErrorCodeException

close

void close()

Release any resource allocated by this object. The object cannot be used after this call.