de.lmu.ifi.dbs.elki.utilities

Class ELKIServiceRegistry

java.lang.Object

de.lmu.ifi.dbs.elki.utilities.ELKIServiceRegistry

public class ELKIServiceRegistry
extends Object

Registry of available implementations in ELKI.

Author:

Erich Schubert

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	ELKIServiceRegistry.Entry Entry in the service registry.

Field Summary

Fields

Modifier and Type	Field and Description
private static URLClassLoader	CLASSLOADER Class loader
private static Map<Class<?>,ELKIServiceRegistry.Entry>	data Registry data.
static String	FACTORY_POSTFIX Factory class postfix.
(package private) static Class<?>	FAILED_LOAD Value to abuse for failures.
private static Logging	LOG Class logger.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	ELKIServiceRegistry() Do not use constructor.

Method Summary

Methods

Modifier and Type	Method and Description
protected static boolean	contains(Class<?> c) Test if a registry entry has already been created.
static List<Class<?>>	findAllImplementations(Class<?> restrictionClass) Find all implementations of a particular interface.
static List<Class<?>>	findAllImplementations(Class<?> c, boolean everything, boolean parameterizable) Find all implementations of a given class in the classpath.
static <C> Class<? extends C>	findImplementation(Class<? super C> restrictionClass, String value) Find an implementation of the given interface / super class, given a relative class name or alias name.
protected static void	register(Class<?> parent, Class<?> clazz) Register a class in the registry.
protected static void	register(Class<?> parent, String cname) Register a class with the registry.
protected static void	registerAlias(Class<?> parent, String alias, String cname) Register a class alias with the registry.
private static Class<?>	tryLoadClass(String value) Attempt to load a class

Methods inherited from class java.lang.Object

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

Field Detail

LOG

private static final Logging LOG

Class logger.

CLASSLOADER

private static final URLClassLoader CLASSLOADER

Class loader

FACTORY_POSTFIX

public static final String FACTORY_POSTFIX

Factory class postfix.

See Also:

Constant Field Values

data

private static Map<Class<?>,ELKIServiceRegistry.Entry> data

Registry data.

FAILED_LOAD

static final Class<?> FAILED_LOAD

Value to abuse for failures.

Constructor Detail

ELKIServiceRegistry

private ELKIServiceRegistry()

Do not use constructor.

Method Detail

register

protected static void register(Class<?> parent,
            String cname)

Register a class with the registry.

Parameters:

parent - Parent class

cname - Class name

register

protected static void register(Class<?> parent,
            Class<?> clazz)

Register a class in the registry. Careful: do not use this from your code before first making sure this has been fully initialized. Otherwise, other implementations will not be found. Therefore, avoid calling this from your own Java code!

Parameters:

parent - Class

clazz - Implementation

registerAlias

protected static void registerAlias(Class<?> parent,
                 String alias,
                 String cname)

Register a class alias with the registry.

Parameters:

parent - Parent class

alias - Alias name

cname - Class name

tryLoadClass

private static Class<?> tryLoadClass(String value)

Attempt to load a class

Parameters:

value - Class name to try.

Returns:

Class, or null.

contains

protected static boolean contains(Class<?> c)

Test if a registry entry has already been created.

Parameters:

c - Class

Returns:

true if a registry entry has been created.

findAllImplementations

public static List<Class<?>> findAllImplementations(Class<?> restrictionClass)

Find all implementations of a particular interface.

Parameters:

restrictionClass - Class to scan for

Returns:

Found implementations

findAllImplementations

public static List<Class<?>> findAllImplementations(Class<?> c,
                                    boolean everything,
                                    boolean parameterizable)

Find all implementations of a given class in the classpath. Note: returned classes may be abstract.

Parameters:

c - Class restriction

everything - include interfaces, abstract and private classes

parameterizable - only return classes instantiable by the parameterizable API

Returns:

List of found classes.

findImplementation

public static <C> Class<? extends C> findImplementation(Class<? super C> restrictionClass,
                                        String value)

Find an implementation of the given interface / super class, given a relative class name or alias name.

Parameters:

restrictionClass - Restriction class

value - Class name, relative class name, or nickname.

Returns:

Class found or null