ESFramework介绍之（9）－－ 插件对（Addin Pai

正如 上文 结尾处提到，当增加一项新的业务，调试包含了这个新业务实现的插件对（ AddinPair ）时非常麻烦，因为在 ESFramework 4 层架构中，服务端功能插件加载于功能服务器（ FS ）上，客户端插件加载在客户端应用程序上，中间的通信还经过了应用服务器（AS）。这样就要将 AS 、 FS 、 Client 都启动起来，才能对插件 Pair 进行调试，并且在这样调试的过程中，很多其它的因素会分散我们的注意力，比如多线程的影响、消息 Hook 的影响等等，这使得调试 Addin Pair 并不轻松，正是由于这个原因，促使我开发一个插件调试框架来简化这个麻烦的过程。

我的想法是，在 VS.NET 调试模式中运行这个“插件调试框架”（一个 winForm 应用程序），加载要调试的 Addin Pair ，然后，启动 “业务操作窗体”显示出来，后续的交互将在两个插件之间直接进行通信，而 VS.NET 提供了我们跟踪到加载的插件的源码中的能力，这样就可以调试 Addin Pair 了。 “插件调试框架”应用程序的主界面如下：

测试模式中的“异常（功能服务器掉线）”用于模拟找不到对应服务端功能插件的情况。

我们知道，客户插件（ PassiveAddin ）通过 IServerAgent 来发送请求获取回复，在客户端应用程序中， IServerAgent 是对底层 Tcp 或 Udp 的封装。在“插件调试框架”我们提供一个 IServerAgent 的实现给要调试的 PassiveAddin 使用， ESFramework 给出的实现是 AddinBridge 类，它实现了 IServerAgent 接口，并且把 PassiveAddin 提交的请求直接提交给已加载的业务功能插件处理。 AddinBridge 实现如下：

AddinBridge
<!--<br><br>Code highlighting produced by Actipro CodeHighlighter (freeware)<br>http://www.CodeHighlighter.com/<br><br>--> 1 /// <summary>
2 /// AddinBridge用于将服务端插件和对应的客户端插件桥接起来，进行调试。
3 /// zhuweisky
4 /// </summary>
5 public class AddinBridge:IServerAgent
6 {
7 public AddinBridge()
8 {
9 }
10
11 #region Property
12 #region FunAddinManagement
13 private IAddinManagementfunAddinManagement = null ;
14 public IAddinManagementFunAddinManagement
15 {
16 set
17 {
18 this .funAddinManagement = value;
19 }
20 }
21
22
23 #endregion
24
25 #region TestMode
26 private TestModetestMode = TestMode.Normal;
27 public TestModeTestMode
28 {
29 set
30 {
31 this .testMode = value;
32 }
33 }
34 #endregion
35
36 #endregion
37
38 #region IServerAgent成员
39 public NetMessageCommitRequest(MessagerequestMsg,DataPrioritydataPriority, bool checkRespond)
40 {
41 if ( this .testMode == ESFramework.Addins.TestMode.FSOffline)
42 {
43 requestMsg.Header.MessageBodyLength = 0 ;
44 requestMsg.Header.Result = ServiceResultType.ServiceIsNotExist;
45 return new NetMessage(requestMsg.Header, null );
46 }
47
48 foreach (IFunAddinfunAddin in this .funAddinManagement.AddinList)
49 {
50 if (funAddin.ServiceKey == requestMsg.Header.ServiceKey)
51 {
52 // 交给功能插件处理
53 return funAddin.DealRequestMessage(requestMsg.ToNetMessage());
54 }
55 }
56
57 requestMsg.Header.MessageBodyLength = 0 ;
58 requestMsg.Header.Result = ServiceResultType.ServiceIsNotExist;
59 return new NetMessage(requestMsg.Header, null );
60 }
61
62 public NetMessageCommitRequest(MessagerequestMsg,DataPrioritydataPriority, int expectResServiceKey)
63 {
64 return this .CommitRequest(requestMsg,dataPriority, true );
65 }
66
67 #endregion
68 }
69
70 /// <summary>
71 /// 调试模式
72 /// </summary>
73 public enum TestMode
74 {
75 Normal,FSOffline
76 }