com.lf.commons.io.ds

Class TextDataSource

java.lang.Object

com.lf.commons.io.AbstractDataSource

com.lf.commons.io.ds.TextDataSource

All Implemented Interfaces:

ConfigurableUnit, javax.activation.DataSource

public class TextDataSource
extends AbstractDataSource
implements ConfigurableUnit

Data source implementation representing simple texts.

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.util.Locale	locale639_1 The locale like "en_US".
protected Locale	locale639_2 The locale like "ger_DE".
protected ApplicationModel	model The application model.
static java.lang.String	PROP_LOCALE_639_1 Represents a format specific property (java.util.Locale).
static java.lang.String	PROP_LOCALE_639_2 Represents a format specific property (com.lf.commons.i18n.Locale).
protected char[]	textdata The managed content.

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
TextDataSource() Constructor method for i18n purposes only.
TextDataSource(java.lang.String name, java.lang.String path, java.util.Date date, java.lang.String type, char[] textdata, java.lang.String encoding, java.util.Locale locale_639_1, Locale locale_639_2, int action) Init functionality.
TextDataSource(java.lang.String name, java.lang.String path, java.util.Date date, java.lang.String type, java.io.File textfile, java.lang.String encoding, java.util.Locale locale_639_1, Locale locale_639_2, 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.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.
char[]	getTextData() Provides an array with text data.
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_LOCALE_639_1

public static final java.lang.String PROP_LOCALE_639_1

Represents a format specific property (java.util.Locale).

PROP_LOCALE_639_2

public static final java.lang.String PROP_LOCALE_639_2

Represents a format specific property (com.lf.commons.i18n.Locale).

textdata

protected char[] textdata

The managed content.

locale639_1

protected java.util.Locale locale639_1

The locale like "en_US".

locale639_2

protected Locale locale639_2

The locale like "ger_DE".

model

protected ApplicationModel model

The application model.

Constructor Detail

TextDataSource

public TextDataSource()

Constructor method for i18n purposes only.

Since:

1.6

TextDataSource

public TextDataSource(java.lang.String name,
              java.lang.String path,
              java.util.Date date,
              java.lang.String type,
              char[] textdata,
              java.lang.String encoding,
              java.util.Locale locale_639_1,
              Locale locale_639_2,
              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)

type - The MIME type (default is "text/plain", optional)

textdata - The managed content

encoding - The encoding (optional)

locale_639_1 - The locale like "en_US" (optional)

locale_639_2 - The locale like "ger_DE" (optional)

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

Throws:

java.lang.NullPointerException - If a parameter is null

Since:

1.6

TextDataSource

public TextDataSource(java.lang.String name,
              java.lang.String path,
              java.util.Date date,
              java.lang.String type,
              java.io.File textfile,
              java.lang.String encoding,
              java.util.Locale locale_639_1,
              Locale locale_639_2,
              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)

type - The MIME type (default is "text/plain", optional)

textfile - The managed content, loaded here

encoding - The encoding (optional)

locale_639_1 - The locale like "en_US" (optional)

locale_639_2 - The locale like "ger_DE" (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

getTextData

public char[] getTextData()

Provides an array with text data.

Returns:

A raw text array, 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