be.SIRAPRISE.typeimplementations

Class TypeImplementationsManager

java.lang.Object

be.SIRAPRISE.typeimplementations.TypeImplementationsManager

Direct Known Subclasses:

ClientSideTypeImplementationsManager, ServerSideTypeImplementationsManager

public abstract class TypeImplementationsManager
extends java.lang.Object

The interface for TypeImplementations Managers.

Author:

Erwin

Constructor Summary

Constructors

Constructor and Description
TypeImplementationsManager() Creates the TypeImplementationsManager, and preloads the cache with the types named in the PRELOAD property of the class' properties file

Method Summary

Modifier and Type	Method and Description
long	cacheSize() Gets the size of the type cache
static AbstractTypeImplementation_V0105	findTypeImplementationInCP(NameIdentifier typeName, java.util.List<java.lang.String> typeImplementationsSearchPath) Attempts to load a TypeImplementation object for the given typeName from the JVM's classpath.
static TypeImplementationsManager	getInstance() Gets the instance of the TypeImplementationsManager service for this JVM
AbstractTypeImplementation_V0105	getTypeImplementation(NameIdentifier typeName) Gets the TypeImplementation object corresponding to the given typeDeclaration
AbstractTypeImplementation_V0105	getTypeImplementationWithoutException(NameIdentifier typeName) Gets the TypeImplementation object corresponding to the given typeDeclaration
static java.lang.String	getUnqualifiedClassName(java.lang.String typeName) Gets The unqualified classname for the given type's implementing class, if the type were java-backed.
void	removeTypeImplementation(NameIdentifier typeName) Removes the implementation for the named type
void	reset() Resets the TypeImplementationsManager by clearing the type implementations cache, except for those that are mentioned in the PRELOAD config property.

Methods inherited from class java.lang.Object

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

Constructor Detail

TypeImplementationsManager

public TypeImplementationsManager()

Creates the TypeImplementationsManager, and preloads the cache with the types named in the PRELOAD property of the class' properties file

Method Detail

findTypeImplementationInCP

public static AbstractTypeImplementation_V0105 findTypeImplementationInCP(NameIdentifier typeName,
                                                                          java.util.List<java.lang.String> typeImplementationsSearchPath)
                                                                   throws NotFoundException

Attempts to load a TypeImplementation object for the given typeName from the JVM's classpath.

Parameters:

typeName - The name of the Type for which an implementation object is sought

typeImplementationsSearchPath - A CSV list of fully-qualified package names.

Returns:

A TypeImplementation object for the named type

Throws:

NotFoundException - If no implementation could be returned

TypeImplementationsManagerRunTimeException - if an impementing class could be found for the named type, but some problem prevented that class from being instantiated

getInstance

public static TypeImplementationsManager getInstance()

Gets the instance of the TypeImplementationsManager service for this JVM

Returns:

the instance of the TypeImplementationsManager service for this JVM

getUnqualifiedClassName

public static java.lang.String getUnqualifiedClassName(java.lang.String typeName)

Gets The unqualified classname for the given type's implementing class, if the type were java-backed.

Parameters:

typeName - the type's identifying name

Returns:

The unqualified classname for the given type's implementing class, if the type were java-backed.

cacheSize

public final long cacheSize()

Gets the size of the type cache

Returns:

the size of the type cache

getTypeImplementation

public final AbstractTypeImplementation_V0105 getTypeImplementation(NameIdentifier typeName)
                                                             throws NotFoundException

Gets the TypeImplementation object corresponding to the given typeDeclaration

Parameters:

typeName - The type declaration object holding the name of a type, whose implementation object is to be fetched

Returns:

the TypeImplementation object corresponding to the given typeDeclaration

Throws:

NotFoundException - If no implementation could be returned

getTypeImplementationWithoutException

public final AbstractTypeImplementation_V0105 getTypeImplementationWithoutException(NameIdentifier typeName)

Gets the TypeImplementation object corresponding to the given typeDeclaration

Parameters:

typeName - The type declaration object holding the name of a type, whose implementation object is to be fetched

Returns:

the TypeImplementation object corresponding to the given typeDeclaration

removeTypeImplementation

public final void removeTypeImplementation(NameIdentifier typeName)

Removes the implementation for the named type

Parameters:

typeName - The name of the type whose implementation is to be removed

reset

public final void reset()

Resets the TypeImplementationsManager by clearing the type implementations cache, except for those that are mentioned in the PRELOAD config property.