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配置入口：

  
  
   
    
      
    "Taurus.Core" type="Taurus.Core.UrlRewrite,Taurus.Core"/>
    
  
  
    "false" />
    
      
      "Taurus.Core" type="Taurus.Core.UrlRewrite,Taurus.Core"/>

    
  

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(x => x.AllowSynchronousIO = true).Configure(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(x => x.AllowSynchronousIO = true).Configure(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项目，并进行初始运行成功。

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