Module io.xlate.staedi
Package io.xlate.edi.stream

Class EDIInputFactory

    • Field Detail

      • EDI_VALIDATE_CONTROL_CODE_VALUES

        public static final String EDI_VALIDATE_CONTROL_CODE_VALUES
        When set to false, enumerated code values of control structure elements will be ignore. Element size and type validation will still occur.
        See Also:
        Constant Field Values

      • XML_DECLARE_TRANSACTION_XMLNS

        public static final String XML_DECLARE_TRANSACTION_XMLNS
        When set to true, XMLStreamReader instances created from an EDIInputFactory will generate XMLNS attributes on the TRANSACTION element in addition to the INTERCHANGE element.
        See Also:
        Constant Field Values

    • Constructor Detail

      • EDIInputFactory

        public EDIInputFactory()

    • Method Detail

      • newFactory

        public static EDIInputFactory newFactory()
        Create a new instance of the factory. This static method creates a new factory instance. Once an application has obtained a reference to an EDIInputFactory it can use the factory to configure and obtain stream instances.
        Returns:
        the factory implementation

      • createEDIStreamReader

        public abstract EDIStreamReader createEDIStreamReader​(InputStream stream,
                                                      Schema schema)
        Creates a new EDIStreamReader using the given InputStream (with default encoding) which uses the Schema for validation of the input's control structures (interchange, group, transaction). Note that a separate schema for validation of messages/transactions may be passed directly to the EDIStreamReader once the type and version of the messages is known.
        Parameters:
        stream - InputStream from which the EDI data will be read
        schema - Schema for control structure validation
        Returns:
        a new EDIStreamReader which reads from the stream

      • createEDIStreamReader

        public abstract EDIStreamReader createEDIStreamReader​(InputStream stream,
                                                      String encoding,
                                                      Schema schema)
                                               throws EDIStreamException
        Creates a new EDIStreamReader using the given InputStream and encoding which uses the Schema for validation of the input's control structures (interchange, group, transaction). The encoding must be a valid Charset. Note that a separate schema for validation of messages/transactions may be passed directly to the EDIStreamReader once the type and version of the messages is known.
        Parameters:
        stream - InputStream from which the EDI data will be read
        encoding - character encoding of the stream, must be a valid Charset.
        schema - Schema for control structure validation
        Returns:
        a new EDIStreamReader which reads from the stream
        Throws:
        EDIStreamException - when encoding is not supported

      • createXMLStreamReader

        public abstract XMLStreamReader createXMLStreamReader​(EDIStreamReader reader)
                                               throws XMLStreamException
        Creates a new XMLStreamReader that uses the given reader as its data source. The reader should be positioned before the start of an interchange or at the start of an interchange. XML generated by the XMLStreamReader consist exclusively of elements in the namespaces declared by the constants in EDINamespaces. The names of the elements will be as follows:
        EDI Event Namespace Cross Reference
        Event Element Local Name Element Namespace
        Start/End of interchange INTERCHANGE EDINamespaces.LOOPS
        Start/End of functional group GROUP EDINamespaces.LOOPS
        Start/End of message/transaction TRANSACTION EDINamespaces.LOOPS
        Start/End of loop Loop code from EDI schema EDINamespaces.LOOPS
        Start/End of segment Segment tag from EDI data EDINamespaces.SEGMENTS
        Start/End of composite Segment tag plus two digit element position from EDI data EDINamespaces.COMPOSITES
        Start/End of simple element Segment tag plus two digit element position from EDI data EDINamespaces.ELEMENTS
        Start/End of component element in a composite Segment tag plus two digit element position from EDI data plus hyphen plus two digit component position EDINamespaces.ELEMENTS
        Errors encountered in the EDI data will result in an XMLStreamException with a message describing the error.
        Parameters:
        reader - the reader to wrap
        Returns:
        a new XMLStreamReader
        Throws:
        XMLStreamException - when the reader encounters an error in creation
        See Also:
        EDINamespaces

      • getEDIReporter

        public abstract EDIReporter getEDIReporter()
        Retrieves the reporter that will be set on any EDIStreamReader created by this factory instance.
        Returns:
        the reporter that will be set on any EDIStreamReader created by this factory instance
        Since:
        1.4

      • setEDIReporter

        public abstract void setEDIReporter​(EDIReporter reporter)
        The reporter that will be set on any EDIStreamReader created by this factory instance. NOTE: When using an EDIReporter, errors found in the data stream that are reported to the reporter will not appear in the stream of events returned by the EDIStreamReader.
        Parameters:
        reporter - the resolver to use to report non fatal errors
        Since:
        1.4