sk.baka.ambient.collection.file
Class AbstractAudio

java.lang.Object
  sk.baka.ambient.collection.file.AbstractAudio

Direct Known Subclasses:

FileAudio, MediaStoreAudio, URLAudio

public abstract class AbstractAudio
extends java.lang.Object

Contains information about an audio file.

Author:

Martin Vysny

Constructor Summary

protected

AbstractAudio(java.lang.String uri) Creates new audio object instance.

Method Summary

abstract boolean	exists() Checks if the file denoted by this object exists.
static AbstractAudio	fromUri(java.lang.String fileUri) Returns the audio object instance from a file denoted by given URI.
java.lang.String	getLocation() Returns location of the audio file.
abstract java.lang.String	getMimeType() Returns the file MIME type.
abstract long	getSize() Returns file size, in bytes.
abstract boolean	isReadable() Checks if the file denoted by this object is playable (i.e.
abstract java.io.InputStream	openInputStream() Reads the file contents.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractAudio

protected AbstractAudio(java.lang.String uri)

Creates new audio object instance.

Parameters:

uri - the URI

Method Detail

getLocation

public final java.lang.String getLocation()

Returns location of the audio file.

Returns:

the location URI

exists

public abstract boolean exists()

Checks if the file denoted by this object exists.

Returns:

true if the file exists, false otherwise.

isReadable

public abstract boolean isReadable()

Checks if the file denoted by this object is playable (i.e. user has rights to read the file, the file is playable etc).

Returns:

true if the file is readable, false otherwise.

openInputStream

public abstract java.io.InputStream openInputStream()
                                             throws java.io.IOException

Reads the file contents.

Returns:

input stream instance, never null.

Throws:

java.io.IOException - if i/o error occurs.

getMimeType

public abstract java.lang.String getMimeType()

Returns the file MIME type.

Returns:

MIME type, never null.

getSize

public abstract long getSize()

Returns file size, in bytes.

Returns:

the file size.

fromUri

public static AbstractAudio fromUri(java.lang.String fileUri)

Returns the audio object instance from a file denoted by given URI.

Parameters:

fileUri - the URI

Returns:

audio instance.