OpenJDK 1.23 · javax.xml.datatype.FactoryFinder · APIdia, the JavaDoc alternative

Modifier and Type	Field and Description
private static boolean	debug Internal debug flag.
private static final String	DEFAULT_PACKAGE

Access	Constructor and Description
pack-priv	FactoryFinder()

Method Summary

Modifier and Type	Method and Description
private static void	dPrint(Supplier<String> msgGen)
pack-priv static <T> T	Returns: Class object of factory, never null find(Class<T> Base class / Service interface of the factory to find. type, String Implementation class name, if nothing else is found. Use null to mean no fallback. Package private so this code can be shared. fallbackClassName) Finds the implementation Class object in the specified order.
private static <T> T	findServiceProvider(final Class<T> type)
private static Class<?>	getProviderClass(String className, ClassLoader cl, boolean doFallback, boolean useBSClsLoader) Attempt to load a class using the class loader supplied.
pack-priv static <T> T	newInstance(Class<T> Base class / Service interface of the factory to instantiate. type, String Name of the concrete class corresponding to the service provider className, ClassLoader `ClassLoader` used to load the factory class. If `null` current `Thread`'s context classLoader is used to load the factory class. cl, boolean True if the current ClassLoader should be tried as a fallback if the class is not found using cl doFallback) Create an instance of a class.
pack-priv static <T> T	newInstance(Class<T> Base class / Service interface of the factory to instantiate. type, String Name of the concrete class corresponding to the service provider className, ClassLoader ClassLoader to use to load the class, null means to use the bootstrap ClassLoader cl, boolean True if the current ClassLoader should be tried as a fallback if the class is not found using cl doFallback, boolean True if cl=null actually meant bootstrap classLoader. This parameter is needed since DocumentBuilderFactory/SAXParserFactory defined null as context classLoader. useBSClsLoader) Create an instance of a class.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

debug	back to summary
private static boolean debug Internal debug flag.

DEFAULT_PACKAGE	back to summary
private static final String DEFAULT_PACKAGE

FactoryFinder	back to summary
pack-priv FactoryFinder()

Method Detail

dPrint	back to summary
private static void dPrint(Supplier<String> msgGen)

find	back to summary
pack-priv static <T> T find(Class<T> type, String fallbackClassName) throws DatatypeConfigurationException Finds the implementation Class object in the specified order. Main entry point. Parameters type:Class<T> Base class / Service interface of the factory to find. fallbackClassName:String Implementation class name, if nothing else is found. Use null to mean no fallback. Package private so this code can be shared. Returns:T Class object of factory, never null

find

back to summary

pack-priv static <T> T find(Class<T> type, String fallbackClassName) throws DatatypeConfigurationException

Finds the implementation Class object in the specified order. Main entry point.

Parameters

type:Class<T>: Base class / Service interface of the factory to find.
fallbackClassName:String: Implementation class name, if nothing else is found. Use null to mean no fallback. Package private so this code can be shared.

Returns:T

Class object of factory, never null

findServiceProvider	back to summary
private static <T> T findServiceProvider(final Class<T> type) throws DatatypeConfigurationException Annotations @SuppressWarnings:removal

getProviderClass back to summary

getProviderClass	back to summary
private static Class<?> getProviderClass(String className, ClassLoader cl, boolean doFallback, boolean useBSClsLoader) throws ClassNotFoundException Attempt to load a class using the class loader supplied. If that fails and fall back is enabled, the current (i.e. bootstrap) class loader is tried. If the class loader supplied is `null`, first try using the context class loader followed by the current (i.e. bootstrap) class loader. Use bootstrap classLoader if cl = null and useBSClsLoader is true

private static Class<?> getProviderClass(String className, ClassLoader cl, boolean doFallback, boolean useBSClsLoader) throws ClassNotFoundException

Attempt to load a class using the class loader supplied. If that fails and fall back is enabled, the current (i.e. bootstrap) class loader is tried. If the class loader supplied is null, first try using the context class loader followed by the current (i.e. bootstrap) class loader. Use bootstrap classLoader if cl = null and useBSClsLoader is true

newInstance back to summary

newInstance	back to summary
pack-priv static <T> T newInstance(Class<T> type, String className, ClassLoader cl, boolean doFallback) throws DatatypeConfigurationException Create an instance of a class. Delegates to method `getProviderClass()` in order to load the class. Parameters type:Class<T> Base class / Service interface of the factory to instantiate. className:String Name of the concrete class corresponding to the service provider cl:ClassLoader `ClassLoader` used to load the factory class. If `null` current `Thread`'s context classLoader is used to load the factory class. doFallback:boolean True if the current ClassLoader should be tried as a fallback if the class is not found using cl

pack-priv static <T> T newInstance(Class<T> type, String className, ClassLoader cl, boolean doFallback) throws DatatypeConfigurationException

Create an instance of a class. Delegates to method getProviderClass() in order to load the class.

Parameters

type:Class<T>: Base class / Service interface of the factory to instantiate.
className:String: Name of the concrete class corresponding to the service provider
cl:ClassLoader: ClassLoader used to load the factory class. If null current Thread's context classLoader is used to load the factory class.
doFallback:boolean: True if the current ClassLoader should be tried as a fallback if the class is not found using cl

newInstance back to summary

newInstance	back to summary
pack-priv static <T> T newInstance(Class<T> type, String className, ClassLoader cl, boolean doFallback, boolean useBSClsLoader) throws DatatypeConfigurationException Create an instance of a class. Delegates to method `getProviderClass()` in order to load the class. Parameters type:Class<T> Base class / Service interface of the factory to instantiate. className:String Name of the concrete class corresponding to the service provider cl:ClassLoader ClassLoader to use to load the class, null means to use the bootstrap ClassLoader doFallback:boolean True if the current ClassLoader should be tried as a fallback if the class is not found using cl useBSClsLoader:boolean True if cl=null actually meant bootstrap classLoader. This parameter is needed since DocumentBuilderFactory/SAXParserFactory defined null as context classLoader. Annotations @SuppressWarnings:removal

pack-priv static <T> T newInstance(Class<T> type, String className, ClassLoader cl, boolean doFallback, boolean useBSClsLoader) throws DatatypeConfigurationException

Create an instance of a class. Delegates to method getProviderClass() in order to load the class.

Parameters

type:Class<T>: Base class / Service interface of the factory to instantiate.
className:String: Name of the concrete class corresponding to the service provider
cl:ClassLoader: ClassLoader to use to load the class, null means to use the bootstrap ClassLoader
doFallback:boolean: True if the current ClassLoader should be tried as a fallback if the class is not found using cl
useBSClsLoader:boolean: True if cl=null actually meant bootstrap classLoader. This parameter is needed since DocumentBuilderFactory/SAXParserFactory defined null as context classLoader.

Annotations

@SuppressWarnings:removal

pack-priv Class FactoryFinder

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail