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

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

生物技术

开发平台：

C/C++

typeinfo.hpp：源码内容
  1. /*
  2.  * ===========================================================================
  3.  * PRODUCTION $Log: typeinfo.hpp,v $
  4.  * PRODUCTION Revision 1000.3  2004/04/12 17:16:02  gouriano
  5.  * PRODUCTION PRODUCTION: UPGRADED [CATCHUP_003] Dev-tree R1.46
  6.  * PRODUCTION
  7.  * ===========================================================================
  8.  */
  10. #ifndef TYPEINFO__HPP
  11. #define TYPEINFO__HPP
  13. /*  $Id: typeinfo.hpp,v 1000.3 2004/04/12 17:16:02 gouriano Exp $
  14. * ===========================================================================
  15. *
  16. *                            PUBLIC DOMAIN NOTICE
  17. *               National Center for Biotechnology Information
  18. *
  19. *  This software/database is a "United States Government Work" under the
  20. *  terms of the United States Copyright Act.  It was written as part of
  21. *  the author's official duties as a United States Government employee and
  22. *  thus cannot be copyrighted.  This software/database is freely available
  23. *  to the public for use. The National Library of Medicine and the U.S.
  24. *  Government have not placed any restriction on its use or reproduction.
  25. *
  26. *  Although all reasonable efforts have been taken to ensure the accuracy
  27. *  and reliability of the software and data, the NLM and the U.S.
  28. *  Government do not and cannot warrant the performance or results that
  29. *  may be obtained by using this software or data. The NLM and the U.S.
  30. *  Government disclaim all warranties, express or implied, including
  31. *  warranties of performance, merchantability or fitness for any particular
  32. *  purpose.
  33. *
  34. *  Please cite the author in any work or product based on this material.
  35. *
  36. * ===========================================================================
  37. *
  38. * Author: Eugene Vasilchenko
  39. *
  40. * File Description:
  41. *   !!! PUT YOUR DESCRIPTION HERE !!!
  42. */
  44. #include <corelib/ncbistd.hpp>
  45. #include <serial/serialdef.hpp>
  46. #include <serial/hookdata.hpp>
  47. #include <serial/hookfunc.hpp>
  50. /** @addtogroup TypeInfoCPP
  51.  *
  52.  * @{
  53.  */
  56. BEGIN_NCBI_SCOPE
  58. class CObject;
  60. class CObjectIStream;
  61. class CObjectOStream;
  62. class CObjectStreamCopier;
  64. class CClassTypeInfo;
  66. class CObjectTypeInfo;
  67. class CConstObjectInfo;
  68. class CObjectInfo;
  70. class CReadObjectHook;
  71. class CWriteObjectHook;
  72. class CSkipObjectHook;
  73. class CCopyObjectHook;
  75. class CTypeInfoFunctions;
  77. class CNamespaceInfoItem;
  79. // CTypeInfo class contains all information about C++ types (both basic and
  80. // classes): members and layout in memory.
  81. class NCBI_XSERIAL_EXPORT CTypeInfo
  82. {
  83. protected:
  84.     CTypeInfo(ETypeFamily typeFamily, size_t size);
  85.     CTypeInfo(ETypeFamily typeFamily, size_t size, const char* name);
  86.     CTypeInfo(ETypeFamily typeFamily, size_t size, const string& name);
  87. public:
  88.     // various function pointers
  89.     typedef TObjectPtr (*TTypeCreate)(TTypeInfo objectType);
  91.     virtual ~CTypeInfo(void);
  93.     ETypeFamily GetTypeFamily(void) const;
  95.     // name of this type
  96.     const string& GetName(void) const;
  98.     // namespace name
  99.     bool HasNamespaceName(void) const;
  100.     const string& GetNamespaceName(void) const;
  101.     void SetNamespaceName(const string& ns_name) const;
  103.     // namespace prefix
  104.     bool HasNamespacePrefix(void) const;
  105.     const string& GetNamespacePrefix(void) const;
  106.     void SetNamespacePrefix(const string& ns_prefix) const;
  108.     // name of module
  109.     virtual const string& GetModuleName(void) const;
  110.     void SetModuleName(const string& name);
  111.     void SetModuleName(const char* name);
  113.     // size of data object in memory (like sizeof in C)
  114.     size_t GetSize(void) const;
  116.     // creates object of this type in heap (can be deleted by operator delete)
  117.     TObjectPtr Create(void) const;
  119.     // deletes object
  120.     virtual void Delete(TObjectPtr object) const;
  121.     // clear object contents so Delete will not leave unused memory allocated
  122.     // note: object contents is not guaranteed to be in initial state
  123.     //       (as after Create), to do so you should call SetDefault after
  124.     virtual void DeleteExternalObjects(TObjectPtr object) const;
  126.     // check, whether object contains default value
  127.     virtual bool IsDefault(TConstObjectPtr object) const = 0;
  128.     // check if both objects contain the same values
  129.     virtual bool Equals(TConstObjectPtr object1, TConstObjectPtr object2,
  130.                         ESerialRecursionMode how = eRecursive) const = 0;
  131.     // set object to default value
  132.     virtual void SetDefault(TObjectPtr dst) const = 0;
  133.     // set object to copy of another one
  134.     virtual void Assign(TObjectPtr dst, TConstObjectPtr src,
  135.                         ESerialRecursionMode how = eRecursive) const = 0;
  137.     // return true if type is inherited from CObject
  138.     bool IsCObject(void) const;
  139.     virtual const CObject* GetCObjectPtr(TConstObjectPtr objectPtr) const;
  140.     // return true CTypeInfo of object (redefined in polymorphic classes)
  141.     virtual TTypeInfo GetRealTypeInfo(TConstObjectPtr object) const;
  143.     // I/O interface:
  144.     void ReadData(CObjectIStream& in, TObjectPtr object) const;
  145.     void WriteData(CObjectOStream& out, TConstObjectPtr object) const;
  146.     void CopyData(CObjectStreamCopier& copier) const;
  147.     void SkipData(CObjectIStream& in) const;
  149.     virtual bool IsParentClassOf(const CClassTypeInfo* classInfo) const;
  150.     virtual bool IsType(TTypeInfo type) const;
  151.     virtual bool MayContainType(TTypeInfo type) const;
  152.     bool IsOrMayContainType(TTypeInfo type) const;
  154.     // hooks
  155.     void SetGlobalReadHook(CReadObjectHook* hook);
  156.     void SetLocalReadHook(CObjectIStream& in, CReadObjectHook* hook);
  157.     void ResetGlobalReadHook(void);
  158.     void ResetLocalReadHook(CObjectIStream& in);
  159.     void SetPathReadHook(CObjectIStream* in, const string& path,
  160.                          CReadObjectHook* hook);
  162.     void SetGlobalWriteHook(CWriteObjectHook* hook);
  163.     void SetLocalWriteHook(CObjectOStream& out, CWriteObjectHook* hook);
  164.     void ResetGlobalWriteHook(void);
  165.     void ResetLocalWriteHook(CObjectOStream& out);
  166.     void SetPathWriteHook(CObjectOStream* out, const string& path,
  167.                           CWriteObjectHook* hook);
  169.     void SetGlobalSkipHook(CSkipObjectHook* hook);
  170.     void SetLocalSkipHook(CObjectIStream& in, CSkipObjectHook* hook);
  171.     void ResetGlobalSkipHook(void);
  172.     void ResetLocalSkipHook(CObjectIStream& in);
  173.     void SetPathSkipHook(CObjectIStream* in, const string& path,
  174.                          CSkipObjectHook* hook);
  176.     void SetGlobalCopyHook(CCopyObjectHook* hook);
  177.     void SetLocalCopyHook(CObjectStreamCopier& copier, CCopyObjectHook* hook);
  178.     void ResetGlobalCopyHook(void);
  179.     void ResetLocalCopyHook(CObjectStreamCopier& copier);
  180.     void SetPathCopyHook(CObjectStreamCopier* copier, const string& path,
  181.                          CCopyObjectHook* hook);
  183.     // default methods without checking hook
  184.     void DefaultReadData(CObjectIStream& in, TObjectPtr object) const;
  185.     void DefaultWriteData(CObjectOStream& out, TConstObjectPtr object) const;
  186.     void DefaultCopyData(CObjectStreamCopier& copier) const;
  187.     void DefaultSkipData(CObjectIStream& in) const;
  189. private:
  190.     // private constructors to avoid copying
  191.     CTypeInfo(const CTypeInfo&);
  192.     CTypeInfo& operator=(const CTypeInfo&);
  194.     // type information
  195.     ETypeFamily m_TypeFamily;
  196.     size_t m_Size;
  197.     string m_Name;
  198.     string m_ModuleName;
  199.     mutable CNamespaceInfoItem* m_InfoItem;
  201. protected:
  202.     void SetCreateFunction(TTypeCreate func);
  203.     void SetReadFunction(TTypeReadFunction func);
  204.     void SetWriteFunction(TTypeWriteFunction func);
  205.     void SetCopyFunction(TTypeCopyFunction func);
  206.     void SetSkipFunction(TTypeSkipFunction func);
  208.     bool m_IsCObject;
  210. private:
  211.     // type specific function pointers
  212.     TTypeCreate m_CreateFunction;
  214.     CHookData<CReadObjectHook, TTypeReadFunction> m_ReadHookData;
  215.     CHookData<CWriteObjectHook, TTypeWriteFunction> m_WriteHookData;
  216.     CHookData<CSkipObjectHook, TTypeSkipFunction> m_SkipHookData;
  217.     CHookData<CCopyObjectHook, TTypeCopyFunction> m_CopyHookData;
  219.     friend class CTypeInfoFunctions;
  221.     void x_CreateInfoItemIfNeeded(void) const;
  222. };
  225. /* @} */
  228. #include <serial/typeinfo.inl>
  230. END_NCBI_SCOPE
  232. #endif  /* TYPEINFO__HPP */
  236. /* ---------------------------------------------------------------------------
  237. * $Log: typeinfo.hpp,v $
  238. * Revision 1000.3  2004/04/12 17:16:02  gouriano
  239. * PRODUCTION: UPGRADED [CATCHUP_003] Dev-tree R1.46
  240. *
  241. * Revision 1.46  2004/03/25 15:57:55  gouriano
  242. * Added possibility to copy and compare serial object non-recursively
  243. *
  244. * Revision 1.45  2004/01/05 14:24:09  gouriano
  245. * Added possibility to set serialization hooks by stack path
  246. *
  247. * Revision 1.44  2003/11/24 14:10:04  grichenk
  248. * Changed base class for CAliasTypeInfo to CPointerTypeInfo
  249. *
  250. * Revision 1.43  2003/11/18 18:11:47  grichenk
  251. * Resolve aliased type info before using it in CObjectTypeInfo
  252. *
  253. * Revision 1.42  2003/09/16 14:49:15  gouriano
  254. * Enhanced AnyContent objects to support XML namespaces and attribute info items.
  255. *
  256. * Revision 1.41  2003/08/25 15:58:32  gouriano
  257. * added possibility to use namespaces in XML i/o streams
  258. *
  259. * Revision 1.40  2003/07/29 18:47:46  vasilche
  260. * Fixed thread safeness of object stream hooks.
  261. *
  262. * Revision 1.39  2003/04/15 16:19:06  siyan
  263. * Added doxygen support
  264. *
  265. * Revision 1.38  2002/12/23 18:38:51  dicuccio
  266. * Added WIn32 export specifier: NCBI_XSERIAL_EXPORT.
  267. * Moved all CVS logs to the end.
  268. *
  269. * Revision 1.37  2002/09/09 18:14:00  grichenk
  270. * Added CObjectHookGuard class.
  271. * Added methods to be used by hooks for data
  272. * reading and skipping.
  273. *
  274. * Revision 1.36  2001/10/22 15:16:20  grichenk
  275. * Optimized CTypeInfo::IsCObject()
  276. *
  277. * Revision 1.35  2001/05/17 14:59:47  lavr
  278. * Typos corrected
  279. *
  280. * Revision 1.34  2000/11/07 17:25:13  vasilche
  281. * Fixed encoding of XML:
  282. *     removed unnecessary apostrophes in OCTET STRING
  283. *     removed unnecessary content in NULL
  284. * Added module names to CTypeInfo and CEnumeratedTypeValues
  285. *
  286. * Revision 1.33  2000/10/03 17:22:36  vasilche
  287. * Reduced header dependency.
  288. * Reduced size of debug libraries on WorkShop by 3 times.
  289. * Fixed tag allocation for parent classes.
  290. * Fixed CObject allocation/deallocation in streams.
  291. * Moved instantiation of several templates in separate source file.
  292. *
  293. * Revision 1.32  2000/09/29 16:18:15  vasilche
  294. * Fixed binary format encoding/decoding on 64 bit compulers.
  295. * Implemented CWeakMap<> for automatic cleaning map entries.
  296. * Added cleaning local hooks via CWeakMap<>.
  297. * Renamed ReadTypeName -> ReadFileHeader, ENoTypeName -> ENoFileHeader.
  298. * Added some user interface methods to CObjectIStream, CObjectOStream and
  299. * CObjectStreamCopier.
  300. *
  301. * Revision 1.31  2000/09/18 20:00:11  vasilche
  302. * Separated CVariantInfo and CMemberInfo.
  303. * Implemented copy hooks.
  304. * All hooks now are stored in CTypeInfo/CMemberInfo/CVariantInfo.
  305. * Most type specific functions now are implemented via function pointers instead of virtual functions.
  306. *
  307. * Revision 1.30  2000/09/01 13:16:04  vasilche
  308. * Implemented class/container/choice iterators.
  309. * Implemented CObjectStreamCopier for copying data without loading into memory.
  310. *
  311. * Revision 1.29  2000/08/15 19:44:43  vasilche
  312. * Added Read/Write hooks:
  313. * CReadObjectHook/CWriteObjectHook for objects of specified type.
  314. * CReadClassMemberHook/CWriteClassMemberHook for specified members.
  315. * CReadChoiceVariantHook/CWriteChoiceVariant for specified choice variants.
  316. * CReadContainerElementHook/CWriteContainerElementsHook for containers.
  317. *
  318. * Revision 1.28  2000/07/03 18:42:38  vasilche
  319. * Added interface to typeinfo via CObjectInfo and CConstObjectInfo.
  320. * Reduced header dependency.
  321. *
  322. * Revision 1.27  2000/06/16 16:31:08  vasilche
  323. * Changed implementation of choices and classes info to allow use of the same classes in generated and user written classes.
  324. *
  325. * Revision 1.26  2000/05/24 20:08:16  vasilche
  326. * Implemented XML dump.
  327. *
  328. * Revision 1.25  2000/05/09 16:38:34  vasilche
  329. * CObject::GetTypeInfo now moved to CObjectGetTypeInfo::GetTypeInfo to reduce possible errors.
  330. * Added write context to CObjectOStream.
  331. * Inlined most of methods of helping class Member, Block, ByteBlock etc.
  332. *
  333. * Revision 1.24  2000/03/29 15:55:22  vasilche
  334. * Added two versions of object info - CObjectInfo and CConstObjectInfo.
  335. * Added generic iterators by class -
  336. *  CTypeIterator<class>, CTypeConstIterator<class>,
  337. *  CStdTypeIterator<type>, CStdTypeConstIterator<type>,
  338. *  CObjectsIterator and CObjectsConstIterator.
  339. *
  340. * Revision 1.23  2000/03/14 14:43:30  vasilche
  341. * Fixed error reporting.
  342. *
  343. * Revision 1.22  2000/03/07 14:05:33  vasilche
  344. * Added stream buffering to ASN.1 binary input.
  345. * Optimized class loading/storing.
  346. * Fixed bugs in processing OPTIONAL fields.
  347. *
  348. * Revision 1.21  2000/02/17 20:02:30  vasilche
  349. * Added some standard serialization exceptions.
  350. * Optimized text/binary ASN.1 reading.
  351. * Fixed wrong encoding of StringStore in ASN.1 binary format.
  352. * Optimized logic of object collection.
  353. *
  354. * Revision 1.20  1999/12/28 18:55:40  vasilche
  355. * Reduced size of compiled object files:
  356. * 1. avoid inline or implicit virtual methods (especially destructors).
  357. * 2. avoid std::string's methods usage in inline methods.
  358. * 3. avoid string literals ("xxx") in inline methods.
  359. *
  360. * Revision 1.19  1999/12/17 19:04:55  vasilche
  361. * Simplified generation of GetTypeInfo methods.
  362. *
  363. * Revision 1.18  1999/09/22 20:11:51  vasilche
  364. * Modified for compilation on IRIX native c++ compiler.
  365. *
  366. * Revision 1.17  1999/09/14 18:54:07  vasilche
  367. * Fixed bugs detected by gcc & egcs.
  368. * Removed unneeded includes.
  369. *
  370. * Revision 1.16  1999/08/31 17:50:05  vasilche
  371. * Implemented several macros for specific data types.
  372. * Added implicit members.
  373. * Added multimap and set.
  374. *
  375. * Revision 1.15  1999/07/20 18:22:57  vasilche
  376. * Added interface to old ASN.1 routines.
  377. * Added fixed choice of subclasses to use for pointers.
  378. *
  379. * Revision 1.14  1999/07/19 15:50:22  vasilche
  380. * Added interface to old ASN.1 routines.
  381. * Added naming of key/value in STL map.
  382. *
  383. * Revision 1.13  1999/07/13 20:18:10  vasilche
  384. * Changed types naming.
  385. *
  386. * Revision 1.12  1999/07/07 19:58:47  vasilche
  387. * Reduced amount of data allocated on heap
  388. * Cleaned ASN.1 structures info
  389. *
  390. * Revision 1.11  1999/07/07 18:18:32  vasilche
  391. * Fixed some bugs found by MS VC++
  392. *
  393. * Revision 1.10  1999/07/01 17:55:23  vasilche
  394. * Implemented ASN.1 binary write.
  395. *
  396. * Revision 1.9  1999/06/30 18:54:55  vasilche
  397. * Fixed some errors under MSVS
  398. *
  399. * Revision 1.8  1999/06/30 16:04:39  vasilche
  400. * Added support for old ASN.1 structures.
  401. *
  402. * Revision 1.7  1999/06/24 14:44:47  vasilche
  403. * Added binary ASN.1 output.
  404. *
  405. * Revision 1.6  1999/06/15 16:20:09  vasilche
  406. * Added ASN.1 object output stream.
  407. *
  408. * Revision 1.5  1999/06/10 21:06:42  vasilche
  409. * Working binary output and almost working binary input.
  410. *
  411. * Revision 1.4  1999/06/07 19:59:38  vasilche
  412. * offset_t -> size_t
  413. *
  414. * Revision 1.3  1999/06/07 19:30:21  vasilche
  415. * More bug fixes
  416. *
  417. * Revision 1.2  1999/06/04 20:51:40  vasilche
  418. * First compilable version of serialization.
  419. *
  420. * Revision 1.1  1999/05/19 19:56:32  vasilche
  421. * Commit just in case.
  422. *
  423. * ===========================================================================
  424. */