Timothy's Space 君看一叶舟，出没风波里

今天和同事一起把Plugins Manager放在了google code上面。大家可以从下面的地址获取所有的源码了。

http://code.google.com/p/dynamic-plugins-manager/

这里提供了插件的Demo程序，和编译好的Plugin Manager下载。
Plugin Manager的代码待整理后放上来。[cool]

开发运行环境：
Windows Vista Ultimate
.NET Framework 3.5
Microsoft Visual Studio 2008

点击下载此文件

下面来演示一下Plugins Manager，先看看我们事先做好的Interface和两个具体实现的插件.

Interface，接口定义：
[code]
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

namespace Component
{
public interface IComponent
{
string Invoke();
}
}
[/code]

整个接口，只声明了一个Invoke方法，这也是具体的插件必须实现的一个方法。

第一个插件类 class1.cs
[code]
namespace Component
{

public class Class1 : MarshalByRefObject,IComponent
{
string message = string.Empty;
int number;
float number2;

public Class1(string input, int num)
{
message = input;
number = num;
number2 = 0;
}

public Class1(int num1, float num2)
{
message = "none";
number = num1;
number2 = num2;
}

public string Invoke()
{
return "This is TestLibrary. member---message:" + message + "number:" + number.ToString() + "number2:" +number2.ToString();
}
}
}

[/code]

第二个插件类 class2.cs
[code]
namespace Component
{
public class Class2 : MarshalByRefObject,IComponent
{
public Class2()
{
}

public string Invoke()
{
return "This is TestLibrary2 without construct param";
}
}
}

[/code]

这里我们看到区别，第一个插件，需要构造函数，第二个插件不需要构造函数，所以在配置文件中，第二个插件可以关闭掉ConstructParam这个节点。

下面我们将Class1.cs编译好，放到插件目录中，改名为TestLibrary.dll，将Class2.cs直接改名为TestLibrary2.cs，放到插件目录中。
演示的目的：插件1需要在加载时，构造初始化函数，而插件2不需要。
插件1，是已经编译好的dll，不需要实时编译，但是插件2需要。

下面是测试的截图

1.插件目录，一个放入编译好的dll，一个放入.cs源码

2.启动测试程序，看到2个插件都已经被加载

3.此时，再查看插件的目录，我们会看到Plugin Manager为我们编译，并生成的插件2的dll

4.查看插件的日志记录

5.插件的调用
选中TestLibrary,点击Invoke按钮：

选中TestLibrary2,点击Invoke按钮：

6.插件的动态卸载和发布
a.动态卸载，可以直接使用Plugins Manager的UnloadPluginByName直接通过程序调用卸载。也可以手动打开插件的配置文件，将EnablePlugin设置为False
b.动态发布，直接在插件目录中，建立一个新的子目录，然后将插件的dll和xml配置文件直接拷入即可
关于第6点，这些功能的演示，截图比较麻烦，大家可以直接使用测试程序测试即可。

整个Plugins Manager是一个基于dll的程序集，开发平台，基于VS2008和.NET 3.5 Framework。为何要用.NET 3.5呢？没别的原因，只要是为了尝试一下Linq to XML [cool]

使用改组件，需要在应用程序中，添加引用。另外，还需要在应用程序中，建立相关的配置项：
[code]







[/code]

PluginsPath是插件的主目录，里面通过子目录的方式，存放不同的插件。Plugins Manager在启动的时候，会遍历插件主目录，并搜寻可加载的插件。
LogPath是插件的日志目录，里面的日志文件，会详细记载插件管理器当前的运行情况。

另外，在Plugins Manager中，区别不同的插件，是根据不同的插件名称来决定的，这取决于插件dll的命名。
对于不同的插件，Plugins Manager也提供不同的特性配置文件。配置文件是.xml文件，命名需要和插件dll相一致。
下面是一个配置文件的示例：
[code]

TypeName:插件的类名，和具体的插件命名空间和类名有关，Plugins Manager根据配置文件提供此相关信息，通过.NET的反射技术，生成具体的插件Instance
EnablePlugin:插件开关，True表示当前插件可用，False表示阻止Plugins Manager加载此插件。该开关可以在Plugins Manager运行前设定，也可以在Plugins Manager运行时动态更改。Plugins Manager会检测配置文件变化，并留意EnablePlugin开关，以决定是否动态加载或者卸载该插件。
ConstructParams:此节点，及其子节点，用以读取插件是否需要在运行时初始化构造函数。子节点用以描述构造函数中的参数，以及类型，和初始化的值。构造初始化函数，也是在.NET的反射中实现。这里要注意，节点顺序和构造函数参数顺序有关。如果插件不需要构造函数，可以关闭此节点。
ReferenceList:此节点用以需要动态编译的插件，如果插件代码中还引用了其他的程序集，需要在此进行描述。

此外，插件还提供了事件通知功能，供应用程序进行响应和处理，实现的事件类型有以下几种：

[code]
public enum PluginEventType
{
PluginLoadOver, //所有插件加载完毕
PluginAdded, //插件新增完毕
PluginRemoved, //插件卸载完毕
PluginStopped, //插件管理器已停止
PluginStarted //插件管理器已启动
}
[/code]

插件的事件参数定义如下，只包含简单的事件类型和文本描述：

[code]
public class PluginEventArgs : EventArgs
{
#region Private Members
public PluginEventType EventType { get; set; }
public string EventMessage { get; set; }
#endregion

public PluginEventArgs(PluginEventType eventtype, string message)
{
EventType = eventtype;
EventMessage = message;
}

}
[/code]

以上是使用该插件，需要配置的地方，下一篇日志，将演示该插件的Demo.

Dynamic Plugins Manager是一个基于.NET的动态插件管理组件，也是我在业余时间做的一个小东东，代码在07年底就开始动工，因为一直没充裕时间完成，趁这个周末休息，加班加点的Coding，出来了一个原型，估计里面还有很多的显而易见的以及隐而未现的bug。
设计这个组件的初衷，是为了能方便的应用于今后的项目中。先进的企业级项目中，变化最为突出的，还是业务，业务的变化，直接导致编码中业务逻辑代码的变化。如果将这些业务逻辑混杂在一起，业务的变化，最终会导致代码的混乱，甚至难以维护。这对于一个长期迭代的项目来说，是相当痛苦的事。就像直接拿一个成千上万行的代码给开发人员，估计开发人员不是晕厥，就是吐血。而一个难以维护的业务逻辑代码，对于每一次迭代，都是一次冒险。很可能在某次的迭代中，会对以前的业务逻辑，产生影响或者风险。
对于复杂的业务逻辑，需要进行重构，并且将不断变化的业务逻辑，抽离出来。比较折中的方法，就是将这些变化的逻辑，做成独立的插件形式。这样一来，独立的业务，在物理上进行了分离。开发人员也不用担心修改某处业务逻辑，会影响其他的业务模块。而动态的插件管理形式，对后期维护也带来益处，独立的业务逻辑插件之间，不会相互影响。开发人员还可以在程序运行而又不影响业务的情况下，动态的发布、替换原有的业务逻辑模块。
Dynamic Plugins Manager(以下简称Plugins Manager)，也就是按照这样的思路和需求来设计的，其实现的功能，具体有一下几个特点：
1.所有的插件，都以DLL程序集的方式发布,Plugins Manager在启动的时候，搜索加载所有可加载的插件并进行加载
2.Plugins Manager，支持插件的动态卸载功能。借助于AppDomain的特性，所有的组件，在动态加载后，可以动态从内存中卸载。插件的实现，需要继承自MarshalByRefObject。
3.与接口无依赖性，Plugins Manager负责插件的管理、动态加载、动态卸载、调用。但是和具体的插件接口无关，这样一来，开发人员可以定义自己的插件接口，并开发不同的插件实现接口。
4.插件可以动态发布和卸载,Plugins Manager会监视当前目录中，插件的变化，对于以xcopy方式，拷贝入插件目录的插件，可以进行动态加载。对于插件的卸载，可以Plugins Manager提供的接口进行动态卸载，也可以实时更改插件配置文件中的具体开关进行卸载。
5.动态编译功能：Plugins Manager允许直接发布插件代码。通过读取插件配置文件中的引用信息，可以直接从代码生成dll插件，并加载。
6.允许插件实现不同的构造函数重载，并将构造函数参数以及值信息，定义在插件配置文件中。Plugins Manager在加载插件的时候，采用配置文件中的值，调用相应的构造函数，并加载插件。
7.事件通知：Plugins Manager在不同的插件操作完成后，会触发相应的事件机制，通知客户端程序进行相应的处理

插件的结构一览：

PluginsManager:插件管理类，实现插件功能的主要代码逻辑，以及对插件容器的维护
AssemblyLoader:插件加载类，实现从AppDomain加载插件的逻辑
PluginEntity:插件实体类，包含插件的信息(插件实例、插件名称……)
AssemblyFactory:插件生成类，实现从插件代码生成dll的功能

下一篇日志中，将会介绍这个插件的具体配置，及简单分析其实现。

Dynamic Plugins Manager (一) 介绍

http://www.xiaozhou.net/article.asp?id=187

Dynamic Plugins Manager (二) 配置及实现分析

http://www.xiaozhou.net/article.asp?id=188

Dynamic Plugins Manager (三) Demo

http://www.xiaozhou.net/article.asp?id=189

Dynamic Plugins Manager (四) 插件及Demo源码下载

http://www.xiaozhou.net/article.asp?id=190

Dynamic Plugins Manager (五) Plugins Manager 源码下载

http://www.xiaozhou.net/article.asp?id=191

/*
* PhotoAlbum Control V1.0
* By Timothy Ye 2007.7.6
* You can modify it, and republish it.
* http://www.xiaozhou.net
*/

PhotoAlbum 功能列表：
1.无须数据库支持，直接处理服务器图片目录
2.为大图片生成缩略图，并存放到专门的目录，提高相册预览图片的效率
3.简化图片添加过程，直接上传图片到图片目录即可，相册自动获取、遍历新上传的图片，并生成缩略图
4.增加多页跳转功能
5.简单易用，直接插入控件到你的页面，并进行相关设置即可使用

PhotoAlbum 控件说明：
1.该控件在页面加载的时候，会搜索当前网站指定目录所有jpg格式的文件，在使用时需要指定原图片存放地址和生成的缩略图存放地址，需要添加到web.config文件中：

try
{
smallfoldername = Server.MapPath(ConfigurationManager.AppSettings["SmallPath"]);
bigfoldername = Server.MapPath(ConfigurationManager.AppSettings["NormalPath"]);
}
catch
{
smallfoldername = Server.MapPath("./Photo/SmallPics/");
bigfoldername = Server.MapPath("./Photo/NormalPics/");
}

如果获取用户配置路径失败，控件默认采用./Photo/SmallPics/ 和./Photo/NormalPics/ 两个目录
NormalPics为用户上传原图片的地址，SmallPics为控件生成并存放缩略图的地址。

2.控件在页面加载的时候，遍历原图地址，并逐个生成缩略图，存放到缩略图地址目录。第一次运行，会牺牲效率，当缩略图生成完毕后，运行速度大幅提高。

3.生成缩略图，采用ImageThumbnail类的MakeThumbnail方法实现，缩略图的大小和生成方式，可以自行设置。可以分别按高、宽生成，不过图片可能会产生变形，也可以用CUT裁剪方式。

4.相册处理图片文件，并把图片文件展现给前端浏览器。相册可视化部分，采用DataList控件实现。

相册控件效果图如下：
点击浏览

相册源码下载：
点击下载此文件

开发环境：
Windows XP SP2
.NET Framework2.0
Visual Studio 2005 SP1

无意中在电脑中的角落，发现05年替成都的路正驾校做的学员管理系统，被遗忘在这里很久了。是刚毕业不久接下来的第一个“私活”，呵呵。这个系统从头到尾都是用VC做的，也费了不少时间，用业余的时间来做，做了差不多一个月。要是现在，我一定会用C#来开发了，开发时间至少节约一半以上 ：）
第一次做的东西，还是比较值得留恋。其实界面和功能上都有待提高。不幸的是我的系统重装过了，以前的数据库表脚本也找不到了。只是恢复了登陆验证的数据。抓了几张图，留在这里做一个纪念。

许可生成器

登录界面

操作界面