Interface ClassLoaderService
-
- All Superinterfaces:
Serializable
,Service
,Stoppable
public interface ClassLoaderService extends Service, Stoppable
A service for interacting with class loaders.
-
-
Nested Class Summary
Nested Classes Modifier and Type Interface Description static interface
ClassLoaderService.Work<T>
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description <T> Class<T>
classForName(String className)
Locate a class by name.<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.<T> T
workWithClassLoader(ClassLoaderService.Work<T> work)
-
-
-
Method Detail
-
classForName
<T> Class<T> classForName(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
URL locateResource(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
InputStream locateResourceStream(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
List<URL> locateResources(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> Collection<S> loadJavaServices(Class<S> serviceContract)
Discovers and instantiates implementations of the named service contract. NOTE : the terms service here is used differently thanService
. Instead here we are talking about services as defined byServiceLoader
.- 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(InvocationHandler handler, Class... interfaces)
-
workWithClassLoader
<T> T workWithClassLoader(ClassLoaderService.Work<T> work)
-
-