在前面幾篇隨筆介紹了我對ABP框架的改造,包括對ABP總體的介紹,以及對各個業務分層的簡化,Web API 客戶端封裝層的設計,使得我們基于ABP框架的整體方案越來越清晰化, 也越來越接近實際的項目開發需求,一旦整個模式比較成熟,并以一種比較固化的模式來指導開發,那么就可以很方便的應用在實際項目開發當中了。本篇隨筆是基于前面幾篇的基礎上,在Winform項目上進一步改造為實際項目的場景,把我原來基于微軟企業庫底層的數據庫訪問方式的Winform框架或者混合框架的字典模塊界面改造為基于ABP框架基礎上的字典應用模塊。
1)APICaller層接口的回顧
在上一篇隨筆《ABP開發框架前后端開發系列---(4)Web API調用類的封裝和使用》中,我介紹了Web API調用類的封裝和使用,并介紹了在.net 控制臺程序中,測試對ApiCaller層的調用,并能夠順利返回我們所需要的數據。測試代碼如下所示。
#region DictType
using (var client = bootstrapper.IocManager.ResolveAsDisposable<DictTypeApiCaller>())
{
var caller = client.Object;
Console.WriteLine("Logging in with TOKEN based auth...");
var token = caller.Authenticate("admin", "123qwe").Result;
Console.WriteLine(token.ToJson());
caller.RequestHeaders.Add(new NameValue("Authorization", "Bearer " + token.AccessToken));
Console.WriteLine("Get All ...");
var pagerDto = new DictTypePagedDto() { SkipCount = 0, MaxResultCount = 10 };
var result = caller.GetAll(pagerDto).Result;
Console.WriteLine(result.ToJson());
Console.WriteLine("Get All by condition ...");
var pagerdictDto = new DictTypePagedDto() { Name = "民族" };
result = caller.GetAll(pagerdictDto).Result;
Console.WriteLine(result.ToJson());
Console.WriteLine("Get count by condition ...");
pagerdictDto = new DictTypePagedDto() {};
var count = caller.Count(pagerdictDto).Result;
Console.WriteLine(count);
Console.WriteLine();
Console.WriteLine("Create DictType...");
var createDto = new CreateDictTypeDto { Id = Guid.NewGuid().ToString(), Name = "Test", Code = "Test" };
var dictDto = caller.Create(createDto).Result;
Console.WriteLine(dictDto.ToJson());
Console.WriteLine("Update DictType...");
dictDto.Code = "testcode";
var updateDto = caller.Update(dictDto).Result;
Console.WriteLine(updateDto.ToJson());
if (updateDto != null)
{
Console.WriteLine("Delete DictType...");
caller.Delete(new EntityDto<string>() { Id = dictDto.Id });
}
}
#endregion
這些ApiCaller對象的接口測試代碼,包括了授權登錄,獲取所有記錄,獲取條件查詢記錄,創建、更新、刪除這些接口都成功執行,驗證了我們對整體架構的設計改良,并通過對ApiCaller層基類的設計,減少我們對常規增刪改查接口的編碼,我們只需要編寫我們的自定義業務接口代碼封裝類即可。
其中基類的代碼如下所示。
針對Web API接口的封裝,為了適應客戶端快速調用的目的,這個封裝作為一個獨立的封裝層,以方便各個模塊之間進行共同調用。
也就是說,上面我們全部是基于基類接口的調用,還不需要為我們自定義接口編寫任何一行代碼,已經具備了常規的各種查詢和數據處理功能了。
我們完整的字典類型ApiCaller類的代碼如下所示。
namespace MyProject.Caller
{
/// <summary>
/// 字典類型對象的Web API調用處理
/// </summary>
public class DictTypeApiCaller : AsyncCrudApiCaller<DictTypeDto, string, DictTypePagedDto, CreateDictTypeDto, DictTypeDto>, IDictTypeAppService
{
/// <summary>
/// 提供單件對象使用
/// </summary>
public static DictTypeApiCaller Instance
{
get
{
return Singleton<DictTypeApiCaller>.Instance;
}
}
/// <summary>
/// 默認構造函數
/// </summary>
public DictTypeApiCaller()
{
this.DomainName = "DictType";//指定域對象名稱,用于組裝接口地址
}
public async Task<Dictionary<string, string>> GetAllType(string dictTypeId)
{
AddRequestHeaders();//加入認證的token頭信息
string url = GetActionUrl(MethodBase.GetCurrentMethod());//獲取訪問API的地址(未包含參數)
url += string.Format("?dictTypeId={0}", dictTypeId);
var result = await apiClient.GetAsync<Dictionary<string, string>>(url);
return result;
}
public async Task<IList<DictTypeNodeDto>> GetTree(string pid)
{
AddRequestHeaders();//加入認證的token頭信息
string url = GetActionUrl(MethodBase.GetCurrentMethod());//獲取訪問API的地址(未包含參數)
url += string.Format("?pid={0}", pid);
var result = await apiClient.GetAsync<IList<DictTypeNodeDto>>(url);
return result;
}
}
這里面的函數定義才是我們需要根據實際的自定義接口封裝的調用類函數代碼。
前面我們介紹了,我們把ApiCaller層的項目設計為.net Standard的類庫項目,因此可以在.net core或者在.net framework中進行使用,并且也在基于.net core的控制臺程序中測試成功了。
下面就重點介紹一下,基于.net framework的Winfrom程序中對ABP框架的Web API接口的調用,如果以后Winform支持.net core了(據說9月份出的.net core3就包含了),那么也一樣的模式進行調用。
2)Winform對ApiCaller層的調用
我們先來看看字典模塊,通過封裝對ABP框架的Web API調用后,實際的功能界面效果吧。
先設計一個授權登錄的界面獲取訪問令牌信息。
字典管理界面,列出字典類型,并對字典類型下的字典數據進行分頁展示,分頁展示利用分頁控件展示。
新增或者編輯窗體界面如下
這個界面是來自于我的框架里面的字典模塊界面,不過里面對數據的處理代碼確實已經更改為適應ABP框架的Web API接口的調用的了(基于ApiCaller 層的調用)。
我們下面來一一進行分析即可。
登陸界面,我們看看主要的邏輯就是調用獲取授權令牌的接口,并存儲起來供后續界面中的業務類進行調用即可。
由于我們自己封裝的ApiCaller類,都是基于異步的方式封裝的,因此我們可以看到很多地方調用都使用await的關鍵字,這個是異步調用的關鍵字,如果方法需要定義為異步,就需要增加async關鍵字,一般這兩個關鍵字是配套使用的。
如果我們在事件處理代碼里面使用了異步,那么事件的函數也需要標記為async,如下是字典管理模塊窗體的加載函數,也是用了async聲明 和await調用異步方法標記。
private async void FrmDictionary_Load(object sender, EventArgs e)
{
await InitTreeView();
this.lblDictType.Text = "";
await BindData();
//分頁控件事件處理代碼
this.winGridViewPager1.OnPageChanged += new EventHandler(winGridViewPager1_OnPageChanged);
this.winGridViewPager1.OnStartExport += new EventHandler(winGridViewPager1_OnStartExport);
this.winGridViewPager1.OnEditSelected += new EventHandler(winGridViewPager1_OnEditSelected);
this.winGridViewPager1.OnAddNew += new EventHandler(winGridViewPager1_OnAddNew);
this.winGridViewPager1.OnDeleteSelected += new EventHandler(winGridViewPager1_OnDeleteSelected);
this.winGridViewPager1.OnRefresh += new EventHandler(winGridViewPager1_OnRefresh);
this.winGridViewPager1.AppendedMenu = this.contextMenuStrip2;
this.winGridViewPager1.BestFitColumnWith = false;
this.winGridViewPager1.gridView1.DataSourceChanged += new EventHandler(gridView1_DataSourceChanged);
}
我們的數據,主要是在BindData里面實現,這個函數是我們自己加的,由于使用了異步方法,因此也用async進行聲明。
整個對于分頁的數據獲取和控件的數據綁定過程,代碼如下所示。
/// <summary>
/// 獲取數據
/// </summary>
/// <returns></returns>
private async Task<IPagedResult<DictDataDto>> GetData()
{
//構建分頁的條件和查詢條件
var pagerDto = new DictDataPagedDto(this.winGridViewPager1.PagerInfo)
{
DictType_ID = string.Concat(this.lblDictType.Tag)
};
var result = await DictDataApiCaller.Instance.GetAll(pagerDto);
return result;
}
/// <summary>
/// 綁定數據
/// </summary>
private async Task BindData()
{
#region 添加別名解析
this.winGridViewPager1.DisplayColumns = "Name,Value,Seq,Remark,EditTime";
this.winGridViewPager1.AddColumnAlias(Id_FieldName, "編號");
this.winGridViewPager1.AddColumnAlias("DictType_ID", "字典大類");
this.winGridViewPager1.AddColumnAlias("Name", "項目名稱");
this.winGridViewPager1.AddColumnAlias("Value", "項目值");
this.winGridViewPager1.AddColumnAlias("Seq", "字典排序");
this.winGridViewPager1.AddColumnAlias("Remark", "備注");
this.winGridViewPager1.AddColumnAlias("Editor", "修改用戶");
this.winGridViewPager1.AddColumnAlias("EditTime", "更新日期");
#endregion
if (this.lblDictType.Tag != null)
{
var result = await GetData();
//設置所有記錄數和列表數據源
this.winGridViewPager1.DataSource = result.Items;
this.winGridViewPager1.PagerInfo.RecordCount = result.TotalCount;
}
}
其中注意的是GetAll方式是傳入一個條件查詢的對象,這個就是DictDataPagedDto是我們定義的,放入我們DictDataDto里面的常見屬性,方便我們根據屬性匹配精確或者模糊查詢。
/// <summary>
/// 用于根據條件查詢
/// </summary>
public class DictDataPagedDto : PagedResultRequestDto
{
/// <summary>
/// 字典類型ID
/// </summary>
public virtual string DictType_ID { get; set; }
/// <summary>
/// 類型名稱
/// </summary>
public virtual string Name { get; set; }
/// <summary>
/// 指定值
/// </summary>
public virtual string Value { get; set; }
/// <summary>
/// 備注
/// </summary>
public virtual string Remark { get; set; }
}
我們在調用的時候,讓它限定為一個類型的ID進行精確查詢,如下代碼
//構建分頁的條件和查詢條件
var pagerDto = new DictDataPagedDto(this.winGridViewPager1.PagerInfo)
{
DictType_ID = string.Concat(this.lblDictType.Tag)
};
這個精確或者模糊查詢,則是在應用服務層里面定義規則的,這個之前沒有詳細介紹了,這里稍微補充說明一下。
在應用服務層接口類里面,重寫CreateFilteredQuery可以設置GetAll的查詢規則,重寫ApplySorting則可以指定列表的排序順序。
再次回到Winform界面的調用上來,刪除類型下面字典數據的事件的處理函數如下所示。
private async void menu_ClearData_Click(object sender, EventArgs e)
{
TreeNode selectedNode = this.treeView1.SelectedNode;
if (selectedNode != null && selectedNode.Tag != null)
{
string typeId = selectedNode.Tag.ToString();
var dict = await DictDataApiCaller.Instance.GetDictByTypeID(typeId);
int count = dict.Count;
var format = "您確定要刪除節點:{0},該節點下面有【{1}】項數據";
format = JsonLanguage.Default.GetString(format);
string message = string.Format(format, selectedNode.Text, count);
if (MessageDxUtil.ShowYesNoAndWarning(message) == DialogResult.Yes)
{
try
{
await DictDataApiCaller.Instance.DeleteByTypeID(typeId);
await InitTreeView();
await BindData();
}
catch (Exception ex)
{
LogTextHelper.Error(ex);
MessageDxUtil.ShowError(ex.Message);
}
}
}
}
我們看看編輯窗體界面的后臺處理,編輯和更新數據的邏輯代碼如下所示。
#region 編輯大類
var info = await DictTypeApiCaller.Instance.Get(new EntityDto<string>(ID));
if (info != null)
{
SetInfo(info);
try
{
var updatedDto = await DictTypeApiCaller.Instance.Update(info);
if (updatedDto != null)
{
MessageDxUtil.ShowTips("保存成功");
this.DialogResult = DialogResult.OK;
}
}
catch (Exception ex)
{
LogTextHelper.Error(ex);
MessageDxUtil.ShowError(ex.Message);
}
}
#endregion
最后來一段gif動圖,展示程序的操作功能吧。
好了,這些事件的使用規則一旦確定了,我們好利用代碼生成工具對窗體界面的代碼進行統一規則的生成,就好像我前面對于我Winform框架和混合框架里面的Winform窗體界面的生成一樣,我們只需要稍微修改一下代碼生成工具的NVelocity模板,利用上數據庫表的元數據就可以快速生成整個框架所需要的代碼了。
這樣基于整個ABP框架,而快速應用起來的項目,其實開發項目的工作量看起來也不會很多,而且我們可以把字典、權限控制、整體框架等基礎設施建設好,就會形成一整套的開發方法和思路了,這樣對于我們利用ABP框架來開發業務系統,是不是有事半功倍的感覺。
一旦某個東西你很喜歡,你就會用的越來越好。