给IBuySpy构建一个PlugIn系统

话说公元2003年12月17日，MSDN Library网站上悄无声息的多了一篇文章，介绍了关于构建一个PlugIn Framework的一些基础知识，于是，有了这篇随笔…

PlugIn，很COOL的特性，下面将演示如何给我们的IBuySpy定制一个Page Start PlugIn，这个PlugIn可以让用户自己来创建PlugIn，嵌入到IBuySpy的Page Start PlugIn里面，在网站页面载入的时候，会执行用户嵌入的PlugIn。

可我们为什么要给IBuySpy创建PlugIn接口呢？我们要实现同样的功能，可以直接的修改它的代码，岂不是直接很多？原因：IBuySpy只是用来演示PlugIn的，你可以把同样的技术应用到其他的WebForm甚至WinForm，而它们可能并不会像IBuySpy一样是免费的，我们交付的产品里面不会附上代码，如果我们提供了PlugIn的接口，无疑会让我们的产品更加具有扩展性。何况很多功能可能可以直接作成PlugIn来嵌入到原有的系统中，这个时候无需再改动原有的代码，再去编译它。

1、构建IBuySpy的PlugIn所需的接口，这些接口就是可以公开给用户代码的：

首先需要的是一个通用的IPlugIn接口，所有具体的插件将实现这个接口：

namespace ASPNetPortal.PlugIns {

 public interface IPlugIn {
  String Name {get;}
  String Version {get;}
  void DoAction(IPlugInArgs args);    
 }
}

这个接口有三个成员：
Name属性，公开插件的名称
Version属性，公开插件的版本
DoAction()方法，执行插件要做的操作，这个方法还有一个IPlugInArgs的参数，需要传递给方法所参数可以通过它传递出去。

然后就是这个IPlugInArgs接口：

namespace ASPNetPortal.PlugIns {

 public interface IPlugInArgs { 
  System.Web.HttpContext Context {get;}
  Object Data {get;}
 }
}

它有两个成员：
Context属性，一个HttpContext类型的对象，如果我们要让插件能够在页面上做些事，不给它HttpContext肯定不行。
Data属性，一个Object类型的对象，预留的，什么地方需要就什么地方用上。

接着是一个接口集合类：

namespace ASPNetPortal.PlugIns {

 public class PlugInCollection : CollectionBase {

  public Int32 Add(IPlugIn plugIn) {
   return this.List.Add(plugIn);
  }

  public IPlugIn this[Int32 index] {
   get {
    return (IPlugIn) this.List[index];
   }
  }
 }
}

很简单明了。用户可能不止嵌入一个插件。

PlugIn也可以有很多类型，比如我们这里要实现的Page Start PlugIn，是一个在页面载入的时候可以让嵌入的PlugIn执行的。当然你也可以创建各种类型的PlugIn。

namespace ASPNetPortal.PlugIns {

 public interface IPageStartPlugIn : IPlugIn {}
}

这个PlugIn接口不需要再做任何事，直接继承IPlugIn就可以了。

2、修改IBuySpy，让它支持执行PlugIn：

根据我们的需求，我们创建一个实际的插件参数类，这个类继承自IPlugInArgs：

namespace ASPNetPortal.PlugIns {

 public class PlugInArgs : IPlugInArgs {
  private System.Web.HttpContext _context;
  private Object _data;

  public PlugInArgs(System.Web.HttpContext context, Object data) {
   _context = context;
   _data = data;
  }

  public System.Web.HttpContext Context {
   get {
    return _context;
   }
  }

  public Object Data {
   get {
    return _data;
   }
  }
 }
}

我们需要地方来标示用户嵌入的PlugIn的列表，我们放在web.config里面的里面，我们加上一项，来表示我们要添上的Page Start PlugIn：

《ADD key="PageStartPlugIns" value="" /》

value里面可以写入嵌入的PlugIn的列表，格式像这样：Value = "插件一的类名, 插件一的程序集名; 插件二的类名, 插件二的程序集名"

然后，我们构建一个PlugInHelper类，来执行获取PlugIn、执行PlugIn的操作：

namespace ASPNetPortal.PlugIns {

 public class PlugInHelper {

 private PlugInHelper() {}

 public static PlugInCollection GetPlugIns(String plugInType) {
  PlugInCollection plugIns = new PlugInCollection();
  String sPageStartPlugIns = System.Configuration.ConfigurationSettings.AppSettings[plugInType];
  if ((sPageStartPlugIns != null) && (sPageStartPlugIns != "")) {
   String[] asPlugInStr = sPageStartPlugIns.Split(';');    foreach(String plugInStr in asPlugInStr) {
    plugIns.Add( (IPageStartPlugIn) System.Activator.CreateInstance(System.Type.GetType(plugInStr)));
   }
  }
  return plugIns;
 }

 public static void ExecutePlugIns(PlugInCollection plugIns, IPlugInArgs args) {
  foreach(IPlugIn plugIn in plugIns) {
   plugIn.DoAction(args);
  }
 }
 }
}

GetPlugIns()方法返回指定类型的PlugIn的列表，返回类型是PlugInCollection，ExecutePlugIns()用来执行参数中的PlugIn。

最后，我们要把执行插件的代码加入到页面的执行队列中。为了在每个页面开始的时候能够执行用户嵌入的Page Start Plug，标准方法是在Global.asa里面来实现，更标准的方法是构建一个httpModule，然后在这个httpModule中来执行这个PlugIn（关于构建自定义的httpModule，辣椒是个中高手）。我这里就偷懒了，因为IBuySpy几乎所有的内容页面都是DesktopDefault.aspx这个页面中载入，所以我们先在这个页面里面创建一个方法来执行插件：

private void PerformPlugIns() {
 PlugInCollection plugIns = PlugInHelper.GetPlugIns("PageStartPlugIns");
 PlugInArgs args = new PlugInArgs(Context, null);
 PlugInHelper.ExecutePlugIns(plugIns, args);
}

第一句得到所有的Page Start PlugIn，第二句创建一个传递给插件的PlugInArgs对象，第三句调用PlugInHelper.ExecutePlugIns()来执行第一句得到的PlugIn队列。

在DesktopDefault.aspx的Page_Init事件中调用上面的这个PerformPlugIns()方法就OK了。

3、演示如何创建一个Page Start PlugIn：

前面两步已经让IBuySpy可以嵌入用户自定义的Page Start PlugIn了，现在我们来做一个实际的PlugIn嵌进去。

启动VS，创建一个“C#类库”项目，引入IBuySpy的程序集Portal.dll，这是因为我们需要用到IBuySpy里面的PlugIn相关的那些接口，更好的方法是把IBuySpy中与PlugIn相关的公共接口放在一个单独的程序集里面。

namespace WelcomeMessage {

 public class ShowWelcome : ASPNetPortal.PlugIns.IPageStartPlugIn {

  public string Name {
   get {
    return "Show Page Welcome Message";
   }
  }

  public string Version {
   get {
    return "1.0.0.1";
   }
  }

  public void DoAction(IPlugInArgs args) {
   args.Context.Response.Write(“<_script_>alert(‘Hello, world!’);”);  // 故意写错了 ，不然...
}
}
}

这个ShowWelcome类继承自IPageStartPlugIn，表示它是一个Page Start PlugIn，用来具体执行操作的DoAction()方法只做了一件事，从参数中得到页面相关的HttpContext对象，然后输出一段字符以在页面内容载入之前弹出一个“Hello,world!”的提示框。

然后我们修改IBuySpy的web.config里面相关的那句设定：

《ADD value="WelcomeMessage.ShowWelcome, WelcomeMessage" key="PageStartPlugIns" /》

OK了，编译，把生成的dll放到IBuySpy的bin目录，打开浏览器浏览IBuySpy网站，你会看到每次载入页面内容时，都会弹出一个“Hello,world!”的提示框。