Class FileUDTValue

  • All Implemented Interfaces:
    UDTValue, 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.
    See Also:
    Serialized Form
    • Field Detail

      • fileName

        protected final String fileName
        The name of the file this UDT stems from.
    • Constructor Detail

      • FileUDTValue

        public FileUDTValue​(String userDefinedType,
                            FileUDTValue.FileDescriptor fileDescriptor)
                     throws 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:
        IOException - If the designated file can not be read, an IOException will be thrown.
        IllegalArgumentException - If the designated file descriptor does not represent an existing file, an IllegalArgumentException will be thrown.
    • Method Detail

      • getContent

        public static byte[] getContent​(FileUDTValue.FileDescriptor fileDescriptor)
                                 throws 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:
        IOException - If the designated file can not be read, an IOException will be thrown.
        IllegalArgumentException - If the designated file descriptor does not represent an existing file, an IllegalArgumentException will be thrown.