Taurus.MVC WebAPI 入門開發教程1:框架下載環境配置與運行(含系列目錄)。
- 2022 年 8 月 3 日
- 筆記
- ASP.NET Taurus.MVC, aspnetcore, taurus.mvc, WebApi
前言:
Taurus.MVC 微服務版本已經發布了:Taurus.MVC V3.0.3 微服務開源框架發布:讓.NET 架構在大並發的演進過程更簡單。
以前都是框架發布時寫點相關功能點的文章,沒有形成系列。
因此,計劃補充些詳細的入門開發教程,本系列教程目錄如下:
1、Taurus.MVC WebAPI 入門開發教程1:框架下載環境配置與運行。
2、Taurus.MVC WebAPI 入門開發教程2:添加控制器輸出Hello World。
3、Taurus.MVC WebAPI 入門開發教程3:路由類型和路由映射。
4、Taurus.MVC WebAPI 入門開發教程4:控制器方法及參數定義、獲取及基礎校驗屬性【Require】。
5、Taurus.MVC WebAPI 入門開發教程5:控制器安全校驗屬性【HttpGet、HttpPost】【Ack】【Token】【MicroService】。
6、Taurus.MVC WebAPI 入門開發教程6:全局控制器DefaultController與全局事件。
7、Taurus.MVC WebAPI 入門開發教程7:業務邏輯基類LogicBase的使用。
8、Taurus.MVC WebAPI 入門開發教程8:WebAPI文檔與自動化測試。
後續還有兩個補充系列:
1、Taurus.MVC 微服務 入門開發教程系列。 2、Taurus.MVC Web應用 入門開發教程系列。
下面開始本系列教程第一篇:
引用源碼方式:下載框架Taurus.MVC
開源地址://github.com/cyq1162/Taurus.MVC
引用源碼方式:1、打開項目工程:
1、Taurus.MVC.sln :.Net Framework 版本,部署在Window平台。(建議:VS2012以上,直接運行時web.config把經典模式註冊打開,保持和下圖一致)
2、Taurus.MVC_NetCore :支援.NET Core 系列版和NET5、NET6、NET7…以及未來版本。(建議:VS2017以上,當前最新VS2022)
說明:
框架默認有引用:Package中的CYQ.Data.dll,若項目運行報相關錯誤時,重新引用即可。 若有需要,也可以引用CYQ.Data的源碼項目:https://github.com/cyq1162/cyqdata
引用源碼方式:2、F5運行工程項目
.NET 底層版本選擇:
可以根據需要: 1、.NET版本2.0到4.N版本 2、.NET Core2.1 到.NET6、.NET7及未來版本。 框架在的強大,在於自適應從早期到未來,可以適應微軟的無限底層升級,而應用層面的開發程式碼無需程式碼遷移。
運行成功時:
說明:
源碼項目,默認包含MVC的介面,還有Demo控制器,對於WebAPI開發而言,都是可以刪除的。 唯一要保留的目錄文件是:WebAPI開發文檔相關介面文件:
.NET :/View/Doc/... .NET Core :/wwwroot/Views/Doc/.....
引用Nuget包方式:1、新建空項目:
1、ASP.NET 系列:
2、ASP.NET Core 系列:
引用Nuget包方式:2、引用Taurus.MVC:
nuget管理中,搜索taurus,根據工程版本引用版本:
.NET :Taurus.MVC
.NET Core :Taurus.MVC.Core
引用Nuget包方式:3、配置攔截入口
1、普通.Net Framework 項目,引用包時會自動生成Web.Config配置入口:
<configuration> <system.web> <httpModules> <!--Taurus IIS應用程式池:經典模式(下運行,開啟此配置,反之,注釋掉此行)--> <add name="Taurus.Core" type="Taurus.Core.UrlRewrite,Taurus.Core"/> </httpModules> </system.web> <system.webServer> <validation validateIntegratedModeConfiguration="false" /> <modules> <!--Taurus IIS應用程式池:集成模式(下運行,開啟此配置,反之,注釋掉此行)--> <add name="Taurus.Core" type="Taurus.Core.UrlRewrite,Taurus.Core"/> </modules> </system.webServer> </configuration>
2、.NET Core 項目,通過Startup.cs 配置入口:
public class Startup { // This method gets called by the runtime. Use this method to add services to the container. // For more information on how to configure your application, visit //go.microsoft.com/fwlink/?LinkID=398940 public void ConfigureServices(IServiceCollection services) { services.AddHttpContext(); services.Configure<KestrelServerOptions>(x => x.AllowSynchronousIO = true).Configure<IISServerOptions>(x => x.AllowSynchronousIO = true); } // This method gets called by the runtime. Use this method to configure the HTTP request pipeline. public void Configure(IApplicationBuilder app, IWebHostEnvironment env) { app.UseHttpContext(); app.UseTaurusMvc(env); } }
3、NET5、NET6、NET7…系列,通過Program.cs 配置入口:
var builder = WebApplication.CreateBuilder(args); //補上Starpup的ConfigureServices:
builder.Services.Configure<KestrelServerOptions>(x => x.AllowSynchronousIO = true).Configure<IISServerOptions>(x => x.AllowSynchronousIO = true);
builder.Services.AddHttpContext();
var app = builder.Build(); //補上Starpup的Configure: app.UseHttpContext(); app.UseTaurusMvc(app.Environment); app.Run();
Nuget包引用方式:4:F5運行工程項目
運行成功:(提示需要控制器進行編碼,下一篇添加控制器)
總結:
本篇就介紹兩種方式下建議Taurus.MVC WebAPI項目,並進行初始運行成功。
下一篇介紹控制器的簡單編碼使用。