/******************************************************************************** * Copyright (C) 2014-2017 GSI Helmholtzzentrum fuer Schwerionenforschung GmbH * * * * This software is distributed under the terms of the * * GNU Lesser General Public Licence (LGPL) version 3, * * copied verbatim in the file "LICENSE" * ********************************************************************************/ #ifndef FAIRMQTRANSPORTFACTORY_H_ #define FAIRMQTRANSPORTFACTORY_H_ #include "FairMQMessage.h" #include "FairMQSocket.h" #include "FairMQPoller.h" #include "FairMQRegion.h" #include "FairMQLogger.h" #include "FairMQTransports.h" #include #include #include #include class FairMQChannel; class FairMQProgOptions; class FairMQTransportFactory { private: /// Topology wide unique id const std::string fkId; public: /// ctor /// @param id Topology wide unique id, usually the device id. FairMQTransportFactory(const std::string& id); auto GetId() const -> const std::string { return fkId; }; /// @brief Create empty FairMQMessage /// @return pointer to FairMQMessage virtual FairMQMessagePtr CreateMessage() const = 0; /// @brief Create new FairMQMessage of specified size /// @param size message size /// @return pointer to FairMQMessage virtual FairMQMessagePtr CreateMessage(const size_t size) const = 0; /// @brief Create new FairMQMessage with user provided buffer and size /// @param data pointer to user provided buffer /// @param size size of the user provided buffer /// @param ffn callback, called when the message is transfered (and can be deleted) /// @param obj optional helper pointer that can be used in the callback /// @return pointer to FairMQMessage virtual FairMQMessagePtr CreateMessage(void* data, const size_t size, fairmq_free_fn* ffn, void* hint = nullptr) const = 0; virtual FairMQMessagePtr CreateMessage(FairMQRegionPtr& region, void* data, const size_t size) const = 0; /// Create a socket virtual FairMQSocketPtr CreateSocket(const std::string& type, const std::string& name) const = 0; /// Create a poller for a single channel (all subchannels) virtual FairMQPollerPtr CreatePoller(const std::vector& channels) const = 0; /// Create a poller for specific channels virtual FairMQPollerPtr CreatePoller(const std::vector& channels) const = 0; /// Create a poller for specific channels (all subchannels) virtual FairMQPollerPtr CreatePoller(const std::unordered_map>& channelsMap, const std::vector& channelList) const = 0; /// Create a poller for two sockets virtual FairMQPollerPtr CreatePoller(const FairMQSocket& cmdSocket, const FairMQSocket& dataSocket) const = 0; virtual FairMQRegionPtr CreateRegion(const size_t size) const = 0; /// Get transport type virtual FairMQ::Transport GetType() const = 0; virtual ~FairMQTransportFactory() {}; static auto CreateTransportFactory(const std::string& type, const std::string& id = "", const FairMQProgOptions* config = nullptr) -> std::shared_ptr; static void FairMQNoCleanup(void* /*data*/, void* /*obj*/) { } template static void FairMQSimpleMsgCleanup(void* /*data*/, void* obj) { delete static_cast(obj); } template inline FairMQMessagePtr NewSimpleMessage(const T& data) const { // todo: is_trivially_copyable not available on gcc < 5, workaround? // static_assert(std::is_trivially_copyable::value, "The argument type for NewSimpleMessage has to be trivially copyable!"); T* dataCopy = new T(data); return CreateMessage(dataCopy, sizeof(T), FairMQSimpleMsgCleanup, dataCopy); } template inline FairMQMessagePtr NewSimpleMessage(const char(&data)[N]) const { std::string* msgStr = new std::string(data); return CreateMessage(const_cast(msgStr->c_str()), msgStr->length(), FairMQSimpleMsgCleanup, msgStr); } inline FairMQMessagePtr NewSimpleMessage(const std::string& str) const { std::string* msgStr = new std::string(str); return CreateMessage(const_cast(msgStr->c_str()), msgStr->length(), FairMQSimpleMsgCleanup, msgStr); } template inline FairMQMessagePtr NewStaticMessage(const T& data) const { return CreateMessage(data, sizeof(T), FairMQNoCleanup, nullptr); } inline FairMQMessagePtr NewStaticMessage(const std::string& str) const { return CreateMessage(const_cast(str.c_str()), str.length(), FairMQNoCleanup, nullptr); } }; #endif /* FAIRMQTRANSPORTFACTORY_H_ */