使用.NET8实现Web API

link管理

链接快照平台

输入网页链接，自动生成快照
标签化管理网页链接

1、环境准备

1.1、从官网下载及安装VS2022社区版

可从官网下载 VS2022 社区版本，并进行安装。下载链接：官网VS2022社区版本链接
【说明】去年（2023年）底，微软发布了 NET8 ，为长期支持版本。目前长期支持的版本为： NET6 和 NET8 。所以建议直接使用NET8。在VS2022安装时，默认的NET版本就是 NET8 。

1.2、下载及安装asp.net core的运行时及IIS Module

安装完成VS2022后，需要额外安装Core运行时及IIS的 模块 。

1、下载及安装运行时以及IIS的模块
直接在网上输入： windows hosting bundle 或 托管捆绑包 。找到官网就能下载，下载完成后进行安装。
【说明】先在本机完成安装IIS，否则还得折腾。
2、完成安装

安装完成后，在 IIS 的 模块 中应该能够看到 AspNetCoreModuleV2
3、IIS设置
因为要支持跨平台性，微软推出“ Kestrel ”服务，替代IIS承载 asp.net core 等Web服务。因此 IIS 的web承载功能就没用了， IIS 只是一个请求转发的功能，类似 Nginx 。所以，需要设置 IIS 的程序池进行相关设置。
创建一个新的程序应用池，CLR版本选择“ 无托管代码 ”，如下图所示。使用asp.net core发布的网站，选择应用程序池时，选择刚才创建的这个。
在发布 asp.net core 的web程序时，选择刚才设置的程序池
以上工作完成后，就进入 Web API 的正式创建了

//第2步：设置第三方ORM-SQLSugar
//注册上下文
builder.Services.AddHttpContextAccessor();
//注册SqlSugar用AddScoped
builder.Services.AddScoped<ISqlSugarClient>(s =>
    //Scoped用SqlSugarClient 
    SqlSugarClient sqlSugar = new SqlSugarClient(new ConnectionConfig()
        DbType = SqlSugar.DbType.Oracle,
        ConnectionString = builder.Configuration["DBConnectStr"],//在appsettings.json配置文件中的字符串设置
        IsAutoCloseConnection = true,
       db.Aop.OnLogExecuting = (sql, pars) =>
           //可以进行日志记录之类的工作
   });
    return sqlSugar;
});
2.2.1.2、 OracleAccess
 
若不使用ORM等第三方的库，则使用Oracle的库“ManagedDataAccess”。这个的好处是不用关心32还64位的问题。
  
2.2.2、IOC篇
 
IOC就是实例的创建，交给了容器。由容器创建实例，一般而言。项目中本身也包含此功能：Microsoft.Extention.DependencyInjection。既可以使用自带的，也可以使用第三方的。第三方使用比较多的是autofac。目前推荐大家使用自带的，省事儿 
2.2.2.1、autofac
 
1、在program.cs文件中 
builder.Host.UseServiceProviderFactory(new AutofacServiceProviderFactory());
builder.Host.ConfigureContainer<ContainerBuilder>(b =>
    b.RegisterModule<AutofacModuleRegister>();
});
其中AutofacModuleRegister的定义如下： 
 public class AutofacModuleRegister: Autofac.Module
     /// <summary>
     /// 自动加载注册程序集
     /// </summary>
     /// <param name="builder"></param>
     protected override void Load(ContainerBuilder builder)
         var basePath = AppContext.BaseDirectory;
         #region 带有接口层的服务注入
         //服务注入
         List<string> dllServiceFiles = new List<string>()
                 "TsinghuaNet8WebAPI.Dl.dll",
                 "TsinghuaNet8WebAPI.dll",
                 "TsinghuaNet8WebAPI.Bl.dll"
         var cacheType = new List<Type>();
         List<Assembly> servicesAssembly = new List<Assembly>();
         foreach (var item in dllServiceFiles)
             var dllFile = Path.Combine(basePath, item);
             if (!File.Exists(dllFile))
                 throw new Exception($"{item}丢失，请重新编译后请检查 bin 文件夹，并拷贝。");
             servicesAssembly.Add(Assembly.LoadFrom(dllFile));
         //构造器注入
         builder.RegisterAssemblyTypes(servicesAssembly.ToArray()).
             Where(t => !t.IsAbstract) //还可以添加自定义的检索条件
             .InstancePerDependency(); //默认的类型
         #endregion
2.2.2.2、使用自带的容器
 
直接在program.cs中填写。简单省事。 
#region 注入接口服务
builder.Services.AddScoped<IGetEmrInfo, GetEmrInfo>();
#endregion
2.2.3、日志记录篇
 
常用的NET日志工具，一般有：log4NET、NLog这两个。基本上都差不多，这有个连接：NET常用的10个日志记录工具
 本次以Nlog为例 
2.2.3.2 nlog
 
在program.测试中添加以下代码。 
//第3步，配置日志信息，使用NLog
builder.Logging.ClearProviders();//清除所有的日志ILoggerProvider 记录提供器
builder.Logging.SetMinimumLevel(LogLevel.Information);
builder.Logging.AddNLog("Configs/NlogConfig.config");
builder.Host.UseNLog();//设置NLog 依赖注入 .net core 版本需要引用NLog.Web.AspNetCore
builder.Logging.AddConsole();
添加配置文件，如图所示。
  
配置文件如下： 
<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      autoReload="true"
      internalLogLevel="Warn"
      internalLogFile="internal-nlog.txt">
	<!-- autoReload:true 监视配置文件，并在配置文件发生更改时自动重新载入配置文件而不需要重启应用程序 -->
	<targets>
		<!-- archiveAboveSize 代表日志文本文件的最大字节数，单位字节 -->
		<!-- maxArchiveFiles 代表存储的日志文件最大个数，设置后可以避免日志文件无限量增加，导致磁盘空间不够 -->
		<target name="Infofile" xsi:type="File" 
			fileName="${currentdir}/Logs/Info-${shortdate}.txt" 
			archiveAboveSize="10000000" maxArchiveFiles="30"
		<target 
			name="Errorfile" 
			xsi:type="File" 
			fileName="${currentdir}/Logs/Error-${shortdate}.txt"  
			archiveAboveSize="10000000" 
			maxArchiveFiles="3"
			layout="${longdate}|${logger}|${uppercase:${level}}|${message} ${exception}"
	</targets>
	<rules>
		<!--All logs, including from Microsoft-->
		<logger name="*" minlevel="Info"  writeTo="Infofile" />
		<logger name="*" minlevel="Error" writeTo="Errorfile" />
		<!--Skip Microsoft logs and so log only own logs-->
		<logger name="Microsoft.*" minlevel="Trace" writeTo="blackhole" final="true" />
	</rules>
</nlog>
2.2.4 其他
 
2.2.4.1 设置
 
swagger的设置 
//Swagger服务
builder.Services.AddSwaggerGen(c =>
	c.SwaggerDoc("v1", new OpenApiInfo
		Title = "接口说明",
		Version = "v1",
		Contact = new OpenApiContact { Name = "WebApi", Email = "xxx", Url = new Uri("http://info.btch.edu.cn") },
		License = new OpenApiLicense { Name = "XXX公司", Url = new Uri("http://info.btch.edu.cn") }
	});
	c.OrderActionsBy(o => o.RelativePath);
	string path = AppContext.BaseDirectory;
	var xmlPath = Path.Combine(path, "ClinicWebApplication.xml");
	c.IncludeXmlComments(xmlPath, true);
});
基本的配置就是这样子
                                    控制器处理传入的 HTTP 请求并响应客户端。它们是通过继承自 ControllerBase 并使用 进行注释来定义的。通过配置 JSON 序列化程序设置，自定义 JSON 响应格式，例如 camelCase 命名或忽略 null 值。中间件是组装到应用程序管道中以处理请求和响应的软件。可以创建自定义中间件来执行特定任务。自定义验证属性允许您定义数据模型的验证逻辑，从而扩展内置验证属性。
                                    随着软件开发行业的快速发展，编程语言和框架也在不断迭代更新。.NET 8作为.NET平台的重要版本，带来了一系列令人瞩目的新功能，这些功能不仅提升了开发效率，还深刻地改变了开发者的编码方式。本文将深入探讨.NET 8中7个具有代表性的新功能，以及它们如何推动开发范式的变革。一、动态配置文件引导优化（PGO）功能介绍在.NET 8中，默认启用了动态配置文件引导优化（PGO）。这是一种新的代码生成...
                                    在 .NET Conf 2023 大会上，.NET 8 正式发布了，.NET 8 是一个长期支持（LTS）版本，这意味着可以获得三年的支持和补丁。我们也计划将框架从 .NET Core3.1 升级到 8 ，关于如何升级等升级完成后再来分享。要使用 .NET 8 ，需要安装相关的 SDK，可以在这个地址进行下载：https://dotnet.microsoft.com/zh-cn/downlo...
                                    我们现在刚开始，创建就是一个可直接运行的项目，我的习惯是可直接运行发的项目命名后面加上.Host，又由于项目本身属于Web类型的项目，故项目名称为MyStudyAPI.Web.Host。好了，本节内容就先介绍到这里，也许有人会问，既然是刚开始入门课程，怎么会没有Hello,World的出现，下节的内容，我们就来提供一个名为hello的接口，接口返回内容为就Hello,World！可以看到，接口返回状态为200，返回内容也存在（是json格式的内容），说明接口可以正常运行。5、创建完成后，解决方案目录如下。
                                    1.前言.Net8通过各种骚操，把性能提升到了前所未有的高度。超越以往任何版本，也涵盖了后续版本，比如.NET9或许可能没有如此大的性能优化了。本篇来看下它其中的一个优化:类型转换的优化效果。2.示例通过类型检查的优化，优化掉某些情况下类型转换的时候JIT类型检查的函数。下面的代码是类型检查的典型应用。[HideColumns("Error", "StdDev", "Median", "Ratio...
                                    随着生成式AI的到来，人工智能领域发生了翻天覆地的变化，从底层语言、运行时，到库的处理，到接口，到跨平台应用，对于 人工智能，.NET都有相对成熟的解决方案了。由于新的基于“Jiterpreter”的运行时和新的内置组件，您的 .NET 代码在 WebAssembly 上的运行速度明显更快。.NET 8 以多种方式促进了云原生开发，例如包括许多容器增强功能，但这里的重大新闻是 .NET Aspire 的第一个预览版的可用性，这是一个用于构建弹性、可观察和可配置的云原生应用程序的堆栈。以下是每个领域的介绍。
                                    .NET 8作为一个长期支持版本（LTS）马上就要发布了，.NET7会在2024年5月14日终止支持，上一个长期支持版本.NET6也会在2024年11月12日终止，所以.NET8发布会，会迎来一波升级。说说为什么升级吧。其实升级对程序员来说，比较烦，用的好好的，升什么升。其实如果你们安全部门不作要求，可以不升；如果你们没有安全部门，可以不升；如果你们不担心漏洞攻击也可以不升；再如果你们这个服务可有...
                                    1.前言.Net7到.Net8各种魔改，几乎有些不认得了。本篇来看下.Net8支持的两个新功能，序列化变异。2.接口层次结构序列化先上代码,用以观察：public interface IBase
   public int Base { get; set; }
public interface IDerived : IBase
    public int Derived { get;...
                                    Blazor增强了身份验证、授权等功能，随着.Net 8的发布，Blazor 已成为全堆栈 Web UI 框架，大有消灭前端开发人员的想法！.Net 8 增加了数以千计的性能、稳定性和安全性改进，以及平台和工具增强功能，有助于提高开发人员的工作效率和创新速度。.Net的野心确实不小，目标是让其在任何平台上都能运行得游刃有余，展现出卓越的性能。这个版本，.Net重塑构建智能、云原生的应用、可按需扩展的高流量服务的方式。总的来说，这次.Net 8的发布可以说是针对各端，都做了非常多的升级与优化。

1、环境准备

1.1、从官网下载及安装VS2022社区版

1.2、下载及安装asp.net core的运行时及IIS Module

2、WebAPI工程创建

2.2 推荐的库

2.2.1 数据库篇

2.2.1.1、 SQLSugar

2.2.1.2、 OracleAccess

2.2.2、IOC篇

2.2.2.1、autofac

2.2.2.2、使用自带的容器

2.2.3、日志记录篇

2.2.3.2 nlog

2.2.4 其他

2.2.4.1 设置