src/javax/xml/stream/XMLOutputFactory.java
Print this page
*** 124,166 ****
* @throws FactoryConfigurationError if an instance of this factory cannot be loaded
*/
public static XMLOutputFactory newInstance()
throws FactoryConfigurationError
{
! return (XMLOutputFactory) FactoryFinder.find("javax.xml.stream.XMLOutputFactory",
DEFAULIMPL);
}
/**
! * Create a new instance of the factory.
* This static method creates a new factory instance. This method uses the
* following ordered lookup procedure to determine the XMLOutputFactory
* implementation class to load:
* Use the javax.xml.stream.XMLOutputFactory system property.
* Use the properties file "lib/stax.properties" in the JRE directory.
* This configuration file is in standard java.util.Properties format
* and contains the fully qualified name of the implementation class
* with the key being the system property defined above.
! * Use the Services API (as detailed in the JAR specification), if available,
! * to determine the classname. The Services API will look for a classname
! * in the file META-INF/services/javax.xml.stream.XMLOutputFactory in jars
! * available to the runtime.
* Platform default XMLOutputFactory instance.
*
* Once an application has obtained a reference to a XMLOutputFactory it
* can use the factory to configure and obtain stream instances.
! *
* Note that this is a new method that replaces the deprecated newInstance() method.
* No changes in behavior are defined by this replacement method relative to the
* deprecated method.
! *
* @throws FactoryConfigurationError if an instance of this factory cannot be loaded
*/
public static XMLOutputFactory newFactory()
throws FactoryConfigurationError
{
! return (XMLOutputFactory) FactoryFinder.find("javax.xml.stream.XMLOutputFactory",
DEFAULIMPL);
}
/**
* Create a new instance of the factory.
--- 124,182 ----
* @throws FactoryConfigurationError if an instance of this factory cannot be loaded
*/
public static XMLOutputFactory newInstance()
throws FactoryConfigurationError
{
! return (XMLOutputFactory) FactoryFinder.find(XMLOutputFactory.class,
! "javax.xml.stream.XMLOutputFactory",
DEFAULIMPL);
}
/**
! * <p>Create a new instance of the factory.
! * </p><p>
* This static method creates a new factory instance. This method uses the
* following ordered lookup procedure to determine the XMLOutputFactory
* implementation class to load:
+ * <ul>
+ * <li>
* Use the javax.xml.stream.XMLOutputFactory system property.
+ * </li>
+ * <li>
* Use the properties file "lib/stax.properties" in the JRE directory.
* This configuration file is in standard java.util.Properties format
* and contains the fully qualified name of the implementation class
* with the key being the system property defined above.
! * </li>
! * <li>
! * <p>Uses the service-provider loading facilities, defined by the {@link java.util.ServiceLoader} class, to attempt
! * to locate and load an implementation of the service. In case of multiple providers, the first non-default implementation
! * shall be instantiated and returned. The default implementation is returned if it is the only one
! * found by the service loader.</p>
! * <p>
! * If a misconfigured provider is encountered and {@link java.util.ServiceConfigurationError} is thrown, the error will be wrapped
! * in a {@link javax.xml.stream.FactoryConfigurationError}.</p>
! * </li>
! * <li>
* Platform default XMLOutputFactory instance.
+ * </li>
+ * </ul>
*
* Once an application has obtained a reference to a XMLOutputFactory it
* can use the factory to configure and obtain stream instances.
! *</p><p>
* Note that this is a new method that replaces the deprecated newInstance() method.
* No changes in behavior are defined by this replacement method relative to the
* deprecated method.
! *</p>
* @throws FactoryConfigurationError if an instance of this factory cannot be loaded
*/
public static XMLOutputFactory newFactory()
throws FactoryConfigurationError
{
! return (XMLOutputFactory) FactoryFinder.find(XMLOutputFactory.class,
! "javax.xml.stream.XMLOutputFactory",
DEFAULIMPL);
}
/**
* Create a new instance of the factory.
*** 177,193 ****
* java.lang.ClassLoader)} instead.
*/
public static XMLInputFactory newInstance(String factoryId,
ClassLoader classLoader)
throws FactoryConfigurationError {
- try {
//do not fallback if given classloader can't find the class, throw exception
! return (XMLInputFactory) FactoryFinder.find(factoryId, classLoader, null);
! } catch (FactoryFinder.ConfigurationError e) {
! throw new FactoryConfigurationError(e.getException(),
! e.getMessage());
! }
}
/**
* Create a new instance of the factory.
* If the classLoader argument is null, then the ContextClassLoader is used.
--- 193,204 ----
* java.lang.ClassLoader)} instead.
*/
public static XMLInputFactory newInstance(String factoryId,
ClassLoader classLoader)
throws FactoryConfigurationError {
//do not fallback if given classloader can't find the class, throw exception
! return (XMLInputFactory) FactoryFinder.find(XMLInputFactory.class, factoryId, classLoader, null);
}
/**
* Create a new instance of the factory.
* If the classLoader argument is null, then the ContextClassLoader is used.
*** 206,222 ****
* @throws FactoryConfigurationError if an instance of this factory cannot be loaded
*/
public static XMLOutputFactory newFactory(String factoryId,
ClassLoader classLoader)
throws FactoryConfigurationError {
- try {
//do not fallback if given classloader can't find the class, throw exception
! return (XMLOutputFactory) FactoryFinder.find(factoryId, classLoader, null);
! } catch (FactoryFinder.ConfigurationError e) {
! throw new FactoryConfigurationError(e.getException(),
! e.getMessage());
! }
}
/**
* Create a new XMLStreamWriter that writes to a writer
* @param stream the writer to write to
--- 217,228 ----
* @throws FactoryConfigurationError if an instance of this factory cannot be loaded
*/
public static XMLOutputFactory newFactory(String factoryId,
ClassLoader classLoader)
throws FactoryConfigurationError {
//do not fallback if given classloader can't find the class, throw exception
! return (XMLOutputFactory) FactoryFinder.find(XMLOutputFactory.class, factoryId, classLoader, null);
}
/**
* Create a new XMLStreamWriter that writes to a writer
* @param stream the writer to write to