route_operation_client.hpp

// Copyright (c) 2025 Open Navigation LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
 
#ifndef NAV2_ROUTE__PLUGINS__ROUTE_OPERATION_CLIENT_HPP_
#define NAV2_ROUTE__PLUGINS__ROUTE_OPERATION_CLIENT_HPP_
 
#include <memory>
#include <chrono>
#include <string>
 
#include "rclcpp/rclcpp.hpp"
#include "rclcpp_lifecycle/lifecycle_node.hpp"
#include "nav2_route/interfaces/route_operation.hpp"
#include "nav2_core/route_exceptions.hpp"
#include "nav2_ros_common/node_utils.hpp"
#include "nav2_ros_common/service_client.hpp"
#include "std_srvs/srv/trigger.hpp"
 
namespace nav2_route
{
 
using namespace std::chrono_literals;  // NOLINT
 
template<typename SrvT>
class RouteOperationClient : public RouteOperation
{
public:
  RouteOperationClient() = default;
 
  virtual ~RouteOperationClient() = default;
 
  virtual void configureEvent(
    const nav2::LifecycleNode::SharedPtr /*node*/,
    const std::string & /*name*/) {}
 
  virtual void populateRequest(
    std::shared_ptr<typename SrvT::Request>/*request*/, const Metadata * /*mdata*/) {}
 
  virtual OperationResult processResponse(
    std::shared_ptr<typename SrvT::Response>/*response*/) {return OperationResult();}
 
protected:
  void configure(
    const nav2::LifecycleNode::SharedPtr node,
    std::shared_ptr<nav2_costmap_2d::CostmapSubscriber>,
    const std::string & name) final
  {
    RCLCPP_INFO(node->get_logger(), "Configuring route operation client: %s.", name.c_str());
    name_ = name;
    logger_ = node->get_logger();
    node_ = node;
 
    main_srv_name_ = node->declare_or_get_parameter(
      getName() + ".service_name", std::string(""));
 
    configureEvent(node, name);
 
    // There exists a single central service to use, create client.
    // If this is set to empty string after configuration, then the individual nodes will
    // indicate the endpoint for the particular service call.
    if (!main_srv_name_.empty()) {
      main_client_ =
        node->create_client<SrvT>(main_srv_name_, true);
    }
  }
 
  OperationResult perform(
    NodePtr node_achieved,
    EdgePtr /*edge_entered*/,
    EdgePtr /*edge_exited*/,
    const Route & /*route*/,
    const geometry_msgs::msg::PoseStamped & /*curr_pose*/,
    const Metadata * mdata) final
  {
    auto req = std::make_shared<typename SrvT::Request>();
    std::shared_ptr<typename SrvT::Response> response;
    populateRequest(req, mdata);
 
    std::string srv_name;
    srv_name = mdata->getValue<std::string>("service_name", srv_name);
    if (srv_name.empty() && !main_client_) {
      throw nav2_core::OperationFailed(
              "Route operation service (" + getName() + ") needs 'server_name' "
              "set in the param file or in the operation's metadata!");
    }
 
    try {
      if (srv_name.empty()) {
        srv_name = main_srv_name_;
        response = main_client_->invoke(req, std::chrono::nanoseconds(500ms));
      } else {
        auto node = node_.lock();
        if (!node) {
          throw nav2_core::OperationFailed(
                  "Route operation service (" + getName() + ") failed to lock node.");
        }
        auto client =
          node->template create_client<SrvT>(srv_name, true);
        response = client->invoke(req, std::chrono::nanoseconds(500ms));
      }
    } catch (const std::exception & e) {
      throw nav2_core::OperationFailed(
              "Route operation service (" + getName() + ") failed to call service: " +
              srv_name + " at Node " + std::to_string(node_achieved->nodeid));
    }
 
    RCLCPP_INFO(
      logger_,
      "%s: Processed operation at Node %i with service %s.",
      name_.c_str(), node_achieved->nodeid, srv_name.c_str());
    return processResponse(response);
  }
 
  std::string getName() override {return name_;}
 
  RouteOperationType processType() final {return RouteOperationType::ON_GRAPH;}
 
  std::string name_, main_srv_name_;
  std::atomic_bool reroute_;
  rclcpp::Logger logger_{rclcpp::get_logger("RouteOperationClient")};
  typename nav2::ServiceClient<SrvT>::SharedPtr main_client_;
  nav2::LifecycleNode::WeakPtr node_;
};
 
}  // namespace nav2_route
 
#endif  // NAV2_ROUTE__PLUGINS__ROUTE_OPERATION_CLIENT_HPP_