ABP開發框架先後端開發系列---（8）ABP框架之Winform界面的開發過程

時間 2019-11-05

標籤 abp 開發框架後端系列 winform 界面開發過程简体版

原文原文鏈接

在前面隨筆介紹的《ABP開發框架先後端開發系列---（7）系統審計日誌和登陸日誌的管理》裏面，介紹瞭如何改進和完善審計日誌和登陸日誌的應用服務端和Winform客戶端，因爲篇幅限制，沒有進一步詳細介紹Winform界面的開發過程，本篇隨筆介紹這部份內容，並進一步擴展Winform界面的各類狀況處理，力求讓它進入一個新的開發里程碑。html

一、回顧審計日誌和登錄日誌管理界面

前面介紹瞭如何擴展審計日誌應用服務層（Application Service層）和ApiCaller層（API客戶端調用封裝層），同時也展現審計日誌和登陸日誌在Winform界面的展現，因爲整個ABP框架目前我仍是採用了.net core的開發路線，全部的封裝項目都是基於.net core基礎上進行的。不過因爲目前Winform尚未可以以 .net core進行開發，因此界面端仍是用.net framework的方式開發，不過能夠調用 .net standard的類庫。數據庫

下面是審計日誌的列表展現界面，和我以前的Winform框架同樣的佈局，所以我重用了Winform框架裏面公用類庫項目、基礎界面封裝項目、分頁控件等內容，所以整個界面看起來仍是很一致的。後端

因爲審計日誌主要供底層記錄，所以在界面不能增長增刪改的操做，咱們只須要分頁查詢，和導出記錄便可，以下窗體界面所示。瀏覽器

而明細內容，能夠經過雙擊或者右鍵選擇菜單打開便可彈出新的展現界面，主要展現審計日誌裏面的各項信息。服務器

而對於用戶登陸日誌來講，處理方式差很少，也是經過在列表中查詢展現，並在列表中整合右鍵菜單或者雙擊處理，能夠查看登陸明細內容。架構

經過雙擊或者右鍵選擇菜單打開便可彈出新的展現界面，主要展現登陸日誌裏面的各項信息。框架

二、Winform界面代碼實現

上面展現了列表界面和查看明細界面，實際上咱們Winform的界面內部是如何處理的呢，咱們這裏對其中的一些關鍵處理進行分析介紹。異步

列表界面的窗體初始化代碼以下所示async

    /// <summary>
    /// 審計日誌
    /// </summary>    
    public partial class FrmAuditLog : BaseDock
    {
        private const string Id_FieldName = "Id";//Id的字段名稱

        public FrmAuditLog()
        {
            InitializeComponent();

            //分頁控件初始化事件
            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.contextMenuStrip1;
            this.winGridViewPager1.ShowLineNumber = true;
            this.winGridViewPager1.BestFitColumnWith = false;//是否設置爲自動調整寬度，false爲不設置
            this.winGridViewPager1.gridView1.DataSourceChanged +=new EventHandler(gridView1_DataSourceChanged);
            this.winGridViewPager1.gridView1.CustomColumnDisplayText += new DevExpress.XtraGrid.Views.Base.CustomColumnDisplayTextEventHandler(gridView1_CustomColumnDisplayText);
            this.winGridViewPager1.gridView1.RowCellStyle += new DevExpress.XtraGrid.Views.Grid.RowCellStyleEventHandler(gridView1_RowCellStyle);

            //關聯回車鍵進行查詢
            foreach (Control control in this.layoutControl1.Controls)
            {
                control.KeyUp += new System.Windows.Forms.KeyEventHandler(this.SearchControl_KeyUp);
            }

            //屏蔽某些處理
            this.winGridViewPager1.ShowAddMenu = false;
            this.winGridViewPager1.ShowDeleteMenu = false;
        }

這些是使用分頁控件來初始化一些界面的處理事件，不要一看就抱怨須要編寫這麼多代碼，這些基本上都是代碼生成工具生成的，後面會介紹。ide

其實窗體的加載的時候，主要邏輯是初始化字典列表和展現列表數據，以下代碼所示。

        /// <summary>
        /// 編寫初始化窗體的實現，能夠用於刷新
        /// </summary>
        public override async void  FormOnLoad()
        {   
            await InitDictItem();
            await BindData();
        }

其中這裏都是使用async和await 配對實現的異步處理操做。咱們對於審計日誌列表來講，字典模塊沒有須要字典綁定信息，那麼默認爲空不用修改。

        /// <summary>
        /// 初始化字典列表內容
        /// </summary>
        private async Task InitDictItem()
        {
            //初始化代碼
            //await this.txtCategory.BindDictItems("報銷類型");

            await Task.FromResult(0);
        }

那麼咱們主要處理的就是BindData的數據綁定操做了。

        /// <summary>
        /// 綁定列表數據
        /// </summary>
        private async Task BindData()
        {
            this.winGridViewPager1.DisplayColumns = "Id,BrowserInfo,ClientIpAddress,ClientName,CreationTime,Result,UserId,UserNameOrEmailAddress";
            this.winGridViewPager1.ColumnNameAlias = await UserLoginAttemptApiCaller.Instance.GetColumnNameAlias();//字段列顯示名稱轉義

            //獲取分頁數據列表
            var result = await GetData();

            //設置全部記錄數和列表數據源
            this.winGridViewPager1.PagerInfo.RecordCount = result.TotalCount; //需先於DataSource的賦值，更新分頁信息
            this.winGridViewPager1.DataSource = result.Items;

            this.winGridViewPager1.PrintTitle = "用戶登陸日誌報表";
        }

其中咱們經過調用服務端接口 GetColumnNameAlias 來獲取對應的別名，其實咱們也能夠在Winform客戶端設置對等的別名處理，以下代碼所示。

            #region 添加別名解析

            //this.winGridViewPager1.AddColumnAlias("Id", "Id");
            //this.winGridViewPager1.AddColumnAlias("BrowserInfo", "瀏覽器");
            //this.winGridViewPager1.AddColumnAlias("ClientIpAddress", "IP地址");
            //this.winGridViewPager1.AddColumnAlias("ClientName", "客戶端");
            //this.winGridViewPager1.AddColumnAlias("CreationTime", "時間");
            //this.winGridViewPager1.AddColumnAlias("Result", "結果");
            //this.winGridViewPager1.AddColumnAlias("UserId", "用戶ID");
            //this.winGridViewPager1.AddColumnAlias("UserNameOrEmailAddress", "用戶名或郵件");

            #endregion

只是基於服務端更加方便，也減小客戶端的編碼了。

而獲取數據主要經過 GetData 函數進行統一獲取對應的列表和數據記錄信息，以下是GetData的函數實現。

        /// <summary>
        /// 獲取數據
        /// </summary>
        /// <returns></returns>
        private async Task<IPagedResult<UserLoginAttemptDto>> GetData()
        {
            //構建分頁的條件和查詢條件
            var pagerDto = new UserLoginAttemptPagedDto(this.winGridViewPager1.PagerInfo)
            {
                UserNameOrEmailAddress = this.txtUserNameOrEmailAddress.Text.Trim(),
            };

            //日期和數值範圍定義
            //時間，需在UserLoginAttemptPagedDto中添加DateTime?類型字段CreationTimeStart和CreationTimeEnd
            var CreationTime = new TimeRange(this.txtCreationTime1.Text, this.txtCreationTime2.Text); //日期類型
            pagerDto.CreationTimeStart = CreationTime.Start;
            pagerDto.CreationTimeEnd = CreationTime.End;

            var result = await UserLoginAttemptApiCaller.Instance.GetAll(pagerDto);
            return result;
        }

這個函數裏面，主要是接收列表界面裏面的查詢條件，並構建對應的分頁查詢條件，這樣根據條件DTO就能夠請求服務器的數據了。

前面講了，這個過濾條件並返回對應的數據，主要就是在Application Service層，設置CreateFilteredQuery的控制邏輯便可，以下所示。

        /// <summary>
        /// 自定義條件處理
        /// </summary>
        /// <param name="input">分頁查詢Dto對象</param>
        /// <returns></returns>
        protected override IQueryable<AuditLog> CreateFilteredQuery(AuditLogPagedDto input)
        {
            //構建關聯查詢Query
            var query = from auditLog in Repository.GetAll()
                        join user in _userRepository.GetAll() on auditLog.UserId equals user.Id into userJoin
                        from joinedUser in userJoin.DefaultIfEmpty()
                        where auditLog.UserId.HasValue
                        select new AuditLogAndUser { AuditLog = auditLog, User = joinedUser };

            //過濾分頁條件
            return query
                .WhereIf(!string.IsNullOrEmpty(input.UserName), t => t.User.UserName.Contains(input.UserName))
                .WhereIf(input.ExecutionTimeStart.HasValue, s => s.AuditLog.ExecutionTime >= input.ExecutionTimeStart.Value)
                .WhereIf(input.ExecutionTimeEnd.HasValue, s => s.AuditLog.ExecutionTime <= input.ExecutionTimeEnd.Value)
                .Select(s => s.AuditLog);
        }

這裏就不在贅述服務層的邏輯代碼，主要關注咱們本篇的主題，Winform的界面實現邏輯。

上面經過GetData獲取到服務端數據後，咱們就能夠把列表數據綁定到分頁控件上面，讓分頁控件調用GridControl 進行展現出來便可。

            //設置全部記錄數和列表數據源
            this.winGridViewPager1.PagerInfo.RecordCount = result.TotalCount;
            this.winGridViewPager1.DataSource = result.Items;

數據的導出操做，咱們這裏也順便提一下，雖然這些代碼是基於代碼生成工具生成的，不過仍是提一下邏輯處理。

數據的導出操做，主要就是經過GetData獲取到數據後，轉換爲DataTable，並經過Apose.Cell進行寫入Excel文件便可，以下代碼所示。

        /// <summary>
        /// 導出的操做
        /// </summary>        
        private async void ExportData()
        {
            string file = FileDialogHelper.SaveExcel(string.Format("{0}.xls", moduleName));
            if (!string.IsNullOrEmpty(file))
            {
                //獲取分頁數據列表
                var result = await GetData();
                var list = result.Items;
                DataTable dtNew = DataTableHelper.CreateTable("序號|int,Id,時間,用戶名,服務,操做,參數,持續時間,IP地址,客戶端,瀏覽器,自定義數據,異常,返回值");
                DataRow dr;
                int j = 1;
                for (int i = 0; i < list.Count; i++)
                {
                    dr = dtNew.NewRow();
                    dr["序號"] = j++;
                    dr["Id"] = list[i].Id;
                    dr["瀏覽器"] = list[i].BrowserInfo;
                    dr["IP地址"] = list[i].ClientIpAddress;
                    dr["客戶端"] = list[i].ClientName;
                    dr["自定義數據"] = list[i].CustomData;
                    dr["異常"] = list[i].Exception;
                    dr["持續時間"] = list[i].ExecutionDuration;
                    dr["時間"] = list[i].ExecutionTime;
                    dr["操做"] = list[i].MethodName;
                    dr["參數"] = list[i].Parameters;
                    dr["服務"] = list[i].ServiceName;
                    dr["用戶名"] = list[i].UserName;
                    dr["返回值"] = list[i].ReturnValue;
                    dtNew.Rows.Add(dr);
                }

                try
                {
                    string error = "";
                    AsposeExcelTools.DataTableToExcel2(dtNew, file, out error);
                    if (!string.IsNullOrEmpty(error))
                    {
                        MessageDxUtil.ShowError(string.Format("導出Excel出現錯誤：{0}", error));
                    }
                    else
                    {
                        if (MessageDxUtil.ShowYesNoAndTips("導出成功，是否打開文件？") == System.Windows.Forms.DialogResult.Yes)
                        {
                            System.Diagnostics.Process.Start(file);
                        }
                    }
                }
                catch (Exception ex)
                {
                    LogTextHelper.Error(ex);
                    MessageDxUtil.ShowError(ex.Message);
                }
            }            
        }

而對於編輯或者查看界面，以下所示。

它的實現邏輯主要就是獲取單個記錄，而後在界面上逐一綁定控件內容顯示便可。

        /// <summary>
        /// 數據顯示的函數
        /// </summary>
        public async override void DisplayData()
        {
            InitDictItem();//數據字典加載（公用）

            if (!string.IsNullOrEmpty(ID))
            {
                #region 顯示信息
                var info = await AuditLogApiCaller.Instance.Get(ID.ToInt64());
                if (info != null)
                {
                    tempInfo = info;//從新給臨時對象賦值，使之指向存在的記錄對象

                    txtBrowserInfo.Text = info.BrowserInfo;
                    txtClientIpAddress.Text = info.ClientIpAddress;
                    txtClientName.Text = info.ClientName;
                    txtCustomData.Text = info.CustomData;
                    txtException.Text = info.Exception;
                    txtExecutionDuration.Value = info.ExecutionDuration;
                    txtExecutionTime.SetDateTime(info.ExecutionTime);
                    txtMethodName.Text = info.MethodName;
                    txtParameters.Text = ConvertJson(info.Parameters);
                    txtServiceName.Text = info.ServiceName;
                    if (info.UserId.HasValue)
                    {
                        txtUserId.Value = info.UserId.Value;
                    }
                    txtUserName.Text = info.UserName;//轉義的用戶名

                }
                #endregion 
            }
            else
            {
            }

            this.btnAdd.Visible = false;
            this.btnOK.Visible = false;
        }

固然對於新增或編輯的界面，咱們須要處理它的保存或者更新的操做事件，雖然審計日誌不須要這些操做，不過生成的編輯窗體界面，依舊保留這些處理邏輯，以下代碼所示。

        /// <summary>
        /// 新增狀態下的數據保存
        /// </summary>
        /// <returns></returns>
        public async override Task<bool> SaveAddNew()
        {
            AuditLogDto info = tempInfo;//必須使用存在的局部變量，由於部分信息可能被附件使用
            SetInfo(info);

            try
            {
                #region 新增數據

                tempInfo = await AuditLogApiCaller.Instance.Create(info);
                if (tempInfo != null)
                {
                    //可添加其餘關聯操做

                    return true;
                }
                #endregion
            }
            catch (Exception ex)
            {
                LogTextHelper.Error(ex);
                MessageDxUtil.ShowError(ex.Message);
            }
            return false;
        }

        /// <summary>
        /// 編輯狀態下的數據保存
        /// </summary>
        /// <returns></returns>
        public async override Task<bool> SaveUpdated()
        {
            AuditLogDto info = await AuditLogApiCaller.Instance.Get(ID.ToInt64());
            if (info != null)
            {
                SetInfo(info);

                try
                {
                    #region 更新數據

                    tempInfo = await AuditLogApiCaller.Instance.Update(info);
                    if (tempInfo != null)
                    {
                        //可添加其餘關聯操做

                        return true;
                    }
                    #endregion
                }
                catch (Exception ex)
                {
                    LogTextHelper.Error(ex);
                    MessageDxUtil.ShowError(ex.Message);
                }
            }
            return false;
        }

咱們能夠根據實際的須要，對咱們業務對象的窗體進行必定的改造便可。

三、複雜一點的WInform界面處理

例如對於前面的列表界面，一個比較複雜一點的列表展現內容，須要在查詢條件中綁定字典列表，並對列表記錄的一些狀態進行特殊展現等，以及須要考慮增長、導入、導出等功能按鈕，這些默認的列表生成界面就有的。

以下是對於產品信息的一個界面展現，也是基於ABP框架構建的服務進行數據展現的例子。

和前面介紹的例子同樣，也是基於分頁控件進行展現的，咱們來看看狀態的處理吧。

因爲狀態和用戶信息，咱們在數據庫裏面記錄的是整形的數據信息，也就是狀態爲0,1的這樣，以及用戶ID等，咱們若是須要轉義給客戶端使用，那麼咱們須要在對應的DTO裏面增長一些字段進行承載，以下所示是產品信息的DTO對象，除了自己CreateProductDto必須有的字段外，咱們另外增長了兩個屬性，以下代碼所示。

而後咱們在應用服務接口的ConvertDto轉義函數裏面增長本身的處理轉義邏輯便可，以下代碼所示。

        /// <summary>
        /// 對記錄進行轉義
        /// </summary>
        /// <param name="item">dto數據對象</param>
        /// <returns></returns>
        protected override void ConvertDto(ProductDto item)
        {
            //如須要轉義，則進行重寫

            #region 參考代碼
            //用戶名稱轉義
            if (item.CreatorUserId.HasValue)
            {
                //需在ProductDto中增長CreatorUserName屬性
                item.CreatorUserName = _userRepository.Get(item.CreatorUserId.Value).UserName;
            }

            if (item.Status.HasValue)
            {
                item.StatusDisplay = item.Status.Value == 0 ? "正常" : "停用";
            }
            #endregion
        }

這樣客戶端就能夠採用這兩個屬性展現信息了。

前面也介紹了，對於產品類型屬性，咱們通常是一個字典信息的，所以咱們能夠集成綁定字典的處理，以下代碼所示。

這個BindDictItems是擴展函數，經過擴展函數，咱們對控件類型的綁定字典操做進行處理便可，具體的邏輯代碼以下所示。

    /// <summary>
    /// 擴展函數封裝
    /// </summary>
    internal static class ExtensionMethod
    {
        /// <summary>
        /// 綁定下拉列表控件爲指定的數據字典列表
        /// </summary>
        /// <param name="control">下拉列表控件</param>
        /// <param name="dictTypeName">數據字典類型名稱</param>
        /// <param name="emptyFlag">是否添加空行</param>
        public static async Task BindDictItems(this ComboBoxEdit control, string dictTypeName, bool isCache = true, bool emptyFlag = true)
        {
            await BindDictItems(control, dictTypeName, null, isCache, emptyFlag);
        }

        /// <summary>
        /// 綁定下拉列表控件爲指定的數據字典列表
        /// </summary>
        /// <param name="control">下拉列表控件</param>
        /// <param name="dictTypeName">數據字典類型名稱</param>
        /// <param name="defaultValue">控件默認值</param>
        /// <param name="emptyFlag">是否添加空行</param>
        public static async Task BindDictItems(this ComboBoxEdit control, string dictTypeName, string defaultValue, bool isCache = true, bool emptyFlag = true)
        {
            var dict = await DictItemUtil.GetDictByDictType(dictTypeName, isCache);

            List<CListItem> itemList = new List<CListItem>();
            foreach (string key in dict.Keys)
            {
                itemList.Add(new CListItem(key, dict[key]));
            }

            control.BindDictItems(itemList, defaultValue, emptyFlag);
        }

......