com.stylusstudio.converter
Class Configuration

java.lang.Object
  com.stylusstudio.converter.Configuration

public class Configuration

extends Object

A Configuration object contains user settable policies that govern certain aspects of the conversion process.

Each ConverterFactory contains a Configuration object which can be modified by the application; any changes affect all Converter objects created subsequently from that ConverterFactory.

When the user creates a Converter object from the ConverterFactory, the Converter object gets a copy of the factory's Configuration. This copy can also be modified by the application if desired.

The Configuration object is fully Thread-safe, however if one Thread modifies a Configuration object, that may affect the behavior of another Thread's conversion which is using the same Configuration.

Field Summary

static int	ABORT Value for setBufferOverflowPolicy and setTempFilePolicy.
static int	UNLIMITED_BUFFER Value for setMaxBufferSize to indicate there should be no limit.
static int	USE_MEMORY Value for setTempFilePolicy.
static int	USE_TEMP_FILE Value for setBufferOverflowPolicy.

Constructor Summary

Method Summary

int	getBufferOverflowPolicy() Get the current value of the memory buffer overflow policy.
int	getMaxBufferSize() Get the current size limit for the memory buffer.
int	getTempFilePolicy() Get the current value of the temp file policy.
void	setBufferOverflowPolicy(int bufferOverflowPolicy) Set the memory buffer overflow policy.
void	setMaxBufferSize(int maxBufferSize) Set the maximum size limit for the memory buffer.
void	setTempFilePolicy(int tempFilePolicy) Get the temp file policy.

Methods inherited from class java.lang.Object

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

Field Detail

UNLIMITED_BUFFER

public static final int UNLIMITED_BUFFER

Value for setMaxBufferSize to indicate there should be no limit.

See Also:

Constant Field Values

ABORT

public static final int ABORT

Value for setBufferOverflowPolicy and setTempFilePolicy.

See Also:

Constant Field Values

USE_TEMP_FILE

public static final int USE_TEMP_FILE

Value for setBufferOverflowPolicy.

See Also:

Constant Field Values

USE_MEMORY

public static final int USE_MEMORY

Value for setTempFilePolicy.

See Also:

Constant Field Values

Constructor Detail

Method Detail

setMaxBufferSize

public void setMaxBufferSize(int maxBufferSize)

Set the maximum size limit for the memory buffer. The value UNLIMITED_BUFFER indicates that the memory buffer can grow without limit. Any positive value is used as the size limit for the memory buffer. The default value is 1MB.

getMaxBufferSize

public int getMaxBufferSize()

Get the current size limit for the memory buffer.

setBufferOverflowPolicy

public void setBufferOverflowPolicy(int bufferOverflowPolicy)

Set the memory buffer overflow policy. Permitted values are:

• ABORT: If the buffer overflows, abort the conversion and throw an exception
• USE_TEMP_FILE: If the buffer overflows, continue the conversion using a temp file for additional data.

The default is USE_TEMP_FILE.

getBufferOverflowPolicy

public int getBufferOverflowPolicy()

Get the current value of the memory buffer overflow policy.

setTempFilePolicy

public void setTempFilePolicy(int tempFilePolicy)

Get the temp file policy. Permitted values are:

• ABORT: If a temp file is required but cannot be created, abort the conversion and throw an exception.
• USE_MEMORY: If a temp file is required but cannot be created, use an unlimited memory buffer.

The default is ABORT.

getTempFilePolicy

public int getTempFilePolicy()

Get the current value of the temp file policy.