sag_connectivity_plugins.hpp

Go to the documentation of this file.

/*
 * Title:        sag_connectivity_plugins.hpp
 * Description:  C++ API for writing connectivity plugins
 * $Copyright (c) 2015-2017 Software AG, Darmstadt, Germany and/or Software AG USA Inc., Reston, VA, USA, and/or its subsidiaries and/or its affiliates and/or their licensors.$
 * Use, reproduction, transfer, publication or disclosure is prohibited except as specifically provided for in your License Agreement with Software AG
 * @Version:     $Id: sag_connectivity_plugins.hpp 302070 2017-02-13 15:27:24Z cree $
 */

#ifndef _SAG_CONNECTIVITY_PLUGINS_HPP_
#define _SAG_CONNECTIVITY_PLUGINS_HPP_

#include <sag_connectivity_cpp.hpp>
#include <sag_plugin_logging.hpp>
#include <memory>

// must define __STDC_FORMAT_MACROS before first include of inttypes else printf macros won't be defined
#ifndef __STDC_FORMAT_MACROS
#define __STDC_FORMAT_MACROS 1
#endif
#include <inttypes.h>

namespace com {
namespace softwareag {
namespace connectivity { 

enum class Direction { 
        TOWARDS_HOST = 1,
        TOWARDS_TRANSPORT = 2
};

class PluginHost {
        friend class Plugin;
public:
        typedef std::unique_ptr<PluginHost> ptr_t;

        void enableReliability(Direction direction) { 
                if (SAG_ERROR_OK != sag_enable_reliability(chain, static_cast<int>(direction))) { 
                        throw std::runtime_error("An error occurred while setting chain reliability"); 
                }
        }
        
        bool isShuttingDown() { 
                bool isShuttingDown = false; 
                if (SAG_ERROR_OK != sag_is_host_shutting_down(chain, isShuttingDown)) {
                        throw std::runtime_error("An error occurred while checking if host is shutting down");
                }
                return isShuttingDown; 
        }
private:
        PluginHost(void* chain = NULL) :chain(chain) {}
        void* chain;
};

// forward decl for parameters friend
class Plugin;

class PluginConstructorParameters
{
        // for constructor access to connectivityManager
        friend class Plugin;

public:
        class TransportConstructorParameters;

        class CodecConstructorParameters;

        const map_t &getConfig() const { return config; }

        const std::string &getChainId() const { return chainId; }

        const std::string &getPluginName() const { return pluginName; }

protected:
        PluginConstructorParameters(const std::string &pluginName, const std::string &chainId, const map_t &config, void* connectivityManager, void* chain)
                : chainId(chainId), pluginName(pluginName), config(config.copy()), connectivityManager(connectivityManager), chain(chain)
        {}

private:
        std::string chainId;
        std::string pluginName;
        map_t config;
        void* connectivityManager;
        void* chain;
};

class PluginConstructorParameters::TransportConstructorParameters : public PluginConstructorParameters
{
public:
        TransportConstructorParameters(const std::string &pluginName, const std::string &chainId, const map_t &config, void* connectivityManager, void* reserved)
        : PluginConstructorParameters(pluginName, chainId, config, connectivityManager, reserved)
        {}
};

class PluginConstructorParameters::CodecConstructorParameters : public PluginConstructorParameters
{
public:
        CodecConstructorParameters(const std::string &pluginName, const std::string &chainId, const map_t &config, void* connectivityManager, void* reserved)
        : PluginConstructorParameters(pluginName, chainId, config, connectivityManager, reserved)
        {}
};


class StatusReporter
{
public:

        static const char* STATUS_ONLINE() { return "ONLINE"; }
        static const char* STATUS_STARTING() { return "STARTING"; }
        static const char* STATUS_FAILED() { return "FAILED"; }


        class StatusItem
        {
                friend class StatusReporter;
        public:

                ~StatusItem()
                {
                        sag_delete_user_status_item(connectivityManager, underlying);
                        underlying.item = 0; // use nullptr when compiler supports it
                }

                void setStatus(const std::string &value)
                {
                        if (!underlying.item) throw std::runtime_error("Cannot call setStatus after StatusItem has been deleted!");

                        if (value == lastValue) return; // no-op this case
                        lastValue = value;

                        sag_set_user_status_item(underlying, value.c_str());
                }

                void setStatus(int64_t value)
                {
                        intValue = value;
                        setStatus(toString(value));
                }

                std::string getStatus() { return lastValue; }

                void increment(int64_t incrementValue = 1)
                {
                        intValue += incrementValue;
                        setStatus(intValue);
                }

                const std::string &key() { return mkey; }


        private:

                static const std::string toString(int64_t value)
                {
                        // stringstream is very slow when called from multiple threads concurrently, so doing this 
                        // to avoid introducing a bottleneck on the critical path
                        char result[25];
#if defined(_WIN32) || defined(__WIN32) || defined(WIN32)
                        // snprintf will be supported in VS 2015, but until then:
                        _snprintf_s(result, sizeof(result), _TRUNCATE, "%" PRId64, value);
#else
                        snprintf(result, sizeof(result), "%" PRId64, value);
#endif
                        return std::string(result);     
                }

                StatusItem(const StatusItem& other) = delete; // non construction-copyable
                StatusItem& operator=(const StatusItem&) = delete; // non copyable

                StatusItem(void* connectivityManager, const std::string &key, const std::string &initialValue, const int64_t intValue)
                        : intValue(intValue),
                        mkey(key),
                        lastValue(initialValue),
                        connectivityManager(connectivityManager),
                        underlying(sag_create_user_status_item(connectivityManager, key.c_str(), initialValue.c_str()))
                {
                        if (!underlying.item)
                        {
                                std::ostringstream oss;
                                oss << "Failed to create status item '" << key << "' (ensure the key is unique and that this plug-in has not been shutdown already)";
                                throw std::runtime_error(oss.str());
                        }
                }

                int64_t intValue;
                const std::string mkey;
                std::string lastValue;
                void* connectivityManager;
                sag_status_item_t underlying;
        };

        std::unique_ptr<StatusItem> createStatusItem(const std::string &key, const std::string &initialValue)
        {
                return std::unique_ptr<StatusItem>(new StatusItem(connectivityManager, key, initialValue, 0));
        }

        std::unique_ptr<StatusItem> createStatusItem(const std::string &key, int64_t initialValue)
        {
                std::ostringstream oss;
                oss << initialValue;
                return std::unique_ptr<StatusItem>(new StatusItem(connectivityManager, key, oss.str(), initialValue));
        }

        void setStatus(const map_t &statusmap)
        {
                sag_set_user_status_map(connectivityManager, reinterpret_cast<const sag_underlying_map_t&>(statusmap));
                // keep track of what keys we've added so we can automatically remove them when we're destroyed
                for (auto it = statusmap.cbegin(); it != statusmap.cend(); it++)
                        if (it->first.type_tag() == SAG_DATA_STRING) // ignore invalid ones
                        {
                        if (it->second.empty())
                                mapKeysToCleanup.erase(it->first);
                        else
                                mapKeysToCleanup.insert(it->first.copy(), std::move(data_t()));
                        }
        }



        ~StatusReporter()
        {
                if (!mapKeysToCleanup.empty())
                        sag_set_user_status_map(connectivityManager, reinterpret_cast<const sag_underlying_map_t&>(mapKeysToCleanup));
        }

        explicit StatusReporter(void *connectivityManager) : connectivityManager(connectivityManager), mapKeysToCleanup()
        {
        }

private:
        void* connectivityManager;
        map_t mapKeysToCleanup;


        StatusReporter() = delete;

        // non-copyable, due to the cleanup code we don't want people to shoot themselves in the foot by having multiple copies
        StatusReporter(const StatusReporter& other) = delete; 
        StatusReporter& operator=(const StatusReporter&) = delete; 

};

class Plugin
{
public:
        /* Legacy constructor [DEPRECATED]. 
        @deprecated This constructor signature is deprecated, please use the alternative constructor.
        */
        Plugin(const std::string &pluginName, const std::string &chainId, const map_t &config)
                : name(pluginName), pluginName(pluginName), chainId(chainId), config(config.copy()), host(new PluginHost()), LOGGER(pluginName + "." + chainId), logger(name + "." + chainId), statusReporter()
        {
                logger.info("The %s connectivity plug-in in chain '%s' is using the deprecated legacy (std::string&,std::string&,map_t&) constructor. We recommend changing to use the recommended (PluginConstructorParameters&) constructor instead.", 
                        pluginName.c_str(), chainId.c_str());
        }

        /* Constructor.
        * @since 9.12.0.1
        */
        Plugin(const PluginConstructorParameters &params)
                : name(params.getPluginName()), pluginName(params.getPluginName()), chainId(params.getChainId()), config(params.getConfig().copy()),
                host(new PluginHost(params.chain)), LOGGER(params.getPluginName() + "." + params.getChainId()), logger(pluginName + "." + chainId), 
                statusReporter(new StatusReporter(params.connectivityManager))
        {
        }

        virtual ~Plugin() {}

        virtual void start() {}

        virtual void hostReady() {}

        virtual void shutdown() {}
        const std::string &getName() const { return name; }
protected:
        const std::string name;
        const std::string pluginName;
        const std::string chainId;
        map_t config;
        const PluginHost::ptr_t host;
        StatusReporter &getStatusReporter() {
                if (statusReporter) return *statusReporter;
                throw std::runtime_error("Cannot call getStatusReporter when using the legacy constructor");
        }

public:
        Logger LOGGER;

        Logger logger;
private:
        std::unique_ptr<StatusReporter> statusReporter;
};

class HostSide
{
public:
        virtual ~HostSide() {}
        typedef std::auto_ptr<HostSide> ptr_t;
        virtual void sendBatchTowardsHost(Message *start, Message *end) = 0;
};

class RemoteHostSide: public HostSide
{
public:
        RemoteHostSide(sag_plugin_t other, sag_send_fn_t fn): other(other), fn(fn) {}
        virtual ~RemoteHostSide() {}
        virtual void sendBatchTowardsHost(Message *start, Message *end);
private:
        sag_plugin_t other;
        sag_send_fn_t fn;
};

class TransportSide
{
public:
        virtual ~TransportSide() {}
        typedef std::auto_ptr<TransportSide> ptr_t;
        virtual void sendBatchTowardsTransport(Message *start, Message *end) = 0;
};

class RemoteTransportSide: public TransportSide
{
public:
        RemoteTransportSide(sag_plugin_t other, sag_send_fn_t fn): other(other), fn(fn) {}
        virtual ~RemoteTransportSide() {}
        virtual void sendBatchTowardsTransport(Message *start, Message *end);
private:
        sag_plugin_t other;
        sag_send_fn_t fn;
};


class AbstractCodec: public Plugin, public HostSide, public TransportSide
{
public:
        typedef PluginConstructorParameters::CodecConstructorParameters CodecConstructorParameters;

        AbstractCodec(const std::string &pluginName, const std::string &chainId, const map_t &config)
                : Plugin(pluginName, chainId, config)
        {}

        AbstractCodec(const PluginConstructorParameters::CodecConstructorParameters &params)
                : Plugin(params)
        {}

        // these methods do not need to show up in doxygen
        /* Called between construction and start() to set the hostSide field  */
        virtual void setNextTowardsHost(HostSide::ptr_t &&host)
        {
                hostSide = std::move(host);
        }
        /* Called between construction and start() to set the transportSide field */
        virtual void setNextTowardsTransport(TransportSide::ptr_t &&transport)
        {
                transportSide = std::move(transport);
        }
protected:
        HostSide::ptr_t hostSide;

        TransportSide::ptr_t transportSide;
};

class AbstractTransport: public Plugin, public TransportSide
{
public:
        typedef PluginConstructorParameters::TransportConstructorParameters TransportConstructorParameters;

        AbstractTransport(const std::string &name, const std::string &chainId, const map_t &config)
                : Plugin(name, chainId, config) 
        {}

        AbstractTransport(const PluginConstructorParameters::TransportConstructorParameters &params)
                : Plugin(params)
        {}

        // this method does not need to show up in doxygen
        /* Called between construction and start() to set the hostSide field */
        virtual void setNextTowardsHost(HostSide::ptr_t &&host)
        {
                hostSide = std::move(host);
        }

protected:
        HostSide::ptr_t hostSide;
};

class AbstractSimpleTransport: public AbstractTransport
{
public:

        AbstractSimpleTransport(const std::string &name, const std::string &chainId, const map_t &config)
                : AbstractTransport(name, chainId, config)
        {}

        AbstractSimpleTransport(const PluginConstructorParameters::TransportConstructorParameters &params)
                : AbstractTransport(params)
        {}


        virtual void sendBatchTowardsTransport(Message *start, Message *end)
        {
                for (Message *it = start; it != end; ++it) {
                        try {
                                if (it->getPayload().empty()) {
                                        deliverNullPayloadTowardsTransport(*it);
                                } else {
                                        deliverMessageTowardsTransport(*it);
                                }
                        } catch (...) {
                                handleException(*it);
                        }
                }
        }
        virtual void deliverMessageTowardsTransport(Message &msg) = 0;
        virtual void deliverNullPayloadTowardsTransport(Message &msg) 
        {
                // do nothing
        }

        virtual void handleException(Message &m)
        {
                try {
                        throw;
                } catch (const std::exception &e) {
                        logger.warn("Caught exception delivering message: %s", e.what());
                } catch (...) {
                        logger.warn("Caught unknown exception delivering message: %s");
                }
        }
};

class AbstractSimpleCodec: public AbstractCodec
{
public:
        AbstractSimpleCodec(const std::string &name, const std::string &chainId, const map_t &config)
                : AbstractCodec(name, chainId, config) 
        {}

        AbstractSimpleCodec(const PluginConstructorParameters::CodecConstructorParameters &params)
                : AbstractCodec(params)
        {}

        virtual void sendBatchTowardsHost(Message *start, Message *end)
        {
                Message *curr = start;
                for (Message *it = start; it != end; ++it) {
                        bool rv;
                        try {
                                if (it->getPayload().empty()) {
                                        rv = transformNullPayloadTowardsHost(*it);
                                } else {
                                        rv = transformMessageTowardsHost(*it);
                                }
                        } catch (...) {
                                rv = handleException(*it, false);
                        }
                        // if we keep it (and it didn't throw) swap it with the accumulator
                        if (rv) {
                                if (it != curr) it->swap(std::move(*curr)); // don't self-swap
                                ++curr;
                        }
                }
                if (hostSide.get()) hostSide->sendBatchTowardsHost(start, curr);
        }
        virtual void sendBatchTowardsTransport(Message *start, Message *end)
        {
                Message *curr = start;
                for (Message *it = start; it != end; ++it) {
                        bool rv;
                        try {
                                // process the message
                                if (it->getPayload().empty()) {
                                        rv = transformNullPayloadTowardsTransport(*it);
                                } else {
                                        rv = transformMessageTowardsTransport(*it);
                                }
                        } catch (...) {
                                rv = handleException(*it, true);
                        }
                        // if we keep it (and it didn't throw) swap it with the accumulator
                        if (rv) {
                                if (it != curr) it->swap(std::move(*curr)); // don't self-swap
                                ++curr;
                        }
                }
                if (transportSide.get()) transportSide->sendBatchTowardsTransport(start, curr);
        }

        virtual bool transformMessageTowardsHost(Message &msg) = 0;
        virtual bool transformMessageTowardsTransport(Message &msg) = 0;
        virtual bool transformNullPayloadTowardsHost(Message &msg)
        {
                // do nothing
                return true;
        }
        virtual bool transformNullPayloadTowardsTransport(Message &msg)
        {
                // do nothing
                return true;
        }
        virtual bool handleException(Message &m, bool towardsTransport)
        {
                try {
                        throw;
                } catch (const std::exception &e) {
                        logger.warn("Caught exception transforming message: %s", e.what());
                } catch (...) {
                        logger.warn("Caught unknown exception transforming message");
                }
                return false;
        }
};

}}} // com.softwareag.connectivity

// internal implementation included from these files
#include <sag_internal/exception.hpp>
#include <sag_internal/remote_plugins.hpp>
#include <sag_internal/plugin_macros.hpp>

#define SAG_DECLARE_CONNECTIVITY_TRANSPORT_CLASS(Class) _SAG_DECLARE_CONNECTIVITY_TRANSPORT_CLASS(Class)

#define SAG_DECLARE_CONNECTIVITY_TRANSPORT(Class) _SAG_DECLARE_CONNECTIVITY_TRANSPORT_LEGACY(Class)

#define SAG_DECLARE_CONNECTIVITY_CODEC_CLASS(Class) _SAG_DECLARE_CONNECTIVITY_CODEC_CLASS(Class)

#define SAG_DECLARE_CONNECTIVITY_CODEC(Class) _SAG_DECLARE_CONNECTIVITY_CODEC_LEGACY(Class)

#endif // _SAG_CONNECTIVITY_PLUGINS_HPP_