.net core框架

ASP.NET Core 入门

跨平台开源框架 B/S

类与方法

Console 部分称为“类”。类“拥有”方法；或者可以说方法存在于类中。

WriteLine() 部分称为“方法”。

想要使用方法就要知道方法在哪里

——————————

执行流

一次执行一段

ASP.NET Core 是什么东西？.net框架吗？

企业里面-把后端完善

1.配置Swagger

1.为生成的api追加注释

Program.cs

builder.Services.AddSwaggerGen(option =>
{
    //xml文档绝对路经--读取根据控制器api生成的Xml的文件  ?????
    var file = Path.Combine(AppContext.BaseDirectory,
        "BookReadWebApi.xml");

    //true显示器层展示注释
    option.IncludeXmlComments(file, true);

    //action排序
    option.OrderActionsBy(o => o.RelativePath);
});

配置让swagger展示注释

2.不同版本api的版本控制

0.创建版本枚举文件夹

1.获取api的名称

builder.Services.AddSwaggerGen(option =>
{
    typeof(ApiVersions).GetEnumNames().ToList().ForEach(Version =>
    {
        //1.先获取所有name
      option.SwaggerDoc(Version,new Microsoft.OpenApi.Models.OpenApiInfo() 
      {
        Title = $"读书平台",
        Version = Version,
        Description = $"通用版本的CoreApi版本{Version}"
      });
    });
    ......
    }

2.遍历api

app.UseSwaggerUI(c =>
{
    foreach(string version in typeof(ApiVersions).GetEnumNames())
    {
        c.SwaggerEndpoint($"/swagger/{version}/swagger.json",$"阅读平台第{version} 版本");
    }
});

3.控制当前api只在特定(V1)的版本中展示改接口

[ApiExplorerSettings(IgnoreApi =false,GroupName =nameof(Utility.SwaggerExt.ApiVersions.V1))]

静态类里面的静态方法的this成为扩展方法

可以将里面的方法调用改写

CustomSwaggerExt.AddSwaggerExt(builder.Services);等效于
builder.Services.AddSwaggerExt();

这就是中间件的封装？？？？？不懂，不管

2.连接数据库？？

还没学

3.中间件

将文件定义到该代理下面

app.Use(async (context, next) =>
{
    await next.Invoke();
});

app.Run(async context =>
{
    await context.Response.WriteAsync("hello");
});

启用静态文件中间件：

一，可以通过打开浏览器查看该静态文件里的内容

1.根目录下新建文件夹wwwroot->将图片文件存储到该地址下

2.Program.cs配置如下内容

app.UseStaticFiles()//启用静态文件中间件

二，指定目录：MyRouse文件夹作为指定目录，RequestPath设置请求前缀

app.UseStaticFiles(new StaticFileOptions()
{
    FileProvider=new PhysicalFileProvider(Path.Combine(builder.Environment.ContentRootPath,"MyRouse")),
        RequestPath="/StaticFiles"//https://localhost:7035/StaticFiles/2.png(选择性添加)
});

三，目录浏览-中间件

在Program.cs配置如下内容

var fileProvider = new PhysicalFileProvider(
        Path.Combine(builder.Environment.ContentRootPath, "MyRouse"));
var requestPath = "/MyRouse";
....
app.UseStaticFiles(new StaticFileOptions()
{
    FileProvider=new PhysicalFileProvider(
        Path.Combine(builder.Environment.ContentRootPath,"MyRouse")),
    RequestPath= requestPath
});

app.UseDirectoryBrowser(new DirectoryBrowserOptions
{
    FileProvider=fileProvider,
    RequestPath= requestPath

});

https重定向

现在都是默认点击就送

1.启动两个默认地址，默认启动swagger文件，

 "https": {
   "commandName": "Project",
   "dotnetRunMessages": true,
   "launchBrowser": true,
   "launchUrl": "swagger",
   "applicationUrl": "https://localhost:7035;http://localhost:5043",
   "environmentVariables": {
     "ASPNETCORE_ENVIRONMENT": "Development"
   }

但http地址是不安全的所以我们现在重定向

2.在Program.cs配置如下内容

app.UseHsts();
app.UseHttpsRedirection();

Hsts是一种安全机制，在未来一段时间只使用https来访问网站

读取配置

ASP.NET Core 项目默认配置文件：appsettings.json文件

 //appsettings.json
 "msg": "yeye"

//Program.cs
app.MapGet("config", (IConfiguration configuration) =>
{
    return configuration["msg"] + '_' + configuration["Logging:LogLevel:befault"];
});

省略

开发环境

控制swagger仅仅在开发环境中展示，发布之后将不再展示

在Program.cs配置如下内容

if (app.Environment.IsDevelopment())
{
    app.UseHsts();
    app.UseSwagger();
    app.UseSwaggerUI();
}
..
    app.Run();

4.more

日志

开发可以使用

app.Logger.LogInformation("程序已启动");//本地自带的

生产环境一般使用第三方的库作为日志：

可以生成txt文件，可以将日志添加到数据库里面，方便排查问题

需要注意的点：保存文件的名称及存储地址

//CfgFile/log4net.Config
<?xml version="1.0" encoding="utf-8"?>
<log4net>
	<!-- 控制台日志配置 -->
	<appender name="Console" type="log4net.Appender.ConsoleAppender">
		<!-- 日志输出格式 -->
		<layout type="log4net.Layout.PatternLayout">
			<conversionPattern value="%5level [%thread] (%file:%line) - %message%newline" />
		</layout>
	</appender>

	<!-- 文件存储日志配置 -->
	<appender name="RollingFile" type="log4net.Appender.RollingFileAppender">
		<!-- 保存文件的名称及存储地址 -->
		<file value="log4\log.log" />
		<!-- 追加内容覆盖 -->
		<appendToFile value="true" />
		<!-- 文件的编码方式 -->
		<param name="Encoding" value="UTF-8"/>
		<!-- 每个文件的大小 -->
		<maximumFileSize value="100KB" />
		<!-- 保存文件数量 -->
		<maxSizeRollBackups value="2" />
		<!-- 日志输出格式 -->
		<layout type="log4net.Layout.PatternLayout">
			<conversionPattern value="%level %thread %logger - %message%newline" />
		</layout>
	</appender>

	<root>
		<level value="ALL" />
		<appender-ref ref="Console" />
		<appender-ref ref="RollingFile" />
	</root>
</log4net>

0了，会生成log.log的日志文件