FairMQ  1.2.0
C++ Message Passing Framework
FairMQTransportFactory.h
1 /********************************************************************************
2  * Copyright (C) 2014-2018 GSI Helmholtzzentrum fuer Schwerionenforschung GmbH *
3  * *
4  * This software is distributed under the terms of the *
5  * GNU Lesser General Public Licence (LGPL) version 3, *
6  * copied verbatim in the file "LICENSE" *
7  ********************************************************************************/
8 
9 #ifndef FAIRMQTRANSPORTFACTORY_H_
10 #define FAIRMQTRANSPORTFACTORY_H_
11 
12 #include <FairMQMessage.h>
13 #include <FairMQSocket.h>
14 #include <FairMQPoller.h>
15 #include <FairMQUnmanagedRegion.h>
16 #include <FairMQLogger.h>
17 #include <fairmq/Transports.h>
18 
19 #include <string>
20 #include <memory>
21 #include <vector>
22 #include <unordered_map>
23 
24 class FairMQChannel;
25 class FairMQProgOptions;
26 
28 {
29  private:
31  const std::string fkId;
32 
33  public:
36  FairMQTransportFactory(const std::string& id);
37 
38  auto GetId() const -> const std::string { return fkId; };
39 
42  virtual FairMQMessagePtr CreateMessage() const = 0;
46  virtual FairMQMessagePtr CreateMessage(const size_t size) const = 0;
53  virtual FairMQMessagePtr CreateMessage(void* data, const size_t size, fairmq_free_fn* ffn, void* hint = nullptr) const = 0;
54 
55  virtual FairMQMessagePtr CreateMessage(FairMQUnmanagedRegionPtr& unmanagedRegion, void* data, const size_t size, void* hint = 0) const = 0;
56 
58  virtual FairMQSocketPtr CreateSocket(const std::string& type, const std::string& name) const = 0;
59 
61  virtual FairMQPollerPtr CreatePoller(const std::vector<FairMQChannel>& channels) const = 0;
63  virtual FairMQPollerPtr CreatePoller(const std::vector<const FairMQChannel*>& channels) const = 0;
65  virtual FairMQPollerPtr CreatePoller(const std::unordered_map<std::string, std::vector<FairMQChannel>>& channelsMap, const std::vector<std::string>& channelList) const = 0;
67  virtual FairMQPollerPtr CreatePoller(const FairMQSocket& cmdSocket, const FairMQSocket& dataSocket) const = 0;
68 
69  virtual FairMQUnmanagedRegionPtr CreateUnmanagedRegion(const size_t size, FairMQRegionCallback callback = nullptr) const = 0;
70 
72  virtual FairMQ::Transport GetType() const = 0;
73 
74  virtual void Interrupt() = 0;
75  virtual void Resume() = 0;
76 
77  virtual ~FairMQTransportFactory() {};
78 
79  static auto CreateTransportFactory(const std::string& type, const std::string& id = "", const FairMQProgOptions* config = nullptr) -> std::shared_ptr<FairMQTransportFactory>;
80 
81  static void FairMQNoCleanup(void* /*data*/, void* /*obj*/)
82  {
83  }
84 
85  template<typename T>
86  static void FairMQSimpleMsgCleanup(void* /*data*/, void* obj)
87  {
88  delete static_cast<T*>(obj);
89  }
90 
91  template<typename T>
92  FairMQMessagePtr NewSimpleMessage(const T& data) const
93  {
94  // todo: is_trivially_copyable not available on gcc < 5, workaround?
95  // static_assert(std::is_trivially_copyable<T>::value, "The argument type for NewSimpleMessage has to be trivially copyable!");
96  T* dataCopy = new T(data);
97  return CreateMessage(dataCopy, sizeof(T), FairMQSimpleMsgCleanup<T>, dataCopy);
98  }
99 
100  template<std::size_t N>
101  FairMQMessagePtr NewSimpleMessage(const char(&data)[N]) const
102  {
103  std::string* msgStr = new std::string(data);
104  return CreateMessage(const_cast<char*>(msgStr->c_str()), msgStr->length(), FairMQSimpleMsgCleanup<std::string>, msgStr);
105  }
106 
107  FairMQMessagePtr NewSimpleMessage(const std::string& str) const
108  {
109 
110  std::string* msgStr = new std::string(str);
111  return CreateMessage(const_cast<char*>(msgStr->c_str()), msgStr->length(), FairMQSimpleMsgCleanup<std::string>, msgStr);
112  }
113 
114  template<typename T>
115  FairMQMessagePtr NewStaticMessage(const T& data) const
116  {
117  return CreateMessage(data, sizeof(T), FairMQNoCleanup, nullptr);
118  }
119 
120  FairMQMessagePtr NewStaticMessage(const std::string& str) const
121  {
122  return CreateMessage(const_cast<char*>(str.c_str()), str.length(), FairMQNoCleanup, nullptr);
123  }
124 };
125 
126 namespace fair
127 {
128 namespace mq
129 {
130 
131 struct TransportFactoryError : std::runtime_error { using std::runtime_error::runtime_error; };
132 
133 } /* namespace mq */
134 } /* namespace fair */
135 
136 #endif /* FAIRMQTRANSPORTFACTORY_H_ */
Definition: FairMQTransportFactory.h:131
virtual FairMQ::Transport GetType() const =0
Get transport type.
Definition: FairMQTransportFactory.h:27
virtual FairMQMessagePtr CreateMessage() const =0
Create empty FairMQMessage.
Definition: FairMQChannel.h:24
FairMQTransportFactory(const std::string &id)
Definition: FairMQTransportFactory.cxx:25
Definition: FairMQProgOptions.h:41
virtual FairMQPollerPtr CreatePoller(const std::vector< FairMQChannel > &channels) const =0
Create a poller for a single channel (all subchannels)
Definition: FairMQSocket.h:18
Definition: DeviceRunner.h:23
virtual FairMQSocketPtr CreateSocket(const std::string &type, const std::string &name) const =0
Create a socket.