安裝ASP.NET Core Zero Power Tool
根據官方的介紹, 使用該工具, 可以快速得創建具備單個表結構及父子表結構的服務以及前端頁面。
服務: 指的是生產對應基礎功能webApi接口
前端: 這里使用Angular生產得前端頁面及模塊
目前支持VisualStudio版本: VS2017、VS2019
使用ASP.NET Core Zero Power Tool
打開工具-> ASP.NET Zero-> Create Entity, 會如下所示:
上面看到得第一個頁面， 其中用於配置實體得信息, 如:
- 實體類的基礎參數: 命名空間、實體類名、表名、繼承的基類、主鍵類型
- 數據庫遷移: 是否選擇自動創建遷移、更新數據庫
- 用戶接口: 創建接口、讀取、父子表
- 多租戶、審計日志
如下所示,創建了一個實體類:
配置完成實體信息之后, 選擇第二個選項卡Properties,如下所示:
在這里, 主要用於添加實體類的字段,根據實際需求來添加表的字段名稱及類型。
如下所示,創建了一部分屬性列表:
然后直接點擊GENERATE 生成操作, 如果點擊按鈕無任何操作,請確保本機安裝.NET2.2對應的環境。
點擊我安裝.NET2.2 Runtime
解釋為什么要安裝2.2？
答疑: 因為Power Tool是基於2.2開發,官方為更新最新的版本, 所以使用的時候確保本機安裝對應的環境,否則會無法執行的情況。
生成的界面會如下所示:
- 創建接口服務、Dto、數據庫實體、以及查詢實體和 Mapper映射配置
- 創建數據庫遷移文件及生成數據庫操作
- 創建Angular的模塊配置以及頁面功能
注意: 第二部會使用EF來執行遷移和更新數據庫腳本, 這里需要確保你本機安裝了EF工具。
如果你的電腦這里提示執行錯誤, 那么你需要檢查你的本機電腦是否全局安裝了EF CLI, 打開CMD 執行以下命令檢查:
dotnet ef
如果未安裝,請在窗口當中輸入進行安裝:
dotnet tool install --global dotnet-ef
當你在上一步失敗之后, 項目當中可以進行手動創建遷移以及生成數據庫, 因為在你沒有安裝EF工具所以不會自動創建。
下一步
生成之后, 請檢查對應的項目列表當中是否包含對應生成的文件, 大概包含兩塊 后台+前端。
后台:
- 實體類、Dto、接口、接口實現等文件。
前端Angular:
- 包含模塊信息、ts、html等文件。
此時,啟動Host項目, 可以看到對應的OpenApi文檔中已經出現新添加的內容,如下所示:
調試前端Angular
啟動前端項目, 如果編譯異常, 可能的原因是由於沒有更新對應的代理服務導致。
此時,在終端窗口依次輸入以下內容, 主要用於手動同步代理服務接口的信息,如下所示:
cd nswag
./refresh.bat
注意: 調用refresh.bat 實際上是去同步本地服務當中對應的接口,生成對應的前端代理服務, 所以調用時請確保WebApi已經正常啟動。
執行完成之后, 請檢查service-proxies文件中是否包含對應的服務實現,如下所示:
對應實現如下所示:
完成后, 啟動項目npm start 或 npm run hmr
運行成功后, 會發現界面菜單當中包含了新添加的模塊, 以及對應的功能如下所示:
目前為止, 界面的后台和前端已經自動生成, 下面就是關於本地化的配置, 例如Posts 需要顯示成對應的中文, 以及列表當中的字段中心配置。
關於這部分的配置, 主要在后台當中進行設置, 找到Core項目的Localzation文件夾, 找到對應版本的XML編輯即可, 如下所示:
注意: 默認情況下, 會生成對應的英文映射, 所以針對不同版本的語言, 我們只需要復制英文版本下的字典進行對應的翻譯即可。
修改完成之后, 重新啟動Host項目、再次刷新前端項目, 即可發現對應的英文在中文的語言下已經變成了中文顯示, 如下所示:
總結
結合Power Tool工具, 可以快速的在項目當中生成簡單的模塊, 可以極大的提高開發效率, 包含前后端代碼、多租戶、審計日志等功能。