IceRpc.Slice 0.1.0

IceRPC + Slice integration

The IceRPC framework allows you to make RPCs with the serialization format and IDL of your choice.

The IceRpc.Slice assembly is part of the IceRPC + Slice integration: it helps the Slice compiler for C# implement Slice interfaces and operations for use with IceRPC.

Package | Source code | Documentation | Examples | API reference

Sample Code

// Slice contract

module VisitorCenter

/// Represents a simple greeter.
interface Greeter {
    /// Creates a personalized greeting.
    /// @param name: The name of the person to greet.
    /// @returns: The greeting.
    greet(name: string) -> string
}

// Client application

using IceRpc;
using VisitorCenter;

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

// GreeterProxy is a struct generated by the Slice compiler; its implementation uses IceRpc.Slice.
var greeterProxy = new GreeterProxy(connection);
string greeting = await greeterProxy.GreetAsync(Environment.UserName);

Console.WriteLine(greeting);

await connection.ShutdownAsync();

// Server application

using IceRpc;
using IceRpc.Features;
using IceRpc.Slice;
using VisitorCenter;

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

// Wait until the console receives a Ctrl+C.
await CancelKeyPressed;
await server.ShutdownAsync();

// Class IceRpc.Slice.Service is an IceRPC dispatcher. This dispatch is implemented by Chatbot and helper code provided
// by the IGreeterService interface generated by the Slice compiler.
internal class Chatbot : Service, IGreeterService
{
    public ValueTask<string> GreetAsync(
        string name,
        IFeatureCollection features,
        CancellationToken cancellationToken)
    {
        Console.WriteLine($"Dispatching greet request {{ name = '{name}' }}");
        return new($"Hello, {name}!");
    }
}