IceRpc.Compressor 0.3.1

The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org. Prefix Reserved
dotnet add package IceRpc.Compressor --version 0.3.1
NuGet\Install-Package IceRpc.Compressor -Version 0.3.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="IceRpc.Compressor" Version="0.3.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add IceRpc.Compressor --version 0.3.1
#r "nuget: IceRpc.Compressor, 0.3.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install IceRpc.Compressor as a Cake Addin
#addin nuget:?package=IceRpc.Compressor&version=0.3.1

// Install IceRpc.Compressor as a Cake Tool
#tool nuget:?package=IceRpc.Compressor&version=0.3.1

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.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
0.3.1 81 3/28/2024
0.3.0 167 2/14/2024
0.2.1 186 12/12/2023
0.2.0 105 12/4/2023
0.1.2 107 10/9/2023
0.1.1 108 9/18/2023
0.1.0 115 9/6/2023