com.lf.commons.io.ds

Class ImageDataSource

java.lang.Object

com.lf.commons.io.AbstractDataSource

com.lf.commons.io.ds.ImageDataSource

All Implemented Interfaces:

ConfigurableUnit, javax.activation.DataSource

public class ImageDataSource
extends AbstractDataSource
implements ConfigurableUnit

Data source implementation representing images.

Since:

1.6

Version:

$Revision: 1.13 $, $Date: 2016/01/01 15:43:02 $

Author:

Axel Schwolow

Field Summary

Fields

Modifier and Type	Field and Description
protected java.awt.image.BufferedImage	image The managed content.
protected ApplicationModel	model The application model.
static java.lang.String	PROP_RESOLUTION Represents a format specific property (String).
static java.lang.String	PROP_TRANSPARENCY Represents a format specific property (String).
static java.lang.String	PROP_TYPE Represents a format specific property (String).

Fields inherited from class com.lf.commons.io.AbstractDataSource

action, ACTION_FILE_EDIT, ACTION_FILE_HEXEDIT, ACTION_FILE_OPEN, ACTION_UNKNOWN, ACTION_URL_EDIT, ACTION_URL_HEXEDIT, ACTION_URL_OPEN, date, encoding, formatProps, name, path, size, type

Constructor Summary

Constructors

Constructor and Description
ImageDataSource() Constructor method for i18n purposes only.
ImageDataSource(java.lang.String name, java.lang.String path, java.util.Date date, java.awt.image.BufferedImage image, java.lang.String type, int action) Init functionality.
ImageDataSource(java.lang.String name, java.lang.String path, java.util.Date date, javax.swing.ImageIcon icon, java.lang.String type, int action) Init functionality.

Method Summary

Methods

Modifier and Type	Method and Description
void	configureUnit(java.lang.String id, Configuration config) Restores values from persistent data stores.
void	finish(java.io.OutputStream ostream) After the data has been written to the output stream it is flushed, closed and updated here.
java.lang.String	getDisplayName() Provides the data source display name.
OrderedHashtable<java.lang.String,java.lang.String>	getFormatProperties() Provides the format specific properties presented by the AbstractViewer class.
javax.swing.Icon	getIcon() Provides the data source specific icon (optional).
java.awt.image.BufferedImage	getImage() Provides a BufferedImage object.
java.io.InputStream	getInputStream() This method returns an InputStream representing the data and throws the appropriate exception if it can not do so.
java.io.OutputStream	getOutputStream() This method returns an OutputStream where the data can be written and throws the appropriate exception if it can not do so Note that a new OutputStream object must be returned each time this method is called, and the stream must be positioned at the location the data is to be written.
static void	populateFormatProperties(java.awt.image.BufferedImage image, OrderedHashtable<java.lang.String,java.lang.String> cache) Extracts the format properties from the given image.
void	storeUnit(java.lang.String id, Configuration config) Stores the current configuration values persistently.
void	unitRegistered(ApplicationModel model, java.lang.String id) Informs the configurable unit that it was registered with a model.
void	unitUnregistered(ApplicationModel model, java.lang.String id) Informs the configurable unit that it was unregistered with a model.

Methods inherited from class com.lf.commons.io.AbstractDataSource

finalize, getAction, getContentType, getDate, getDisplayAction, getEncoding, getName, getPath, getSize, loadTemporaryFile, setAction, setContentType, setDate, setEncoding, setFormatProperty, setName, setPath, setSize, storeTemporaryFile

Methods inherited from class java.lang.Object

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

Field Detail

PROP_RESOLUTION

public static final java.lang.String PROP_RESOLUTION

Represents a format specific property (String).

PROP_TYPE

public static final java.lang.String PROP_TYPE

Represents a format specific property (String).

PROP_TRANSPARENCY

public static final java.lang.String PROP_TRANSPARENCY

Represents a format specific property (String).

image

protected java.awt.image.BufferedImage image

The managed content.

model

protected ApplicationModel model

The application model.

Constructor Detail

ImageDataSource

public ImageDataSource()

Constructor method for i18n purposes only.

Since:

1.6

ImageDataSource

public ImageDataSource(java.lang.String name,
               java.lang.String path,
               java.util.Date date,
               java.awt.image.BufferedImage image,
               java.lang.String type,
               int action)

Init functionality.

Parameters:

name - The name of the represented data portion (optional)

path - The path of this object (optional)

date - The date of this object (optional)

image - The managed content

type - The MIME type (optional)

action - The load action AbstractDataSource.FILE_OPEN, ...

Throws:

java.lang.NullPointerException - If a parameter is null

Since:

1.6

ImageDataSource

public ImageDataSource(java.lang.String name,
               java.lang.String path,
               java.util.Date date,
               javax.swing.ImageIcon icon,
               java.lang.String type,
               int action)

Init functionality.

Parameters:

name - The name of the represented data portion (optional)

path - The path of this object (optional)

date - The date of this object (optional)

icon - The managed content

type - The MIME type (optional)

action - The load action AbstractDataSource.FILE_OPEN, ...

Throws:

java.lang.NullPointerException - If a parameter is null

Since:

1.6

Method Detail

getInputStream

public java.io.InputStream getInputStream()
                                   throws java.io.IOException

This method returns an InputStream representing the data and throws the appropriate exception if it can not do so.

Note that a new InputStream object must be returned each time this method is called, and the stream must be positioned at the beginning of the data.

Specified by:

getInputStream in interface javax.activation.DataSource

Specified by:

getInputStream in class AbstractDataSource

Returns:

An input stream

Throws:

java.io.IOException - If an error occurred

java.lang.NullPointerException - If the loaded content is null

Since:

1.6

getOutputStream

public java.io.OutputStream getOutputStream()
                                     throws java.io.IOException

This method returns an OutputStream where the data can be written and throws the appropriate exception if it can not do so

Note that a new OutputStream object must be returned each time this method is called, and the stream must be positioned at the location the data is to be written.

Specified by:

getOutputStream in interface javax.activation.DataSource

Specified by:

getOutputStream in class AbstractDataSource

Returns:

An output stream

Throws:

java.io.IOException - If an error occurred

Since:

1.6

finish

public void finish(java.io.OutputStream ostream)
            throws java.io.IOException

After the data has been written to the output stream it is flushed, closed and updated here.

Specified by:

finish in class AbstractDataSource

Parameters:

ostream - An output stream

Throws:

java.io.IOException - If an error occurred

Since:

1.6

getFormatProperties

public OrderedHashtable<java.lang.String,java.lang.String> getFormatProperties()

Provides the format specific properties presented by the AbstractViewer class.

Overrides:

getFormatProperties in class AbstractDataSource

Returns:

The container, may be null or empty

Since:

1.6

populateFormatProperties

public static void populateFormatProperties(java.awt.image.BufferedImage image,
                            OrderedHashtable<java.lang.String,java.lang.String> cache)

Extracts the format properties from the given image.

Parameters:

image - The image, may be null

cache - The container

Since:

1.6

getImage

public java.awt.image.BufferedImage getImage()

Provides a BufferedImage object.

Returns:

An image, may be null

Since:

1.6

getIcon

public javax.swing.Icon getIcon()

Provides the data source specific icon (optional).

Specified by:

getIcon in class AbstractDataSource

Returns:

An icon, may be null

Since:

1.6

configureUnit

public void configureUnit(java.lang.String id,
                 Configuration config)

Restores values from persistent data stores.

Specified by:

configureUnit in interface ConfigurableUnit

Overrides:

configureUnit in class AbstractDataSource

Parameters:

id - The unique identifier for the instance

config - The configuration

Since:

1.6

storeUnit

public void storeUnit(java.lang.String id,
             Configuration config)

Stores the current configuration values persistently.

Specified by:

storeUnit in interface ConfigurableUnit

Overrides:

storeUnit in class AbstractDataSource

Parameters:

id - The unique identifier for the instance

config - The configuration

Since:

1.6

unitRegistered

public void unitRegistered(ApplicationModel model,
                  java.lang.String id)

Informs the configurable unit that it was registered with a model.

Specified by:

unitRegistered in interface ConfigurableUnit

Parameters:

model - The application model

id - The unique identifier for the instance

Since:

1.6

unitUnregistered

public void unitUnregistered(ApplicationModel model,
                    java.lang.String id)

Informs the configurable unit that it was unregistered with a model.

Specified by:

unitUnregistered in interface ConfigurableUnit

Parameters:

model - The application model

id - The unique identifier for the instance

Since:

1.6

getDisplayName

public java.lang.String getDisplayName()

Provides the data source display name.

Specified by:

getDisplayName in class AbstractDataSource

Returns:

Name, may be null

Since:

1.6