--- /dev/null
+// $Id$
+//
+// Copyright (C) 2008
+// Fraunhofer Institute for Open Communication Systems (FOKUS)
+// Competence Center NETwork research (NET), St. Augustin, GERMANY
+// Stefan Bund <g0dil@berlios.de>
+//
+// This program is free software; you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation; either version 2 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program; if not, write to the
+// Free Software Foundation, Inc.,
+// 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+
+/** \file
+ \brief OverloadedCommand public header */
+
+#ifndef HH_SENF_Scheduler_Console_OverloadedCommand_
+#define HH_SENF_Scheduler_Console_OverloadedCommand_ 1
+
+// Custom includes
+#include "Node.hh"
+#include <boost/intrusive_ptr.hpp>
+#include <boost/range/iterator_range.hpp>
+#include "../../Utils/intrusive_refcount.hh"
+
+//#include "OverloadedCommand.mpp"
+///////////////////////////////hh.p////////////////////////////////////////
+
+namespace senf {
+namespace console {
+
+ class OverloadedCommandNode;
+
+ /** \brief Documentation for a single argument
+
+ This struct is used by CommandOverload::argumentDoc()
+ */
+ struct ArgumentDoc {
+ std::string name; ///< Argument name
+ std::string type; ///< Argument type (string representation)
+ std::string defaultValue; ///< Default value (string representation) or empty string
+ std::string doc; ///< Documentation for this argument
+ bool singleToken; ///< \c true, if argument is parsed from single token
+ };
+
+ /** \brief Base class for command overload of OverloadedCommandNode
+
+ This class is the base class of the commands which may be added to an
+ OverloadedCommandNode.
+ */
+ class CommandOverload
+ : public senf::intrusive_refcount
+ {
+ public:
+ ///////////////////////////////////////////////////////////////////////////
+ // Types
+
+ typedef boost::intrusive_ptr<CommandOverload> ptr;
+ typedef boost::intrusive_ptr<CommandOverload const> cptr;
+
+ ///////////////////////////////////////////////////////////////////////////
+
+ virtual ~CommandOverload();
+
+ void execute(boost::any & rv, std::ostream & os, ParseCommandInfo const & command);
+ ///< Call the overload
+ /**< If the \a arguments are not acceptable for this
+ overload, a SyntaxErrorException must be thrown.
+ Same as operator()() */
+
+ void operator()(boost::any & rv, std::ostream & os, ParseCommandInfo const & command);
+ ///< Call the overload
+ /**< If the \a arguments are not acceptable for this
+ overload, a SyntaxErrorException must be thrown.
+ Same as execute() */
+
+ unsigned numArguments() const; ///< Number of arguments this overload takes
+ void argumentDoc(unsigned index, ArgumentDoc & doc) const;
+ ///< Get information on argument \a index
+ /**< The information is returned in \e doc. \e doc must be
+ empty before this call.
+ \pre \a index < numArguments()
+ \param[in] index Argument index
+ \param[out] doc Argument documentation */
+
+ std::string doc() const; ///< Get overload documentation
+
+ OverloadedCommandNode & node() const; ///< Access owning node
+ /**< \pre The command \e must have been added to an
+ OverloadedCommandNode. */
+
+ unsigned overloadIndex() const; ///< Get index of overload in it's OverloadedCommandNode
+
+ protected:
+ CommandOverload();
+
+#ifndef DOXYGEN
+ private:
+#endif
+ virtual unsigned v_numArguments() const = 0;
+ ///< Return the number of arguments
+ /**< This member must be implemented in the derived class to
+ return the number of arguments, the command expects. */
+
+ virtual void v_argumentDoc(unsigned index, ArgumentDoc & doc) const = 0;
+ ///< Return argument documentation
+ /**< The member must be implemented int the derived class to
+ return all documentation information for the \a
+ index'th parameter in \a doc. */
+
+ virtual std::string v_doc() const = 0;
+ ///< Return overload documentation
+ /**< This member must be implemented in the derived class to
+ return the overloads documentation string. */
+
+ virtual void v_execute(boost::any & rv, std::ostream & os, ParseCommandInfo const & command)
+ const = 0;
+ ///< Execute the overload
+ /**< This member must be implemented in the derived class
+ o execute the overload. */
+
+ private:
+ OverloadedCommandNode * node_;
+
+ friend class OverloadedCommandNode;
+ };
+
+ /** \brief Command node which allows multiple registered callbacks
+
+ OverloadedCommandNode is like SimpleCommandNode but allows to register multiple commands to
+ a single node. This works by calling each command in the list consecutively until no
+ 'SyntaxErrorException' exception is thrown.
+
+ This works by first adding an OverloadedCommandNode to the directory in question and then
+ adding commands to that node. Commands are derived from CommandOverload.
+ \code
+ senf::console::DirectoryNode & dir (...);
+ senf::console::OverloadedCommandNode & cmd (
+ dir.add("cmd", senf::console::OverloadedCommandNode::create()) );
+ cmd.add(senf::console::SimpleCommandOverload::create(&callback));
+ cmd.add(senf::console::SimpleCommandOverload::create(&anotherCallback));
+ \endcode
+
+ However, this facility is normally used not directly but indirectly (and automatically) when
+ adding argument parsing callbacks.
+
+ \warning For this to work, the commands <b>must</b> do all syntax checking before doing any
+ operation
+
+ \ingroup console_commands
+ */
+ class OverloadedCommandNode
+ : public CommandNode
+ {
+ typedef std::vector<CommandOverload::ptr> Overloads;
+
+ public:
+ ///////////////////////////////////////////////////////////////////////////
+ // Types
+
+ typedef boost::shared_ptr<OverloadedCommandNode> ptr;
+ typedef boost::shared_ptr<OverloadedCommandNode const> cptr;
+ typedef boost::weak_ptr<OverloadedCommandNode> weak_ptr;
+
+ typedef OverloadedCommandNode node_type;
+ typedef OverloadedCommandNode & return_type;
+
+ typedef boost::iterator_range<Overloads::const_iterator> OverloadsRange;
+
+ ///////////////////////////////////////////////////////////////////////////
+ ///\name Structors and default members
+ ///@{
+
+ static ptr create();
+
+ ///@}
+ ///////////////////////////////////////////////////////////////////////////
+
+ template <class Command>
+ Command & add(boost::intrusive_ptr<Command> overload); ///< Add an additional overload
+
+ OverloadedCommandNode & doc(std::string const & doc);
+ ///< Assign global help for all overloads
+ OverloadedCommandNode & shortdoc(std::string const & doc);
+ ///< Assign short documentation for all overloads
+
+ unsigned overloadIndex(CommandOverload const & overload);
+ ///< Return the overload index for \a overload
+ /**< overloadIndex returns the index of \a overload in the
+ internal list of overloads. */
+
+ OverloadsRange overloads() const; ///< Get all overloads
+
+ ptr thisptr();
+ cptr thisptr() const;
+
+ private:
+ OverloadedCommandNode();
+
+ virtual void v_help(std::ostream & output) const;
+ virtual std::string v_shorthelp() const;
+ virtual void v_execute(boost::any & rv, std::ostream & os, ParseCommandInfo const & command)
+ const;
+
+ Overloads overloads_;
+ std::string doc_;
+ std::string shortdoc_;
+ };
+
+ /** \brief Basic command overload
+
+ This is an implementation of CommandOverload which allows to call an arbitrary callback with
+ the correct signature
+ (<tt>void (std::ostream &, senf::console::ParseCommandInfo const &)</tt>)
+ */
+ class SimpleCommandOverload
+ : public CommandOverload
+ {
+ public:
+ ///////////////////////////////////////////////////////////////////////////
+ // Types
+
+ typedef boost::intrusive_ptr<SimpleCommandOverload> ptr;
+ typedef boost::function<void (std::ostream &, ParseCommandInfo const &)> Function;
+
+ ///////////////////////////////////////////////////////////////////////////
+ ///\name Structors and default members
+ ///@{
+
+ static SimpleCommandOverload::ptr create(Function fn);
+ ///< Create new SimpleCommandOverload
+ /**< \param[in] fn callback to call */
+
+ ///@}
+ ///////////////////////////////////////////////////////////////////////////
+
+ SimpleCommandOverload & doc(std::string const & doc);
+ ///< Assign overload specific documentation
+
+ private:
+ explicit SimpleCommandOverload(Function fn);
+
+ virtual unsigned v_numArguments() const;
+ virtual void v_argumentDoc(unsigned index, ArgumentDoc & doc) const;
+ virtual std::string v_doc() const;
+ virtual void v_execute(boost::any & rv, std::ostream & os, ParseCommandInfo const & command)
+ const;
+
+ Function fn_;
+ std::string doc_;
+ };
+
+}}
+
+///////////////////////////////hh.e////////////////////////////////////////
+#include "OverloadedCommand.cci"
+//#include "OverloadedCommand.ct"
+#include "OverloadedCommand.cti"
+#endif
+
+\f
+// Local Variables:
+// mode: c++
+// fill-column: 100
+// comment-column: 40
+// c-file-style: "senf"
+// indent-tabs-mode: nil
+// ispell-local-dictionary: "american"
+// compile-command: "scons -u test"
+// End: