org.apache.daffodil.japi

Class DataProcessor

java.lang.Object

org.apache.daffodil.japi.WithDiagnostics

org.apache.daffodil.japi.DataProcessor

All Implemented Interfaces:

java.io.Serializable

public class DataProcessor
extends WithDiagnostics
implements scala.Serializable

Compiled version of a DFDL Schema, used to parse data and get the DFDL infoset

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
DataProcessor(org.apache.daffodil.runtime1.processors.DataProcessor dp)

Method Summary

Modifier and Type	Method and Description
DaffodilUnparseContentHandler	newContentHandlerInstance(java.nio.channels.WritableByteChannel output) Obtain a new DaffodilUnparseContentHandler from the current DataProcessor.
DaffodilParseXMLReader	newXMLReaderInstance() Obtain a new DaffodilParseXMLReader from the current DataProcessor.
ParseResult	parse(InputSourceDataInputStream input, InfosetOutputter output) Parse input data from an InputSourceDataInputStream and output the infoset to an InfosetOutputter
void	save(java.nio.channels.WritableByteChannel output) Save the DataProcessor
UnparseResult	unparse(InfosetInputter input, java.nio.channels.WritableByteChannel output) Unparse an InfosetInputter
void	walkMetadata(org.apache.daffodil.runtime1.api.MetadataHandler handler) Walks the handler over the runtime Metadata structures.
DataProcessor	withDebugger(org.apache.daffodil.runtime1.debugger.Debugger dbg) Obtain a new DataProcessor with a specified debugger.
DataProcessor	withDebuggerRunner(DebuggerRunner dr) Obtain a new DataProcessor with a specified debugger runner.
DataProcessor	withDebugging(boolean flag) Obtain a new DataProcessor instance with debugging enabled or disabled.
DataProcessor	withExternalVariables(java.util.AbstractMap<java.lang.String,java.lang.String> extVars) Obtain a new DataProcessor with multiple DFDL variables set.
DataProcessor	withExternalVariables(java.io.File extVars) Obtain a new DataProcessor with external variables read from a Daffodil configuration file
DataProcessor	withValidationMode(ValidationMode mode) Obtain a new DataProcessor having a specific validation mode
DataProcessor	withValidator(org.apache.daffodil.lib.api.Validator validator) Obtain a new DataProcessor having a specific validator

Methods inherited from class org.apache.daffodil.japi.WithDiagnostics

getDiagnostics, isError

Methods inherited from class java.lang.Object

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

Constructor Detail

DataProcessor

public DataProcessor(org.apache.daffodil.runtime1.processors.DataProcessor dp)

Method Detail

newContentHandlerInstance

public DaffodilUnparseContentHandler newContentHandlerInstance(java.nio.channels.WritableByteChannel output)

Obtain a new DaffodilUnparseContentHandler from the current DataProcessor.

Parameters:

output - (undocumented)

Returns:

(undocumented)

newXMLReaderInstance

public DaffodilParseXMLReader newXMLReaderInstance()

Obtain a new DaffodilParseXMLReader from the current DataProcessor.

Returns:

(undocumented)

parse

public ParseResult parse(InputSourceDataInputStream input,
                         InfosetOutputter output)

Parse input data from an InputSourceDataInputStream and output the infoset to an InfosetOutputter

Parameters:

input - data to be parsed

output - the InfosetOutputter that will be used to output the infoset

Returns:

an object which contains the result, and/or diagnostic information.

save

public void save(java.nio.channels.WritableByteChannel output)

Save the DataProcessor

The resulting output can be reloaded by Compiler.reload(java.nio.channels.ReadableByteChannel). Note that external variable bindings are not saved, and will not be restored upon reloading.

Parameters:

output - the byte channel to write the DataProcessor to

unparse

public UnparseResult unparse(InfosetInputter input,
                             java.nio.channels.WritableByteChannel output)

Unparse an InfosetInputter

Parameters:

input - the infoset inputter to use for unparsing

output - the byte channel to write the data to

Returns:

an object with contains diagnostic information

walkMetadata

public void walkMetadata(org.apache.daffodil.runtime1.api.MetadataHandler handler)

Walks the handler over the runtime Metadata structures. These provide information about name, namespace, type, simple/complex, etc.

This is used to interface Daffodil runtime1 metadata to the metadata structures of other software systems.

See MetadataHandler for more motivating materials about runtime1 metadata walking.

Parameters:

handler - - the handler is called-back during the walk as each metadata structure is encountered.

withDebugger

public DataProcessor withDebugger(org.apache.daffodil.runtime1.debugger.Debugger dbg)

Obtain a new DataProcessor with a specified debugger.

Parameters:

dbg - debugger

Returns:

(undocumented)

withDebuggerRunner

public DataProcessor withDebuggerRunner(DebuggerRunner dr)

Obtain a new DataProcessor with a specified debugger runner.

Parameters:

dr - debugger runner

Returns:

(undocumented)

withDebugging

public DataProcessor withDebugging(boolean flag)

Obtain a new DataProcessor instance with debugging enabled or disabled.

Before enabling, withDebugger(Debugger) or withDebuggerRunner(DebuggerRunner) must be called to obtain a DataProcessor with a non-null debugger.

Parameters:

flag - true to enable debugging, false to disabled

Returns:

(undocumented)

withExternalVariables

public DataProcessor withExternalVariables(java.io.File extVars)
                                    throws ExternalVariableException

Obtain a new DataProcessor with external variables read from a Daffodil configuration file

Parameters:

extVars - file to read DFDL variables from.

Returns:

(undocumented)

Throws:

ExternalVariableException - if an error occurs while setting an external variable

See Also:

Daffodil Configuration File - Daffodil configuration file format

withExternalVariables

public DataProcessor withExternalVariables(java.util.AbstractMap<java.lang.String,java.lang.String> extVars)
                                    throws ExternalVariableException

Obtain a new DataProcessor with multiple DFDL variables set.

Parameters:

extVars - a map of key/value pairs, where the key is the variable name, and the value is the value of the variable. The key may be preceded by a string of the form "{namespace}" to define a namespace for the variable. If preceded with "{}", then no namespace is used. If not preceded by anything, then Daffodil will figure out the namespace.

Returns:

(undocumented)

Throws:

ExternalVariableException - if an error occurs while setting an external variable

withValidationMode

public DataProcessor withValidationMode(ValidationMode mode)
                                 throws InvalidUsageException

Obtain a new DataProcessor having a specific validation mode

Parameters:

mode - mode to control validation

Returns:

(undocumented)

Throws:

InvalidUsageException - if mode is not a valid ValidateMode value

withValidator

public DataProcessor withValidator(org.apache.daffodil.lib.api.Validator validator)

Obtain a new DataProcessor having a specific validator

Parameters:

validator - validator instance

Returns:

(undocumented)