Azure Url Shortener 项目教程

1. 项目的目录结构及介绍

AzUrlShortener/
├── .github/
│   └── workflows/
├── AzUrlShortener/
│   ├── Functions/
│   │   ├── CreateShortUrl.cs
│   │   ├── GetShortUrl.cs
│   │   ├── RedirectShortUrl.cs
│   │   └── ...
│   ├── Models/
│   │   ├── ShortUrl.cs
│   │   └── ...
│   ├── Services/
│   │   ├── IShortUrlService.cs
│   │   ├── ShortUrlService.cs
│   │   └── ...
│   ├── Startup.cs
│   └── ...
├── TinyBlazorAdmin/
│   ├── Pages/
│   │   ├── CreateShortUrl.razor
│   │   ├── ManageShortUrls.razor
│   │   └── ...
│   ├── Shared/
│   │   ├── MainLayout.razor
│   │   └── ...
│   ├── wwwroot/
│   │   ├── css/
│   │   ├── js/
│   │   └── ...
│   ├── App.razor
│   ├── Program.cs
│   └── ...
├── .gitignore
├── LICENSE
├── README.md
└── ...

目录结构介绍

• .github/workflows/: 包含GitHub Actions的工作流配置文件，用于自动化部署和测试。
• AzUrlShortener/: 核心项目目录，包含Azure Functions的实现、模型和服务。
  • Functions/: 包含处理短链接创建、获取和重定向的Azure Functions。
  • Models/: 包含项目中使用的数据模型，如ShortUrl。
  • Services/: 包含服务接口和实现，如IShortUrlService和ShortUrlService。
  • Startup.cs: 项目的启动文件，负责配置依赖注入和服务初始化。
• TinyBlazorAdmin/: 轻量级前端管理界面，使用Blazor框架构建。
  • Pages/: 包含前端页面的Razor组件，如创建短链接和管理短链接的页面。
  • Shared/: 包含共享的Razor组件，如布局组件。
  • wwwroot/: 包含静态资源，如CSS、JavaScript文件。
  • App.razor: Blazor应用的根组件。
  • Program.cs: 前端应用的启动文件。
• .gitignore: Git忽略文件配置。
• LICENSE: 项目许可证文件。
• README.md: 项目说明文档。

2. 项目的启动文件介绍

AzUrlShortener/Startup.cs

Startup.cs 是Azure Functions项目的启动文件，负责配置依赖注入和服务初始化。以下是文件的主要内容：

public class Startup : FunctionsStartup
{
    public override void Configure(IFunctionsHostBuilder builder)
    {
        builder.Services.AddSingleton<IShortUrlService, ShortUrlService>();
        builder.Services.AddSingleton<IConfiguration>(Configuration);
    }

    public override void ConfigureAppConfiguration(IFunctionsConfigurationBuilder builder)
    {
        var context = builder.GetContext();
        builder.ConfigurationBuilder
            .AddJsonFile(Path.Combine(context.ApplicationRootPath, "appsettings.json"), optional: true, reloadOnChange: false)
            .AddEnvironmentVariables();
    }
}

TinyBlazorAdmin/Program.cs

Program.cs 是Blazor前端应用的启动文件，负责配置和启动Blazor应用。以下是文件的主要内容：

public class Program
{
    public static async Task Main(string[] args)
    {
        var builder = WebAssemblyHostBuilder.CreateDefault(args);
        builder.RootComponents.Add<App>("#app");

        builder.Services.AddScoped(sp => new HttpClient { BaseAddress = new Uri(builder.HostEnvironment.BaseAddress) });

        await builder.Build().RunAsync();
    }
}

3. 项目的配置文件介绍

AzUrlShortener/appsettings.json

appsettings.json 是Azure Functions项目的配置文件，包含应用的配置项。以下是文件的主要内容：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    }
  },
  "ConnectionStrings": {
    "CosmosDB": "AccountEndpoint=https://your-cosmosdb-account.documents.azure.com:443/;AccountKey=your-account-key;"
  },
  "AllowedHosts": "*"
}

TinyBlazorAdmin/wwwroot/appsettings.json

wwwroot/appsettings.json 是Blazor前端应用的配置文件，包含应用的配置项。以下是文件的主要内容：

{
  "ApiBaseUrl": "https://your-api-base-url.com",
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    }
  }
}

以上是Azure Url Shortener项目的目录结构、启动文件和配置文件的详细介绍。通过这些内容，您可以更好地理解和使用该项目。