Module java.xml.bind

Package javax.xml.bind

Class ContextFinder

java.lang.Object

javax.xml.bind.ContextFinder

class ContextFinder
extends Object

This class is package private and therefore is not exposed as part of the JAXB API. This code is designed to implement the JAXB 1.0 spec pluggability feature

See Also:

• JAXBContext

Field Summary

Fields

Modifier and Type	Field	Description
private static ServiceLoaderUtil.ExceptionHandler<JAXBException>	EXCEPTION_HANDLER
private static final String	JAXB_CONTEXT_FACTORY_DEPRECATED
private static final Logger	logger

Constructor Summary

Constructors

Constructor	Description
ContextFinder()

Method Summary

Modifier and Type	Method	Description
private static String	classNameFromPackageProperties(URL packagePropertiesUrl, String... factoryIds)	first factoryId should be the preferred one, more of those can be provided to support backwards compatibility
private static String	classNameFromSystemProperties()
(package private) static JAXBContext	find(Class<?>[] classes, Map<String,?> properties)
(package private) static JAXBContext	find(String factoryId, String contextPath, ClassLoader classLoader, Map properties)
(package private) static String	firstByServiceLoaderDeprecated(Class spiClass, ClassLoader classLoader)	Deprecated.
private static ClassLoader	getClassClassLoader(Class c)
private static ClassLoader	getContextClassLoader()
private static String	getDeprecatedSystemProperty(String property)
private static URL	getResourceUrl(Class<?> clazz, String resourceName)
private static URL	getResourceUrl(ClassLoader classLoader, String resourceName)	If run on JPMS package containing resource must be open unconditionally.
private static ClassLoader	getSystemClassLoader()
private static String	getSystemProperty(String property)
private static JAXBException	handleClassCastException(Class originalType, Class targetType)	Determine if two types (JAXBContext in this case) will generate a ClassCastException.
private static Throwable	handleInvocationTargetException(InvocationTargetException x)	If the InvocationTargetException wraps an exception that shouldn't be wrapped, throw the wrapped exception.
private static Object	instantiateProviderIfNecessary(Class<?> implClass)
private static String	jaxbProperties(Class[] classesFromContextPath, String factoryId)
private static String	jaxbProperties(String contextPath, ClassLoader classLoader, String factoryId)
private static Properties	loadJAXBProperties(URL url)
(package private) static JAXBContext	newInstance(Class[] classes, Map properties, Class spFactory)
(package private) static JAXBContext	newInstance(Class[] classes, Map properties, String className)	Create an instance of a class using the thread context ClassLoader
(package private) static JAXBContext	newInstance(String contextPath, Class[] contextPathClasses, Class spFactory, ClassLoader classLoader, Map properties)
(package private) static JAXBContext	newInstance(String contextPath, Class[] contextPathClasses, String className, ClassLoader classLoader, Map properties)	Create an instance of a class using the specified ClassLoader
(package private) static URL	which(Class clazz)	Get the URL for the Class from it's ClassLoader.
(package private) static URL	which(Class clazz, ClassLoader loader)	Search the given ClassLoader for an instance of the specified class and return a string representation of the URL that points to the resource.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

JAXB_CONTEXT_FACTORY_DEPRECATED

private static final String JAXB_CONTEXT_FACTORY_DEPRECATED

See Also:

• Constant Field Values

logger

private static final Logger logger

EXCEPTION_HANDLER

private static ServiceLoaderUtil.ExceptionHandler<JAXBException> EXCEPTION_HANDLER

Constructor Details

ContextFinder

ContextFinder()

Method Details

handleInvocationTargetException

private static Throwable handleInvocationTargetException(InvocationTargetException x)
                                                  throws JAXBException

If the InvocationTargetException wraps an exception that shouldn't be wrapped, throw the wrapped exception. Otherwise returns exception to be wrapped for further processing.

Throws:

JAXBException

handleClassCastException

private static JAXBException handleClassCastException(Class originalType,
 Class targetType)

Determine if two types (JAXBContext in this case) will generate a ClassCastException. For example, (targetType)originalType

Parameters:

originalType - The Class object of the type being cast

targetType - The Class object of the type that is being cast to

Returns:

JAXBException to be thrown.

newInstance

static JAXBContext newInstance(String contextPath,
 Class[] contextPathClasses,
 String className,
 ClassLoader classLoader,
 Map properties)
                        throws JAXBException

Create an instance of a class using the specified ClassLoader

Throws:

JAXBException

newInstance

static JAXBContext newInstance(String contextPath,
 Class[] contextPathClasses,
 Class spFactory,
 ClassLoader classLoader,
 Map properties)
                        throws JAXBException

Throws:

JAXBException

instantiateProviderIfNecessary

private static Object instantiateProviderIfNecessary(Class<?> implClass)
                                              throws JAXBException

Throws:

JAXBException

newInstance

static JAXBContext newInstance(Class[] classes,
 Map properties,
 String className)
                        throws JAXBException

Create an instance of a class using the thread context ClassLoader

Throws:

JAXBException

newInstance

static JAXBContext newInstance(Class[] classes,
 Map properties,
 Class spFactory)
                        throws JAXBException

Throws:

JAXBException

find

static JAXBContext find(String factoryId,
 String contextPath,
 ClassLoader classLoader,
 Map properties)
                 throws JAXBException

Throws:

JAXBException

find

static JAXBContext find(Class<?>[] classes,
 Map<String,?> properties)
                 throws JAXBException

Throws:

JAXBException

classNameFromPackageProperties

private static String classNameFromPackageProperties(URL packagePropertiesUrl,
 String... factoryIds)
                                              throws JAXBException

first factoryId should be the preferred one, more of those can be provided to support backwards compatibility

Throws:

JAXBException

classNameFromSystemProperties

private static String classNameFromSystemProperties()
                                             throws JAXBException

Throws:

JAXBException

getDeprecatedSystemProperty

private static String getDeprecatedSystemProperty(String property)

getSystemProperty

private static String getSystemProperty(String property)

loadJAXBProperties

private static Properties loadJAXBProperties(URL url)
                                      throws JAXBException

Throws:

JAXBException

getResourceUrl

private static URL getResourceUrl(ClassLoader classLoader,
 String resourceName)

If run on JPMS package containing resource must be open unconditionally.

Parameters:

classLoader - classloader to load resource with

resourceName - qualified name of the resource

Returns:

resource url if found

getResourceUrl

private static URL getResourceUrl(Class<?> clazz,
 String resourceName)

which

static URL which(Class clazz,
 ClassLoader loader)

Search the given ClassLoader for an instance of the specified class and return a string representation of the URL that points to the resource.

Parameters:

clazz - The class to search for

loader - The ClassLoader to search. If this parameter is null, then the system class loader will be searched

Returns:

the URL for the class or null if it wasn't found

which

static URL which(Class clazz)

Get the URL for the Class from it's ClassLoader. Convenience method for which(Class, ClassLoader). Equivalent to calling: which(clazz, clazz.getClassLoader())

Parameters:

clazz - The class to search for

Returns:

the URL for the class or null if it wasn't found

getContextClassLoader

private static ClassLoader getContextClassLoader()

getClassClassLoader

private static ClassLoader getClassClassLoader(Class c)

getSystemClassLoader

private static ClassLoader getSystemClassLoader()

firstByServiceLoaderDeprecated

@Deprecated
static String firstByServiceLoaderDeprecated(Class spiClass,
 ClassLoader classLoader)
                                      throws JAXBException

Deprecated.

Throws:

JAXBException

jaxbProperties

private static String jaxbProperties(String contextPath,
 ClassLoader classLoader,
 String factoryId)
                              throws JAXBException

Throws:

JAXBException

jaxbProperties

private static String jaxbProperties(Class[] classesFromContextPath,
 String factoryId)
                              throws JAXBException

Throws:

JAXBException