com.sun.dtv.broadcast
Class BroadcastFilesystem

java.lang.Object
  com.sun.dtv.broadcast.BroadcastFilesystem

All Implemented Interfaces:

Serializable

public class BroadcastFilesystem
extends Object
implements Serializable

This class represents instances of broadcast filesystems mounted into the local filesystem. That means every service transmitting a broadcast filesystem creates its own filesystem, depending on the definition of the transport stream.

See Also:

Serialized Form

Constructor Summary

BroadcastFilesystem(Locator l)
Create and mount a broadcast filesystem defined by the given transport dependent locator.

BroadcastFilesystem(URL url)
Create and mount a broadcast filesystem defined by the given URL.

Method Summary

static BroadcastFile	getBroadcastRoot() Retrieves the system specific root mount point of all broadcast filesystems in the local filesystem.
static String	getBroadcastRootPath() Retrieves the system specific root mount point of all broadcast filesystems in the local filesystem.
BroadcastFile	getMountLocation() Retrieve the root of this mounted broadcast filesystem.
void	unmount() Unmount this broadcast filesystem from the local filesystem.

Methods inherited from class java.lang.Object

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

Constructor Detail

BroadcastFilesystem

public BroadcastFilesystem(Locator l)
                    throws IOException,
                           IllegalArgumentException

Create and mount a broadcast filesystem defined by the given transport dependent locator.

Parameters:

l - the locator of the broadcast filesystem to be mounted

Throws:

IOException - if no broadcast filesystem exists at the given location.

IllegalArgumentException - if the given locator cannot be used to identify a broadcast filesystem.

BroadcastFilesystem

public BroadcastFilesystem(URL url)
                    throws IOException,
                           IllegalArgumentException

Create and mount a broadcast filesystem defined by the given URL. The provided URL has to follow the "file:" protocol as defined in RFC1630 "Universal Resource Identifiers in WWW" and RFC1738 "Uniform Resource Locators (URL)"

Parameters:

url - the URL of the broadcast filesystem to be mounted

Throws:

IOException - if no broadcast filesystem exists at the given location

IllegalArgumentException - if the given URL can't be used to identify a broadcast filesystem

Method Detail

unmount

public void unmount()

Unmount this broadcast filesystem from the local filesystem.

getMountLocation

public BroadcastFile getMountLocation()
                               throws IOException

Retrieve the root of this mounted broadcast filesystem.

Returns:

the location of this broadcast filesystem root.

Throws:

IOException - thrown if the filesystem is unmounted.

getBroadcastRoot

public static BroadcastFile getBroadcastRoot()

Retrieves the system specific root mount point of all broadcast filesystems in the local filesystem. A list of all available broadcast filesystems (no matter if mounted or not) can be retrieved from the returned BroadcastFile.listDirectory().

Returns:

the location of the broadcast root

getBroadcastRootPath

public static String getBroadcastRootPath()

Retrieves the system specific root mount point of all broadcast filesystems in the local filesystem.

Returns:

the path of root mount point