前言:
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项目,并进行初始运行成功。
下一篇介绍控制器的简单编码使用。
转载请注明:Taurus.MVC WebAPI 入门开发教程1:框架下载环境配置与运行(含系列目录)。 | 胖虎的工具箱-编程导航