IceRpc.Compressor 0.4.0

Compressor interceptor and middleware for IceRPC

IceRpc.Compressor provides an IceRPC interceptor and the corresponding IceRPC middleware.

The compressor interceptor allows you to compress the payloads of outgoing requests. It also decompresses the payloads of incoming responses when these payloads are compressed.

The compressor middleware allows you to compress the payloads of outgoing responses. It also decompresses the payloads of incoming requests these payloads are compressed.

Source code | Package | Example | API reference | Interceptor documentation | Middleware documentation

Sample code

// Slice definitions

module VisitorCenter

interface Greeter {
    // The compress attribute instructs the compressor interceptor or middleware (if
    // installed) to compress the payload of the outgoing request or response.
    // The compressor interceptor or middleware does not compress the payloads of Slice
    // operations without this attribute.
    [compress(Args, Return)] greet(name: string) -> string
}

// Client application

using IceRpc;
using VisitorCenter;

await using var connection = new ClientConnection(new Uri("icerpc://localhost"));

// Add the compressor interceptor to the invocation pipeline.
Pipeline pipeline = new Pipeline()
    .UseCompressor(CompressionFormat.Brotli)
    .Into(connection);

// Create the proxy using the invocation pipeline.
var greeter = new GreeterProxy(pipeline);

// The compressor interceptor compresses the request payload. It also decompresses the
// response payload (if it comes back compressed).
string greeting = await greeter.GreetAsync(Environment.UserName);

// Server application

using IceRpc;
using IceRpc.Slice;
using VisitorCenter;

// Add the compressor middleware to the dispatch pipeline.
Router router = new Router()
    .UseCompressor(CompressionFormat.Brotli);
    .Map<IGreeterService>(new Chatbot());

await using var server = new Server(router);
server.Listen();

Sample code with DI

// Slice definitions

module VisitorCenter

interface Greeter {
    // The compress attribute instructs the compressor interceptor or middleware (if
    // installed) to compress the payload of the outgoing request or response.
    // The compressor interceptor or middleware does not compress the payloads of Slice
    // operations without this attribute.
    [compress(Args, Return)] greet(name: string) -> string
}

// Client application

using IceRpc;
using IceRpc.Extensions.DependencyInjection;
using VisitorCenter;

var hostBuilder = Host.CreateDefaultBuilder(args);

hostBuilder.ConfigureServices(services =>
    services
        .AddIceRpcClientConnection(new Uri("icerpc://localhost"))
        .AddIceRpcInvoker(builder =>
            builder
                // Add the compressor interceptor to the invocation pipeline.
               .UseCompressor(CompressionFormat.Brotli)
               .Into<ClientConnection>())
        // Add an IGreeter singleton that uses the IInvoker singleton registered above.
       .AddSingleton<IGreeter>(provider => provider.CreateSliceProxy<GreeterProxy>());

using var host = hostBuilder.Build();
host.Run();

// Server application

using IceRpc;
using IceRpc.Extensions.DependencyInjection;
using IceRpc.Slice;
using VisitorCenter;

var hostBuilder = Host.CreateDefaultBuilder(args);

hostBuilder.ConfigureServices(services =>
    services
        .AddSingleton<IGreeterService, Chatbot>()
        .AddIceRpcServer(builder =>
            builder
                // Add the compressor middleware to the dispatch pipeline.
                .UseCompressor(CompressionFormat.Brotli)
                .Map<IGreeterService>()));

using var host = hostBuilder.Build();
host.Run();

Remarks

The compressor interceptor and middleware compress and decompress payloads regardless of how these payloads are encoded. They work well with Slice but don't require Slice.