gov.nasa.worldwind.util.xml
Class XMLEventParserContextFactory

java.lang.Object
  gov.nasa.worldwind.util.xml.XMLEventParserContextFactory

public class XMLEventParserContextFactory
extends Object

Provides a global registry of XML parsers. Enables registration of parsers for specific mime types and namespace specialization. Parsers should generally be drawn from this class in order to ensure that parsers configured by World Wind and the application are used.

Nested Class Summary

protected static class

XMLEventParserContextFactory.ParserTableEntry Holds the mime types and the associated prototype parser.

Field Summary

protected static List<XMLEventParserContextFactory.ParserTableEntry>

parsers The list of registered parser contexts.

Constructor Summary

XMLEventParserContextFactory()

Method Summary

static void	addParserContext(String[] mimeTypes, XMLEventParserContext prototypeContext) Appends a specified prototype parser context to the list of those already registered.
protected static XMLEventParserContext	createInstanceFromPrototype(XMLEventParserContext prototype) Constructs a new parser context given a prototype parser context.
static XMLEventParserContext	createParserContext(String mimeType, String defaultNamespace) Constructs and returns a parser context for a specified mime type and namespace.
static void	prependParserContext(String[] mimeTypes, XMLEventParserContext prototypeContext) Prepends a specified prototype parser context to the list of those already registered.

Methods inherited from class java.lang.Object

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

Field Detail

parsers

protected static List<XMLEventParserContextFactory.ParserTableEntry> parsers

The list of registered parser contexts. A copy-on-write list is used to avoid the need to explicitly synchronize access.

Constructor Detail

XMLEventParserContextFactory

public XMLEventParserContextFactory()

Method Detail

addParserContext

public static void addParserContext(String[] mimeTypes,
                                    XMLEventParserContext prototypeContext)

Appends a specified prototype parser context to the list of those already registered.

Parameters:

mimeTypes - the list of mime types for which to use the specified prototype parser context.

prototypeContext - the prototype parser context to use for the specified mime types. This parser context's class must provide a copy constructor, a constructor that takes an instance of its class as its only argument.

Throws:

IllegalArgumentException - if the mime type list is null or empty or the prototype context is null or has no copy constructor.

createInstanceFromPrototype

protected static XMLEventParserContext createInstanceFromPrototype(XMLEventParserContext prototype)
                                                            throws Exception

Constructs a new parser context given a prototype parser context.

Parameters:

prototype - the prototype parser context. This parser context's class must provide a copy constructor, a constructor that takes an instance of the class as its only argument.

Returns:

the new parser context.

Throws:

Exception - if an exception occurs while attempting to construct the new context.

createParserContext

public static XMLEventParserContext createParserContext(String mimeType,
                                                        String defaultNamespace)

Constructs and returns a parser context for a specified mime type and namespace. The list of registered parser contexts is searched from first to last. A parser context is constructed from the first entry matching the specified mime type and namespace. Null is returned if no match is found.

Note that the empty namespace, XMLConstants.NULL_NS_URI does not match any other namespace. In order for a parser context with the empty namespace to be returned, one with the empty namespace must be registered.

Parameters:

mimeType - the mime type for which to construct a parser.

defaultNamespace - a namespace qualifying the parser context to return. May be null, in which case a parser context for the specified mime type and an empty namespace, XMLConstants.NULL_NS_URI, is searched for.

Returns:

a new parser context constructed from the prototype context registered for the specified mime type and having the specified default namespace.

Throws:

IllegalArgumentException - if the specified mime type is null.

prependParserContext

public static void prependParserContext(String[] mimeTypes,
                                        XMLEventParserContext prototypeContext)

Prepends a specified prototype parser context to the list of those already registered. Because the new entry is prepended to the list of registered parsers, it will be the first match for the specified mime types.

Parameters:

mimeTypes - the list of mime types for which to use the specified prototype parser context.

prototypeContext - the prototype parser context to use for the specified mime types. This parser context's class must provide a copy constructor, a constructor that takes an instance of its class as its only argument.

Throws:

IllegalArgumentException - if the mime type list is null or empty or the prototype context is null or has no copy constructor.