基于接口的插件机制

一、前言

插件,意味着可扩展,且宿主程序不依赖于插件,即插即用。这种软件设计方式可以使我们的应用程序最大化地获得可扩展性、适应性和稳定性,而且便于软件的维护和升级。在什么场景下使用插件呢?例如在本篇文章中,我个人有一个小需求就是希望记事本带行号,于是我自己写了一个极简易的编辑器(CodeEditor),以这个编辑器为例,主体程序功能包括常见的新建、复制、查找、保存等已经完成,但是在使用的过程中发现需要用到 格式化 这个功能,但是我还不想再去改主程序,这种情形下就可以通过插件来实现,这样以后在使用的时候,只要有新的需求就可以通过新增插件来实现,从某种程度上讲这也符合了开放-封闭的设计原则。下面对插件的定义来自百度百科。

插件(Plug-in)是一种遵循一定规范的应用程序接口编写出来的程序。其只能运行在程序规定的系统平台下(可能同时支持多个平台),而不能脱离指定的平台单独运行。

二、插件机制实现原理

实现插件机制的两大要素:一个是接口,另一个是反射。接口其实是一种“契约”,主程序是通过这种“契约”来约束是否存在符合我期望的对象,如果不符合就不会去加载该对象。在CodeEditor中我们约定的接口是IExcutable。而这种“契约”的执行就是通过反射来达到目的,主程序中会通过反射加载约定好的Plugin文件夹下所有的DLL文件,然后遍历这些插件并查看是否存在实现了IExcutable的并且可以实例化的类,如果有则创建该类的实例加入集合并返回集合。主程序拿到集合后会在构造函数中加载这些插件,加载过程包括动态添加菜单、指定菜单的点击事件,这样完整的插件加载过程就完成了。下面通过CodeEditor来具体看下插件的实现过程。

三、插件机制的实践

下面的图是整个CodeEditor的目录结构

第三个CodeEditorControl可以忽略,这个类库是一个自定义的控件,是实现一个带行号的文本编辑器的核心组件,但是和本文主题关系不大。主要看插件接口CodeEditorInterface和插件实现CodeEditorPlugins以及主程序CodeEditor。这三者的关系可以通过以下图片来展示。

首先从主程序和插件之间的桥梁入手,就是插件的接口,在CodeEditorInterface中的接口IExcutable中有两个约定方法,一个是GetName负责返回当前的插件名称,用于主程序获取并动态加载到菜单中;另一个是Excute负责获取主程序中文本并执行相应的操作。代码如下:

1 public interface IExcutable2 {3     //用于主程序动态创建菜单4     string GetName();5     //执行具体的文本操作6     string Excute(string text);7 }

下面是主程序加载符合“契约”的插件对象的核心代码,主要作用就是过滤符合接口的类并实例化类的对象,加到集合中:

 1 public class Common 2 { 3     /// <summary> 4     /// 加载插件 5     /// </summary> 6     /// <returns></returns> 7     public static List<IExcutable> GetPlugins() 8     { 9         List<IExcutable> implementObject = new List<IExcutable>();10         //获取项目根目录下的Plugins文件夹11         string dir = GetPluginsDir();12         //遍历目标文件夹中包含dll后缀的文件13         foreach (var file in Directory.GetFiles(dir + @"\", "*.dll"))14         {15             //加载程序集16             var asm = Assembly.LoadFrom(file);17             //遍历程序集中的类型18             foreach (var type in asm.GetTypes())19             {20                 //如果是IExcutable接口21                 if (type.GetInterfaces().Contains(typeof(IExcutable)))22                 {23                     //创建接口类型实例24                     var IExcutable = Activator.CreateInstance(type) as IExcutable;25                     if (IExcutable != null)26                     {27                         implementObject.Add(IExcutable);28                     }29                 }30             }31         }32         return implementObject;33     }34 35     /// <summary>36     /// 获取插件目录37     /// </summary>38     /// <returns></returns>39     static string GetPluginsDir()40     {41         string pluginDir = ConfigurationManager.AppSettings["pluginDir"];42         return pluginDir;43     }44 }

下面的代码段主要功能是在主程序中为插件分配菜单,绑定公共事件:

 1 /// <summary> 2 /// 创建插件公共事件 3 /// </summary> 4 /// <param name="sender"></param> 5 /// <param name="e"></param> 6 private void Plugin_Click(object sender, EventArgs e) 7 { 8     ToolStripItem item= sender as ToolStripItem; 9     if (null != item)10     {11 12         if (null != item.Tag)13         {14             IExcutable plugin = item.Tag as IExcutable;15             if (null != plugin)16             {17                 CodeContent.RichText=plugin.Excute(CodeContent.RichText);18             }19         }20     }21 }22 23 /// <summary>24 /// 主程序加载插件25 /// </summary>26 private void LoadPlugins()27 {28     List<IExcutable> list = Common.Common.GetPlugins();29     foreach (var Iplugins in list)30     {31         ToolStripMenuItem item = new ToolStripMenuItem(Iplugins.GetName());//动态创建以插件菜单32         item.Name = Iplugins.GetName();33         item.Click += new EventHandler(Plugin_Click);//绑定公共事件34         item.Tag = Iplugins;35         this.Plugins.DropDownItems.Add(item);36     }37 }

其中的GetPlugins方法就是遍历指定目录下的DLL文件,并把符合接口约定的对象加入集合返回给主程序。而GetPluginsDir方法是获取插件的存储位置,主要是在配置文件中读取插件目录。

 1 <?xml version="1.0" encoding="utf-8"?> 2 <configuration> 3   <startup> 4     <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5"/> 5   </startup> 6   <appSettings> 7     <!--配置加载插件目录--> 8     <add key="pluginDir"  value="CodeEditorPlugins"/> 9   </appSettings>10 </configuration>

实现效果如图:

转换前的文本,Format的作用是把所有的小写字母转为大写。

转换后的文本。

四、总结

这个迷你编辑器是之前的一个小程序,整理代码的时候发现的,突然想改造一下使其更符合我的使用要求,就顺便加了个插件机制。插件机制是一种良好的软件设计思想,可以在不修改主程序的情况下扩展主程序的功能,有时候一款软件的插件功能要比主程序自带的功能要强大得多。应用插件机制要注意几点:

  • 定义接口,也就是主程序与插件的“契约”
  • 应用反射,通过反射来加载符合接口的类,然后创建该类的对象调用接口方法
时间: 2024-10-26 02:10:01

基于接口的插件机制的相关文章

在VC6中基于dll开发插件用于各种图片显示(BMP/TGA/JPG/GIF/PNG/TIF/ICO/WMF/EMF/...)

一.图片显示 图片显示的方法: 1.  直接写程序 2.  第3方库 3.  调用COM组件的IPicture接口 4.  使用MFC的CPictureHolder类 5.  使用GDI+的CImage类(VC6无,从VS2003开始有) 测试过的方法有1.3.5. 测试过的格式有BMP/TGA/JPG/GIF/PNG/TIF/ICO/WMF/EMF. IPicture接口不支持的格式有:PNG和TIF. GDI+支持全部格式. 二.插件的实现(VC6) 只做了基于DLL的插件实现试验,基于“公

MyBatis 源码分析 - 插件机制

1.简介 一般情况下,开源框架都会提供插件或其他形式的拓展点,供开发者自行拓展.这样的好处是显而易见的,一是增加了框架的灵活性.二是开发者可以结合实际需求,对框架进行拓展,使其能够更好的工作.以 MyBatis 为例,我们可基于 MyBatis 插件机制实现分页.分表,监控等功能.由于插件和业务无关,业务也无法感知插件的存在.因此可以无感植入插件,在无形中增强功能. 开发 MyBatis 插件需要对 MyBatis 比较深了解才行,一般来说最好能够掌握 MyBatis 的源码,门槛相对较高.本篇

Android基础入门教程——3.2 基于回调的事件处理机制

Android基础入门教程--3.2 基于回调的事件处理机制 标签(空格分隔): Android基础入门教程 本节引言 在3.1中我们对Android中的一个事件处理机制--基于监听的事件处理机制进行了学习,简单的说就是 为我们的事件源(组件)添加一个监听器,然后当用户触发了事件后,交给监听器去处理,根据不同的事件 执行不同的操作;那么基于回调的事件处理机制又是什么样的原理呢?好吧,还有一个问题:你知道 什么是方法回调吗?知道吗?相信很多朋友都是了解,但又说不出来吧!好了,带着这些疑问我们 对a

[转载]通达信插件选股(基于通达信插件编程规范的简单分析)

[转载]通达信插件选股(基于通达信插件编程规范的简单分析) 原文地址:通达信插件选股(基于通达信插件编程规范的简单分析)作者:哈尔滨猫猫 首先声明,鄙人是编程人员,不是股民.对选股概念了解甚少.本文仅作编程人员学习借鉴之用.不对选股理论进行探讨和解释. 以前有客户找我做过通达信插件选股的小任务,当时第一次接触面向接口(此类“接口”)编程,也是第一次接触到股票里相关的概念.最近由于接手一个任务,与上次开发相类似,故旧事重提,仔细研究一番.将个人学习研究所得知识与大家分享.在网上搜相关资料,可用的.

winform插件机制学习

这两天在看自定义控件,原来有太多知识没有掌握.今天看到插件机制,心里突然一亮,这个东西听了不少次,就是不知道是啥回事.这次有幸书里包含一个案例,我就跟着它一步步来.终于知道是什么回事了.这个应该在软件开发中非常多见.只是当时不理解罢了. 开始 新建一个winform项目CustomControls在窗体上放一个button按钮 窗体代码 using System;using System.Collections.Generic;using System.ComponentModel;using

Atitit&#160;插件机制原理与设计微内核&#160;c#&#160;java&#160;的实现attilax总结

Atitit 插件机制原理与设计微内核 c# java 的实现attilax总结 1. 微内核与插件的优点1 2. 插件的注册与使用2 2.1. Ioc容器中注册插件2 2.2. 启动器微内核启动3 3. 插件的俩种执行策略3 3.1. 必须手动接续,否则自动终止(推荐)3 3.2. 必须手动throw  stop ex终止,负责自动接续..4 4. 插件链的生成原理4 5. -------code4 6. 参考7 1. 微内核与插件的优点 但凡有生命力的产品,都是在扩展性方面设计的比较好的,因

基于AppDomain的&quot;插件式&quot;开发

很多时候,我们都想使用(开发)USB式(热插拔)的应用,例如,开发一个WinForm应用,并且这个WinForm应用能允许开发人员定制扩展插件,又例如,我们可能维护着一个WinService管理系统,这个WinService系统管理的形形色色各种各样的服务,这些服务也是各个"插件式"的类库,例如: public interface IJob { void Run(DateTime time); } public class CollectUserInfo : IJob { public

微信开发学习日记(八):7步看懂weiphp插件机制,核心目标是响应微信请求

又经过了几个小时的梳理.回顾,截至目前,终于对weiphp这个框架的机制搞明白了些.想要完全明白,自然还需要大把的时间.第1步:   配置微信公众号,http://weiphp.jiutianniao.com/ ... .html  从上面这个配置可以看出,微信请求呗weiphp的入口文件index.php接收了,可能会被/home/weixin/index/这个action响应.第2步:   index.php入口文件,校验了是否是微信请求.   /** * 微信接入验证 * 在入口进行验证而

从npm tips到express插件机制设计

大部分时间,我们只用到npm的install,init,publish等功能,但它设计的非常好,有很多是我们不了解的 一起看一下 全局命令 用nodejs来写cli工具是非常爽的,我干了不少这样的事儿 kp =kill by port je = json editor mh = start mongo here 核心就是在package.json里配置 "preferGlobal": "true", "bin": { "mh"