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应用 入门开发教程系列。

下面开始本系列教程第一篇：

项目的工程引入方式：

1、引用源码（自带工程项目）

2、引用Nuget（纯dll引用）

开发方式：

1、.Net Framework.

2、.Net Core.

1、引用源码：下载框架源码（含工程文件）：Taurus.MVC

开源地址：https://github.com/cyq1162/Taurus.MVC

 

1.1、引用源码：打开 .Net Framework 项目工程：

Taurus.MVC.sln ：.持.Net Framework 2.0+版本，部署在Window平台。（建议：VS2012以上，直接运行时web.config把经典模式注册打开，保持和下图一致）

 

1.2、引用源码：打开 .Net Core 项目工程：

Taurus.MVC_NetCore ：支持.NET Core 2.1+（含NET5、NET6、NET7...以及未来版本）。（建议：VS2017以上，当前最新VS2022）

说明：

框架默认有引用：Package中的CYQ.Data.dll，若项目运行报相关错误时，重新引用即可。

若有需要，也可以引用CYQ.Data的源码项目：https://github.com/cyq1162/cyqdata

1.3、引用源码：F5运行工程项目

正常成功运行时界面：（新版本新增：Taurus Admin Center，用于微服务管理中心）

2.1、引用Nuget：新建.Net Framework 项目：

2.2、引用Nuget：新建.Net Core 项目：

 

 

2.3、引用Nuget：搜索并引入Nuget 包：

nuget管理中，搜索taurus，根据工程版本引用版本：

.NET Framework：Taurus.MVC

.NET Core ：Taurus.MVC.Core

2.4、引用Nuget：配置拦截入口

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.AddTaurusMvc();
        }

        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            app.UseTaurusMvc();
        }
    }

3、NET5、NET6、NET7...系列，通过Program.cs 配置入口：

var builder = WebApplication.CreateBuilder(args);

//补上Starpup的ConfigureServices：

builder.Services.AddTaurusMvc();

var app = builder.Build();

app.UseTaurusMvc();

app.Run();

2.5、引用Nuget：F5运行工程项目

运行成功：（提示需要控制器进行编码，下一篇添加控制器）

后续这个输出文本，调整输出为：

404 - Not found.

总结：

本篇就介绍两种方式下建议Taurus.MVC WebAPI项目，并进行初始运行成功。

下一篇介绍控制器的简单编码使用。