FairMQ  1.4.33
C++ Message Queuing Library and Framework
TransportFactory.h
1 /********************************************************************************
2  * Copyright (C) 2014 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 FAIR_MQ_ZMQ_TRANSPORTFACTORY_H
10 #define FAIR_MQ_ZMQ_TRANSPORTFACTORY_H
11 
12 #include <fairmq/zeromq/Context.h>
13 #include <fairmq/zeromq/Message.h>
14 #include <fairmq/zeromq/Socket.h>
15 #include <fairmq/zeromq/Poller.h>
16 #include <fairmq/zeromq/UnmanagedRegion.h>
17 #include <FairMQTransportFactory.h>
18 #include <fairmq/ProgOptions.h>
19 
20 #include <memory> // unique_ptr, make_unique
21 #include <string>
22 #include <vector>
23 
24 namespace fair::mq::zmq
25 {
26 
27 class TransportFactory final : public FairMQTransportFactory
28 {
29  public:
30  TransportFactory(const std::string& id = "", const ProgOptions* config = nullptr)
32  , fCtx(nullptr)
33  {
34  int major, minor, patch;
35  zmq_version(&major, &minor, &patch);
36  LOG(debug) << "Transport: Using ZeroMQ library, version: " << major << "." << minor << "." << patch;
37 
38  if (config) {
39  fCtx = std::make_unique<Context>(config->GetProperty<int>("io-threads", 1));
40  } else {
41  LOG(debug) << "fair::mq::ProgOptions not available! Using defaults.";
42  fCtx = std::make_unique<Context>(1);
43  }
44  }
45 
46  TransportFactory(const TransportFactory&) = delete;
47  TransportFactory operator=(const TransportFactory&) = delete;
48 
49  MessagePtr CreateMessage() override
50  {
51  return std::make_unique<Message>(this);
52  }
53 
54  MessagePtr CreateMessage(Alignment alignment) override
55  {
56  return std::make_unique<Message>(alignment, this);
57  }
58 
59  MessagePtr CreateMessage(const size_t size) override
60  {
61  return std::make_unique<Message>(size, this);
62  }
63 
64  MessagePtr CreateMessage(const size_t size, Alignment alignment) override
65  {
66  return std::make_unique<Message>(size, alignment, this);
67  }
68 
69  MessagePtr CreateMessage(void* data, const size_t size, fairmq_free_fn* ffn, void* hint = nullptr) override
70  {
71  return std::make_unique<Message>(data, size, ffn, hint, this);
72  }
73 
74  MessagePtr CreateMessage(UnmanagedRegionPtr& region, void* data, const size_t size, void* hint = 0) override
75  {
76  return std::make_unique<Message>(region, data, size, hint, this);
77  }
78 
79  SocketPtr CreateSocket(const std::string& type, const std::string& name) override
80  {
81  return std::make_unique<Socket>(*fCtx, type, name, GetId(), this);
82  }
83 
84  PollerPtr CreatePoller(const std::vector<FairMQChannel>& channels) const override
85  {
86  return std::make_unique<Poller>(channels);
87  }
88 
89  PollerPtr CreatePoller(const std::vector<FairMQChannel*>& channels) const override
90  {
91  return std::make_unique<Poller>(channels);
92  }
93 
94  PollerPtr CreatePoller(const std::unordered_map<std::string, std::vector<FairMQChannel>>& channelsMap, const std::vector<std::string>& channelList) const override
95  {
96  return std::make_unique<Poller>(channelsMap, channelList);
97  }
98 
99  UnmanagedRegionPtr CreateUnmanagedRegion(const size_t size, RegionCallback callback, const std::string& path = "", int flags = 0) override
100  {
101  return CreateUnmanagedRegion(size, 0, callback, nullptr, path, flags);
102  }
103 
104  UnmanagedRegionPtr CreateUnmanagedRegion(const size_t size, RegionBulkCallback bulkCallback, const std::string& path = "", int flags = 0) override
105  {
106  return CreateUnmanagedRegion(size, 0, nullptr, bulkCallback, path, flags);
107  }
108 
109  UnmanagedRegionPtr CreateUnmanagedRegion(const size_t size, const int64_t userFlags, RegionCallback callback, const std::string& path = "", int flags = 0) override
110  {
111  return CreateUnmanagedRegion(size, userFlags, callback, nullptr, path, flags);
112  }
113 
114  UnmanagedRegionPtr CreateUnmanagedRegion(const size_t size, const int64_t userFlags, RegionBulkCallback bulkCallback, const std::string& path = "", int flags = 0) override
115  {
116  return CreateUnmanagedRegion(size, userFlags, nullptr, bulkCallback, path, flags);
117  }
118 
119  UnmanagedRegionPtr CreateUnmanagedRegion(const size_t size, const int64_t userFlags, RegionCallback callback, RegionBulkCallback bulkCallback, const std::string&, int)
120  {
121  UnmanagedRegionPtr ptr = std::make_unique<UnmanagedRegion>(*fCtx, size, userFlags, callback, bulkCallback, this);
122  auto zPtr = static_cast<UnmanagedRegion*>(ptr.get());
123  fCtx->AddRegion(false, zPtr->GetId(), zPtr->GetData(), zPtr->GetSize(), zPtr->GetUserFlags(), RegionEvent::created);
124  return ptr;
125  }
126 
127  void SubscribeToRegionEvents(RegionEventCallback callback) override { fCtx->SubscribeToRegionEvents(callback); }
128  bool SubscribedToRegionEvents() override { return fCtx->SubscribedToRegionEvents(); }
129  void UnsubscribeFromRegionEvents() override { fCtx->UnsubscribeFromRegionEvents(); }
130  std::vector<RegionInfo> GetRegionInfo() override { return fCtx->GetRegionInfo(); }
131 
132  Transport GetType() const override { return Transport::ZMQ; }
133 
134  void Interrupt() override { fCtx->Interrupt(); }
135  void Resume() override { fCtx->Resume(); }
136  void Reset() override { fCtx->Reset(); }
137 
138  ~TransportFactory() override { LOG(debug) << "Destroying ZeroMQ transport..."; }
139 
140  private:
141  std::unique_ptr<Context> fCtx;
142 };
143 
144 } // namespace fair::mq::zmq
145 
146 #endif /* FAIR_MQ_ZMQ_TRANSPORTFACTORY_H */
fair::mq::Alignment
Definition: FairMQMessage.h:25
fair::mq::zmq::TransportFactory::SubscribeToRegionEvents
void SubscribeToRegionEvents(RegionEventCallback callback) override
Subscribe to region events (creation, destruction, ...)
Definition: TransportFactory.h:139
fair::mq::zmq::TransportFactory::CreatePoller
PollerPtr CreatePoller(const std::vector< FairMQChannel > &channels) const override
Create a poller for a single channel (all subchannels)
Definition: TransportFactory.h:96
fair::mq::zmq::TransportFactory
Definition: TransportFactory.h:34
fair::mq::zmq::TransportFactory::SubscribedToRegionEvents
bool SubscribedToRegionEvents() override
Check if there is an active subscription to region events.
Definition: TransportFactory.h:140
fair::mq::zmq::TransportFactory::UnsubscribeFromRegionEvents
void UnsubscribeFromRegionEvents() override
Unsubscribe from region events.
Definition: TransportFactory.h:141
fair::mq::zmq::TransportFactory::CreateSocket
SocketPtr CreateSocket(const std::string &type, const std::string &name) override
Create a socket.
Definition: TransportFactory.h:91
fair::mq::zmq::TransportFactory::CreateMessage
MessagePtr CreateMessage() override
Create empty FairMQMessage (for receiving)
Definition: TransportFactory.h:61
fair::mq::zmq::UnmanagedRegion
Definition: UnmanagedRegion.h:29
fair::mq::zmq::TransportFactory::GetType
Transport GetType() const override
Get transport type.
Definition: TransportFactory.h:144
fair::mq::zmq::TransportFactory::CreateUnmanagedRegion
UnmanagedRegionPtr CreateUnmanagedRegion(const size_t size, RegionCallback callback, const std::string &path="", int flags=0) override
Create new UnmanagedRegion.
Definition: TransportFactory.h:111
FairMQTransportFactory
Definition: FairMQTransportFactory.h:30

privacy