编写可复用性更好的C++代码——Band对象和COMToys(七)

2024-01-14 11:38
文章标签 代码 c++ 编写 对象 复用 更好 band comtoys

本文主要是介绍编写可复用性更好的C++代码——Band对象和COMToys(七)，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

编译/赵湘宁

原著:Paul Dilascia

MSJ November 1999 & December 1999

关键字：Bands 对象，Desk Bands，Info/Comm Bands，Explorer Bar，Tool Bands。

本文假设你熟悉C++，COM，IE。

下载本文源代码: MyBands.zip (128KB)
                TestEditSrch.zip (75KB)


第一部分:Band 对象介绍
第二部分:BandObj的类层次和MyBands服务程序的注册
第三部分:深入Band内部，揭开Band的面纱
第四部分:Band对象使用中遇到的一些问题
第五部分:建立自己的COM编程平台ComToys
第六部分:设计和构造COMToys


第七部分 类的实现

类的混合实现
    到目前为止，我介绍了一种用多继承代替嵌套类在MFC中实现COM对象的方法。基本思路是忽略MFC宏和接口映射，并调用GetInterfaceHook来返回接口指针。很明显，这已经使编程容易了许多，但可复用性体现在哪呢？开发COMToys的主要目的是让它具备可复用性特点来实现普通的COM接口。为此，COMToys使用了混合类。
    混合类被设计成利用多继承特性与其它类混合。通常混合类与主类的关系是直交的，也就是说它提供与类层次的无关性来避免菱形派生树（请原谅我的矛盾修饰法），不用怀疑，CBandObj比我在前面四个部分中讨论的要复杂一些，其新版本的代码如下： 
//更新的 CBandObj 
/
// CBandObj —— 典型的实现多接口的 COM 类
// 头文件.h :
class CBandObj : public CWnd,
// interfaces 
// public IOleWindow,      // 从IDeskBand继承
// public IDockingWindow,  // 从IDeskBand继承
public IDeskBand,
public IObjectWithSite,
public IInputObject,
// public IPersist,        // 从IPersistStream继承
public IPersistStream,
public IContextMenu,
// 使用ComToys实现
public CTOleWindow,
public CTDockingWindow,
public CTPersist,
public CTPersistStream,
public CTInputObject,
public CTInputObjectSite,
public CTContextMenu
{
public:
CBandObj(REFCLSID clsid);
virtual ~CBandObj();
// 改写以便实现 QueryInterface
virtual LPUNKNOWN GetInterfaceHook(const void* iid);
// 用ComToys实现的接口
DECLARE_IUnknown();
DECLARE_IOleWindow();
DECLARE_IDockingWindow();
DECLARE_IInputObject();
DECLARE_IPersist();
DECLARE_IPersistStream();
DECLARE_IContextMenu();
DECLARE_IObjectWithSite();
// IDeskBand
STDMETHOD (GetBandInfo) (DWORD, DWORD, DESKBANDINFO*);
};
// 实现文件 .cpp :
CBandObj::CBandObj(REFCLSID clsid) :
// 初始化所有实现类
CTMfcComObj(this),
CTOleWindow(this),
CTDockingWindow(this),
CTPersist(clsid),
CTPersistStream(),
CTInputObject(this),
CTContextMenu(this, CTMfcComObjFactory::GetFactory(clsid)->GetResourceID())
{
......
}
//
// 这些宏用ComToys实现了所有接口
//
IMPLEMENT_IUnknown         (CBandObj, CTMfcComObj);
IMPLEMENT_IOleWindow       (CBandObj, CTOleWindow);
IMPLEMENT_IDockingWindow   (CBandObj, CTDockingWindow);
IMPLEMENT_IPersist         (CBandObj, CTPersist);
IMPLEMENT_IContextMenu     (CBandObj, CTContextMenu);
IMPLEMENT_IPersistStream   (CBandObj, CTPersistStream);
IMPLEMENT_IInputObject     (CBandObj, CTInputObject);
/
// 改写后旁路掉MFC在CCmdTarget::InternalQueryInterface中的接口映射
//
LPUNKNOWN CBandObj::GetInterfaceHook(const void* piid)
{
REFIID iid = *((IID*)piid);
if (iid==IID_IUnknown) 
return (IDeskBand*)this;
#define IF_INTERFACE(iid, iface)                            /
if (iid==IID_##iface)                                    /
return (iface*)this;                                  /
IF_INTERFACE(iid, IOleWindow);
IF_INTERFACE(iid, IDockingWindow);
IF_INTERFACE(iid, IObjectWithSite);
IF_INTERFACE(iid, IInputObject);
IF_INTERFACE(iid, IPersist);
IF_INTERFACE(iid, IPersistStream);
IF_INTERFACE(iid, IContextMenu);
IF_INTERFACE(iid, IDeskBand);
return NULL;
}
乍一看这些类与ATL如此类似！且看下文的分析。
        CBandObj从IDeskBand继承IOleWindow 和 IDockingWindow，所以必须实现它们。对于IUnknown来说，COMToys的宏声明方法，DECLARE_IOleWindow 和 DECLARE_IDockingWindow仅声明大多数派生的方法，而不是继承的方法（马上就会明白为什么），这两个宏都是不可少的。DECLARE_IDeskBand宏是不存在的，因为COMToys不具备实现它的类；IDeskBand由CBandObj实现。对于IUnknown，COMToys有更多的宏实现此接口。
    新的宏用CTOleWindow实现了IOleWindow，并用CTDockingWindow 实现了IDockingWindow。IMPLEMENT_IWhatsIt宏通过产生调用类实现的方法将某个接口定义（抽象类）与接口实现（具体的类）进行链接。 
 // 由IMPLEMENT_IOleWindow产生
HRESULT CBandObj::GetWindow(HWND* pHwnd)
{
CMDTARGENTRYTR(
_T("CBandObj(%p)::IOleWindow::GetWindow/n"), 
this);      
return CTOleWindow::GetWindow(pHwnd);
}
一旦你声明并实现了这些接口，剩下的事情是通过在GetInterfaceHook中编写代码，让MFC知道它们： 
 // 在CBandObj::GetInterfaceHook中
if (iid==IID_IOleWindow)
return (IOleWindow*)this;
if (iid==IID_IDockingWindow)
return (IDockingWindow*)this;
    很简单，如果理解了它们在IOleWindow中的工作原理，便会明白CBandObj的代码大多是相同东西的重复。对于新的COM类实现的每个IWhatsIt接口，要从两个类派生：COM接口本身(IWhatsIt)和实现CTWhatsIt的CT类。执行类可以是COMToys所带的一个类或是自己的类。两种情况的接口和实现都是分开的。这样感觉比较专业，因为它也是COM的基本原则。 现在假设已经有了实现某些接口的CTWhatsIt,为了在自己的COM类中使用它，必须做四件事情：
  • 派生IWhatsIt 和 CTWhatsIt；
  • 用DECLARE_IWhatsIt声明方法；
  • 用IMPLEMENT_IWhatsIt(CMyComClass, CTWhatsIt)来实现这些方法；
  • 并在CMyComClass::GetInterfaceHook中添加几行相应的代码，看上面就知道只有总共五行代码，就这么简单。

实现执行类

    前面的讨论都是假设已经具备了实现接口的CTWhatsIt！至少是已知如何将接口实现局部化在一个C++类中——换句话说，就是如何重用接口实现。为了提供更加方便的应用，COMToys内建了许多现成的接口实现。CTPersist, CTPersistStream, CTOleWindow, CTDockingWindow, CTInputObject等等。它们是如何工作的呢？ 有关执行类的第一个让人奇怪的地方是它们不是从其对应的接口派生而来的！而只是带有相同名字和签名方法的类。 
 // 不从IOleWindow派生!
class CTOleWindow {
public:
// 与主类相同的宏
DECLARE_IOleWindow();
};
    接口和实现之间没有真正的联系；所谓的联系完全是词汇上的。这就是另外一个使用DECLARE_IFoo的理由：它保证获得正确的名字和签名。在CTOleWindow中的编排也不会产生错误，简单地定义一个新函数即可。 关于混合类的另外一个要注意的事情是方法实现只针对派生接口，而不是继承的接口。IDockingWindow 实现 ShowDW，CloseDW 和ResizeBorderDW——而不是GetWindow 或ContextSensitiveHelp，它们从IOleWindow继承。所以要想实现IDockingWindow，就必须混合CTDockingWindow 和CTOleWindow。同样，CTPersistStream也不实现GetClassID，它是从IPersist继承的。 为什么我要这么做呢？第一，它混合并匹配不同的实现类。第二，可选择性考虑。例如，假设我从CTPersist派生CTPersistFile 和CTPersistStream，它们都有GetClassID函数（我最初就是这么做的）。现在使用CTPersistFile 和CTPersistStream的任何类都有GetClassID的两个拷贝，这样造成了不明确的多继承。图十七 中的多继承规则（Magic MI）只用于纯粹的虚函数，而非具体函数，由此所有多继承接口获得相同的具体函数。想象得到，尽管希望IPersistFile 和 IPersistStream有不同的GetClassID实现，但百分之九十九的时间做不到。通过在CTPersistFile 和 CTPersistStream,中只实现大多数派生方法，COMToys可以进行一次而且是仅有的一次混合来实现想要的CTPersist。当编写下面的代码后： 
 IMPLEMENT_IPersist(CMyComClass, CTPersist);
产生的GetClassID方法便替代IPersistStream 和 IPersistFile中的GetClassID。 最后正是在这些方法中我不得不针对语言规范编写一些代码。所幸的是它不算太麻烦。只是将前面用嵌套类实现的BandObj转换成本文中对应的CTXxx类，将必须的变量转换成数据成员并在构造函数中进行初始化。例如，CTPersist的代码如下： 
 class CTPersist {
public:
const CLSID& m_clsid;
CTPersist(const CLSID& clsid) : m_clsid(clsid) { }
STDMETHODIMP GetClassID(LPCLSID pClassID) {
return pClassID ? 
(*pClassID=m_clsid, S_OK) : E_UNEXPECTED;
}
};
    CTPersist保存着类ID的引用，并不是类ID本身。此乃COMToys的一般原则：执行类不存储实际数据，只有外部对象的指针或引用。对于CTPersist，它无关紧要，因为一旦运行中的对象类ID改变，它便无所适从。但一般来说，数据是可以改变的，所以让父类拥有数据是明智的，这样它就可以自由的处理这些数据。CTPersistFile 和 CTPersistStream都有一个m_bModified修改标志，但它是对BOOL类型的一个引用，而不是BOOL类型。如果主类改变了实际的标志，执行类自动改变，不用自己去调用诸如SetModified之类的函数。作为一个一般的编程规则，对状态的操作最好是用按需方式进行（demand-pull），而不要用先入方式（supply-push），并且整个系统的每个状态变量自始至终只应该有一个拷贝。 CTMfcContextMenu的情况类似，它保存着对仅仅一个CMenu的引用，主类必须在构造时提供。 
// 在COMToys.h文件中
class CTMfcContextMenu {
public:
CCmdTarget* m_pCmdTarget;
CMenu& m_ctxMenu;
CTMfcContextMenu(CCmdTarget* pTarg, CMenu& menu)
: m_pCmdTarget(pTarg), m_ctxMenu(menu) { }
……
};
// 在BandObj.cpp文件中
CBandObj::CBandObj(REFCLSID clsid) :
CTMfcContextMenu(this, m_menu), ...
{
……
}
    因为CTMfcContextMenu::m_ctxMenu是个引用，CBandObj可以任何方式改变菜单，不必显式通知CTMfcContextMenu。CBandObj依赖这个特性，因为当用户右键单击Band时，它产生其浮动菜单。如图十二）。CTMfcContextMenu的实现基本上照搬前面代码中相应的部分。


图十二 CBandObj 上下文菜单 

    当容器调用IContextMenu::QueryContextMenu获得菜单项时，CTMfcContextMenu用希望的CMenu项填写菜单，但不是在创建CcmdUI对象之前，并且通过CCmdTarget发送，从而ON_UPDATE_COMMAND_UI处理器都能挂上菜单。同样，当容器调用InvokeCommand，CTMfcContextMenu发送这个命令到ON_COMMAND处理器。CTMfcContextMenu甚至能通过查找串资源来处理提示串。简言之，CTMfcContextMenu将COM语言转换成MFC语言。剩下的事情只是给它一个菜单和命令目标（通常是COM类本身）。所有的命令处理与在MFC应用中处理一样，不用再次实现IContextMenu——用COMToys就能搞掂。（待续）

这篇关于编写可复用性更好的C++代码——Band对象和COMToys(七)的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/605035。

相关文章

Python使用Tenacity一行代码实现自动重试详解

Python使用Tenacity一行代码实现自动重试详解

《Python使用Tenacity一行代码实现自动重试详解》tenacity是一个专为Python设计的通用重试库,它的核心理念就是用简单、清晰的方式,为任何可能失败的操作添加重试能力,下面我们就来看... 目录一切始于一个简单的 API 调用Tenacity 入门：一行代码实现优雅重试精细控制：让重试按我
阅读更多...
C++11范围for初始化列表auto decltype详解

C++11范围for初始化列表auto decltype详解

《C++11范围for初始化列表autodecltype详解》C++11引入auto类型推导、decltype类型推断、统一列表初始化、范围for循环及智能指针,提升代码简洁性、类型安全与资源管理效... 目录C++11新特性1. 自动类型推导auto1.1 基本语法2. decltype3. 列表初始化3
阅读更多...
C++11右值引用与Lambda表达式的使用

C++11右值引用与Lambda表达式的使用

《C++11右值引用与Lambda表达式的使用》C++11引入右值引用,实现移动语义提升性能,支持资源转移与完美转发；同时引入Lambda表达式,简化匿名函数定义,通过捕获列表和参数列表灵活处理变量... 目录C++11新特性右值引用和移动语义左值 / 右值常见的左值和右值移动语义移动构造函数移动复制运算符
阅读更多...
C++中detach的作用、使用场景及注意事项

C++中detach的作用、使用场景及注意事项

《C++中detach的作用、使用场景及注意事项》关于C++中的detach,它主要涉及多线程编程中的线程管理,理解detach的作用、使用场景以及注意事项,对于写出高效、安全的多线程程序至关重要,下... 目录一、什么是join()？它的作用是什么？类比一下：二、join()的作用总结三、join()怎么
阅读更多...
Python实现MQTT通信的示例代码

Python实现MQTT通信的示例代码

《Python实现MQTT通信的示例代码》本文主要介绍了Python实现MQTT通信的示例代码,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一... 目录1. 安装paho-mqtt库‌2. 搭建MQTT代理服务器（Broker）‌‌3. pytho
阅读更多...
MySQL进行数据库审计的详细步骤和示例代码

MySQL进行数据库审计的详细步骤和示例代码

《MySQL进行数据库审计的详细步骤和示例代码》数据库审计通过触发器、内置功能及第三方工具记录和监控数据库活动,确保安全、完整与合规,Java代码实现自动化日志记录,整合分析系统提升监控效率,本文给大... 目录一、数据库审计的基本概念二、使用触发器进行数据库审计1. 创建审计表2. 创建触发器三、Java
阅读更多...
C++中全局变量和局部变量的区别

C++中全局变量和局部变量的区别

《C++中全局变量和局部变量的区别》本文主要介绍了C++中全局变量和局部变量的区别,全局变量和局部变量在作用域和生命周期上有显著的区别,下面就来介绍一下,感兴趣的可以了解一下... 目录一、全局变量定义生命周期存储位置代码示例输出二、局部变量定义生命周期存储位置代码示例输出三、全局变量和局部变量的区别作用域
阅读更多...
C++中assign函数的使用

C++中assign函数的使用

《C++中assign函数的使用》在C++标准模板库中,std::list等容器都提供了assign成员函数,它比操作符更灵活,支持多种初始化方式,下面就来介绍一下assign的用法,具有一定的参考价... 目录​1.assign的基本功能​​语法​2. 具体用法示例​​​(1) 填充n个相同值​​(2)
阅读更多...
c++ 类成员变量默认初始值的实现

c++ 类成员变量默认初始值的实现

《c++类成员变量默认初始值的实现》本文主要介绍了c++类成员变量默认初始值,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧... 目录C++类成员变量初始化c++类的变量的初始化在C++中，如果使用类成员变量时未给定其初始值，那么它将被
阅读更多...
C++中NULL与nullptr的区别小结

C++中NULL与nullptr的区别小结

《C++中NULL与nullptr的区别小结》本文介绍了C++编程中NULL与nullptr的区别,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编... 目录C++98空值——NULLC++11空值——nullptr区别对比示例 C++98空值——NUL
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2