coherence/lang/SystemClassLoader.hpp

/*
* SystemClassLoader.hpp
*
* Copyright (c) 2000, 2009, Oracle and/or its affiliates. All rights reserved.
*
* Oracle is a registered trademarks of Oracle Corporation and/or its
* affiliates.
*
* This software is the confidential and proprietary information of Oracle
* Corporation. You shall not disclose such confidential and proprietary
* information and shall use it only in accordance with the terms of the
* license agreement you entered into with Oracle.
*
* This notice may not be removed or altered.
*/
#ifndef COH_SYSTEM_CLASS_LOADER_HPP
#define COH_SYSTEM_CLASS_LOADER_HPP

#include "coherence/lang/compatibility.hpp"

#include "coherence/lang/Class.hpp"
#include "coherence/lang/ClassLoader.hpp"
#include "coherence/lang/ObjectArray.hpp"
#include "coherence/lang/TypedClass.hpp"
#include "coherence/lang/TypedExecutableClass.hpp"

COH_OPEN_NAMESPACE2(coherence,lang)


/**
* 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
*/
class COH_EXPORT SystemClassLoader
    : public class_spec<SystemClassLoader,
        extends<Object>,
        implements<ClassLoader> >
    {
    friend class factory<SystemClassLoader>;

    // ----- constructors ---------------------------------------------------

    protected:
        /**
        * @internal
        */
        using this_spec::create;

    private:
        /**
        * @internal
        */
        SystemClassLoader();


    // ----- SystemClassLoader interface ------------------------------------

    public:
        /**
        * Register a class with the SystemClassLoader.
        *
        * @param vClass the Class to register
        *
        * @return the registered class
        *
        * @throws IllegalArgumentException if a Class of the same name has
        *         already been registered
        */
        virtual Class::View registerClass(Class::View vClass);


    // ----- ClassLoader interface ------------------------------------------

    public:
        /**
        * {@inheritDoc}
        */
        virtual Class::View loadByName(String::View vsName) const;

        /**
        * {@inheritDoc}
        */
        virtual Class::View loadByType(const std::type_info& info) const;

        /**
        * @return NULL
        */
        virtual ClassLoader::Handle getParent() const;


    // ----- Object interface -----------------------------------------------

    public:
        /**
        * {@inheritDoc}
        */
        void toStream(std::ostream& out) const;


    // ----- static methods -------------------------------------------------

    public:
        /**
        * Return the SystemClassLoader singleton.
        *
        * @return the SystemClassLoader
        */
        static SystemClassLoader::Handle getInstance();

        /**
        * Executable entrypoint for the SystemClassLoader class.
        *
        * Print the loaded classes.
        *
        * @param vasArg  a list of libraries to load, and print their
        *                registered classes.
        */
        static void main(ObjectArray::View vasArg);
    };


// ----- helper macros ------------------------------------------------------

/**
* Register a Class with the system class loader.
*
* @param CLASS the Class object to register
*/
#define COH_REGISTER_CLASS(CLASS) \
    COH_STATIC_INIT(coherence::lang::SystemClassLoader::getInstance()-> \
            registerClass(CLASS))

/**
* Register a TypedClass with the system class loader.
*
* @param TYPE the class type to register, i.e. coherence::lang::Object
*/
#define COH_REGISTER_TYPED_CLASS(TYPE) \
    COH_REGISTER_CLASS(coherence::lang::TypedClass<TYPE >::create())

/**
* Register a TypedExecutableClass with the system class loader.
*
* @param TYPE the class type to register, i.e. coherence::lang::Object
*/
#define COH_REGISTER_EXECUTABLE_CLASS(TYPE) \
    COH_REGISTER_CLASS((coherence::lang::TypedExecutableClass<TYPE, \
            coherence::lang::TypedClass<TYPE> >::create()))

COH_CLOSE_NAMESPACE2

#endif // COH_SYSTEM_CLASS_LOADER_HPP

Copyright (c) 2000, 2009, Oracle and/or its affiliates. All rights reserved.