org.hibernate.boot.registry.classloading.spi

Interface ClassLoaderService

All Superinterfaces:

java.io.Serializable, Service, Stoppable

All Known Implementing Classes:

ClassLoaderServiceImpl, ClassLoaderServiceTestingImpl, OSGiClassLoaderServiceImpl

public interface ClassLoaderService
extends Service, Stoppable

A service for interacting with class loaders.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	ClassLoaderService.Work<T>

Method Summary

Modifier and Type	Method and Description
<T> java.lang.Class<T>	classForName(java.lang.String className) Locate a class by name.
<T> T	generateProxy(java.lang.reflect.InvocationHandler handler, java.lang.Class... interfaces)
<S> java.util.Collection<S>	loadJavaServices(java.lang.Class<S> serviceContract) Discovers and instantiates implementations of the named service contract.
java.net.URL	locateResource(java.lang.String name) Locate a resource by name (classpath lookup).
java.util.List<java.net.URL>	locateResources(java.lang.String name) Locate a series of resource by name (classpath lookup).
java.io.InputStream	locateResourceStream(java.lang.String name) Locate a resource by name (classpath lookup) and gets its stream.
<T> T	workWithClassLoader(ClassLoaderService.Work<T> work)

Methods inherited from interface org.hibernate.service.spi.Stoppable

stop

Method Detail

classForName

<T> java.lang.Class<T> classForName(java.lang.String className)

Locate a class by name.

Type Parameters:

T - The returned class type.

Parameters:

className - The name of the class to locate

Returns:

The class reference

Throws:

ClassLoadingException - Indicates the class could not be found

locateResource

java.net.URL locateResource(java.lang.String name)

Locate a resource by name (classpath lookup).

Parameters:

name - The resource name.

Returns:

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

locateResourceStream

java.io.InputStream locateResourceStream(java.lang.String name)

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

Parameters:

name - The resource name.

Returns:

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

locateResources

java.util.List<java.net.URL> locateResources(java.lang.String name)

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

Parameters:

name - The resource name.

Returns:

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

loadJavaServices

<S> java.util.Collection<S> loadJavaServices(java.lang.Class<S> serviceContract)

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.

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

<T> T generateProxy(java.lang.reflect.InvocationHandler handler,
                    java.lang.Class... interfaces)

workWithClassLoader

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