Oracle Coherence for C++ API
Release 3.7.1.0
E22845-01

coherence/net/DefaultOperationalContext.hpp

/*
* DefaultOperationalContext.hpp
*
* Copyright (c) 2000, 2011, 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_DEFAULT_OPERATIONAL_CONTEXT_HPP
#define COH_DEFAULT_OPERATIONAL_CONTEXT_HPP

#include "coherence/lang.ns"

#include "coherence/net/Member.hpp"
#include "coherence/net/OperationalContext.hpp"
#include "coherence/run/xml/XmlDocument.hpp"
#include "coherence/run/xml/XmlElement.hpp"
#include "coherence/security/IdentityAsserter.hpp"
#include "coherence/security/IdentityTransformer.hpp"
#include "coherence/util/Map.hpp"

COH_OPEN_NAMESPACE2(coherence,net)

using coherence::run::xml::XmlDocument;
using coherence::run::xml::XmlElement;
using coherence::security::IdentityAsserter;
using coherence::security::IdentityTransformer;
using coherence::util::Map;


/**
* The DefaultOperationalContext provides an OperationalContext with
* information obtained from XML in coherence.dtd format, system properties
* (as set through environment variables) and default values.
*
* @author phf  2010.10.28
*
* @since Coherence 3.7
*/
class COH_EXPORT DefaultOperationalContext
    : public class_spec<DefaultOperationalContext,
        extends<Object>,
        implements<OperationalContext> >
    {
    friend class factory<DefaultOperationalContext>;

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

    protected:
        /**
        * Create a new DefaultOperationalContext.
        *
        * @param vXmlCoherence  an XML element corresponding to coherence.dtd
        */
        DefaultOperationalContext(XmlElement::View vXmlCoherence = NULL);


    // ----- typedef: ProductEdition ----------------------------------------

    public:
        /**
        * Extend editions.
        */
        typedef enum
            {
            edition_dc  = 0,
            edition_rtc = 1
            } ProductEdition;


    // ----- DefaultOperationalContext interface ----------------------------

    public:
        /**
        * The default XML configuration used when one isn't explicitly passed
        * in the constructor for this class.
        *
        * @return the default XML configuration
        */
        static XmlDocument::Handle getDefaultOperationalConfig();


    // ----- OperationalContext interface -----------------------------------

    public:
        /**
        * {@inheritDoc}
        */
        virtual int32_t getEdition() const;

        /**
        * {@inheritDoc}
        */
        virtual String::View getEditionName() const;

        /**
        * {@inheritDoc}
        */
        virtual Member::View getLocalMember() const;

        /**
        * {@inheritDoc}
        */
        virtual Map::View getFilterMap() const;

        /**
        * {@inheritDoc}
        */
        virtual IdentityAsserter::View getIdentityAsserter() const;

        /**
        * {@inheritDoc}
        */
        virtual IdentityTransformer::View getIdentityTransformer() const;

        /**
        * {@inheritDoc}
        */
        virtual bool isSubjectScopingEnabled() const;

        /**
        * {@inheritDoc}
        */
        virtual int32_t getLogLevel() const;

        /**
        * {@inheritDoc}
        */
        virtual int32_t getLogCharacterLimit() const;

        /**
        * {@inheritDoc}
        */
        virtual String::View getLogMessageFormat() const;

        /**
        * {@inheritDoc}
        */
        virtual String::View getLogDestination() const;


    // ----- data members ---------------------------------------------------

    protected:
        /**
        * The configured edition.
        */
        int32_t m_nEdition;

        /**
        * The configured edition in a formatted string for use by the Logger.
        */
        FinalView<String> m_vsEdition;

        /**
        * The configured Filter map.
        *
        * See OperationalContext::getFilterMap() for a description of the
        * keys and values.
        */
        FinalView<Map> m_vFilterMap;

        /**
        * The configured local member.
        */
        FinalView<Member> m_vMemberLocal;

        /**
        * The configured IdentityAsserter that validates a token in order to
        * establish a user's identity.
        */
        FinalView<IdentityAsserter> m_vAsserter;

        /**
        * The configured IdentityTransformer that transforms a Subject into
        * a token that asserts a user's identity.
        */
        FinalView<IdentityTransformer> m_vTransformer;

        /**
        * True iff subject scope configuration is set to true.
        */
        bool m_fSubjectScoped;

        /**
        * The configured logging severity level.
        */
        int32_t m_nLogLevel;

        /**
        * The the maximum number of characters for a logger daemon to queue
        * before truncating.
        */
        int32_t m_nLogCharacterLimit;

        /**
        * The configured log message format.
        */
        FinalView<String> m_vsLogMessageFormat;

        /**
        * The configured destination for log messages.
        */
        FinalView<String> m_vsLogDestination;
    };

COH_CLOSE_NAMESPACE2

#endif // COH_DEFAULT_OPERATIONAL_CONTEXT_HPP

Copyright © 2000, 2011, Oracle and/or its affiliates. All rights reserved.