commreg.h
上传用户:dangjiwu
上传日期:2013-07-19
资源大小:42019k
文件大小:7k
源码类别:

Symbian

开发平台:

Visual C++

  1. /* ***** BEGIN LICENSE BLOCK *****
  2.  * Source last modified: $Id: commreg.h,v 1.3.32.3 2004/07/09 01:48:00 hubbe Exp $
  3.  * 
  4.  * Portions Copyright (c) 1995-2004 RealNetworks, Inc. All Rights Reserved.
  5.  * 
  6.  * The contents of this file, and the files included with this file,
  7.  * are subject to the current version of the RealNetworks Public
  8.  * Source License (the "RPSL") available at
  9.  * http://www.helixcommunity.org/content/rpsl unless you have licensed
  10.  * the file under the current version of the RealNetworks Community
  11.  * Source License (the "RCSL") available at
  12.  * http://www.helixcommunity.org/content/rcsl, in which case the RCSL
  13.  * will apply. You may also obtain the license terms directly from
  14.  * RealNetworks.  You may not use this file except in compliance with
  15.  * the RPSL or, if you have a valid RCSL with RealNetworks applicable
  16.  * to this file, the RCSL.  Please see the applicable RPSL or RCSL for
  17.  * the rights, obligations and limitations governing use of the
  18.  * contents of the file.
  19.  * 
  20.  * Alternatively, the contents of this file may be used under the
  21.  * terms of the GNU General Public License Version 2 or later (the
  22.  * "GPL") in which case the provisions of the GPL are applicable
  23.  * instead of those above. If you wish to allow use of your version of
  24.  * this file only under the terms of the GPL, and not to allow others
  25.  * to use your version of this file under the terms of either the RPSL
  26.  * or RCSL, indicate your decision by deleting the provisions above
  27.  * and replace them with the notice and other provisions required by
  28.  * the GPL. If you do not delete the provisions above, a recipient may
  29.  * use your version of this file under the terms of any one of the
  30.  * RPSL, the RCSL or the GPL.
  31.  * 
  32.  * This file is part of the Helix DNA Technology. RealNetworks is the
  33.  * developer of the Original Code and owns the copyrights in the
  34.  * portions it created.
  35.  * 
  36.  * This file, and the files included with this file, is distributed
  37.  * and made available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY
  38.  * KIND, EITHER EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS
  39.  * ALL SUCH WARRANTIES, INCLUDING WITHOUT LIMITATION, ANY WARRANTIES
  40.  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, QUIET
  41.  * ENJOYMENT OR NON-INFRINGEMENT.
  42.  * 
  43.  * Technology Compatibility Kit Test Suite(s) Location:
  44.  *    http://www.helixcommunity.org/content/tck
  45.  * 
  46.  * Contributor(s):
  47.  * 
  48.  * ***** END LICENSE BLOCK ***** */
  49. #ifndef _COMM_REG_H_
  50. #define _COMM_REG_H_
  51. #include "hxtypes.h"
  52. #include "hxcom.h"
  53. #include "hxmon.h"
  54. #include "db_misc.h"
  55. class Property;
  56. class DB_implem;
  57. class DB_node;
  58. class CHXID;
  59. class WatchList;
  60. class Key;
  61. class PropWatch;
  62. class WListElem;
  63. struct IHXBuffer;
  64. struct IHXValues;
  65. /*
  66.  * 
  67.  *  Class:
  68.  *
  69.  * CommonRegistry
  70.  *
  71.  *  Purpose:
  72.  *
  73.  *     this is the common registry which is going to be shared by the client
  74.  *  and the server. it acts like a bridge between the interface and the 
  75.  *  implementation based on a model taken from the book 
  76.  *  "design patterns" by gamma, helm, johnson and vlissides.
  77.  * 
  78.  */
  79. class CommonRegistry
  80. {
  81. public:
  82. CommonRegistry();
  83. ~CommonRegistry();
  84.     UINT32  AddComp(const char* pName);
  85.     UINT32  AddInt(const char* pName, const INT32 iValue);
  86.     HX_RESULT  GetInt(const char* pName, INT32* iValue) const;
  87.     HX_RESULT  GetInt(const UINT32 id, INT32* iValue) const;
  88.     HX_RESULT  SetInt(const char* pName, const INT32 iValue);
  89.     HX_RESULT  SetInt(const UINT32 id, const INT32 iValue);
  90.     UINT32  AddStr(const char* pName, IHXBuffer* pValue);
  91.     HX_RESULT  SetStr(const char* pName, IHXBuffer* pValue);
  92.     HX_RESULT  SetStr(const UINT32 id, IHXBuffer* pValue);
  93.     HX_RESULT  GetStr(const char* pName, 
  94.        REF(IHXBuffer*) pcValue) const;
  95.     HX_RESULT  GetStr(const UINT32 id, REF(IHXBuffer*) pcValue) const;
  96.     UINT32  AddBuf(const char* pName, IHXBuffer* pBuf);
  97.     HX_RESULT  GetBuf(const char* pName, IHXBuffer** ppBuf) const;
  98.     HX_RESULT  GetBuf(const UINT32 id, IHXBuffer** ppBuf) const;
  99.     HX_RESULT  SetBuf(const char* pName, IHXBuffer* pBuf);
  100.     HX_RESULT  SetBuf(const UINT32 id, IHXBuffer* pBuf);
  101.     HX_RESULT SetReadOnly(const char* pName, BOOL bValue);
  102.     HX_RESULT SetReadOnly(UINT32 ulRegId, BOOL bValue);
  103.     UINT32  AddIntRef(const char* pName, INT32* piValue);
  104.     UINT32  Del(const char* pName);
  105.     UINT32  Del(const UINT32 key);
  106.     HXPropType  GetType(const char* pName) const;
  107.     HXPropType  GetType(const UINT32 id) const;
  108.     HX_RESULT GetPropList(IHXValues*& pValues) const;
  109.     HX_RESULT GetPropList(const char* pName,
  110.     IHXValues*& pValues) const;
  111.     HX_RESULT GetPropList(const UINT32 id,
  112.     IHXValues*& pValues) const;
  113.     HX_RESULT Copy(const char* pFrom, const char* pTo);
  114.     HX_RESULT SetStringAccessAsBufferById(UINT32 ulId);
  115.     UINT32 FindParentKey(const char* pName);
  116.     UINT32 FindParentKey(const UINT32 id);
  117.     INT32  Count() const;
  118.     INT32  Count(const char* pName) const;
  119.     INT32  Count(const UINT32 id) const;
  120.     HX_RESULT GetPropName(const UINT32 ulId, 
  121.     IHXBuffer*& prop_name) const;
  122.     UINT32 GetId(const char* prop_name) const;
  123.     virtual HX_RESULT     AddDone(DB_implem* db_level, DB_node* new_node,
  124.                                   DB_node* parent_node, Property* parent_prop);
  125.     virtual HX_RESULT     SetDone(DB_node* new_node, Property* new_prop);
  126.     virtual HX_RESULT     DeleteDone(DB_implem* db_level, DB_node* node,
  127.                                      Property* prop);
  128.     /*
  129.      * Watch specific methods
  130.      */
  131.     UINT32 SetWatch(PropWatch* pPropWatch);
  132.     UINT32 SetWatch(const char* pName, PropWatch* pPropWatch);
  133.     UINT32 SetWatch(const UINT32 id, PropWatch* pPropWatch);
  134.     HX_RESULT SetTrickleWatch(const char* pParName, 
  135. const char* pTargetName,
  136.         PropWatch* pPropWatch);
  137.     HX_RESULT ClearWatch(IHXPropWatchResponse* pResonse=NULL);
  138.     HX_RESULT ClearWatch(const char* pName, IHXPropWatchResponse* pResonse=NULL);
  139.     HX_RESULT ClearWatch(const UINT32 id, IHXPropWatchResponse* pResonse=NULL);
  140.     HX_RESULT DeleteWatch(Property* p, WListElem* wle);
  141.     HX_RESULT           m_LastError;
  142. protected:
  143.     virtual DB_node* _addComp(Key* k, char* key_str, DB_implem* ldb);
  144.     virtual DB_node* _addInt(Key* k, char* key_str, INT32 val, 
  145. DB_implem* ldb);
  146.     virtual DB_node* _addBuf(Key* k, char* key_str, IHXBuffer* buf, 
  147. DB_implem* ldb, 
  148. HXPropType val_type = PT_BUFFER);
  149.     virtual DB_node* _addIntRef(Key* k, char* key_str, INT32* val, 
  150.    DB_implem* ldb);
  151.     virtual HX_RESULT _clearWatch(IHXPropWatchResponse* pResonse);
  152.     virtual HX_RESULT _clearWatch(Property*, IHXPropWatchResponse* pResonse);
  153.     virtual void _dispatchCallbacks(DB_node*, Property*, DB_Event);
  154.     virtual void  _dispatchParentCallbacks(DB_implem*, DB_node*, 
  155.  DB_Event);
  156.    
  157.     virtual HX_RESULT _find(DB_node**, Property**, const char*) const;
  158.     virtual UINT32 _Del(DB_implem*, DB_node*, Property*, UINT32);
  159.     virtual HX_RESULT _del(DB_implem*);
  160.     HX_RESULT _getPropList(DB_implem*, IHXValues*& pValues) const;
  161.     HX_RESULT _setReadOnly(Property* pProp, BOOL bValue);
  162.     UINT32 _buildSubstructure4Prop(const char* pFailurePoint,
  163.     const char* pProp);
  164.     DB_implem*   _logdb_imp;
  165.     CHXID* _ids;
  166.     INT32 _count; // num of elems in the DB
  167.     
  168.     WatchList* m_pWatchList;
  169.     int m_lWatchCount; // count num of Watches
  170. };
  171. #endif // _COMM_REG_H_