Taurus.MVC WebAPI 入門開發教程1：框架下載環境配置與運行（含系列目錄）。

前言：

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

開源地址：https://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 https://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項目，並進行初始運行成功。

下一篇介紹控制器的簡單編碼使用。