org.apache.juneau.xml

Class XmlParser

java.lang.Object

org.apache.juneau.Context

org.apache.juneau.BeanContext

org.apache.juneau.parser.Parser

org.apache.juneau.parser.ReaderParser

org.apache.juneau.xml.XmlParser

Direct Known Subclasses:

HtmlParser

public class XmlParser
extends ReaderParser

Parses text generated by the XmlSerializer class back into a POJO model.

Media types

Handles Content-Type types: text/xml

Description

See the XmlSerializer class for a description of Juneau-generated XML.

Field Summary

Fields

Modifier and Type	Field and Description
static XmlParser	DEFAULT Default parser, all default settings.
static String	XML_eventAllocator Configuration property: XML event allocator.
static String	XML_preserveRootElement Configuration property: Preserve root element during generalized parsing.
static String	XML_reporter Configuration property: XML reporter.
static String	XML_resolver Configuration property: XML resolver.
static String	XML_validating Configuration property: Enable validation.

Fields inherited from class org.apache.juneau.parser.Parser

PARSER_autoCloseStreams, PARSER_fileCharset, PARSER_inputStreamCharset, PARSER_listener, PARSER_strict, PARSER_trimStrings, PARSER_unbuffered

Fields inherited from class org.apache.juneau.BeanContext

BEAN_beanClassVisibility, BEAN_beanConstructorVisibility, BEAN_beanDictionary, BEAN_beanDictionary_add, BEAN_beanDictionary_remove, BEAN_beanFieldVisibility, BEAN_beanFilters, BEAN_beanFilters_add, BEAN_beanFilters_remove, BEAN_beanMapPutReturnsOldValue, BEAN_beanMethodVisibility, BEAN_beansRequireDefaultConstructor, BEAN_beansRequireSerializable, BEAN_beansRequireSettersForGetters, BEAN_beansRequireSomeProperties, BEAN_beanTypePropertyName, BEAN_debug, BEAN_excludeProperties, BEAN_ignoreInvocationExceptionsOnGetters, BEAN_ignoreInvocationExceptionsOnSetters, BEAN_ignorePropertiesWithoutSetters, BEAN_ignoreUnknownBeanProperties, BEAN_ignoreUnknownNullBeanProperties, BEAN_implClasses, BEAN_includeProperties, BEAN_locale, BEAN_mediaType, BEAN_notBeanClasses, BEAN_notBeanClasses_add, BEAN_notBeanClasses_remove, BEAN_notBeanPackages, BEAN_notBeanPackages_add, BEAN_notBeanPackages_remove, BEAN_pojoSwaps, BEAN_pojoSwaps_add, BEAN_pojoSwaps_remove, BEAN_propertyNamer, BEAN_sortProperties, BEAN_timeZone, BEAN_useInterfaceProxies, BEAN_useJavaBeanIntrospector, DEFAULT_SORTED

Constructor Summary

Constructors

Constructor and Description
XmlParser(PropertyStore ps) Constructor.
XmlParser(PropertyStore ps, String... consumes) Constructor.

Method Summary

Modifier and Type	Method and Description
ObjectMap	asMap() Returns the properties defined on this bean context as a simple map for debugging purposes.
XmlParserBuilder	builder() Creates a builder from this context object.
static XmlParserBuilder	create() Instantiates a new clean-slate XmlParserBuilder object.
ReaderParserSession	createSession(ParserSessionArgs args) Create the session object that will be passed in to the parse method.

Methods inherited from class org.apache.juneau.parser.ReaderParser

isReaderParser

Methods inherited from class org.apache.juneau.parser.Parser

createDefaultSessionArgs, createSession, getMediaTypes, getPrimaryMediaType, parse, parse, parse, parseArgs, parseIntoCollection, parseIntoMap

Methods inherited from class org.apache.juneau.BeanContext

_class, createBeanSession, createBeanSession, createDefaultBeanSessionArgs, createSession, createSession, dumpCacheStats, getBeanMeta, getBeanRegistry, getBeanTypePropertyName, getClassMeta, getClassMeta, getClassMetaForObject, getExcludeProperties, getImplClassConstructor, getIncludeProperties, hasSameCache, isBean, isNotABean, newInstance, newInstance, newInstanceFromOuter, object, resolveClassMeta, string

Methods inherited from class org.apache.juneau.Context

equals, getArrayProperty, getArrayProperty, getBooleanProperty, getClassArrayProperty, getClassArrayProperty, getClassArrayProperty, getClassListProperty, getClassListProperty, getClassMapProperty, getClassMapProperty, getClassProperty, getClassSetProperty, getClassSetProperty, getInstanceArrayProperty, getInstanceArrayProperty, getInstanceArrayProperty, getInstanceProperty, getInstanceProperty, getInstanceProperty, getIntegerProperty, getListProperty, getListProperty, getLongProperty, getMapProperty, getProperty, getProperty, getPropertyKeys, getPropertyStore, getSetProperty, getSetProperty, getStringProperty, hashCode, toString

Methods inherited from class java.lang.Object

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

Field Detail

XML_eventAllocator

public static final String XML_eventAllocator

Configuration property: XML event allocator.

Property:

• Name: "XmlParser.eventAllocator.c"
• Data type: Class<? extends XMLEventAllocator>
• Default: null
• Session-overridable: true
• Methods:
  • XmlParserBuilder.eventAllocator(XMLEventAllocator)

Description:

Associates an XMLEventAllocator with this parser.

See Also:

Constant Field Values

XML_preserveRootElement

public static final String XML_preserveRootElement

Configuration property: Preserve root element during generalized parsing.

Property:

• Name: "XmlParser.preserveRootElement.b"
• Data type: Boolean
• Default: false
• Session-overridable: true
• Methods:
  • XmlParserBuilder.preserveRootElement(boolean)
  • XmlParserBuilder.preserveRootElement()

Description:

If true, when parsing into a generic ObjectMap, the map will contain a single entry whose key is the root element name.

Example:

// Parser with preserve-root-element. ReaderParser p1 = XmlParser .create() .preserveRootElement(true) .build(); // Parser without preserve-root-element (the default behavior). ReaderParser p2 = XmlParser .create() .preserveRootElement(false) .build(); String xml = "<root><a>foobar</a></root>"; // Produces: "{ root: { a:'foobar' }}" ObjectMap m1 = p1.parse(xml, ObjectMap.class); // Produces: "{ a:'foobar' }" ObjectMap m2 = p2.parse(xml, ObjectMap.class);

See Also:

Constant Field Values

XML_reporter

public static final String XML_reporter

Configuration property: XML reporter.

Property:

• Name: "XmlParser.reporter.c"
• Data type: Class<? extends XMLReporter>
• Default: null
• Session-overridable: true
• Methods:
  • XmlParserBuilder.reporter(XMLReporter)

Description:

Associates an XMLReporter with this parser.

Notes:

• Reporters are not copied to new parsers during a clone.

See Also:

Constant Field Values

XML_resolver

public static final String XML_resolver

Configuration property: XML resolver.

Property:

• Name: "XmlParser.resolver.c"
• Data type: Class<? extends XMLResolver>
• Default: null
• Session-overridable: true
• Methods:
  • XmlParserBuilder.resolver(XMLResolver)

Description:

Associates an XMLResolver with this parser.

See Also:

Constant Field Values

XML_validating

public static final String XML_validating

Configuration property: Enable validation.

Property:

• Name: "XmlParser.validating.b"
• Data type: Boolean
• Default: false
• Session-overridable: true
• Methods:
  • XmlParserBuilder.validating(boolean)
  • XmlParserBuilder.validating()

Description:

If true, XML document will be validated.

See XMLInputFactory.IS_VALIDATING for more info.

See Also:

Constant Field Values

DEFAULT

public static final XmlParser DEFAULT

Default parser, all default settings.

Constructor Detail

XmlParser

public XmlParser(PropertyStore ps)

Constructor.

Parameters:

ps - The property store containing all the settings for this object.

XmlParser

public XmlParser(PropertyStore ps,
                 String... consumes)

Constructor.

Parameters:

ps - The property store containing all the settings for this object.

consumes - The list of media types that this parser consumes (e.g. "application/json", "*/json").

Method Detail

builder

public XmlParserBuilder builder()

Description copied from class: Context

Creates a builder from this context object.

Builders are used to define new contexts (e.g. serializers, parsers) based on existing configurations.

Overrides:

builder in class Parser

Returns:

A new ContextBuilder object.

create

public static XmlParserBuilder create()

Instantiates a new clean-slate XmlParserBuilder object.

This is equivalent to simply calling new XmlParserBuilder().

Note that this method creates a builder initialized to all default settings, whereas builder() copies the settings of the object called on.

Returns:

A new XmlParserBuilder object.

createSession

public ReaderParserSession createSession(ParserSessionArgs args)

Description copied from class: Parser

Create the session object that will be passed in to the parse method.

It's up to implementers to decide what the session object looks like, although typically it's going to be a subclass of ParserSession.

Specified by:

createSession in class Parser

Parameters:

args - Runtime arguments.

Returns:

The new session.

asMap

public ObjectMap asMap()

Description copied from class: Context

Returns the properties defined on this bean context as a simple map for debugging purposes.

Overrides:

asMap in class Parser

Returns:

A new map containing the properties defined on this context.