Winform开发框架之插件化应用框架实现

时间:2021-09-16 15:14:15

支持插件化应用的开发框架能给程序带来无穷的生命力,也是目前很多系统、程序追求的重要方向之一,插件化的模块,在遵循一定的接口标准的基础上,可以实现快速集成,也就是所谓的热插拔操作,可以无限对已经开发好系统进行扩展,而且不会影响已有的功能,不在需要的模块,通过修改配置移除即可。我的Winform开发框架一直以来,来源于多年的项目积累以及客户的反馈,已经具备了众多很好的特性以及相关的模块组合,为了更好拥抱变化,提高基于Winform开发框架基础上开发新系统的效率,以及为框架融入更多好的特性,故此把我的Winform开发框架在原来的基础上进行扩展,实现基于插件化应用的框架特性。

为了引入插件化的应用框架特点,我在上一篇随笔《Winform开发框架之权限管理系统的改进》已经对我的通用权限管理系统进行了改进,其中增加了菜单管理模块就是为了做插件化做准备的,我们通过权限管理系统配置好菜单的相关信息,然后在应用框架中动态加载菜单功能即可实现。这个菜单模块,是用来配置基于Web开发框架或者Winform开发框架、WCF开发框架的菜单,通过预先的配置,框架程序的动态加载解析,就能实现插件模块的热插拔功能了。实际插件化框架的菜单配置界面效果如下所示。

Winform开发框架之插件化应用框架实现

最终在Winform开发框架的程序中,实现基于插件化的应用,如下所示。

Winform开发框架之插件化应用框架实现

先来看看我改造Winform开发框架,最终形成的框架界面效果,然后在逐一进行介绍,整个开发框架的实现过程。

Winform开发框架之插件化应用框架实现

1、框架的项目工程规划

为了减少框架整体的复杂性以及提高重用,对插件化的应用框架的项目工程进行了划分,包括“框架基础界面模块”、“插件应用框架启动模块”、仓库管理系统模块业务逻辑、仓库管理系统模块窗体界面等几个部分。前面两个部分是插件化框架的核心,可以认为是不需要变化的模块,提供所有插件应用动态创建以及使用的框架支撑;后面两个是具体的主业务模块,这里以WInform开发框架中的仓库管理系统作为主业务模块,它本身也是插件应用之一,具体的项目工程结构以及说明如下所示。

Winform开发框架之插件化应用框架实现

项目名称 项目说明
WHC.Framework.BaseUIDx  框架基础界面模块,定义窗体界面基类、通用Excel导入模块、通用高级查询模块等
WHC.Framework.StarterDx  插件应用框架启动模块,集成权限登录、动态菜单创建、插件应用动态加载、基础框架功能等
WHC.WareHouseMis  仓库管理系统模块的业务逻辑
WHC.Framework.WareHouseDx   仓库管理系统模块的窗体界面

从上面的表格说明中,我们可以看到“WHC.Framework.StarterDx”项目工程,是“插件应用框架启动模块”,它基本上只和权限管理系统模块有关联关系,因为权限系统是框架底层支撑的模块,包括用户登录、菜单管理、权限控制等都需要从权限管理系统中获取数据,具体的主要业务功能如下所示。

Winform开发框架之插件化应用框架实现

2、框架的菜单动态加载

本文第一张图片里面,介绍了菜单的定义信息,其中包括了图标的配置,这些图片为了方便管理,以及插件需要动态添加菜单图标,我把它放置在了程序目录的相对路径下面,如下所示,动态创建菜单的时候,从指定的路径去获取图标并加载即可。

Winform开发框架之插件化应用框架实现

动态加载菜单是指在插件化应用框架启动,用户登录后进入主界面后,在主界面中动态创建相应的菜单(菜单在权限管理系统中进行配置管理),如下代码所示。

Winform开发框架之插件化应用框架实现

其中是RibbonPageHelper为了方便动态创建菜单而创建的辅助类,部分代码如下所示。

    /// <summary>
/// 动态创建RibbonPage和其下面的按钮项目辅助类
/// </summary>
public class RibbonPageHelper
{
private RibbonControl control;
public MainForm mainForm; public RibbonPageHelper(MainForm mainForm, ref RibbonControl control)
{
this.mainForm = mainForm;
this.control = control;
} public void AddPages()
{
//约定菜单共有3级,第一级为大的类别,第二级为小模块分组,第三级为具体的菜单
List<MenuNodeInfo> menuList = WHC.Security.BLL.BLLFactory<SysMenu>.Instance.GetTree(Portal.gc.SystemType);
if (menuList.Count == ) return; int i = ;
foreach(MenuNodeInfo firstInfo in menuList)
{
//如果没有菜单的权限,则跳过
if (!Portal.gc.HasFunction(firstInfo.FunctionId)) continue; //添加页面(一级菜单)
RibbonPage page = new DevExpress.XtraBars.Ribbon.RibbonPage();
page.Text = firstInfo.Name;
page.Name = firstInfo.ID;
this.control.Pages.Insert(i++, page); if(firstInfo.Children.Count == ) continue;
foreach(MenuNodeInfo secondInfo in firstInfo.Children)
{
//如果没有菜单的权限,则跳过
if (!Portal.gc.HasFunction(secondInfo.FunctionId)) continue; //添加RibbonPageGroup(二级菜单)
RibbonPageGroup group = new RibbonPageGroup();
group.Text = secondInfo.Name;
group.Name = secondInfo.ID;
page.Groups.Add(group); if(secondInfo.Children.Count == ) continue;
foreach (MenuNodeInfo thirdInfo in secondInfo.Children)
{
//如果没有菜单的权限,则跳过
if (!Portal.gc.HasFunction(thirdInfo.FunctionId)) continue; //添加功能按钮(三级菜单)
BarButtonItem button = new BarButtonItem();
button.PaintStyle = BarItemPaintStyle.CaptionGlyph;
button.LargeGlyph = LoadIcon(thirdInfo.Icon);
button.Glyph = LoadIcon(thirdInfo.Icon); button.Name = thirdInfo.ID;
button.Caption = thirdInfo.Name;
..................
group.ItemLinks.Add(button);
}
}
}
}
...............

菜单为了方便管理,约定分为3级菜单,三个层级的菜单示意图如下所示。

Winform开发框架之插件化应用框架实现

启动顶部的选项卡级别为第一级,下面的Ribbon分组为第二级,具体的功能菜单(或者按钮)为第三级,以上就是通过菜单数据动态创建的菜单界面图。

3、框架的用户信息和权限控制

基础框架需要传统的登录进行验证,登录成功后,把用户关联的具有的权限下载到本地,然后由系统逻辑统一判断即可。

插件应用框架系统的登录代码和普通的差别不大,登录后把相关信息存储在框架变量中,如下所示。

Winform开发框架之插件化应用框架实现

        private void btLogin_Click(object sender, EventArgs e)
{
................. try
{
string ip = NetworkUtil.GetLocalIP();
string macAddr = HardwareInfoHelper.GetMacAddress();
string loginName = this.cmbzhanhao.Text.Trim();
string identity = WHC.Security.BLL.BLLFactory<WHC.Security.BLL.User>.Instance.VerifyUser(loginName, this.tbPass.Text, Portal.gc.SystemType, ip, macAddr);
if (!string.IsNullOrEmpty(identity))
{
UserInfo info = WHC.Security.BLL.BLLFactory<WHC.Security.BLL.User>.Instance.GetUserByName(loginName);
if (info != null)
{
#region 获取用户的功能列表 List<FunctionInfo> list = WHC.Security.BLL.BLLFactory<WHC.Security.BLL.Function>.Instance.GetFunctionsByUser(info.ID, Portal.gc.SystemType);
if (list != null && list.Count > )
{
foreach (FunctionInfo functionInfo in list)
{
if (!Portal.gc.FunctionDict.ContainsKey(functionInfo.ControlID))
{
Portal.gc.FunctionDict.Add(functionInfo.ControlID, functionInfo.ControlID);
}
}
} #endregion bLogin = true;
Portal.gc.UserInfo = info;
Portal.gc.LoginUserInfo = ConvertToLoginUser(info); this.DialogResult = DialogResult.OK;
}
}
else
{
MessageDxUtil.ShowTips("用户帐号密码不正确");
this.tbPass.Text = ""; //设置密码为空
}
}
catch (Exception err)
{
MessageDxUtil.ShowError(err.Message);
}
}

为了使框架记录的权限信息、用户数据、以及系统的一些配置信息能够传递到每个插件应用的窗体中,设计了一个插件应用界面需要实现的接口,放在了BaseUI项目工程中。

namespace WHC.Framework.BaseUI
{
/// <summary>
/// 父窗体实现的权限控制接口
/// </summary>
public interface IFunction
{
/// <summary>
/// 初始化权限控制信息
/// </summary>
void InitFunction(LoginUserInfo userInfo, Dictionary<string, string> functionDict); /// <summary>
/// 是否具有访问指定控制ID的权限
/// </summary>
/// <param name="controlId">功能控制ID</param>
/// <returns></returns>
bool HasFunction(string controlId); /// <summary>
/// 登陆用户基础信息
/// </summary>
LoginUserInfo LoginUserInfo { get; set; } /// <summary>
/// 登录用户具有的功能字典集合
/// </summary>
Dictionary<string, string> FunctionDict { get; set; } /// <summary>
/// 应用程序基础信息
/// </summary>
AppInfo AppInfo { get; set; } }
}

然后在BaseUI的项目中,界面基类BaseForm实现这个接口。

namespace WHC.Framework.BaseUI
{
public partial class BaseForm : DevExpress.XtraEditors.XtraForm, IFunction
{ public BaseForm()
{
InitializeComponent();
} ...................

最后,就是我们如何传递用户信息以及权限信息到窗体本身,传递到窗体作为其本身的变量后,就可以很方便使用这些关键的信息了。

在我们动态加载插件应用的后,我们会创建对应的Form对象,然后转换为IFunction接口,赋予该接口相关的变量属性即可实现用户信息及权限信息的传递,如下代码所示。

               Form tableForm = (Form)Activator.CreateInstance(formType);

                //如果窗体集成了IFunction接口(第一次创建需要设置)
IFunction function = tableForm as IFunction;
if (function != null)
{
//初始化权限控制信息
function.InitFunction(Portal.gc.LoginUserInfo, Portal.gc.FunctionDict); //记录程序的相关信息
function.AppInfo = new AppInfo(Portal.gc.AppUnit, Portal.gc.AppName, Portal.gc.AppWholeName, Portal.gc.SystemType);
}

4、插件应用的动态加载

上面我们说到,只要是实现基于Form的,我们都可以动态创建方式调用显示插件的界面出来,而如果界面实现了IFucntion的权限控制接口,那么我们就能够传递给它响应的数据,实现更加完善的控制功能。

在第一张关于权限系统的菜单管理图片中,我们看到了有个Winform的窗体类型的字段,里面就是用来动态构造插件的配置信息,我们主要是用来构造插件的窗体,并传递给它相关数据即可,下图是菜单管理里面的 “Winform窗体类型” 信息的具体内容。

Winform开发框架之插件化应用框架实现

但我们完成菜单的动态创建后,菜单按钮的响应事件就是触发动态加载插件的事件。

我们添加菜单的时候,对它的响应事件也做了处理,具体代码如下所示。

                        //添加功能按钮(三级菜单)
BarButtonItem button = new BarButtonItem();
.................
button.Caption = thirdInfo.Name;
button.Tag = thirdInfo.WinformType;
button.ItemClick += (sender, e) =>
{
if (button.Tag != null && !string.IsNullOrEmpty(button.Tag.ToString()))
{
LoadPlugInForm(button.Tag.ToString());
}
else
{
MessageDxUtil.ShowTips(button.Caption);
}
};
group.ItemLinks.Add(button);

单击事件的响应处理就是动态构建插件应用的事件,其中就是根据“Winform窗体类型”的数据进行解析的。

                string dllFullPath = Path.Combine(Application.StartupPath, filePath);
Assembly tempAssembly = System.Reflection.Assembly.LoadFrom(dllFullPath);
if (tempAssembly != null)
{
Type objType = tempAssembly.GetType(type);
if (objType != null)
{
LoadMdiForm(this.mainForm, objType, isShowDialog);
}
}

通过动态创建菜单模块,动态加载插件应用,以及权限控制等管理,我们就能隔离框架本身和插件应用模块之间的耦合性关联,所有后续开发或者别人开发的业务模块,都可以很方便的通过权限管理系统配置数据、自动更新模块更新程序应用的方式,把一个高效、易于扩展、动态管理的系统应用弄得丰富多彩,有声有色。

基于插件化应用框架的Winform开发框架改造,使得今后开发业务系统,只是基于一定的接口协议,开发插件应用即可,整体性的框架本身可以有专门的人员进行维护,提高团队对业务模块的横向切割和快速开发的效率,更好、统一、高效完成企业化应用框架的搭建和使用。

下面的图形是之前Winform开发框架的相关功能点集合,加上目前框架的“支持插件化框架应用,能快速开发插件、支持动态扩展”的特点,就显得更加丰富完善了。

Winform开发框架之插件化应用框架实现

相关文章