👁 Image
IceRpc.Slice 0.6.0

IceRPC + Slice integration

The IceRPC framework allows you to make RPCs with the serialization format and IDL of your choice. It provides full support for both Slice and Protobuf.

IceRpc.Slice provides integration code between the IceRPC core APIs and code generated by the Slice compiler for C#.

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 greeter = new GreeterProxy(connection);
string greeting = await greeter.GreetAsync(Environment.UserName);

Console.WriteLine(greeting);

await connection.ShutdownAsync();

// Server application

using IceRpc;
using IceRpc.Features;
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();

// IGreeterService is an interface generated by the Slice compiler.
// The [Service] attribute instructs the Source Generator to implement IDispatcher by
// routing "greet" requests to the GreetAsync method.
[Service]
internal partial class Chatbot : IGreeterService
{
 public ValueTask<string> GreetAsync(
 string name,
 IFeatureCollection features,
 CancellationToken cancellationToken)
 {
 Console.WriteLine($"Dispatching greet request {{ name = '{name}' }}");
 return new($"Hello, {name}!");
 }
}