Agile.Net 组件式开发平台 - 驱动开发示例

时间:2022-07-13 10:17:08

首先讲一下概念,此驱动非彼驱动。在Agle.Net中我们将组件规划成两种类型,一种是基于业务的窗体组件,一种是提供扩展功能的驱动组件。

打个比方例如一般系统中需要提供身份证读卡功能,然而市面上有很多种身份证读卡器,我们无法约束客户都是用同一种读卡器,为了扩展性我们将身份证读卡功能封装为驱动组件。

那么是用不同的身份证读卡器设备,我们提供相应的封装实现就可以了。下面我来演示一个简单的驱动型组件开发例程。

Agile.Net开发管理平台项目,已经托管在开源中国码云平台(http://git.oschina.net

登陆码云平台进入项目主页(http://git.oschina.net/MuAgile/AgileDevelop)即可浏览下载源代码。

1.开发环境搭建

   软件安装请参考文章《Agile.Net 组件式开发平台 - 开发环境部署》

下载项目【AgileDevelop】->【附件】中的数据库备份文件,恢复数据库到SqlServer,建议数据库命名"Agile"。

2.获取项目源代码

1. 启动 Microsoft Visual Studio,进入菜单项【工具】->【选项】->【源代码管理】-> 设置选项【当前源代码管理插件】下拉框中选择【Microsoft Git 提供程序】。

2. VS切换到团队资源管理器界面,进入菜单项【项目】->【连接到团队项目】。

3. 在本地Git存储库栏目中,输入Git项目地址,克隆"AgileDevelop"项目。

4. 关于Git的源代码管理系统的使用方法,请参考相关文档学习。

3.创建第一个驱动

1. 新建一个类库命名为"Driver.IDCard",框架版本为Net4.0,引用 Agile.Cord.dll , Agile.Entity.dll 等平台SDK库文件。

2. 新增一个驱动类,继承【Agile.Core.Addin.PluginDriverBase】驱动基类并重写"OnOpen"、"OnClose" 方法。

3. 添加【PluginAttribute】标签,添加组件描述。

namespace Driver.IDCard
{
[PluginAttribute("69715891-FBA5-428A-94B1-5C6D5C28926F", "身份证阅读驱动", "华视二代身份证读卡器阅读驱动")]
public class Driver : Agile.Core.Addin.PluginDriverBase
{
private bool _IsOpen; /// <summary>
/// 调用驱动组件并执行方法
/// </summary>
/// <param name="args">参数</param>
/// <returns></returns>
protected override object OnOpen(object args)
{
            try
            {
this.Init();
                frmCard frm = new frmCard();
                if (frm.ShowDialog() == DialogResult.OK)
                    return frm.IDCard.ToClone();
else
                    return null;
            }
            catch (Exception ex)
            {
                throw ex;
            }
            finally
            {
                this.OnClose();
            }
} /// <summary>
/// 关闭(卸载)驱动组件
/// </summary>
/// <returns></returns>
protected override void OnClose()
{
try
{
SDK.CVR_CloseComm();
}
catch { }
} /// <summary>
/// 初始化设备连接
/// </summary>
/// <returns></returns>
private void Init()
{
            if (_IsOpen == false)
            {
                int ret = -1;
                for (int port = 1001; port <= 1016; port++)
                {
                    ret = SDK.CVR_InitComm(port);
if (ret == 1) break;
                }
                if (ret != 1)
                {
                    for (int port = 1; port <= 4; port++)
                    {
                        ret = SDK.CVR_InitComm(port);
                        if (ret == 1) break;
                    }
                }                 if (ret == 1)
                {
                    _IsOpen = true;
                    return;
                }
                else if (ret == 0)
                    throw new Exception("读卡器连接失败!动态库加载异常。");
                else if (ret == 2)
                    throw new Exception("读卡器连接失败!端口开启异常。");
                else
                    throw new Exception("读卡器连接失败!发生未知异常。");
            }
}
}
}

4.至此一个简单的平台驱动组件已经开发完成了,下面咱们来调用试试看。

private void btn_NoneCard_ItemClick(object sender, DevExpress.XtraBars.ItemClickEventArgs e)
{
//通过以下四种方式调用驱动组件
//方式一
//var driver = Controller.GetIPlugin(Guid.Parse("69715891-FBA5-428A-94B1-5C6D5C28926F")) as IPluginDriver;
//方式二
//var driver = Controller.GetIPlugin("Driver.NoneCard.dll", "Driver.NoneCard.Driver", "Drivers") as IPluginDri
//方式三
//var driver = Agile.Library.Controller.GetIPlugin("Driver.NoneCard.Driver.Driver") as IPluginDriver;
//方式四
var driver = Agile.Library.Controller.GetIPlugin<Driver.IDCard.Driver>() as IPluginDriver;
IDCard entity = driver.Open();
}

Agile.Net 组件式开发平台 - 驱动开发示例

OK 运行成功,那么咱们第一个驱动组件【身份证阅读驱动】已经开发好了,Agile.Net开发管理平台中包含本案例完整源代码。