Package Summary Overview Summary

### method:newFactory(java.lang.String, java.lang.ClassLoader) [CHANGED]
- #### newFactory
      public static XMLInputFactory newFactory​(java.lang.String factoryId,
                                               java.lang.ClassLoader classLoader)
                                        throws FactoryConfigurationError
Create a new instance of the factory. If the classLoader argument is null, then the ContextClassLoader is used. This method uses the following ordered lookup procedure to determine the XMLInputFactory implementation class to load: Use the value of the system property identified by `factoryId`. Use the configuration file "stax.properties". The file is in standard `Properties` format and typically located in the `conf` directory value of the Java installation. It contains property `factoryId` set in the fully qualified name of the implementation class with the key being the system property defined above. The stax configuration file , jaxp.properties file is read only onceby the implementation and its values are then cached for future use default. If the file does not exist when exists and the first attempt property `factoryId` is made to read from it, no further attempts are made to check for its existence. It is not possible to change the value of any property specified in stax.properties after it has been read forthe first time. Use the jaxp configurationfile "jaxp.properties". The file is in the same format as stax.properties and, its value will onlybe read if stax.properties does not exist used as the implementation class. If `factoryId` is "javax.xml.stream.XMLInputFactory", use the service-provider loading facility, defined by the `ServiceLoader` class, to attempt to locate and load an implementation of the service using the specified `ClassLoader`. If `classLoader` is null, the default loading mechanism will apply: That is, the service-provider loading facility will use the current thread's context class loader to attempt to load the service. If the context class loader is null, the system class loader will be used. Otherwise, throws a `FactoryConfigurationError`. Note that this is a new method that replaces the deprecated `newInstance(String factoryId, ClassLoader classLoader)` method. No changes in behavior are defined by this replacement method relative to the deprecated method. API Note: The parameter factoryId defined here is inconsistent with that of other JAXP factories where the first parameter is fully qualified factory class name that provides implementation of the factory. Parameters: `factoryId` - Name of the factory to find, same as a property name `classLoader` - classLoader to use Returns: the factory implementation Throws: `FactoryConfigurationError` - in case of service configuration error or if the implementation is not available or cannot be instantiated. `FactoryConfigurationError` - if an instance of this factory cannot be loaded
- #### newFactory
      public static XMLInputFactory newFactory​(java.lang.String factoryId,
                                               java.lang.ClassLoader classLoader)
                                        throws FactoryConfigurationError
- Create a new instance of the factory. If the classLoader argument is null, then the ContextClassLoader is used. This method uses the following ordered lookup procedure to determine the XMLInputFactory implementation class to load: Use the value of the system property identified by `factoryId`. Use the configuration file "stax.properties". The file is in standard `Properties` format and typically located in the `conf` directory of the Java installation. It contains the fully qualified name of the implementation class with the key being the system property defined above. The stax.properties file is read only once by the implementation and its values are then cached for future use. If the file does not exist when the first attempt is made to read from it, no further attempts are made to check for its existence. It is not possible to change the value of any property in stax.properties after it has been read for the first time. Use the jaxp configuration file "jaxp.properties". The file is in the same format as stax.properties and will only be read if stax.properties does not exist. If `factoryId` is "javax.xml.stream.XMLInputFactory", use the service-provider loading facility, defined by the `ServiceLoader` class, to attempt to locate and load an implementation of the service using the specified `ClassLoader`. If `classLoader` is null, the default loading mechanism will apply: That is, the service-provider loading facility will use the current thread's context class loader to attempt to load the service. If the context class loader is null, the system class loader will be used. Otherwise, throws a `FactoryConfigurationError`. Note that this is a new method that replaces the deprecated `newInstance(String factoryId, ClassLoader classLoader)` method. No changes in behavior are defined by this replacement method relative to the deprecated method. API Note: The parameter factoryId defined here is inconsistent with that of other JAXP factories where the first parameter is fully qualified factory class name that provides implementation of the factory. Parameters: `factoryId` - Name of the factory to find, same as a property name `classLoader` - classLoader to use Returns: the factory implementation Throws: `FactoryConfigurationError` - in case of service configuration error or if the implementation is not available or cannot be instantiated. `FactoryConfigurationError` - if an instance of this factory cannot be loaded | #### newFactory
      public static XMLInputFactory newFactory​(java.lang.String factoryId,
                                               java.lang.ClassLoader classLoader)
                                        throws FactoryConfigurationError
Create a new instance of the factory. If the classLoader argument is null, then the ContextClassLoader is used. This method uses the following ordered lookup procedure to determine the XMLInputFactory implementation class to load: Use the value of the system property identified by `factoryId`. Use the value of the property `factoryId` set in the configuration file , jaxp.properties by default. If the file exists and the property `factoryId` is specified in the file, its value will be used as the implementation class. If `factoryId` is "javax.xml.stream.XMLInputFactory", use the service-provider loading facility, defined by the `ServiceLoader` class, to attempt to locate and load an implementation of the service using the specified `ClassLoader`. If `classLoader` is null, the default loading mechanism will apply: That is, the service-provider loading facility will use the current thread's context class loader to attempt to load the service. If the context class loader is null, the system class loader will be used. Otherwise, throws a `FactoryConfigurationError`. Note that this is a new method that replaces the deprecated `newInstance(String factoryId, ClassLoader classLoader)` method. No changes in behavior are defined by this replacement method relative to the deprecated method. API Note: The parameter factoryId defined here is inconsistent with that of other JAXP factories where the first parameter is fully qualified factory class name that provides implementation of the factory. Parameters: `factoryId` - Name of the factory to find, same as a property name `classLoader` - classLoader to use Returns: the factory implementation Throws: `FactoryConfigurationError` - in case of service configuration error or if the implementation is not available or cannot be instantiated. `FactoryConfigurationError` - if an instance of this factory cannot be loaded