Oracle Coherence for C++ API: SystemClassLoader Class Reference

Detailed Description

SystemClassLoader is a ClassLoader implementation based on registration only.

That is it does not "load" any classes, it only knows about those which have been registered with it.

Author:

mf 2008.04.03

Public Types

typedef spec::Handle

Handle

SystemClassLoader Handle definition.

typedef spec::View

View

SystemClassLoader View definition.

typedef spec::Holder

Holder

SystemClassLoader Holder definition.

Public Member Functions

virtual Class::View

registerClass (Class::View vClass)

virtual Class::View

loadByName (String::View vsName) const

Loads the class for the specified name.

Parameters:

vsName

the fully qualified name of the desired class

Returns:: the resulting Class object

Exceptions:

ClassNotFoundException

if the class was not found

virtual Class::View

loadByType (const std::type_info &info) const

Loads the class for the specified RTTI typeid.

Parameters:

info

the class's type_info

Returns:: the resulting Class object

Exceptions:

ClassNotFoundException

if the class was not found

virtual
ClassLoader::Handle

getParent () const

Returns:: NULL

void

toStream (std::ostream &out) const

Output a human-readable description of this Object to the given stream.

coherence::lang::operator<<(std::ostream, Object::View) is defined and will call into the toStream method, to output Objects. If a managed String object is desired, the COH_TO_STRING macro can be used to build up a String from streamable contents.

 Object::View vKey   = ...
 Object::View vValue = ...
 std::cout << vKey << " = " << vValue << std::endl;

 String::Handle hs = COH_TO_STRING(vKey << " = " << vValue);

Parameters:

out

the stream used to output the description

Static Public Member Functions

static
SystemClassLoader::Handle

getInstance ()

Return the SystemClassLoader singleton.

static void

main (ObjectArray::View vasArg)

Executable entrypoint for the SystemClassLoader class.

Member Function Documentation

virtual Class::View registerClass ( Class::View vClass ) [virtual]

Parameters:

vClass

the Class to register

Returns:: the registered class

Exceptions:

IllegalArgumentException

if a Class of the same name has already been registered

static SystemClassLoader::Handle getInstance ( ) [static]

Return the SystemClassLoader singleton.

Returns:: the SystemClassLoader

static void main ( ObjectArray::View vasArg ) [static]

Executable entrypoint for the SystemClassLoader class.

Print the loaded classes.

Parameters:

vasArg

a list of libraries to load, and print their registered classes.