ROS 2 rclcpp + rcl - rolling  rolling-20536064
ROS 2 C++ Client Library with ROS Client Library
message_memory_strategy.hpp
1 // Copyright 2015 Open Source Robotics Foundation, Inc.
2 //
3 // Licensed under the Apache License, Version 2.0 (the "License");
4 // you may not use this file except in compliance with the License.
5 // You may obtain a copy of the License at
6 //
7 // http://www.apache.org/licenses/LICENSE-2.0
8 //
9 // Unless required by applicable law or agreed to in writing, software
10 // distributed under the License is distributed on an "AS IS" BASIS,
11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 // See the License for the specific language governing permissions and
13 // limitations under the License.
14 
15 #ifndef RCLCPP__MESSAGE_MEMORY_STRATEGY_HPP_
16 #define RCLCPP__MESSAGE_MEMORY_STRATEGY_HPP_
17 
18 #include <memory>
19 #include <stdexcept>
20 
21 #include "rcl/allocator.h"
22 #include "rcl/types.h"
23 
24 #include "rclcpp/allocator/allocator_common.hpp"
25 #include "rclcpp/macros.hpp"
26 #include "rclcpp/serialized_message.hpp"
27 #include "rclcpp/visibility_control.hpp"
28 
29 #include "rcutils/logging_macros.h"
30 
31 #include "rmw/serialized_message.h"
32 
33 namespace rclcpp
34 {
35 namespace message_memory_strategy
36 {
37 
39 
40 template<typename MessageT, typename Alloc = std::allocator<void>>
42 {
43 public:
44  RCLCPP_SMART_PTR_DEFINITIONS(MessageMemoryStrategy)
45 
46  using MessageAllocTraits = allocator::AllocRebind<MessageT, Alloc>;
47  using MessageAlloc = typename MessageAllocTraits::allocator_type;
48  using MessageDeleter = allocator::Deleter<MessageAlloc, MessageT>;
49 
50  using SerializedMessageAllocTraits = allocator::AllocRebind<rclcpp::SerializedMessage, Alloc>;
51  using SerializedMessageAlloc = typename SerializedMessageAllocTraits::allocator_type;
52  using SerializedMessageDeleter =
53  allocator::Deleter<SerializedMessageAlloc, rclcpp::SerializedMessage>;
54 
55  using BufferAllocTraits = allocator::AllocRebind<char, Alloc>;
56  using BufferAlloc = typename BufferAllocTraits::allocator_type;
57  using BufferDeleter = allocator::Deleter<BufferAlloc, char>;
58 
60  {
61  message_allocator_ = std::make_shared<MessageAlloc>();
62  serialized_message_allocator_ = std::make_shared<SerializedMessageAlloc>();
63  buffer_allocator_ = std::make_shared<BufferAlloc>();
64  if constexpr (std::is_same_v<Alloc, std::allocator<void>>) {
65  rcutils_allocator_ = rcl_get_default_allocator();
66  } else {
67  if constexpr (rclcpp::allocator::has_get_rcl_allocator_v<Alloc>) {
68  rcutils_allocator_ = message_allocator_->get_rcl_allocator();
69  } else {
70  rcutils_allocator_ = allocator::get_rcl_allocator<char,
71  BufferAlloc>(*buffer_allocator_.get());
72  }
73  }
74  }
75 
76  explicit MessageMemoryStrategy(std::shared_ptr<Alloc> allocator)
77  {
78  message_allocator_ = std::make_shared<MessageAlloc>(*allocator.get());
79  serialized_message_allocator_ = std::make_shared<SerializedMessageAlloc>(*allocator.get());
80  buffer_allocator_ = std::make_shared<BufferAlloc>(*allocator.get());
81  if constexpr (std::is_same_v<Alloc, std::allocator<void>>) {
82  rcutils_allocator_ = rcl_get_default_allocator();
83  } else {
84  if constexpr (rclcpp::allocator::has_get_rcl_allocator_v<Alloc>) {
85  rcutils_allocator_ = allocator->get_rcl_allocator();
86  } else {
87  rcutils_allocator_ = allocator::get_rcl_allocator<char,
88  BufferAlloc>(*buffer_allocator_.get());
89  }
90  }
91  }
92 
93  virtual ~MessageMemoryStrategy() = default;
94 
97  {
98  return std::make_shared<MessageMemoryStrategy<MessageT, Alloc>>(std::make_shared<Alloc>());
99  }
100 
102 
103  virtual std::shared_ptr<MessageT> borrow_message()
104  {
105  return std::allocate_shared<MessageT, MessageAlloc>(*message_allocator_.get());
106  }
107 
108  virtual std::shared_ptr<rclcpp::SerializedMessage> borrow_serialized_message(size_t capacity)
109  {
110  return std::make_shared<rclcpp::SerializedMessage>(capacity);
111  }
112 
113  virtual std::shared_ptr<rclcpp::SerializedMessage> borrow_serialized_message()
114  {
115  return borrow_serialized_message(default_buffer_capacity_);
116  }
117 
118  virtual void set_default_buffer_capacity(size_t capacity)
119  {
120  default_buffer_capacity_ = capacity;
121  }
122 
124 
125  virtual void return_message(std::shared_ptr<MessageT> & msg)
126  {
127  msg.reset();
128  }
129 
130  virtual void return_serialized_message(
131  std::shared_ptr<rclcpp::SerializedMessage> & serialized_msg)
132  {
133  serialized_msg.reset();
134  }
135 
136  std::shared_ptr<MessageAlloc> message_allocator_;
137  MessageDeleter message_deleter_;
138 
139  std::shared_ptr<SerializedMessageAlloc> serialized_message_allocator_;
140  SerializedMessageDeleter serialized_message_deleter_;
141 
142  std::shared_ptr<BufferAlloc> buffer_allocator_;
143  BufferDeleter buffer_deleter_;
144  size_t default_buffer_capacity_ = 0;
145 
146  rcutils_allocator_t rcutils_allocator_;
147 };
148 
149 } // namespace message_memory_strategy
150 } // namespace rclcpp
151 
152 #endif // RCLCPP__MESSAGE_MEMORY_STRATEGY_HPP_
#define rcl_get_default_allocator
Return a properly initialized rcl_allocator_t with default values.
Definition: allocator.h:37
Default allocation strategy for messages received by subscriptions.
static SharedPtr create_default()
Default factory method.
virtual void return_message(std::shared_ptr< MessageT > &msg)
Release ownership of the message, which will deallocate it if it has no more owners.
virtual std::shared_ptr< MessageT > borrow_message()
By default, dynamically allocate a new message.
Versions of rosidl_typesupport_cpp::get_message_type_support_handle that handle adapted types.
@ SharedPtr
Set the data type used in the intra-process buffer as std::shared_ptr<MessageT>