Ocelot 开源项目使用教程

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

Ocelot 是一个基于 ASP.NET Core 的 API 网关项目，其目录结构清晰，便于理解和使用。以下是主要的目录结构及其介绍：

Ocelot/
├── src/
│   ├── Ocelot/
│   │   ├── Configuration/
│   │   ├── DownstreamRouteFinder/
│   │   ├── Errors/
│   │   ├── Logging/
│   │   ├── Middleware/
│   │   ├── Multiplexer/
│   │   ├── RateLimit/
│   │   ├── Requester/
│   │   ├── ResponseProcessor/
│   │   ├── Security/
│   │   ├── Swagger/
│   │   ├── Utilities/
│   │   ├── OcelotBuilder.cs
│   │   ├── OcelotMiddlewareExtensions.cs
│   │   ├── OcelotPipelineConfiguration.cs
│   │   ├── OcelotPipelineExtensions.cs
│   │   ├── OcelotOptions.cs
│   │   ├── OcelotRequestDelegateFactory.cs
│   │   ├── OcelotServiceCollectionExtensions.cs
│   │   ├── Program.cs
│   │   ├── Startup.cs
│   ├── Ocelot.Administration/
│   ├── Ocelot.Cache.CacheManager/
│   ├── Ocelot.Cache.Microsoft/
│   ├── Ocelot.DependencyInjection/
│   ├── Ocelot.Provider.Eureka/
│   ├── Ocelot.Provider.Polly/
│   ├── Ocelot.Requester.Middleware/
│   ├── Ocelot.Tracing.Butterfly/
│   ├── Ocelot.Tracing.OpenTracing/
├── test/
│   ├── Ocelot.AcceptanceTests/
│   ├── Ocelot.UnitTests/
├── README.md
├── LICENSE
├── .gitignore

主要目录介绍：

• src/Ocelot/: 核心代码目录，包含配置、路由、中间件、限流、请求处理等多个模块。
• src/Ocelot.Administration/: 管理模块，提供管理接口。
• src/Ocelot.Cache.CacheManager/ 和 src/Ocelot.Cache.Microsoft/: 缓存实现模块。
• src/Ocelot.DependencyInjection/: 依赖注入模块。
• src/Ocelot.Provider.Eureka/ 和 src/Ocelot.Provider.Polly/: 服务发现和熔断器提供者。
• src/Ocelot.Requester.Middleware/: 请求中间件。
• src/Ocelot.Tracing.Butterfly/ 和 src/Ocelot.Tracing.OpenTracing/: 分布式追踪模块。
• test/: 测试代码目录，包含单元测试和验收测试。

2. 项目的启动文件介绍

Ocelot 项目的启动文件主要位于 src/Ocelot/ 目录下，包括 Program.cs 和 Startup.cs。

Program.cs

Program.cs 文件是 ASP.NET Core 应用程序的入口点，负责配置和启动 Web 主机。

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

Startup.cs 文件负责配置应用程序的服务和请求处理管道。

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddOcelot();
    }

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

        app.UseRouting();

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

        app.UseOcelot().Wait();
    }
}

3. 项目的配置文件介绍

Ocelot 的配置文件通常是一个 JSON 文件，名为 ocelot.json，位于项目的根目录或配置目录中。

ocelot.json