FairMQ  1.3.7
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 <FairMQLogger.h>
13 #include <FairMQMessage.h>
14 #include <FairMQPoller.h>
15 #include <FairMQSocket.h>
16 #include <FairMQUnmanagedRegion.h>
17 #include <fairmq/MemoryResources.h>
18 #include <fairmq/Transports.h>
19 
20 #include <string>
21 #include <memory>
22 #include <vector>
23 #include <unordered_map>
24 
25 class FairMQChannel;
26 class FairMQProgOptions;
27 
29 {
30  private:
32  const std::string fkId;
33 
35  fair::mq::ChannelResource fMemoryResource{this};
36 
37  public:
40  FairMQTransportFactory(const std::string& id);
41 
42  auto GetId() const -> const std::string { return fkId; };
43 
45  fair::mq::ChannelResource* GetMemoryResource() { return &fMemoryResource; }
46 
49  virtual FairMQMessagePtr CreateMessage() = 0;
53  virtual FairMQMessagePtr CreateMessage(const size_t size) = 0;
60  virtual FairMQMessagePtr CreateMessage(void* data, const size_t size, fairmq_free_fn* ffn, void* hint = nullptr) = 0;
61 
62  virtual FairMQMessagePtr CreateMessage(FairMQUnmanagedRegionPtr& unmanagedRegion, void* data, const size_t size, void* hint = 0) = 0;
63 
65  virtual FairMQSocketPtr CreateSocket(const std::string& type, const std::string& name) = 0;
66 
68  virtual FairMQPollerPtr CreatePoller(const std::vector<FairMQChannel>& channels) const = 0;
70  virtual FairMQPollerPtr CreatePoller(const std::vector<FairMQChannel*>& channels) const = 0;
72  virtual FairMQPollerPtr CreatePoller(const std::unordered_map<std::string, std::vector<FairMQChannel>>& channelsMap, const std::vector<std::string>& channelList) const = 0;
73 
74  virtual FairMQUnmanagedRegionPtr CreateUnmanagedRegion(const size_t size, FairMQRegionCallback callback = nullptr) const = 0;
75 
77  virtual fair::mq::Transport GetType() const = 0;
78 
79  virtual void Interrupt() = 0;
80  virtual void Resume() = 0;
81  virtual void Reset() = 0;
82 
83  virtual ~FairMQTransportFactory() {};
84 
85  static auto CreateTransportFactory(const std::string& type, const std::string& id = "", const FairMQProgOptions* config = nullptr) -> std::shared_ptr<FairMQTransportFactory>;
86 
87  static void FairMQNoCleanup(void* /*data*/, void* /*obj*/)
88  {
89  }
90 
91  template<typename T>
92  static void FairMQSimpleMsgCleanup(void* /*data*/, void* obj)
93  {
94  delete static_cast<T*>(obj);
95  }
96 
97  template<typename T>
98  FairMQMessagePtr NewSimpleMessage(const T& data)
99  {
100  // todo: is_trivially_copyable not available on gcc < 5, workaround?
101  // static_assert(std::is_trivially_copyable<T>::value, "The argument type for NewSimpleMessage has to be trivially copyable!");
102  T* dataCopy = new T(data);
103  return CreateMessage(dataCopy, sizeof(T), FairMQSimpleMsgCleanup<T>, dataCopy);
104  }
105 
106  template<std::size_t N>
107  FairMQMessagePtr NewSimpleMessage(const char(&data)[N])
108  {
109  std::string* msgStr = new std::string(data);
110  return CreateMessage(const_cast<char*>(msgStr->c_str()), msgStr->length(), FairMQSimpleMsgCleanup<std::string>, msgStr);
111  }
112 
113  FairMQMessagePtr NewSimpleMessage(const std::string& str)
114  {
115 
116  std::string* msgStr = new std::string(str);
117  return CreateMessage(const_cast<char*>(msgStr->c_str()), msgStr->length(), FairMQSimpleMsgCleanup<std::string>, msgStr);
118  }
119 
120  template<typename T>
121  FairMQMessagePtr NewStaticMessage(const T& data)
122  {
123  return CreateMessage(data, sizeof(T), FairMQNoCleanup, nullptr);
124  }
125 
126  FairMQMessagePtr NewStaticMessage(const std::string& str)
127  {
128  return CreateMessage(const_cast<char*>(str.c_str()), str.length(), FairMQNoCleanup, nullptr);
129  }
130 };
131 
132 namespace fair
133 {
134 namespace mq
135 {
136 
137 struct TransportFactoryError : std::runtime_error { using std::runtime_error::runtime_error; };
138 
139 } /* namespace mq */
140 } /* namespace fair */
141 
142 #endif /* FAIRMQTRANSPORTFACTORY_H_ */
virtual FairMQMessagePtr CreateMessage()=0
Create empty FairMQMessage.
Definition: FairMQTransportFactory.h:137
Definition: FairMQTransportFactory.h:28
virtual FairMQSocketPtr CreateSocket(const std::string &type, const std::string &name)=0
Create a socket.
Definition: FairMQChannel.h:27
FairMQTransportFactory(const std::string &id)
Definition: FairMQTransportFactory.cxx:25
Definition: FairMQProgOptions.h:37
virtual FairMQPollerPtr CreatePoller(const std::vector< FairMQChannel > &channels) const =0
Create a poller for a single channel (all subchannels)
fair::mq::ChannelResource * GetMemoryResource()
Get a pointer to the associated polymorphic memory resource.
Definition: FairMQTransportFactory.h:45
Definition: MemoryResources.h:60
Tools for interfacing containers to the transport via polymorphic allocators.
Definition: DeviceRunner.h:23
virtual fair::mq::Transport GetType() const =0
Get transport type.

privacy