abstract_execution_base.h
Go to the documentation of this file.
1 /*
2  * Copyright 2018, Sebastian Pütz
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  *
8  * 1. Redistributions of source code must retain the above copyright
9  * notice, this list of conditions and the following disclaimer.
10  *
11  * 2. Redistributions in binary form must reproduce the above
12  * copyright notice, this list of conditions and the following
13  * disclaimer in the documentation and/or other materials provided
14  * with the distribution.
15  *
16  * 3. Neither the name of the copyright holder nor the names of its
17  * contributors may be used to endorse or promote products derived
18  * from this software without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
21  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
23  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
24  * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
25  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
26  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
27  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
28  * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
30  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
31  * POSSIBILITY OF SUCH DAMAGE.
32  *
33  * abstract_execution_base.h
34  *
35  * author: Sebastian Pütz <spuetz@uni-osnabrueck.de>
36  *
37  */
38 
39 #ifndef MBF_ABSTRACT_NAV__ABSTRACT_EXECUTION_BASE_H_
40 #define MBF_ABSTRACT_NAV__ABSTRACT_EXECUTION_BASE_H_
41 
42 #include <boost/thread.hpp>
43 
44 #include <mbf_abstract_nav/MoveBaseFlexConfig.h>
45 
46 #include <string>
47 
48 namespace mbf_abstract_nav
49 {
58 {
59  public:
60  AbstractExecutionBase(const std::string& name);
61 
62  virtual ~AbstractExecutionBase();
63 
64  virtual bool start();
65 
66  virtual void stop();
67 
72  virtual bool cancel()
73  {
74  return false;
75  };
76 
77  void join();
78 
79  boost::cv_status waitForStateUpdate(boost::chrono::microseconds const& duration);
80 
84  uint32_t getOutcome() const;
85 
89  const std::string& getMessage() const;
90 
94  const std::string& getName() const;
95 
99  virtual void preRun(){};
100 
104  virtual void postRun(){};
105 
109  virtual void reconfigure(MoveBaseFlexConfig& _cfg)
110  {
111  }
112 
113 protected:
114  virtual void run(){};
115 
117  boost::condition_variable condition_;
118 
120  boost::thread thread_;
121 
123  bool cancel_;
124 
126  uint32_t outcome_;
127 
129  std::string message_;
130 
132  std::string name_;
133 };
134 
135 } /* namespace mbf_abstract_nav */
136 
137 #endif /* MBF_ABSTRACT_NAV__ABSTRACT_EXECUTION_BASE_H_ */
mbf_abstract_nav::AbstractExecutionBase::join
void join()
Definition: src/abstract_execution_base.cpp:76
mbf_abstract_nav::AbstractExecutionBase::cancel_
bool cancel_
flag for canceling controlling
Definition: abstract_execution_base.h:123
mbf_abstract_nav::AbstractExecutionBase::outcome_
uint32_t outcome_
the last received plugin execution outcome
Definition: abstract_execution_base.h:126
mbf_abstract_nav
Definition: abstract_controller_execution.h:58
mbf_abstract_nav::AbstractExecutionBase::thread_
boost::thread thread_
the controlling thread object
Definition: abstract_execution_base.h:120
mbf_abstract_nav::AbstractExecutionBase::getOutcome
uint32_t getOutcome() const
Gets the current plugin execution outcome.
Definition: src/abstract_execution_base.cpp:89
mbf_abstract_nav::AbstractExecutionBase::preRun
virtual void preRun()
Optional implementation-specific setup function, called right before execution.
Definition: abstract_execution_base.h:99
mbf_abstract_nav::AbstractExecutionBase::condition_
boost::condition_variable condition_
condition variable to wake up control thread
Definition: abstract_execution_base.h:114
mbf_abstract_nav::AbstractExecutionBase::stop
virtual void stop()
Definition: src/abstract_execution_base.cpp:70
mbf_abstract_nav::AbstractExecutionBase::cancel
virtual bool cancel()
Cancel the plugin execution.
Definition: abstract_execution_base.h:72
mbf_abstract_nav::AbstractExecutionBase::run
virtual void run()
Definition: abstract_execution_base.h:114
mbf_abstract_nav::AbstractExecutionBase::~AbstractExecutionBase
virtual ~AbstractExecutionBase()
Definition: src/abstract_execution_base.cpp:47
mbf_abstract_nav::AbstractExecutionBase::reconfigure
virtual void reconfigure(MoveBaseFlexConfig &_cfg)
Optional implementaiton-specific configuration function.
Definition: abstract_execution_base.h:109
mbf_abstract_nav::AbstractExecutionBase::getMessage
const std::string & getMessage() const
Gets the current plugin execution message.
Definition: src/abstract_execution_base.cpp:94
mbf_abstract_nav::AbstractExecutionBase::message_
std::string message_
the last received plugin execution message
Definition: abstract_execution_base.h:129
mbf_abstract_nav::AbstractExecutionBase
Base class for running concurrent navigation tasks.
Definition: abstract_execution_base.h:57
mbf_abstract_nav::AbstractExecutionBase::waitForStateUpdate
boost::cv_status waitForStateUpdate(boost::chrono::microseconds const &duration)
Definition: src/abstract_execution_base.cpp:82
mbf_abstract_nav::AbstractExecutionBase::postRun
virtual void postRun()
Optional implementation-specific cleanup function, called right after execution.
Definition: abstract_execution_base.h:104
mbf_abstract_nav::AbstractExecutionBase::start
virtual bool start()
Definition: src/abstract_execution_base.cpp:57
mbf_abstract_nav::AbstractExecutionBase::name_
std::string name_
the plugin name; not the plugin type!
Definition: abstract_execution_base.h:132
mbf_abstract_nav::AbstractExecutionBase::AbstractExecutionBase
AbstractExecutionBase(const std::string &name)
Definition: src/abstract_execution_base.cpp:43
mbf_abstract_nav::AbstractExecutionBase::getName
const std::string & getName() const
Returns the name of the corresponding plugin.
Definition: src/abstract_execution_base.cpp:99


mbf_abstract_nav
Author(s): Sebastian Pütz
autogenerated on Wed Mar 2 2022 00:33:47