ASP.NET Core 真实世界示例应用教程

本教程旨在指导您了解并操作gothinkster/aspnetcore-realworld-example-app，这是一个遵循RealWorld规范的ASP.NET Core后端实现。此项目展示了如何在.NET Core生态系统中构建一个完整的全栈应用程序，包括CRUD操作、认证、路由、分页等功能，并采用了业界最佳实践。

1. 项目目录结构及介绍

ASP.NET Core项目通常具有清晰的组织结构，本项目也不例外：

• src: 核心源代码存放目录。
  • Application: 包含业务逻辑层，如命令处理（CQRS中的Command）和查询（Query）相关类。
  • Domain: 定义领域模型和实体。
  • Features: 按功能模块划分的目录，每个子目录代表一个特定的功能或用例，比如Article、Auth等，体现了垂直切片架构。
  • Infrastructure: 提供基础设施服务，如数据库上下文（Entity Framework Core）、依赖项（例如MediatR的中间件）、映射器配置（AutoMapper）等。
  • Presentation: 控制器和其他Web呈现相关的组件，负责HTTP请求的响应。
  • Startup.cs: 应用程序的入口点，配置IoC容器、中间件、服务等。
• test: 单元测试和集成测试目录，用于确保代码质量。
• obj: 编译过程中产生的中间文件。
• Properties: 项目属性文件，如AssemblyInfo.cs（虽然在较新版本的.NET Core中可能不常用）。
• .csproj: 项目文件，定义了项目的编译设置和依赖关系。

2. 项目的启动文件介绍

Startup.cs是应用程序初始化的核心，它负责以下关键任务：

• ConfigureServices(IServiceCollection services) 方法中注册所有必要的服务，包括数据库上下文（使用Entity Framework Core）、MediatR（用于命令与查询分离）、依赖注入的服务实例等。
• Configure(IApplicationBuilder app, IWebHostEnvironment env) 设置中间件管道，决定请求如何被处理。这里包括添加跨域支持、使用Swagger进行API文档化、以及路由到控制器等配置。

3. 项目的配置文件介绍

ASP.NET Core应用通常使用多种配置来源，包括JSON文件、环境变量和命令行参数。在这个项目中，主要关注的是appsettings.json文件：

• appsettings.json: 默认配置文件，包含了数据库连接字符串、服务配置等基本设置。

  {
    "ConnectionStrings": {
      "DefaultConnection": "DataSource=your-sqlite.db;Version=3;"
    },
    // 其他配置项...
  }
  

• appsettings.Development.json, appsettings.Production.json: 环境特定配置，允许在开发和生产环境中有不同的设置。

环境变量也常用来动态配置敏感信息，如数据库密码，这在实际部署中更为安全。

通过仔细阅读和理解这些关键文件，您可以更深入地掌握此项目的工作原理，进而定制或扩展其功能。记得调整配置以适应您的开发环境，并利用.NET Core提供的灵活性来优化应用部署和运行时配置。