开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 数值算法/人工智能 > 生物技术 > 查看源码
datatool.cpp
资源名称：ncbi_cxx_win--Jul_08_2004.zip　[点击查看]
上传用户：yhdzpy8989
上传日期：2007-06-13
资源大小：13604k
文件大小：27k
源码类别：

生物技术

开发平台：

C/C++

datatool.cpp：源码内容
  1. /*
  2.  * ===========================================================================
  3.  * PRODUCTION $Log: datatool.cpp,v $
  4.  * PRODUCTION Revision 1000.2  2004/06/01 19:42:43  gouriano
  5.  * PRODUCTION PRODUCTION: UPGRADED [GCC34_MSVC7] Dev-tree R1.72
  6.  * PRODUCTION
  7.  * ===========================================================================
  8.  */
  10. /*  $Id: datatool.cpp,v 1000.2 2004/06/01 19:42:43 gouriano Exp $
  11. * ===========================================================================
  12. *
  13. *                            PUBLIC DOMAIN NOTICE
  14. *               National Center for Biotechnology Information
  15. *
  16. *  This software/database is a "United States Government Work" under the
  17. *  terms of the United States Copyright Act.  It was written as part of
  18. *  the author's official duties as a United States Government employee and
  19. *  thus cannot be copyrighted.  This software/database is freely available
  20. *  to the public for use. The National Library of Medicine and the U.S.
  21. *  Government have not placed any restriction on its use or reproduction.
  22. *
  23. *  Although all reasonable efforts have been taken to ensure the accuracy
  24. *  and reliability of the software and data, the NLM and the U.S.
  25. *  Government do not and cannot warrant the performance or results that
  26. *  may be obtained by using this software or data. The NLM and the U.S.
  27. *  Government disclaim all warranties, express or implied, including
  28. *  warranties of performance, merchantability or fitness for any particular
  29. *  purpose.
  30. *
  31. *  Please cite the author in any work or product based on this material.
  32. *
  33. * ===========================================================================
  34. *
  35. * Author: Eugene Vasilchenko
  36. *
  37. * File Description:
  38. *   main datatool file: argument processing and task manager
  39. */
  41. #include <ncbi_pch.hpp>
  42. #include <corelib/ncbistd.hpp>
  43. #include <corelib/ncbiargs.hpp>
  45. #include <serial/objistr.hpp>
  46. #include <serial/objostr.hpp>
  47. #include <serial/objcopy.hpp>
  49. #include <memory>
  51. #include <serial/datatool/exceptions.hpp>
  52. #include <serial/datatool/code.hpp>
  53. #include <serial/datatool/lexer.hpp>
  54. #include <serial/datatool/dtdlexer.hpp>
  55. #include <serial/datatool/parser.hpp>
  56. #include <serial/datatool/dtdparser.hpp>
  57. #include <serial/datatool/moduleset.hpp>
  58. #include <serial/datatool/module.hpp>
  59. #include <serial/datatool/type.hpp>
  60. #include <serial/datatool/generate.hpp>
  61. #include <serial/datatool/datatool.hpp>
  62. #include <serial/datatool/filecode.hpp>
  63. #include <serial/objistrxml.hpp>
  64. #include <serial/objostrxml.hpp>
  66. BEGIN_NCBI_SCOPE
  68. int CDataTool::Run(void)
  69. {
  70.     if ( !ProcessModules() )
  71.         return 1;
  72.     if ( !ProcessData() )
  73.         return 1;
  74.     if ( !GenerateCode() )
  75.         return 1;
  77.     return 0;
  78. }
  81. void CDataTool::Init(void)
  82. {
  83.     SetDiagPostLevel(eDiag_Warning);
  85.     auto_ptr<CArgDescriptions> d(new CArgDescriptions);
  87.     d->SetUsageContext("datatool", "work with ASN.1/XML data");
  89.     // module arguments
  90.     d->AddKey("m", "moduleFile",
  91.               "module file(s)",
  92.               CArgDescriptions::eInputFile);
  93.     d->AddDefaultKey("M", "externalModuleFile",
  94.                      "external module file(s)",
  95.                      CArgDescriptions::eInputFile, NcbiEmptyString);
  96.     d->AddFlag("i",
  97.                "ignore unresolved symbols");
  98.     d->AddOptionalKey("f", "moduleFile",
  99.                       "write ASN.1 module file",
  100.                       CArgDescriptions::eOutputFile);
  101.     d->AddOptionalKey("fx", "dtdFile",
  102.                       "write DTD file ("-fx m" writes modular DTD file)",
  103.                       CArgDescriptions::eOutputFile);
  104.     d->AddOptionalKey("fxs", "XMLSchemaFile",
  105.                       "write XML Schema file",
  106.                       CArgDescriptions::eOutputFile);
  108.     // data arguments
  109.     d->AddOptionalKey("v", "valueFile",
  110.                       "read value in ASN.1 text format",
  111.                       CArgDescriptions::eInputFile);
  112.     d->AddOptionalKey("vx", "valueFile",
  113.                       "read value in XML format",
  114.                       CArgDescriptions::eInputFile);
  115.     d->AddOptionalKey("d", "valueFile",
  116.                       "read value in ASN.1 binary format (-t is required)",
  117.                       CArgDescriptions::eInputFile);
  118.     d->AddOptionalKey("t", "type",
  119.                       "binary value type (see "-d" argument)",
  120.                       CArgDescriptions::eString);
  121.     d->AddOptionalKey("dn", "filename",
  122.                       "DTD module name in XML header (no extension)",
  123.                       CArgDescriptions::eString);
  124.     d->AddFlag("F",
  125.                "read value completely into memory");
  126.     d->AddOptionalKey("p", "valueFile",
  127.                       "write value in ASN.1 text format",
  128.                       CArgDescriptions::eOutputFile);
  129.     d->AddOptionalKey("px", "valueFile",
  130.                       "write value in XML format",
  131.                       CArgDescriptions::eOutputFile);
  132.     d->AddOptionalKey("e", "valueFile",
  133.                       "write value in ASN.1 binary format",
  134.                       CArgDescriptions::eOutputFile);
  135.     d->AddFlag("sxo",
  136.                "no scope prefixes in XML output");
  137.     d->AddFlag("sxi",
  138.                "no scope prefixes in XML input");
  140.     // code generation arguments
  141.     d->AddOptionalKey("oex", "exportSpec",
  142.                       "class export specifier for MSVC",
  143.                       CArgDescriptions::eString);
  144.     d->AddOptionalKey("od", "defFile",
  145.                       "code definition file",
  146.                       CArgDescriptions::eInputFile);
  147.     d->AddFlag("odi",
  148.                "silently ignore absent code definition file");
  149.     d->AddFlag("odw",
  150.                "issue a warning about absent code definition file");
  151.     d->AddOptionalKey("of", "listFile",
  152.                       "write list of generated C++ files",
  153.                       CArgDescriptions::eOutputFile);
  154.     d->AddOptionalKey("oc", "basename",
  155.                       "write combining C++ files",
  156.                       CArgDescriptions::eString);
  157.     d->AddFlag("oA",
  158.                "generate C++ files for all types");
  159.     d->AddOptionalKey("ot", "types",
  160.                       "generate C++ files for listed types",
  161.                       CArgDescriptions::eString);
  162.     d->AddOptionalKey("ox", "types",
  163.                       "exclude listed types from generation",
  164.                       CArgDescriptions::eString);
  165.     d->AddFlag("oX",
  166.                "turn off recursive type generation");
  168.     d->AddOptionalKey("on", "namespace",
  169.                       "default namespace", 
  170.                       CArgDescriptions::eString);
  172.     d->AddOptionalKey("opm", "directory",
  173.                       "directory for searching source modules",
  174.                       CArgDescriptions::eString);
  175.     d->AddOptionalKey("oph", "directory",
  176.                       "directory for generated *.hpp files",
  177.                       CArgDescriptions::eString);
  178.     d->AddOptionalKey("opc", "directory",
  179.                       "directory for generated *.cpp files",
  180.                       CArgDescriptions::eString);
  182.     d->AddOptionalKey("or", "prefix",
  183.                       "add prefix to generated file names",
  184.                       CArgDescriptions::eString);
  185.     d->AddFlag("orq",
  186.                "use quoted syntax form for generated include files");
  187.     d->AddFlag("ors",
  188.                "add source file dir to generated file names");
  189.     d->AddFlag("orm",
  190.                "add module name to generated file names");
  191.     d->AddFlag("orA",
  192.                "combine all -or* prefixes");
  193.     d->AddFlag("ocvs",
  194.                "create ".cvsignore" files");
  195.     d->AddOptionalKey("oR", "rootDirectory",
  196.                       "set "-o*" arguments for NCBI directory tree",
  197.                       CArgDescriptions::eString);
  199.     d->AddFlag("oDc",
  200.                "turn on generation of DOXYGEN-style comments");
  201.     d->AddOptionalKey("odx", "URL",
  202.                       "URL of documentation root folder (for DOXYGEN)",
  203.                       CArgDescriptions::eString);
  204.     d->AddFlag("lax_syntax",
  205.                "allow non-standard ASN.1 syntax accepted by asntool");
  206.     d->AddOptionalKey("pch", "file",
  207.                       "name of the precompiled header to include in all *.cpp files",
  208.                       CArgDescriptions::eString);
  210.     SetupArgDescriptions(d.release());
  211. }
  213. bool CDataTool::ProcessModules(void)
  214. {
  215.     const CArgs& args = GetArgs();
  217.     list<string> modulesPath;
  219.     if ( const CArgValue& oR = args["oR"] ) {
  220.         // NCBI directory tree
  221.         const string& rootDir = oR.AsString();
  222.         generator.SetRootDir(rootDir);
  223.         generator.SetHPPDir(Path(rootDir, "include"));
  224.         string srcDir = Path(rootDir, "src");
  225.         generator.SetCPPDir(srcDir);
  226.         modulesPath.push_back(srcDir);
  227.         generator.SetFileNamePrefixSource(eFileName_FromSourceFileName);
  228.         generator.SetDefaultNamespace("NCBI_NS_NCBI::objects");
  229.     }
  230.     
  231.     if ( const CArgValue& opm = args["opm"] ) {
  232.         modulesPath.clear();
  233.         NStr::Split(opm.AsString(), ",", modulesPath);
  234.     }
  235.     
  236.     SourceFile::EType srctype =
  237.         LoadDefinitions(generator.GetMainModules(),
  238.                         modulesPath, args["m"].AsString());
  240.     if ( const CArgValue& sxo = args["sxo"] ) {
  241.         CDataType::SetEnforcedStdXml(true);
  242.     }
  244.     if ( const CArgValue& f = args["f"] ) {
  245.         generator.GetMainModules().PrintASN(f.AsOutputFile());
  246.         f.CloseFile();
  247.     }
  249.     if ( const CArgValue& fx = args["fx"] ) {
  250.         if ( fx.AsString() == "m" )
  251.             generator.GetMainModules().PrintDTDModular();
  252.         else {
  253.             generator.GetMainModules().PrintDTD(fx.AsOutputFile());
  254.             fx.CloseFile();
  255.         }
  256.     }
  258.     if ( const CArgValue& ax = args["fxs"] ) {
  259.         if (srctype == SourceFile::eDTD) {
  260.             CDataType::SetEnforcedStdXml(true);
  261.         }
  262.         generator.GetMainModules().PrintXMLSchema(ax.AsOutputFile());
  263.         ax.CloseFile();
  264.     }
  265.     
  266.     LoadDefinitions(generator.GetImportModules(),
  267.                     modulesPath, args["M"].AsString(),srctype);
  269.     if ( !generator.Check() ) {
  270.         if ( !args["i"] ) { // ignored
  271.             ERR_POST("some types are unknown");
  272.             return false;
  273.         }
  274.         else {
  275.             ERR_POST(Warning << "some types are unknown: ignoring");
  276.         }
  277.     }
  278.     return true;
  279. }
  281. bool CDataTool::ProcessData(void)
  282. {    
  283.     const CArgs& args = GetArgs();
  284.     bool stdXmlIn = false;
  285.     if ( const CArgValue& sxi = args["sxi"] ) {
  286.         stdXmlIn = true;
  287.     }
  288.     bool stdXmlOut = false;
  289.     if ( const CArgValue& sxo = args["sxo"] ) {
  290.         stdXmlOut = true;
  291.     }
  293.     // convert data
  294.     ESerialDataFormat inFormat;
  295.     string inFileName;
  296.     const CArgValue& t = args["t"];
  297.     
  298.     if ( const CArgValue& v = args["v"] ) {
  299.         inFormat = eSerial_AsnText;
  300.         inFileName = v.AsString();
  301.     }
  302.     else if ( const CArgValue& vx = args["vx"] ) {
  303.         inFormat = eSerial_Xml;
  304.         inFileName = vx.AsString();
  305.     }
  306.     else if ( const CArgValue& d = args["d"] ) {
  307.         if ( !t ) {
  308.             ERR_POST("ASN.1 value type must be specified (-t)");
  309.             return false;
  310.         }
  311.         inFormat = eSerial_AsnBinary;
  312.         inFileName = d.AsString();
  313.     }
  314.     else // no input data
  315.         return true;
  317.     auto_ptr<CObjectIStream>
  318.         in(CObjectIStream::Open(inFormat, inFileName, eSerial_StdWhenAny));
  319.     if (stdXmlIn && inFormat == eSerial_Xml) {
  320.         CObjectIStreamXml *is = dynamic_cast<CObjectIStreamXml*>(in.get());
  321.         is->SetEnforcedStdXml(true);
  322.     }
  324.     string typeName;
  325.     if ( t ) {
  326.         typeName = t.AsString();
  327.         in->ReadFileHeader();
  328.     }
  329.     else {
  330.         typeName = in->ReadFileHeader();
  331.     }
  333.     TTypeInfo typeInfo =
  334.         generator.GetMainModules().ResolveInAnyModule(typeName, true)->
  335.         GetTypeInfo().Get();
  336.     
  337.     // determine output data file
  338.     ESerialDataFormat outFormat;
  339.     string outFileName;
  340.     
  341.     if ( const CArgValue& p = args["p"] ) {
  342.         outFormat = eSerial_AsnText;
  343.         outFileName = p.AsString();
  344.     }
  345.     else if ( const CArgValue& px = args["px"] ) {
  346.         outFormat = eSerial_Xml;
  347.         outFileName = px.AsString();
  348.     }
  349.     else if ( const CArgValue& e = args["e"] ) {
  350.         outFormat = eSerial_AsnBinary;
  351.         outFileName = e.AsString();
  352.     }
  353.     else {
  354.         // no input data
  355.         outFormat = eSerial_None;
  356.     }
  358.     if ( args["F"] ) {
  359.         // read fully in memory
  360.         AnyType value;
  361.         in->Read(&value, typeInfo, CObjectIStream::eNoFileHeader);
  362.         if ( outFormat != eSerial_None ) {
  363.             // store data
  364.             auto_ptr<CObjectOStream>
  365.                 out(CObjectOStream::Open(outFormat, outFileName,
  366.                                          eSerial_StdWhenAny));
  367.             if ( outFormat == eSerial_Xml ) {
  368.                 CObjectOStreamXml *os = dynamic_cast<CObjectOStreamXml*>(out.get());
  369.                 if (stdXmlOut) {
  370.                     os->SetEnforcedStdXml(true);
  371.                 }
  372.                 // Set DTD file name (default prefix is added in any case)
  373.                 if( const CArgValue& dn = args["dn"] ) {
  374.                   os->SetDTDFileName(dn.AsString());
  375.                 }
  376.             }
  377.             out->Write(&value, typeInfo);
  378.         }
  379.     }
  380.     else {
  381.         if ( outFormat != eSerial_None ) {
  382.             // copy
  383.             auto_ptr<CObjectOStream>
  384.                 out(CObjectOStream::Open(outFormat, outFileName,
  385.                                          eSerial_StdWhenAny));
  386.             if ( outFormat == eSerial_Xml ) {
  387.                 CObjectOStreamXml *os = dynamic_cast<CObjectOStreamXml*>(out.get());
  388.                 if (stdXmlOut) {
  389.                     os->SetEnforcedStdXml(true);
  390.                 }
  391.                 // Set DTD file name (default prefix is added in any case)
  392.                 if( const CArgValue& dn = args["dn"] ) {
  393.                   os->SetDTDFileName(dn.AsString());
  394.                 }
  395.             }
  396.             CObjectStreamCopier copier(*in, *out);
  397.             copier.Copy(typeInfo, CObjectStreamCopier::eNoFileHeader);
  398.         }
  399.         else {
  400.             // skip
  401.             in->Skip(typeInfo, CObjectIStream::eNoFileHeader);
  402.         }
  403.     }
  404.     return true;
  405. }
  407. bool CDataTool::GenerateCode(void)
  408. {
  409.     const CArgs& args = GetArgs();
  411.     // load generator config
  412.     if ( const CArgValue& od = args["od"] )
  413.         generator.LoadConfig(od.AsString(), args["odi"], args["odw"]);
  414.     //if ( const CArgValue& oD = args["oD"] )
  415.     //    generator.AddConfigLine(oD.AsString());
  417.     // set list of types for generation
  418.     if ( args["oX"] )
  419.         generator.ExcludeRecursion();
  420.     if ( args["oA"] )
  421.         generator.IncludeAllMainTypes();
  422.     if ( const CArgValue& ot = args["ot"] )
  423.         generator.IncludeTypes(ot.AsString());
  424.     if ( const CArgValue& ox = args["ox"] )
  425.         generator.ExcludeTypes(ox.AsString());
  427.     if ( !generator.HaveGenerateTypes() )
  428.         return true;
  430.     // set the export specifier, if provided
  431.     if ( const CArgValue& oex = args["oex"] ) {
  432.         string ex;
  433.         ex = generator.GetConfig().Get("-","_export");
  434.         if (ex.empty()) {
  435.             ex = oex.AsString();
  436.         }
  437.         CClassCode::SetExportSpecifier(ex);
  438.     }
  439.     // define the Doxygen group
  440.     {
  441.         if ( args["oDc"] ) {
  442.             CClassCode::SetDoxygenComments(true);
  443.             if ( const CArgValue& odx = args["odx"] ) {
  444.                 string root = odx.AsString();
  445.                 if (root.empty()) {
  446.                     // default
  447.                     root = "http://www.ncbi.nlm.nih.gov/IEB/ToolBox/CPP_DOC/lxr/source";
  448.                 }
  449.                 CClassCode::SetDocRootURL(root);
  450.             }
  451.             string group = generator.GetConfig().Get("-","_addtogroup_name");
  452.             CClassCode::SetDoxygenGroup(group);
  453.             group = generator.GetConfig().Get("-","_ingroup_name");
  454.             generator.SetDoxygenIngroup(group);
  455.             group = generator.GetConfig().Get("-","_addtogroup_description");
  456.             generator.SetDoxygenGroupDescription(group);
  457.         } else {
  458.             CClassCode::SetDoxygenComments(false);
  459.         }
  460.     }
  462.     // prepare generator
  463.     
  464.     // set namespace
  465.     if ( const CArgValue& on = args["on"] )
  466.         generator.SetDefaultNamespace(on.AsString());
  467.     
  468.     // set output files
  469.     if ( const CArgValue& oc = args["oc"] ) {
  470.         const string& fileName = oc.AsString();
  471.         generator.SetCombiningFileName(fileName);
  472.         generator.SetFileListFileName(fileName+".files");
  473.     }
  474.     if ( const CArgValue& of = args["of"] )
  475.         generator.SetFileListFileName(of.AsString());
  476.     
  477.     // set directories
  478.     if ( const CArgValue& oph = args["oph"] )
  479.         generator.SetHPPDir(oph.AsString());
  480.     if ( const CArgValue& opc = args["opc"] )
  481.         generator.SetCPPDir(opc.AsString());
  482.     
  483.     // set file names prefixes
  484.     if ( const CArgValue& orF = args["or"] )
  485.         generator.SetFileNamePrefix(orF.AsString());
  486.     if ( args["orq"] )
  487.         generator.UseQuotedForm(true);
  488.     if ( args["ocvs"] )
  489.         generator.CreateCvsignore(true);
  490.     if ( args["ors"] )
  491.         generator.SetFileNamePrefixSource(eFileName_FromSourceFileName);
  492.     if ( args["orm"] )
  493.         generator.SetFileNamePrefixSource(eFileName_FromModuleName);
  494.     if ( args["orA"] )
  495.         generator.SetFileNamePrefixSource(eFileName_UseAllPrefixes);
  497.     // precompiled header
  498.     if ( const CArgValue& pch = args["pch"] )
  499.         CFileCode::SetPchHeader(pch.AsString());
  500.     
  501.     // generate code
  502.     generator.GenerateCode();
  503.     return true;
  504. }
  507. SourceFile::EType CDataTool::LoadDefinitions(
  508.     CFileSet& fileSet, const list<string>& modulesPath,
  509.     const string& nameList, SourceFile::EType srctype)
  510. {
  511.     SourceFile::EType moduleType;
  512.     list<string> names;
  513.     NStr::Split(nameList, " ", names);
  514.     ITERATE ( list<string>, fi, names ) {
  515.         const string& name = *fi;
  516.         if ( !name.empty() ) {
  517.             SourceFile fName(name, modulesPath);
  518.             moduleType = fName.GetType();
  520. // if first module has unknown type - assume ASN
  521.             if (srctype == SourceFile::eUnknown) {
  522.                 if (moduleType == SourceFile::eUnknown) {
  523.                     moduleType = SourceFile::eASN;
  524.                 }
  525.                 srctype = moduleType;
  526.             }
  527. // if second module has unknown type - assume same as the previous one
  528.             else {
  529.                 if (moduleType == SourceFile::eUnknown) {
  530.                     moduleType = srctype;
  531.                 }
  532. // if modules have different types - exception
  533.                 else if (moduleType != srctype) {
  534.                     NCBI_THROW(CDatatoolException,eWrongInput,
  535.                                "Unable to process modules of different types"
  536.                                " simultaneously: "+name);
  537.                 }
  538.             }
  540.             switch (moduleType) {
  541.             default:
  542.                 NCBI_THROW(CDatatoolException,eWrongInput,"Unknown file type: "+name);
  544.             case SourceFile::eASN:
  545.                 {
  546.                     ASNLexer lexer(fName);
  547.                     lexer.AllowIDsEndingWithMinus(GetArgs()["lax_syntax"]);
  548.                     ASNParser parser(lexer);
  549.                     fileSet.AddFile(parser.Modules(name));
  550.                 }
  551.                 break;
  552.             case SourceFile::eDTD:
  553.                 {
  554.                     DTDLexer lexer(fName);
  555.                     DTDParser parser(lexer);
  556.                     fileSet.AddFile(parser.Modules(name));
  557.                 }
  558.                 break;
  559.             }
  560.         }
  561.     }
  562.     return srctype;
  563. }
  565. END_NCBI_SCOPE
  568. int main(int argc, const char* argv[])
  569. {
  570.     USING_NCBI_SCOPE;
  571.     CException::EnableBackgroundReporting(false);
  572.     return CDataTool().AppMain(argc, argv, 0, eDS_Default, 0, "datatool");
  573. }
  575. /*
  576. * ===========================================================================
  577. *
  578. * $Log: datatool.cpp,v $
  579. * Revision 1000.2  2004/06/01 19:42:43  gouriano
  580. * PRODUCTION: UPGRADED [GCC34_MSVC7] Dev-tree R1.72
  581. *
  582. * Revision 1.72  2004/05/17 21:03:13  gorelenk
  583. * Added include of PCH ncbi_pch.hpp
  584. *
  585. * Revision 1.71  2004/05/17 14:50:54  gouriano
  586. * Added possibility to include precompiled header
  587. *
  588. * Revision 1.70  2004/05/03 19:31:03  gouriano
  589. * Made generation of DOXYGEN-style comments optional
  590. *
  591. * Revision 1.69  2004/04/29 20:11:39  gouriano
  592. * Generate DOXYGEN-style comments in C++ headers
  593. *
  594. * Revision 1.68  2004/03/19 15:45:19  gouriano
  595. * corrected fxs argument description
  596. *
  597. * Revision 1.67  2003/06/16 14:41:05  gouriano
  598. * added possibility to convert DTD to XML schema
  599. *
  600. * Revision 1.66  2003/05/29 17:26:49  gouriano
  601. * added possibility of generation .cvsignore file
  602. *
  603. * Revision 1.65  2003/05/23 19:18:39  gouriano
  604. * modules of unknown type are assumed to be ASN
  605. * all modules must have the same type
  606. *
  607. * Revision 1.64  2003/05/23 13:54:48  gouriano
  608. * throw exception on unknown module file type
  609. *
  610. * Revision 1.63  2003/05/14 14:42:22  gouriano
  611. * added generation of XML schema
  612. *
  613. * Revision 1.62  2003/03/11 20:06:47  kuznets
  614. * iterate -> ITERATE
  615. *
  616. * Revision 1.61  2003/03/10 18:55:18  gouriano
  617. * use new structured exceptions (based on CException)
  618. *
  619. * Revision 1.60  2003/02/24 21:57:46  gouriano
  620. * added odw flag - to issue a warning about missing DEF file
  621. *
  622. * Revision 1.59  2003/02/10 17:56:15  gouriano
  623. * make it possible to disable scope prefixes when reading and writing objects generated from ASN specification in XML format, or when converting an ASN spec into DTD.
  624. *
  625. * Revision 1.58  2002/12/31 20:14:24  gouriano
  626. * corrected usage of export specifiers when generating C++ classes
  627. *
  628. * Revision 1.57  2002/12/23 18:40:07  dicuccio
  629. * Added new command-line option: -oex <export-specifier> for adding WIn32 export
  630. * specifiers to generated objects.
  631. *
  632. * Revision 1.56  2002/10/22 15:06:12  gouriano
  633. * added possibillity to use quoted syntax form for generated include files
  634. *
  635. * Revision 1.55  2002/10/15 13:57:09  gouriano
  636. * recognize DTD files and handle them using DTD lexer/parser
  637. *
  638. * Revision 1.54  2002/09/26 16:57:31  vasilche
  639. * Added flag for compatibility with asntool
  640. *
  641. * Revision 1.53  2002/08/06 17:03:48  ucko
  642. * Let -opm take a comma-delimited list; move relevant CVS logs to end.
  643. *
  644. * Revision 1.52  2001/12/13 19:32:41  juran
  645. * Make main()'s argv of type (const char*), for use with jTools.
  646. *
  647. * Revision 1.51  2001/10/17 18:19:52  grichenk
  648. * Updated to use CObjectOStreamXml::GetFileXXX
  649. *
  650. * Revision 1.50  2001/04/16 17:53:45  kholodov
  651. * Added: Option -dn to specify the DTD file name in XML header
  652. *
  653. * Revision 1.49  2000/12/26 22:24:53  vasilche
  654. * Updated for new behaviour of CNcbiArgs.
  655. *
  656. * Revision 1.48  2000/12/12 17:57:06  vasilche
  657. * Avoid using of new C++ keywords ('or' in this case).
  658. *
  659. * Revision 1.47  2000/12/12 14:28:17  vasilche
  660. * Changed the way arguments are processed.
  661. *
  662. * Revision 1.46  2000/11/27 18:19:47  vasilche
  663. * Datatool now conforms CNcbiApplication requirements.
  664. *
  665. * Revision 1.45  2000/11/20 17:26:32  vasilche
  666. * Fixed warnings on 64 bit platforms.
  667. * Updated names of config variables.
  668. *
  669. * Revision 1.44  2000/11/08 17:50:18  vasilche
  670. * Fixed compilation error on MSVC.
  671. *
  672. * Revision 1.43  2000/11/08 17:02:51  vasilche
  673. * Added generation of modular DTD files.
  674. *
  675. * Revision 1.42  2000/11/01 20:38:59  vasilche
  676. * OPTIONAL and DEFAULT are not permitted in CHOICE.
  677. * Fixed code generation for DEFAULT.
  678. *
  679. * Revision 1.41  2000/09/29 16:18:28  vasilche
  680. * Fixed binary format encoding/decoding on 64 bit compulers.
  681. * Implemented CWeakMap<> for automatic cleaning map entries.
  682. * Added cleaning local hooks via CWeakMap<>.
  683. * Renamed ReadTypeName -> ReadFileHeader, ENoTypeName -> ENoFileHeader.
  684. * Added some user interface methods to CObjectIStream, CObjectOStream and
  685. * CObjectStreamCopier.
  686. *
  687. * Revision 1.40  2000/09/26 17:38:26  vasilche
  688. * Fixed incomplete choiceptr implementation.
  689. * Removed temporary comments.
  690. *
  691. * Revision 1.39  2000/09/18 20:00:28  vasilche
  692. * Separated CVariantInfo and CMemberInfo.
  693. * Implemented copy hooks.
  694. * All hooks now are stored in CTypeInfo/CMemberInfo/CVariantInfo.
  695. * Most type specific functions now are implemented via function pointers instead of virtual functions.
  696. *
  697. * Revision 1.38  2000/09/18 13:53:00  vasilche
  698. * Fixed '.files' extension.
  699. *
  700. * Revision 1.37  2000/09/01 13:16:27  vasilche
  701. * Implemented class/container/choice iterators.
  702. * Implemented CObjectStreamCopier for copying data without loading into memory.
  703. *
  704. * Revision 1.36  2000/08/25 15:59:20  vasilche
  705. * Renamed directory tool -> datatool.
  706. *
  707. * Revision 1.35  2000/07/10 17:32:00  vasilche
  708. * Macro arguments made more clear.
  709. * All old ASN stuff moved to serialasn.hpp.
  710. * Changed prefix of enum info functions to GetTypeInfo_enum_.
  711. *
  712. * Revision 1.34  2000/06/16 16:31:39  vasilche
  713. * Changed implementation of choices and classes info to allow use of the same classes in generated and user written classes.
  714. *
  715. * Revision 1.33  2000/05/24 20:09:29  vasilche
  716. * Implemented DTD generation.
  717. *
  718. * Revision 1.32  2000/04/28 16:58:16  vasilche
  719. * Added classes CByteSource and CByteSourceReader for generic reading.
  720. * Added delayed reading of choice variants.
  721. *
  722. * Revision 1.31  2000/04/13 17:30:37  vasilche
  723. * Avoid INTERNAL COMPILER ERROR on MSVC.
  724. * Problem is in "static inline" function which cannot be expanded inline.
  725. *
  726. * Revision 1.30  2000/04/13 14:50:36  vasilche
  727. * Added CObjectIStream::Open() and CObjectOStream::Open() for easier use.
  728. *
  729. * Revision 1.29  2000/04/12 15:36:51  vasilche
  730. * Added -on <namespace> argument to datatool.
  731. * Removed unnecessary namespace specifications in generated files.
  732. *
  733. * Revision 1.28  2000/04/07 19:26:28  vasilche
  734. * Added namespace support to datatool.
  735. * By default with argument -oR datatool will generate objects in namespace
  736. * NCBI_NS_NCBI::objects (aka ncbi::objects).
  737. * Datatool's classes also moved to NCBI namespace.
  738. *
  739. * Revision 1.27  2000/03/10 17:59:31  vasilche
  740. * Fixed error reporting.
  741. *
  742. * Revision 1.26  2000/02/01 21:48:01  vasilche
  743. * Added CGeneratedChoiceTypeInfo for generated choice classes.
  744. * Removed CMemberInfo subclasses.
  745. * Added support for DEFAULT/OPTIONAL members.
  746. * Changed class generation.
  747. * Moved datatool headers to include/internal/serial/tool.
  748. *
  749. * Revision 1.25  2000/01/06 16:13:43  vasilche
  750. * Updated help messages.
  751. *
  752. * Revision 1.24  1999/12/30 21:33:39  vasilche
  753. * Changed arguments - more structured.
  754. * Added intelligence in detection of source directories.
  755. *
  756. * Revision 1.23  1999/12/28 18:55:58  vasilche
  757. * Reduced size of compiled object files:
  758. * 1. avoid inline or implicit virtual methods (especially destructors).
  759. * 2. avoid std::string's methods usage in inline methods.
  760. * 3. avoid string literals ("xxx") in inline methods.
  761. *
  762. * Revision 1.22  1999/12/21 17:18:35  vasilche
  763. * Added CDelayedFostream class which rewrites file only if contents is changed.
  764. *
  765. * Revision 1.21  1999/12/20 21:00:18  vasilche
  766. * Added generation of sources in different directories.
  767. *
  768. * Revision 1.20  1999/12/01 17:36:26  vasilche
  769. * Fixed CHOICE processing.
  770. *
  771. * Revision 1.19  1999/11/15 20:01:34  vasilche
  772. * Fixed GCC error
  773. *
  774. * Revision 1.18  1999/11/15 19:36:16  vasilche
  775. * Fixed warnings on GCC
  776. *
  777. * ===========================================================================
  778. */