JSR-043: JTAPI-1.4

Package javax.telephony.media.container

Defines the Media ContainerService and Media DataObject interfaces for the media package.

See:
          Description

Interface Summary
ContainerConstants Constants common to all the Container interfaces.
ContainerEvent Defines methods for ContainerService events.
ContainerProvider Provider interface to get a ContainerService.
ContainerService Methods for manipulating Containers.
DataObject An open Media Data Object, as returned by ContainerService.openDataObject().
DataObjectEvent Defines methods for DataObject events.
 

Exception Summary
ContainerException Thrown when a ContainerService method fails for various reasons.
 

Package javax.telephony.media.container Description

Defines the Media ContainerService and Media DataObject interfaces for the media package.

Package Overview

The ContainerProvider is an optional interface that may be implemented by a MediaProvider.

Overview

The Container Management API provides an operating system independent mechanism for the storage and interchange of system data. A Container is an object logically residing in the file system of a CT Server and containing zero or more Data Objects. Data Objects are made up of data and a set of attributes describing the properties of the data.

Why Use Containers?

The API uses containers, rather than simply specifying pathnames in either the client or server operating systems, so that the server can augment the normal features found in OS file systems with the features required by Resources to manipulate media data in a convenient manner. For example, a directory on the server containing a .WAV file may be manipulated more conveniently by using the Container API that treats it as a a Container with a Media Data Object (or possibly a collection of such objects) with appropriate coder, data rate, and other parameters defined for it.

In many ways Containers and Data Objects are analogous to file systems and their files. The primary difference is that the Container interface is independent of the actual storage strategies employed. That is, it is independent of the storage medium, and of the data type, formatting and organization.

Using Containers

The working methods for this package are in the ContainerService interface. A ContainerService object is obtained from the ContainerProvider/MediaProvider.

A ContainerProvider object is obtained by checking instanceof and then casting the MediaProvider to a ContainerProvider.
For example:

    MediaProvider mp = ...;
    ContainerService cs = null;
    if (mp instanceof ContainerProvider) 
       cs = ((ContainerProvider)mp).getContainerService();
    ...

Most of the interesting methods are defined in ContainerService and DataObject.

Since:
JTAPI-1.4

JSR-043: JTAPI-1.4

Send comments to: JSR-43@ectf.org