FairMQ  1.3.8
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  operator fair::mq::ChannelResource*() { return &fMemoryResource; }
47 
50  virtual FairMQMessagePtr CreateMessage() = 0;
54  virtual FairMQMessagePtr CreateMessage(const size_t size) = 0;
61  virtual FairMQMessagePtr CreateMessage(void* data, const size_t size, fairmq_free_fn* ffn, void* hint = nullptr) = 0;
62 
63  virtual FairMQMessagePtr CreateMessage(FairMQUnmanagedRegionPtr& unmanagedRegion, void* data, const size_t size, void* hint = 0) = 0;
64 
66  virtual FairMQSocketPtr CreateSocket(const std::string& type, const std::string& name) = 0;
67 
69  virtual FairMQPollerPtr CreatePoller(const std::vector<FairMQChannel>& channels) const = 0;
71  virtual FairMQPollerPtr CreatePoller(const std::vector<FairMQChannel*>& channels) const = 0;
73  virtual FairMQPollerPtr CreatePoller(const std::unordered_map<std::string, std::vector<FairMQChannel>>& channelsMap, const std::vector<std::string>& channelList) const = 0;
74 
75  virtual FairMQUnmanagedRegionPtr CreateUnmanagedRegion(const size_t size, FairMQRegionCallback callback = nullptr) const = 0;
76 
78  virtual fair::mq::Transport GetType() const = 0;
79 
80  virtual void Interrupt() = 0;
81  virtual void Resume() = 0;
82  virtual void Reset() = 0;
83 
84  virtual ~FairMQTransportFactory() {};
85 
86  static auto CreateTransportFactory(const std::string& type, const std::string& id = "", const FairMQProgOptions* config = nullptr) -> std::shared_ptr<FairMQTransportFactory>;
87 
88  static void FairMQNoCleanup(void* /*data*/, void* /*obj*/)
89  {
90  }
91 
92  template<typename T>
93  static void FairMQSimpleMsgCleanup(void* /*data*/, void* obj)
94  {
95  delete static_cast<T*>(obj);
96  }
97 
98  template<typename T>
99  FairMQMessagePtr NewSimpleMessage(const T& data)
100  {
101  // todo: is_trivially_copyable not available on gcc < 5, workaround?
102  // static_assert(std::is_trivially_copyable<T>::value, "The argument type for NewSimpleMessage has to be trivially copyable!");
103  T* dataCopy = new T(data);
104  return CreateMessage(dataCopy, sizeof(T), FairMQSimpleMsgCleanup<T>, dataCopy);
105  }
106 
107  template<std::size_t N>
108  FairMQMessagePtr NewSimpleMessage(const char(&data)[N])
109  {
110  std::string* msgStr = new std::string(data);
111  return CreateMessage(const_cast<char*>(msgStr->c_str()), msgStr->length(), FairMQSimpleMsgCleanup<std::string>, msgStr);
112  }
113 
114  FairMQMessagePtr NewSimpleMessage(const std::string& str)
115  {
116 
117  std::string* msgStr = new std::string(str);
118  return CreateMessage(const_cast<char*>(msgStr->c_str()), msgStr->length(), FairMQSimpleMsgCleanup<std::string>, msgStr);
119  }
120 
121  template<typename T>
122  FairMQMessagePtr NewStaticMessage(const T& data)
123  {
124  return CreateMessage(data, sizeof(T), FairMQNoCleanup, nullptr);
125  }
126 
127  FairMQMessagePtr NewStaticMessage(const std::string& str)
128  {
129  return CreateMessage(const_cast<char*>(str.c_str()), str.length(), FairMQNoCleanup, nullptr);
130  }
131 };
132 
133 namespace fair
134 {
135 namespace mq
136 {
137 
138 struct TransportFactoryError : std::runtime_error { using std::runtime_error::runtime_error; };
139 
140 } /* namespace mq */
141 } /* namespace fair */
142 
143 #endif /* FAIRMQTRANSPORTFACTORY_H_ */
virtual FairMQMessagePtr CreateMessage()=0
Create empty FairMQMessage.
Definition: FairMQTransportFactory.h:138
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