de.aristaflow.adept2.model.datamanagement

Class FileUDTValue

java.lang.Object

de.aristaflow.adept2.model.datamanagement.ADEPT2UDTValue

de.aristaflow.adept2.model.datamanagement.FileUDTValue

All Implemented Interfaces:

UDTValue, java.io.Serializable

public class FileUDTValue
extends ADEPT2UDTValue

A FileUDTValue extends a UDTValue by file support. A file may be specified via a FileUDTValue.FileDescriptor of which the content is read and stored in this UDTValue. Please note that this is only used for input parameters since all file information is lost as soon as the UDTValue is stored. This is intended since only the value is relevant in a process context, not where it stems from.

Author:

Ulrich Kreher

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FileUDTValue.FileDescriptor Represents a file by its name as well as an optional charset which is used to decode the bytes read from the file.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.String	fileName The name of the file this UDT stems from.

Fields inherited from class de.aristaflow.adept2.model.datamanagement.ADEPT2UDTValue

stream, userDefinedTypeName, value

Constructor Summary

Constructors

Constructor and Description
FileUDTValue(java.lang.String userDefinedType, FileUDTValue.FileDescriptor fileDescriptor) Creates a new FileUDTValue with the designated user-defined type name and the input of the file represented by the designated file descriptor.

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object obj)
protected static byte[]	getContent(FileUDTValue.FileDescriptor fileDescriptor) Reads the contents of the file represented by the designated file descriptor.
int	hashCode()
java.lang.String	toString()

Methods inherited from class de.aristaflow.adept2.model.datamanagement.ADEPT2UDTValue

finalize, getUserDefinedType, getValueAsArray, getValueAsStream, readStream

Methods inherited from class java.lang.Object

clone, getClass, notify, notifyAll, wait, wait, wait

Field Detail

fileName

protected final java.lang.String fileName

The name of the file this UDT stems from.

Constructor Detail

FileUDTValue

public FileUDTValue(java.lang.String userDefinedType,
                    FileUDTValue.FileDescriptor fileDescriptor)
             throws java.io.IOException

Creates a new FileUDTValue with the designated user-defined type name and the input of the file represented by the designated file descriptor.

Parameters:

userDefinedType - The name of the user-defined type of the value. the name of the user defined type

fileDescriptor - The file descriptor representing a file containing the content for the UDTValue and the corresponding character set.

Throws:

java.io.IOException - If the designated file can not be read, an IOException will be thrown.

java.lang.IllegalArgumentException - If the designated file descriptor does not represent an existing file, an IllegalArgumentException will be thrown.

Method Detail

getContent

protected static byte[] getContent(FileUDTValue.FileDescriptor fileDescriptor)
                            throws java.io.IOException

Reads the contents of the file represented by the designated file descriptor. In case of a character file the read bytes are decoded according to the character set of the file descriptor and stored as UTF-8. Additionally, line breaks are replaced by \n.

Parameters:

fileDescriptor - The file descriptor representing a file of which the content is to be read.

Returns:

The content of the file specified by the designated file descriptor.

Throws:

java.io.IOException - If the designated file can not be read, an IOException will be thrown.

java.lang.IllegalArgumentException - If the designated file descriptor does not represent an existing file, an IllegalArgumentException will be thrown.

toString

public java.lang.String toString()

Overrides:

toString in class ADEPT2UDTValue

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class ADEPT2UDTValue

hashCode

public int hashCode()

Overrides:

hashCode in class ADEPT2UDTValue