ASP.NET Core 6 Web API 基础项目指南

邴治盟Walton

于 2024-08-19 10:38:18 发布

阅读量406

点赞数 3

本文链接：https://blog.csdn.net/gitblog_00937/article/details/141318279

版权

ASP.NET Core 6 Web API 基础项目指南

AspNetCore6WebAPIFundamentalsFully functioning sample code for my ASP.NET Core 6 Web API Fundamentals course项目地址:https://gitcode.com/gh_mirrors/as/AspNetCore6WebAPIFundamentals

本教程将引导您了解位于 https://github.com/KevinDockx/AspNetCore6WebAPIFundamentals.git 的开源项目的关键组成部分，包括其目录结构、启动文件以及配置文件的深入分析。

1. 目录结构及介绍

目录结构是理解任何ASP.NET Core项目的关键。 在这个项目中，典型的层次结构确保了清晰的代码组织：

src: 主要源代码存放位置。
- _AspNetCore6WebAPIFundamentals: 应用程序的主要目录。
  - Controllers: 包含所有API控制器，负责处理HTTP请求。
    - 示例：ValuesController.cs 是一个基本示例，展示了如何响应GET请求。
  - Models: 定义应用程序使用的数据模型或实体类。
  - Startup.cs: 启动配置所在，这里是服务注册、中间件配置等的地方。
  - appsettings.json 和 appsettings.Development.json: 存储应用配置，后者是环境特定设置（例如开发环境）。
  - Program.cs: 新版ASP.NET Core中的入口点，负责应用的启动流程。
  - Dependencies: 可能包含第三方库的特殊逻辑或自定义依赖项，但在给定的GitHub链接中未特别提及此子目录。

2. 项目的启动文件介绍

Program.cs

在ASP.NET Core 6及以上版本，Program.cs 成为了应用启动的核心。它不仅包含了宿主的构建过程，也负责配置web服务器和应用服务。示例代码通常包括创建WebHostBuilder并配置它来使用Kestrel服务器，加载环境特定配置，以及调用Startup类以进行进一步的服务配置。

namespace __AspNetCore6WebAPIFundamentals
{
    public class Program
    {
        public static void Main(string[] args)
        {
            CreateHostBuilder(args).Build().Run();
        }

        public static IHostBuilder CreateHostBuilder(string[] args) =>
            Host.CreateDefaultBuilder(args)
                .ConfigureWebHostDefaults(webBuilder =>
                    webBuilder.UseStartup<Startup>());
    }
}

Startup.cs

此文件集中了应用的配置逻辑，包括依赖注入和服务配置。它分为两个主要部分：ConfigureServices(IServiceCollection services) 和 Configure(IApplicationBuilder app, IWebHostEnvironment env)。前者用于配置DI容器中的服务，后者用于配置应用程序管道，比如添加路由、中间件等。

public class Startup
{
    public Startup(IConfiguration configuration)
    {
        Configuration = configuration;
    }

    public IConfiguration Configuration { get; }

    public void ConfigureServices(IServiceCollection services)
    {
        // 配置数据库连接、添加服务等
    }

    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }

        app.UseRouting();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapControllers();
        });
    }
}

3. 项目的配置文件介绍

appsettings.json: 通用的配置文件，包含应用级别的静态配置选项，如数据库连接字符串（如果未抽象到环境变量），日志级别等。

{
    "Logging": {
        "LogLevel": {
            "Default": "Information",
            "Microsoft": "Warning",
            "Microsoft.Hosting.Lifetime": "Information"
        }
    },
    "AllowedHosts": "*"
}