AspNetCoreSubdomain 项目使用教程

1. 项目目录结构及介绍

AspNetCoreSubdomain/
├── src/
│   ├── Controllers/
│   ├── Models/
│   ├── Views/
│   └── Startup.cs
├── test/
│   ├── UnitTests/
│   └── IntegrationTests/
├── .gitignore
├── LICENSE
├── README.md
└── AspNetCoreSubdomain.sln

目录结构说明

• src/: 包含项目的源代码，包括控制器、模型、视图等。

  • Controllers/: 存放控制器类文件，处理HTTP请求。
  • Models/: 存放数据模型类文件，定义数据结构。
  • Views/: 存放视图文件，用于渲染HTML页面。
  • Startup.cs: 项目的启动文件，配置服务和中间件。

• test/: 包含项目的测试代码。

  • UnitTests/: 存放单元测试代码。
  • IntegrationTests/: 存放集成测试代码。

• .gitignore: Git忽略文件，指定不需要版本控制的文件和目录。

• LICENSE: 项目的开源许可证文件。

• README.md: 项目的说明文档，介绍项目的基本信息和使用方法。

• AspNetCoreSubdomain.sln: 项目的解决方案文件，用于在Visual Studio中打开项目。

2. 项目启动文件介绍

Startup.cs

Startup.cs 是 ASP.NET Core 项目的启动文件，负责配置应用程序的服务和中间件。以下是 Startup.cs 的主要内容：

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        // 添加子域名路由服务
        services.AddSubdomains();

        // 添加MVC服务
        services.AddMvc(options =>
        {
            options.EnableEndpointRouting = false;
        });
    }

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

        // 配置路由
        app.UseMvc(routes =>
        {
            var hostnames = new[] { "localhost:54575" };

            // 普通路由
            routes.MapRoute(
                name: "NormalRoute",
                template: "{controller=Home}/{action=Index}/{id?}");

            // 子域名路由
            routes.MapSubdomainRoute(
                hostnames,
                name: "SubdomainRoute",
                template: "{controller}/{action=Index}/{id?}",
                defaults: new { controller = "Home", action = "Index" });
        });
    }
}

启动文件说明

• ConfigureServices: 配置应用程序的服务，包括添加子域名路由服务和MVC服务。
• Configure: 配置应用程序的中间件，包括开发环境下的异常处理和路由配置。

3. 项目的配置文件介绍

appsettings.json

appsettings.json 是 ASP.NET Core 项目的配置文件，用于存储应用程序的配置信息。以下是一个示例配置文件：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    }
  },
  "AllowedHosts": "*",
  "Subdomains": {
    "Hostnames": [
      "localhost:54575"
    ]
  }
}

配置文件说明

• Logging: 配置日志记录的级别。
• AllowedHosts: 配置允许访问的主机名。
• Subdomains: 配置子域名的主机名列表。

通过以上配置，项目可以支持子域名路由，并根据配置文件中的主机名进行路由匹配。