编写可复用性更好的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。

相关文章

【C++ Primer Plus习题】13.4

【C++ Primer Plus习题】13.4

大家好,这里是国中之林! ❥前些天发现了一个巨牛的人工智能学习网站，通俗易懂，风趣幽默，忍不住分享一下给大家。点击跳转到网站。有兴趣的可以点点进去看看← 问题: 解答: main.cpp #include <iostream>#include "port.h"int main() {Port p1;Port p2("Abc", "Bcc", 30);std::cout <<
阅读更多...
C++包装器

C++包装器

包装器 在 C++ 中，“包装器”通常指的是一种设计模式或编程技巧，用于封装其他代码或对象，使其更易于使用、管理或扩展。包装器的概念在编程中非常普遍，可以用于函数、类、库等多个方面。下面是几个常见的 “包装器” 类型： 1. 函数包装器 函数包装器用于封装一个或多个函数，使其接口更统一或更便于调用。例如，std::function 是一个通用的函数包装器，它可以存储任意可调用对象（函数、函数
阅读更多...
C++11第三弹：lambda表达式 | 新的类功能 | 模板的可变参数

C++11第三弹：lambda表达式 | 新的类功能 | 模板的可变参数

🌈个人主页： 南桥几晴秋 🌈C++专栏： 南桥谈C++ 🌈C语言专栏： C语言学习系列 🌈Linux学习专栏： 南桥谈Linux 🌈数据结构学习专栏： 数据结构杂谈 🌈数据库学习专栏： 南桥谈MySQL 🌈Qt学习专栏： 南桥谈Qt 🌈菜鸡代码练习： 练习随想记录 🌈git学习： 南桥谈Git 🌈🌈🌈🌈🌈🌈🌈🌈🌈🌈🌈🌈🌈�
阅读更多...
【C++】_list常用方法解析及模拟实现

【C++】_list常用方法解析及模拟实现

相信自己的力量，只要对自己始终保持信心，尽自己最大努力去完成任何事，就算事情最终结果是失败了，努力了也不留遗憾。💓💓💓 目录   ✨说在前面 🍋知识点一：什么是list？ •🌰1.list的定义 •🌰2.list的基本特性 •🌰3.常用接口介绍 🍋知识点二：list常用接口 •🌰1.默认成员函数 🔥构造函数（⭐） 🔥析构函数 •🌰2.list对象
阅读更多...
活用c4d官方开发文档查询代码

活用c4d官方开发文档查询代码

当你问AI助手比如豆包，如何用python禁止掉xpresso标签时候，它会提示到 这时候要用到两个东西。https://developers.maxon.net/论坛搜索和开发文档 比如这里我就在官方找到正确的id描述 然后我就把参数标签换过来
阅读更多...
06 C++Lambda表达式

06 C++Lambda表达式

lambda表达式的定义 没有显式模版形参的lambda表达式 [捕获] 前属性 (形参列表) 说明符 异常 后属性 尾随类型 约束 {函数体} 有显式模版形参的lambda表达式 [捕获] <模版形参> 模版约束 前属性 (形参列表) 说明符 异常 后属性 尾随类型 约束 {函数体} 含义 捕获：包含零个或者多个捕获符的逗号分隔列表 模板形参：用于泛型lambda提供个模板形参的名
阅读更多...
poj 1258 Agri-Net（最小生成树模板代码）

poj 1258 Agri-Net（最小生成树模板代码）

感觉用这题来当模板更适合。 题意就是给你邻接矩阵求最小生成树啦。~ prim代码：效率很高。172k...0ms。 #include<stdio.h>#include<algorithm>using namespace std;const int MaxN = 101;const int INF = 0x3f3f3f3f;int g[MaxN][MaxN];int n
阅读更多...
6.1.数据结构-c/c++堆详解下篇（堆排序，TopK问题）

6.1.数据结构-c/c++堆详解下篇（堆排序，TopK问题）

上篇：6.1.数据结构-c/c++模拟实现堆上篇（向下，上调整算法，建堆，增删数据）-CSDN博客 本章重点 1.使用堆来完成堆排序 2.使用堆解决TopK问题 目录 一.堆排序 1.1 思路 1.2 代码 1.3 简单测试 二.TopK问题 2.1 思路(求最小)： 2.2 C语言代码（手写堆） 2.3 C++代码（使用优先级队列 priority_queue）
阅读更多...
计算机毕业设计 大学志愿填报系统 Java+SpringBoot+Vue 前后端分离 文档报告 代码讲解 安装调试

计算机毕业设计 大学志愿填报系统 Java+SpringBoot+Vue 前后端分离 文档报告 代码讲解 安装调试

🍊作者：计算机编程-吉哥 🍊简介：专业从事JavaWeb程序开发，微信小程序开发，定制化项目、 源码、代码讲解、文档撰写、ppt制作。做自己喜欢的事，生活就是快乐的。 🍊心愿：点赞 👍 收藏 ⭐评论 📝 🍅 文末获取源码联系 👇🏻 精彩专栏推荐订阅 👇🏻 不然下次找不到哟~Java毕业设计项目~热门选题推荐《1000套》 目录 1.技术选型 2.开发工具 3.功能
阅读更多...
【C++高阶】C++类型转换全攻略：深入理解并高效应用

【C++高阶】C++类型转换全攻略：深入理解并高效应用

📝个人主页🌹：Eternity._ ⏩收录专栏⏪：C++ “ 登神长阶 ” 🤡往期回顾🤡：C++ 智能指针 🌹🌹期待您的关注 🌹🌹 ❀C++的类型转换 📒1. C语言中的类型转换📚2. C++强制类型转换⛰️static_cast🌞reinterpret_cast⭐const_cast🍁dynamic_cast 📜3. C++强制类型转换的原因📝
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2