org.codehaus.stax2.osgi
Interface Stax2InputFactoryProvider


public interface Stax2InputFactoryProvider

Simple interface to be used for registering objects that can construct XMLInputFactory2 instances with OSGi framework. The added indirection (provider constructing factory) is needed because of impedance between OSGi service objects (which are essentially singletons) and Stax/Stax2 factories which are not.

Note: implementations of provider should NOT use introspection via XMLInputFactory.newInstance() as it will not work with OSGi. Instead, providers should directly construct instances of concrete factory they represent. That is, there will be one provider implementation per concrete Stax/Stax2 implementation


Field Summary
static String OSGI_SVC_PROP_IMPL_NAME
          Service property that defines name of Stax2 implementation that this provider represents.
static String OSGI_SVC_PROP_IMPL_VERSION
          Service property that defines version of Stax2 implementation that this provider represents.
 
Method Summary
 XMLInputFactory2 createInputFactory()
          Method called to create a new XMLInputFactory2 instance.
 

Field Detail

OSGI_SVC_PROP_IMPL_NAME

static final String OSGI_SVC_PROP_IMPL_NAME
Service property that defines name of Stax2 implementation that this provider represents.

See Also:
Constant Field Values

OSGI_SVC_PROP_IMPL_VERSION

static final String OSGI_SVC_PROP_IMPL_VERSION
Service property that defines version of Stax2 implementation that this provider represents.

See Also:
Constant Field Values
Method Detail

createInputFactory

XMLInputFactory2 createInputFactory()
Method called to create a new XMLInputFactory2 instance.

Returns:
Input factory configured to implementation-specific default settings (some of which are mandated by Stax and Stax2 specifications)


Copyright © 2011 Codehaus. All Rights Reserved.