org.zkoss.util.media
Interface Media

All Known Subinterfaces:
Audio, Image
All Known Implementing Classes:
AAudio, AImage, AMedia, RepeatableMedia

public interface Media

Represents any multi-media, such as a voice, a pdf file, an excel file, an image and so on.

By implementing this interface, objects can be processed generically by servlets and many other codes.

Author:
tomyeh

Method Summary
 byte[] getByteData()
          Returns the raw data in byte array.
 java.lang.String getContentType()
          Returns the content type, e.g., "image/jpeg", or null if not available.
 java.lang.String getFormat()
          Returns the format name, e.g., "jpeg", or null if not available.
 java.lang.String getName()
          Returns the name (usually filename) of this media, or null if not available.
 java.io.Reader getReaderData()
          Returns the raw data in Reader.
 java.io.InputStream getStreamData()
          Returns the raw data in InputStream.
 java.lang.String getStringData()
          Returns the raw data in string.
 boolean inMemory()
          Returns whether the data is cached in memory (in form of byte[] or String).
 boolean isBinary()
          Returns whether the format of this content is binary or text-based.
 

Method Detail

isBinary

boolean isBinary()
Returns whether the format of this content is binary or text-based. If true, use getByteData() or getStreamData() to retrieve its content. If false, use getStringData() or getReaderData() to retrieve its content.

See Also:
getStringData(), getByteData(), getReaderData(), getStreamData()

inMemory

boolean inMemory()
Returns whether the data is cached in memory (in form of byte[] or String).

See Also:
getStringData(), getByteData(), getReaderData(), getStreamData()

getByteData

byte[] getByteData()
Returns the raw data in byte array.

It might not be a copy, so don't modify it directly unless you know what you are doing.

If the data is not cached in memory (inMemory() return false), the data will be read from getStreamData(). Furthermore, it also implies you can not invoke this method again.

Throws:
java.lang.IllegalStateException - if isBinary() returns false
See Also:
getStringData()

getStringData

java.lang.String getStringData()
Returns the raw data in string.

If the data is not cached in memory (inMemory() return false), the data will be read from getReaderData(). Furthermore, it also implies you can not invoke this method again.

Throws:
java.lang.IllegalStateException - if isBinary() returns false
See Also:
getByteData()

getStreamData

java.io.InputStream getStreamData()
Returns the raw data in InputStream.

Note: it wraps getByteData() with ByteArrayInputStream if it is in memory (inMemory() returns true).

Throws:
java.lang.IllegalStateException - if isBinary() returns false.
See Also:
getReaderData()

getReaderData

java.io.Reader getReaderData()
Returns the raw data in Reader.

Note: it wraps getStringData() with StringReader, if it is in memory (inMemory() returns true).

Throws:
java.lang.IllegalStateException - if isBinary() returns true.
See Also:
getStreamData()

getName

java.lang.String getName()
Returns the name (usually filename) of this media, or null if not available.


getFormat

java.lang.String getFormat()
Returns the format name, e.g., "jpeg", or null if not available.

See Also:
getContentType()

getContentType

java.lang.String getContentType()
Returns the content type, e.g., "image/jpeg", or null if not available.

See Also:
getFormat()


Copyright © 2005-2011 Potix Corporation. All Rights Reserved. SourceForge.net Logo