AutoAPMS
Resilient Robot Mission Management
All Classes Namespaces Functions Variables Typedefs Enumerations Enumerator Modules Pages
build_handler.hpp
1// Copyright 2024 Robin Müller
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// https://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#pragma once
16
17#include "auto_apms_behavior_tree_core/definitions.hpp"
18#include "auto_apms_behavior_tree_core/node/node_registration_loader.hpp"
19#include "auto_apms_behavior_tree_core/tree/tree_document.hpp"
20#include "rclcpp/macros.hpp"
21#include "rclcpp/node.hpp"
22
23// Include all built in node models and helpers for convenience
24#include "auto_apms_behavior_tree/behavior_tree_nodes.hpp"
25#include "auto_apms_behavior_tree/util/node.hpp"
26
27// Include exceptions if derived build handlers need to throw a TreeBuildHandlerError
28#include "auto_apms_behavior_tree/exceptions.hpp"
29
31{
32
139{
140public:
141 RCLCPP_SMART_PTR_ALIASES_ONLY(TreeBuildHandler)
142
143 /* Convenience aliases for deriving classes */
144
145 using NodeLoader = core::NodeRegistrationLoader;
146 using NodeManifest = core::NodeManifest;
147 using TreeResource = core::TreeResource;
148 using TreeDocument = core::TreeDocument;
149 using TreeBlackboard = auto_apms_behavior_tree::TreeBlackboard;
150
159 const std::string & name, rclcpp::Node::SharedPtr ros_node_ptr, NodeLoader::SharedPtr tree_node_loader_ptr);
160
179 TreeBuildHandler(rclcpp::Node::SharedPtr ros_node_ptr, NodeLoader::SharedPtr tree_node_loader_ptr);
180
181 virtual ~TreeBuildHandler() = default;
182
200 virtual bool setBuildRequest(
201 const std::string & build_request, const NodeManifest & node_manifest, const std::string & root_tree_name);
202
215 virtual TreeDocument::TreeElement buildTree(TreeDocument & doc, TreeBlackboard & bb) = 0;
216
221 rclcpp::Node::SharedPtr getRosNodePtr() const;
222
227 NodeLoader::SharedPtr getNodeLoaderPtr() const;
228
229protected:
231 const rclcpp::Logger logger_;
232
233private:
234 rclcpp::Node::WeakPtr ros_node_wptr_;
235 NodeLoader::SharedPtr tree_node_loader_ptr;
236};
237
238} // namespace auto_apms_behavior_tree
NodeLoader::SharedPtr getNodeLoaderPtr() const
Get a shared pointer to the class loader instance used for loading the required behavior tree nodes.
TreeBuildHandler(const std::string &name, rclcpp::Node::SharedPtr ros_node_ptr, NodeLoader::SharedPtr tree_node_loader_ptr)
Constructor allowing to give the build handler a specific name.
virtual bool setBuildRequest(const std::string &build_request, const NodeManifest &node_manifest, const std::string &root_tree_name)
Specify the behavior tree build request encoded in a string.
const rclcpp::Logger logger_
ROS 2 logger initialized with the name of the build handler.
rclcpp::Node::SharedPtr getRosNodePtr() const
Get a shared pointer to the parent rclcpp::Node of this build handler.
virtual TreeDocument::TreeElement buildTree(TreeDocument &doc, TreeBlackboard &bb)=0
Build the behavior tree specified before.
Data structure for information about which behavior tree node plugin to load and how to configure the...
A pluginlib::ClassLoader specifically for loading installed behavior tree node plugins.
Handle for a single behavior tree of a TreeDocument.
Document Object Model (DOM) for the behavior tree XML schema. This class offers a programmatic approa...
Class containing behavior tree resource data.
Useful tooling for incorporating behavior trees for task development.
Definition builder.hpp:30