PluginCommand.hpp
上传用户:yhdzpy8989
上传日期:2007-06-13
资源大小:13604k
文件大小:8k
源码类别:

生物技术

开发平台:

C/C++

  1. /*
  2.  * ===========================================================================
  3.  * PRODUCTION $Log: PluginCommand.hpp,v $
  4.  * PRODUCTION Revision 1000.1  2004/04/12 18:14:42  gouriano
  5.  * PRODUCTION PRODUCTION: UPGRADED [CATCHUP_003] Dev-tree R1.11
  6.  * PRODUCTION
  7.  * ===========================================================================
  8.  */
  9. /* $Id: PluginCommand.hpp,v 1000.1 2004/04/12 18:14:42 gouriano Exp $
  10.  * ===========================================================================
  11.  *
  12.  *                            PUBLIC DOMAIN NOTICE
  13.  *               National Center for Biotechnology Information
  14.  *
  15.  *  This software/database is a "United States Government Work" under the
  16.  *  terms of the United States Copyright Act.  It was written as part of
  17.  *  the author's official duties as a United States Government employee and
  18.  *  thus cannot be copyrighted.  This software/database is freely available
  19.  *  to the public for use. The National Library of Medicine and the U.S.
  20.  *  Government have not placed any restriction on its use or reproduction.
  21.  *
  22.  *  Although all reasonable efforts have been taken to ensure the accuracy
  23.  *  and reliability of the software and data, the NLM and the U.S.
  24.  *  Government do not and cannot warrant the performance or results that
  25.  *  may be obtained by using this software or data. The NLM and the U.S.
  26.  *  Government disclaim all warranties, express or implied, including
  27.  *  warranties of performance, merchantability or fitness for any particular
  28.  *  purpose.
  29.  *
  30.  *  Please cite the author in any work or product based on this material.
  31.  *
  32.  * ===========================================================================
  33.  *
  34.  * Author:  Mike DiCuccio, Denis Vakatov, Anatoliy Kuznetsov
  35.  *
  36.  * File Description:
  37.  *    CPluginCommand -- defines an interface for managing a single command
  38.  *                      passed in to a plugin
  39.  *
  40.  * Remark:
  41.  *   This code was originally generated by application DATATOOL
  42.  *   using specifications from the data definition file
  43.  *   'plugin.asn'.
  44.  */
  45. #ifndef GUI_CORE_PLUGIN_PLUGINCOMMAND_HPP
  46. #define GUI_CORE_PLUGIN_PLUGINCOMMAND_HPP
  47. // generated includes
  48. #include <gui/plugin/PluginCommand_.hpp>
  49. #include <gui/plugin/PluginArg.hpp>
  50. // generated classes
  51. BEGIN_NCBI_SCOPE
  52. BEGIN_objects_SCOPE // namespace ncbi::objects::
  53. class CPluginValueConstraint;
  54. class NCBI_XGBPLUGIN_EXPORT CPluginCommand : public CPluginCommand_Base
  55. {
  56.     typedef CPluginCommand_Base Tparent;
  57. public:
  58.     // constructor
  59.     CPluginCommand(void);
  60.     // destructor
  61.     ~CPluginCommand(void);
  62.     // operator[] for indexing based on named argument
  63.     // this will throw if the named argument isn't found
  64.     const CPluginArg&   operator[](const string& name) const;
  65.     CPluginArg&         operator[](const string& name);
  66.     // HasArgument() can be used to verify whether a named argument exists
  67.     bool HasArgument(const string& name) const;
  68.     // add a named argument.  This argument is required, and has no default
  69.     // value.  Attempts to access the value without setting the value will
  70.     // result in an exception being thrown.
  71.     CPluginArg& AddArgument(const string& name, const string& desc,
  72.                             CPluginArg::EType type,
  73.                             CPluginArg::TData::E_Choice single_or_array =
  74.                             CPluginArg::TData::e_Single);
  75.     // add a named argument.  This argument is required, and has no default
  76.     // value.  Attempts to access the value without setting the value will
  77.     // result in an exception being thrown.
  78.     CPluginArg& AddArgument(const string& name, const string& desc,
  79.                             const CTypeInfo* info,
  80.                             CPluginArg::TData::E_Choice single_or_array =
  81.                             CPluginArg::TData::e_Single);
  82.     // Add a flag value.  This is a helper API.
  83.     CPluginArg& AddFlag(const string& name, const string& desc);
  84.     // Add a default argument to the set of arguments.  This function creates a
  85.     // named argument with a default value of type string.
  86.     CPluginArg& AddDefaultArgument(const string& name, const string& desc,
  87.                                    CPluginArg::EType type, const string& val);
  88.     // Add a flag argument with a default value.  This is a helper API.
  89.     CPluginArg& AddDefaultFlag(const string& name, const string& desc,
  90.                                bool val);
  91.     // add an optional argument to the set of arguments.  This supports an
  92.     // optional default value argument.  For non-built-in types, the default
  93.     // value is ignored.
  94.     CPluginArg& AddOptionalArgument(const string& name, const string& desc,
  95.                              CPluginArg::EType type,
  96.                              CPluginArg::TData::E_Choice single_or_array =
  97.                              CPluginArg::TData::e_Single);
  98.     CPluginArg& AddOptionalArgument(const string& name, const string& desc,
  99.                              const CTypeInfo* info,
  100.                              CPluginArg::TData::E_Choice single_or_array =
  101.                              CPluginArg::TData::e_Single);
  102.     // set the constraint for a named argument, removing all previous
  103.     // constraints
  104.     void SetConstraint(const string& name, CPluginValueConstraint& constraint);
  105.     // add a constraint to a named argument.
  106.     void AddConstraint(const string& name, CPluginValueConstraint& constraint);
  107. private:
  108.     // Prohibit copy constructor and assignment operator
  109.     CPluginCommand(const CPluginCommand& value);
  110.     CPluginCommand& operator=(const CPluginCommand& value);
  111. };
  112. /////////////////// CPluginCommand inline methods
  113. // constructor
  114. inline
  115. CPluginCommand::CPluginCommand(void)
  116. {
  117. }
  118. /////////////////// end of CPluginCommand inline methods
  119. END_objects_SCOPE // namespace ncbi::objects::
  120. END_NCBI_SCOPE
  121. /*
  122.  * ===========================================================================
  123.  *
  124.  * $Log: PluginCommand.hpp,v $
  125.  * Revision 1000.1  2004/04/12 18:14:42  gouriano
  126.  * PRODUCTION: UPGRADED [CATCHUP_003] Dev-tree R1.11
  127.  *
  128.  * Revision 1.11  2004/01/21 14:13:15  dicuccio
  129.  * Added AddFlag() and AddDefaultFlag() - front-ends to AddArgument() and
  130.  * AddDefaultArgument()
  131.  *
  132.  * Revision 1.10  2003/10/07 13:33:43  dicuccio
  133.  * Renamed CPluginURL* to CPluginValue*.  Dropped find_if.hpp.  Moved validation
  134.  * code into CPluginUtils.
  135.  *
  136.  * Revision 1.9  2003/07/31 16:43:32  dicuccio
  137.  * Changed return value of AddArgument() functions to return the added argument
  138.  *
  139.  * Revision 1.8  2003/06/20 14:45:52  dicuccio
  140.  * Revised handling of default arguments - now, all built-in argument types are
  141.  * supported.
  142.  *
  143.  * Revision 1.7  2003/05/19 13:33:02  dicuccio
  144.  * Moved gui/core/plugin --> gui/plugin/
  145.  *
  146.  * Revision 1.6  2003/05/09 16:43:57  dicuccio
  147.  * Added interfaces forwarded to CPluginArgSet for non-const op[], HasArgument()
  148.  *
  149.  * Revision 1.5  2003/04/30 13:52:45  dicuccio
  150.  * Added interface for creating multiple constraints for a given argument
  151.  *
  152.  * Revision 1.4  2003/04/25 14:13:17  dicuccio
  153.  * Changed API for optional arguments - permit data model objects as optional
  154.  * components; eliminate old "optional-and-default" combination
  155.  *
  156.  * Revision 1.3  2003/04/24 16:17:07  dicuccio
  157.  * Clarified addition of arguments that take data-model types
  158.  *
  159.  * Revision 1.2  2003/03/03 14:22:04  dicuccio
  160.  * Added argument constraints - lower bound, upper bound, range, and member-of-set
  161.  *
  162.  * Revision 1.1  2003/02/24 13:00:18  dicuccio
  163.  * Renamed classes in plugin spec:
  164.  *     CArgSeg --> CPluginArgSet
  165.  *     CArgument --> CPluginArg
  166.  *     CPluginArgs --> CPluginCommand
  167.  *     CPluginCommands --> CPluginCommandSet
  168.  *
  169.  * Revision 1.2  2003/02/21 16:44:13  dicuccio
  170.  * Added Win32 export specifiers for new plugin library.  Fixed compilation
  171.  * issues for Win32.
  172.  *
  173.  * Revision 1.1  2003/02/20 19:44:06  dicuccio
  174.  * Created new plugin architecture, mediated via an ASN.1 spec.  Moved GBENCH
  175.  * framework over to use new plugin architecture.
  176.  *
  177.  *
  178.  * ===========================================================================
  179.  */
  180. #endif // GUI_CORE_PLUGIN_PLUGINCOMMAND_HPP
  181. /* Original file checksum: lines: 93, chars: 2416, CRC32: 45677dc4 */