org.hibernate.boot.registry.classloading.internal

Class ClassLoaderServiceImpl

java.lang.Object

org.hibernate.boot.registry.classloading.internal.ClassLoaderServiceImpl

All Implemented Interfaces:

Serializable, ClassLoaderService, Service, Stoppable

public class ClassLoaderServiceImpl
extends Object
implements ClassLoaderService

Standard implementation of the service for interacting with class loaders

Author:

Steve Ebersole, Sanne Grinovero

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface org.hibernate.boot.registry.classloading.spi.ClassLoaderService

ClassLoaderService.Work<T>

Constructor Summary

Constructors

Constructor and Description
ClassLoaderServiceImpl() Constructs a ClassLoaderServiceImpl with standard set-up
ClassLoaderServiceImpl(ClassLoader classLoader) Constructs a ClassLoaderServiceImpl with the given ClassLoader
ClassLoaderServiceImpl(Collection<ClassLoader> providedClassLoaders, TcclLookupPrecedence lookupPrecedence) Constructs a ClassLoaderServiceImpl with the given ClassLoader instances

Method Summary

Modifier and Type	Method and Description
<T> Class<T>	classForName(String className) Locate a class by name.
static ClassLoaderServiceImpl	fromConfigSettings(Map configValues) Deprecated. No longer used/supported!
<T> T	generateProxy(InvocationHandler handler, Class... interfaces)
<S> Collection<S>	loadJavaServices(Class<S> serviceContract) Discovers and instantiates implementations of the named service contract.
URL	locateResource(String name) Locate a resource by name (classpath lookup).
List<URL>	locateResources(String name) Locate a series of resource by name (classpath lookup).
InputStream	locateResourceStream(String name) Locate a resource by name (classpath lookup) and gets its stream.
void	stop() Stop phase notification
<T> T	workWithClassLoader(ClassLoaderService.Work<T> work)

Methods inherited from class java.lang.Object

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

Constructor Detail

ClassLoaderServiceImpl

public ClassLoaderServiceImpl()

Constructs a ClassLoaderServiceImpl with standard set-up

ClassLoaderServiceImpl

public ClassLoaderServiceImpl(ClassLoader classLoader)

Constructs a ClassLoaderServiceImpl with the given ClassLoader

Parameters:

classLoader - The ClassLoader to use

ClassLoaderServiceImpl

public ClassLoaderServiceImpl(Collection<ClassLoader> providedClassLoaders,
                              TcclLookupPrecedence lookupPrecedence)

Constructs a ClassLoaderServiceImpl with the given ClassLoader instances

Parameters:

providedClassLoaders - The ClassLoader instances to use

lookupPrecedence - The lookup precedence of the thread context ClassLoader

Method Detail

fromConfigSettings

@Deprecated
public static ClassLoaderServiceImpl fromConfigSettings(Map configValues)

Deprecated. No longer used/supported!

No longer used/supported!

Parameters:

configValues - The config values

Returns:

The built service

classForName

public <T> Class<T> classForName(String className)

Description copied from interface: ClassLoaderService

Locate a class by name.

Specified by:

classForName in interface ClassLoaderService

Type Parameters:

T - The returned class type.

Parameters:

className - The name of the class to locate

Returns:

The class reference

locateResource

public URL locateResource(String name)

Description copied from interface: ClassLoaderService

Locate a resource by name (classpath lookup).

Specified by:

locateResource in interface ClassLoaderService

Parameters:

name - The resource name.

Returns:

The located URL; may return null to indicate the resource was not found

locateResourceStream

public InputStream locateResourceStream(String name)

Description copied from interface: ClassLoaderService

Locate a resource by name (classpath lookup) and gets its stream.

Specified by:

locateResourceStream in interface ClassLoaderService

Parameters:

name - The resource name.

Returns:

The stream of the located resource; may return null to indicate the resource was not found

locateResources

public List<URL> locateResources(String name)

Description copied from interface: ClassLoaderService

Locate a series of resource by name (classpath lookup).

Specified by:

locateResources in interface ClassLoaderService

Parameters:

name - The resource name.

Returns:

The list of URL matching; may return null to indicate the resource was not found

loadJavaServices

public <S> Collection<S> loadJavaServices(Class<S> serviceContract)

Description copied from interface: ClassLoaderService

Discovers and instantiates implementations of the named service contract.

NOTE : the terms service here is used differently than Service. Instead here we are talking about services as defined by ServiceLoader.

Specified by:

loadJavaServices in interface ClassLoaderService

Type Parameters:

S - The type of the service contract

Parameters:

serviceContract - The java type defining the service contract

Returns:

The ordered set of discovered services.

generateProxy

public <T> T generateProxy(InvocationHandler handler,
                           Class... interfaces)

Specified by:

generateProxy in interface ClassLoaderService

workWithClassLoader

public <T> T workWithClassLoader(ClassLoaderService.Work<T> work)

Specified by:

workWithClassLoader in interface ClassLoaderService

stop

public void stop()

Description copied from interface: Stoppable

Stop phase notification

Specified by:

stop in interface Stoppable