Java DTV API 1.3
18-Nov-2009

Package com.sun.dtv.broadcast

Access to broadcast files and streams.

See:
          Description

Interface Summary
BroadcastFileListener The BroadcastFileListener interface is implemented by application classes which require notification of changes to BroadcastFile data.
 

Class Summary
BroadcastFile The BroadcastFile class represents file or directory data obtained from broadcast file systems.
BroadcastFileEvent The BroadcastFileEvent provides notification of a change to BroadcastFile data.
BroadcastFilesystem This class represents instances of broadcast filesystems mounted into the local filesystem.
BroadcastStream The BroadcastStream class represents stream obtained from broadcast file systems.
 

Exception Summary
BroadcastException All broadcast related exceptions MUST use this subclass of java.io.IOException in order to make different reason easier to distinguish.
 

Package com.sun.dtv.broadcast Description

Access to broadcast files and streams.

Design

Description

Provides access to broadcast file and streams through APIs that work in conjunction with the java.io package. The Java DTV API models broadcast transmission as conventional read-only disk file systems with high access latencies. In order to limit access latencies to a minimum it is strongly recommended to cache all incoming broadcast files. Most interactions with the specific transport protocols are handled by the Java TV API implementation rather than the application. The BroadcastFilesystem authenticates its content as defined by the Content and Application Model. If authentication information is available for a file, the file MUST be authenticated before it is made visible via the BroadcastFile API. If authentication fails, then the file is treated as if it does not exist.

The class java.io.File represents generic files for all data, such as files and streams. Special clarifications as described in com.sun.dtv.broadcast.BroadcastFile will also apply when used directly via java.io.File.

The Java DTV API class com.sun.dtv.broadcast.BroadcastFile subclasses java.io.File to handle broadcast file access, adding the ability to:

The Java DTV API class com.sun.dtv.broadcast.BroadcastStream subclasses java.io.File to handle broadcast stream access, adding the ability to:

Applications use the conventional file input classes of the java.io package (i.e., java.io.FileInputStream, java.io.FileReader, and java.io.RandomAccessFile) to read from a BroadcastFile or BroadcastStream object.

Since:
JavaDTV1.0

Java DTV API 1.3
18-Nov-2009

Copyright © 2008-2009 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. All rights reserved.

U.S. Government Rights - Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license agreement and applicable provisions of the FAR and its supplements. Sun, Sun Microsystems, the Sun logo and Java are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries.Products covered by and information contained in this service manual are controlled by U.S. Export Control laws and may be subject to the export or import laws in other countries. Nuclear, missile, chemical biological weapons or nuclear maritime end uses or end users, whether direct or indirect, are strictly prohibited. Export or reexport to countries subject to U.S. embargo or to entities identified on U.S. export exclusion lists, including, but not limited to, the denied persons and specially designated nationals lists is strictly prohibited.

DOCUMENTATION IS PROVIDED AS IS AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.

Use of this document is subject to license terms.