ATL持续化之IPersistPropertyBag

本文深入分析了在ATL框架下对象持久化的机制,详细介绍了使用IMedia接口系列支持对象持久性,并重点阐述了IPersist接口及其实现类IPersistPropertyBagImpl<T>在组件持久化中的应用。同时,文章解释了如何通过属性映射表和IDispatch接口实现组件的持久性属性,并展示了如何添加和使用固有属性以优化持久化效果。
摘要由CSDN通过智能技术生成

浅谈ATL中关于对象持续性
 com对于对象持续性并没有什么规定和支持。但是com提供了一些协议,利用这些协议就可以使用对象的持续性。
 在ATL中,提供了一系列介质接口IMedia,用于对象持续性支持。例如IStream  IStrorage IPropertyBag。为什么为了一个持续性提供三个接口呢?这是因为存在这样的一个事实:com组件容器并不知道用户想要保存对象信息到何处:网络流? 磁盘 or 属性包?
所以,它提供很多接口,用于满足不用持续性方式的需求。
  为了支持对象的永久持续性,ATL提供了IPersist接口,另外,定义了三个接口IPersistStream  IPersistStorage IPersistPropertyBag,它们派生自IPersist接口。IPersist从IUnknown派生,继续了其三个接口函数QueryInterface AddRef  Release,除此之外,它还声明了一个函数GetClassID()。当要进行永久持续化,保存对象信息的时候,首先调用GetClassID()函数获取要持续化对象的CLSID,保存下来,然后再调用对应持续化接口的Write保存有关此对象的一些信息;反之,复然对象的时候,首先调用GetClassID()函数获取对象的CLSID,创建对象,然后调用接口Read获取对象的信息初始化对象。
  下面就属性包IPersistPropertyBag来说说ATL对于永久持续性的支持。
  ATL提供了接口IPersistPropertyBag,我们可以让我们的组件派生于此接口,实现此接口的方法,重写其Load和Save函数,完成组件对象的持续化。但是如此处理过于繁琐。为了简化上层使用,ATL提供的IPersistPropertyBagImpl<T>模板类,顾名思义此模板类实现了IPersistPropertyBag接口,我们可以直接派生此类即可。
  IPersistPropertyBagImpl<T>模板中重写了Load() Save()方法。阅读一下Load()方法就知道,它主要做了下面几件事情:
  (1) 获取属性映射表 BEGIN_PROP_MAP(CLASSNAME) ....  END_PROP_MAP
  (2) 对于属性映射表中的每个表项,调用GetProperty获取其属性。
  关于(2),多说几句。首先:属性映射表的表项有些什么东东。我们先看看属性映射表以及获取静态函数表的函数定义:
BEGIN_PROP_MAP(CXXX)
 PROP_DATA_ENTRY("_cx", m_sizeExtent.cx, VT_UI4)
 PROP_DATA_ENTRY("_cy", m_sizeExtent.cy, VT_UI4)
 //or CLSID_NULL
 PROP_ENTRY("UiMode", 16,  CLSID_XXX)
 PROP_ENTRY("Url", 15, CLSID_XXX) 
END_PROP_MAP()
  上面就是一个简单的ATL组件的属性映射表。前面两个使用了prop_data_entry宏,后面的使用prop_entry,当然还可以用prop_entryex宏,具体的宏的意义
可以查看ATL代码,这里不罗嗦。简单一句话,就是往一个静态表中填充表项,表项--属性映射项,包括信息有:属性名 属性值 属性的dispid IDispatch接口iid等。
   其次,这里说了调用GetProperty方法获取属性。拿上面的属性映射表来说,前面两项是工程自己生成的,后面两个是手动添加的。PROP_ENTRY("UiMode", 16,  CLSID_XXX)带有三个参数:第一个是属性名"UiMode" 第二个是属性dispid,什么意思呢?也就是对应idl文件中的属性的dispid。为什么需要这里?因为永久持续性属性需要通过IDispatch接口,然后调用Invoke方法访问属性,访问哪个属性,就是通过此属性的dispid来确定的。说道这里就都明白了,调用GetProperty()方法,实际上就是通过查出Dispatch接口,然后调用Invoke方法来访问属性的。
  
   步骤二调用GetProperty()其实与就是为了检测一下此dispid对相应的属性的get方法是否存在,没太多其他作用
  
  (3) 调用IPropertyBag::Read()方法,读取指定属性名的值。
  HRESULT hr = pPropBag->Read(pMap[i].szDesc, &var, pErrorLog);
 
 (4) 调用CComPtr<IDispatch>::PutProperty将获取的属性值写入。方法:通过IDispatch::Invoke(dispid)调用对应的属性put函数。
  pDispatch.PutProperty(pMap[i].dispid, &var);
  
  也就是说,就通常的VARIANT兼容类型来说,如果我们想添加永久持续性属性,我们并不需要重写IPersistPropertyBagImpl::Load或者IPersistPropertyBag_Load函数,而只需要在属性映射表中添加相应的永久属性映射项即可,因为IPersistPropertyBagImpl类已经为我们把基本的东西都处理了。
 
  下面就说说如何添加一个固有属性:
  (1) 为组件对象添加基类:public IPersistPropertyBagImpl<CXP> 
  (2) 添加对应的接口映射:COM_INTERFACE_ENTRY(IPersistPropertyBag)
  (3) 属性映射表中添加你要的:
BEGIN_PROP_MAP(CXPPlayer)
 PROP_DATA_ENTRY("_cx", m_sizeExtent.cx, VT_UI4)
 PROP_DATA_ENTRY("_cy", m_sizeExtent.cy, VT_UI4)
 //or CLSID_NULL
 PROP_ENTRY("UiMode", 16,  CLSID_XPPlayer)
END_PROP_MAP()
  这里idl对应关于dispid = 16相关代码如下:
  [propget, id(16), helpstring("property UiMode")]    HRESULT UiMode([out, retval] INT* newVal);
 [propput, id(16), helpstring("property UiMode")]    HRESULT UiMode([in] INT newVal);
 
 如此一来,就定义了自己的固有属性UiMode的,你可以在你的控件使用中使用此属性。为什么需要这个呢?直接有了UiMode属性就可以了,为啥还搞个固有属性。你想想,类似UiMode这种属性,如果你仅仅以属性方式提供的话,更新UiMode会导致界面更新跳动。所以最好的方式就是使用固有属性,让控件在初始化的时候就进行相关的分支操作。要不然等到控件初始化之后,你在调用UiMode属性修改,就会导致界面跳动。
 在web中你可以使用固有属性,也就是你经常看到的<Param name =  value= >之类的东西,例如:
<object id="pplayer" classid="clsid:ABDC34RT-956E-49CC-B444-73AFE593AD34"  width="700" height="600" >
<PARAM NAME="UiMode" VALUE="0">
</object>

 

注:本文出自http://lanhy2000.blog.163.com/blog/static/4367860820124208285287/

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值