coherence/io/pof/SystemPofContext.hpp

/*
* SystemPofContext.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_POF_CONTEXT_HPP
#define COH_SYSTEM_POF_CONTEXT_HPP

#include "coherence/lang.ns"

#include "coherence/io/pof/SimplePofContext.hpp"

COH_OPEN_NAMESPACE3(coherence,io,pof)


/**
* System-wide PofContext implementation that allows POF user types to
* be registered programatically.
*
* @author jh  2008.02.21
*/
class COH_EXPORT SystemPofContext
    : public class_spec<SystemPofContext,
        extends<SimplePofContext> >
    {
    friend class factory<SystemPofContext>;

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

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

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


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

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


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

/**
* Register a PofSerializer with the system PofContext. The call will also
* register the class with the SystemClassLoader.
*
* @param POF_TYPE_ID     the POF type identifier
* @param CLASS           the associated class to register
* @param POF_SERIALIZER  the PofSerializer instance to register
*/
#define COH_REGISTER_POF_SERIALIZER(POF_TYPE_ID, CLASS, POF_SERIALIZER) \
    COH_STATIC_INIT(coherence::io::pof::SystemPofContext::getInstance()-> \
        registerUserType(POF_TYPE_ID, \
            coherence::lang::SystemClassLoader::getInstance()-> \
            registerClass(CLASS), POF_SERIALIZER))

/**
* Register a PortableObject implementation with the system ClassLoader and
* PofContext.
*
* @param POF_TYPE_ID  the POF type identifier
* @param TYPE         the class type to register
*/
#define COH_REGISTER_PORTABLE_CLASS(POF_TYPE_ID, TYPE) \
    COH_REGISTER_POF_SERIALIZER(POF_TYPE_ID, \
        coherence::lang::TypedClass<TYPE >::create(), \
        coherence::io::pof::PortableObjectSerializer::create(POF_TYPE_ID))

/**
* Register a Managed object implementation with the system ClassLoader and
* PofContext.
*
* @param POF_TYPE_ID  the POF type identifier
* @param TYPE         the class type to register
*/
#define COH_REGISTER_MANAGED_CLASS(POF_TYPE_ID, TYPE) \
    COH_REGISTER_POF_SERIALIZER(POF_TYPE_ID, \
        coherence::lang::TypedClass<coherence::lang::Managed<TYPE > >::create(), \
        coherence::io::pof::TypedSerializer<coherence::lang::Managed<TYPE > >::create())

COH_CLOSE_NAMESPACE3

#endif // COH_SYSTEM_POF_CONTEXT_HPP

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