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

时间:2022-10-08 10:21:56

所谓组件式开发平台,它所有的功能模块都是以组件的形式扩展的,下面我来演示一个简单的组件开发例程。

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.项目配置

   开发管理平台建议采用直连方式比较方便调试,首先设置System.Config配置文件,如下:

<Root>
<!--服务端配置-->
<REM>
<!--服务端配置-->
<Server>
<Config Address="127.0.0.1" Port="10000" Enabled="false" />
</Server>
<!--消息总线配置-->
<Message>
<Config Address="127.0.0.1" Port="10010" Enabled="false" />
</Message>
<!--升级地址配置-->
<Upgrade>
<Config Address="Ftp://127.0.0.1:10021" Enabled="false" />
</Upgrade>
</REM>
<!--数据源配置-->
<DBS>
<Config Caption="Default" Description="默认数据库" Provider="SqlServer" Connection="Data Source=localHost;Initial Catalog=Agile;Integrated Security=SSPI;" />
<Config Caption="Report" Description="报表数据库" Provider="SqlServer" Connection="Data Source=(LocalDB)\ProjectsV12;Initial Catalog=Agile;Integrated Security=SSPI;" />
</DBS>
</Root>

4.组件开发

1. 新建一个类库命名为"Plugin.Master",框架版本为Net4.0,引用 Agile.Core.dll,Agile.Library.dll, Agile.Controls.dll, Agile.Entity.dll 等平台SDK库文件。

2. 添一个窗体项并继承【Agile.Core.Addin.PluginFormBase】窗体组件基类。

namespace Plugin.Master
{
public partial class FormUser : Agile.Core.Addin.PluginFormBase
{
public FormUser()
{
InitializeComponent();
}

2.拖入DevExpress控件根据功能需求设计窗体。示例:

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

3.设置组件窗体属性

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

4. 重写组件加载事件(OnStartup),此方法为窗体组件入口。

注:” OnStartup” 事件为同步方法,参数<args>用于组件间相互调用时的传参。

 protected override void OnStartUp(Agile.Core.Addin.PluginArgs args)//组件入口方法
{
     ////绑定部门
     //var deptService = Agile.Library.Controller.GetService<IDept>();
     //tree_Dept.DataSource = deptService.GetAllDept();
     //tree_Dept.CollapseAll();
     //tree_Dept.ExpandToLevel(0);
           
     ////绑定用户
    //var userService = Agile.Library.Controller.GetService<IUser>();
     //grc_Employee.DataSource = userService.GetAllUser();
     //grv_Employee.BestFitColumns();
}

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

5.首先在开发管理平台[Agile.Develop]项目中引用"Plugin.Master"类库,

然后在NavBarControl中添加一个Item并在单击事件下调用组件窗体,示例:

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

private void item_DeptMgmt_LinkPressed(object sender, NavBarLinkEventArgs e)
{
//通过以下四种方式调用窗体组件
//方式一
//var plugin = Controller.GetIPlugin(Guid.Parse("cb3cb6cd-0d8b-4861-8b43-8d4cce2ef272")) as IPluginForm;
//方式二
//var plugin = Controller.GetIPlugin("Plugin.Master.dll", "Plugin.Master.FormDept", "Plugins") as IPluginForm;
//方式三
//var plugin = Agile.Library.Controller.GetIPlugin("Plugin.Master.FormDept") as IPluginForm;
//方式四
var plugin = Agile.Library.Controller.GetIPlugin<Plugin.Master.FormDept>() as IPluginForm;
//启动组件
plugin.Open();
}

5.运行开发平台测试调用组件。

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

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