org.codice.ddf.parser.xml

Class XmlParser

java.lang.Object

org.codice.ddf.parser.xml.XmlParser

All Implemented Interfaces:

Parser

public class XmlParser
extends Object
implements Parser

XML Parser implementation, uses JAXB internally to marshal and unmarshal object.

Constructor Summary

Constructors

Constructor and Description
XmlParser()

Method Summary

Modifier and Type	Method and Description
ParserConfigurator	configureParser(List<String> contextPath, ClassLoader loader) Creates an initial configurator object to be used to facilitate the marshaling and unmarshaling processes.
void	marshal(ParserConfigurator configurator, Object obj, Node node) Converts an object graph into a Node,
void	marshal(ParserConfigurator configurator, Object obj, OutputStream os) Converts an object graph into the appropriate output format, writing it to the given stream.
<T> T	unmarshal(ParserConfigurator configurator, Class<? extends T> cls, InputStream stream) Converts a representation of an object graph into an instance of type T.
<T> T	unmarshal(ParserConfigurator configurator, Class<? extends T> cls, Node node) Converts a representation of an object graph into an instance of type T.
<T> T	unmarshal(ParserConfigurator configurator, Class<? extends T> cls, Source source) Converts a representation of an object graph into an instance of type T.

Methods inherited from class java.lang.Object

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

Constructor Detail

XmlParser

public XmlParser()

Method Detail

configureParser

public ParserConfigurator configureParser(List<String> contextPath,
                                          ClassLoader loader)

Description copied from interface: Parser

Creates an initial configurator object to be used to facilitate the marshaling and unmarshaling processes.

Specified by:

configureParser in interface Parser

Parameters:

contextPath - a list of paths that implementations can search in order to find binding information

loader - the classloader for the parser to use

Returns:

a configuration object with the specified contextPath and loader

marshal

public void marshal(ParserConfigurator configurator,
                    Object obj,
                    OutputStream os)
             throws ParserException

Description copied from interface: Parser

Converts an object graph into the appropriate output format, writing it to the given stream.

Specified by:

marshal in interface Parser

Parameters:

configurator - object containing the relevant configuration information needed to perform the conversion

obj - the root of the object graph to convert

os - the output stream on which the converted object is written

Throws:

ParserException

marshal

public void marshal(ParserConfigurator configurator,
                    Object obj,
                    Node node)
             throws ParserException

Description copied from interface: Parser

Converts an object graph into a Node,

Specified by:

marshal in interface Parser

Throws:

ParserException

unmarshal

public <T> T unmarshal(ParserConfigurator configurator,
                       Class<? extends T> cls,
                       InputStream stream)
                throws ParserException

Description copied from interface: Parser

Converts a representation of an object graph into an instance of type T.

Specified by:

unmarshal in interface Parser

Type Parameters:

T - expected return object

Parameters:

configurator - object containing the relevant configuration information needed to perform the conversion

cls - Class for the conversion

stream - input stream which is read for the object data

Returns:

an object of type T as read and converted from the stream

Throws:

ParserException

unmarshal

public <T> T unmarshal(ParserConfigurator configurator,
                       Class<? extends T> cls,
                       Node node)
                throws ParserException

Description copied from interface: Parser

Converts a representation of an object graph into an instance of type T.

Specified by:

unmarshal in interface Parser

Returns:

an object of type T as read and converted from the node

Throws:

ParserException

unmarshal

public <T> T unmarshal(ParserConfigurator configurator,
                       Class<? extends T> cls,
                       Source source)
                throws ParserException

Description copied from interface: Parser

Converts a representation of an object graph into an instance of type T.

Specified by:

unmarshal in interface Parser

Returns:

an object of type T as read and converted from the source

Throws:

ParserException