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

Fields

Modifier and Type	Field and Description
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

Modifier and Type	Method and Description
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)