IceRpc.Ice 0.6.0

IceRPC + Ice integration

The IceRPC framework provides extensive interop support for the Ice RPC framework through:

• an implementation of the ice protocol, provided by the IceRpc NuGet package
• integration code between the IceRPC core APIs and code generated by Ice's Slice compiler (this package)

Package | Source code | Documentation | Examples | API reference

Sample Code

// Contract written in Ice's Slice language and saved in a `.ice` file.

module VisitorCenter
{
    /// Represents a simple greeter.
    interface Greeter
    {
        /// Creates a personalized greeting.
        /// @param name The name of the person to greet.
        /// @return The greeting.
        string greet(string name);
    }
}

// Client application

using IceRpc;
using VisitorCenter;

// Use the ice protocol for compatibility with ZeroC Ice. We use the default port for the
// ice protocol, 4061.
await using var connection = new ClientConnection(new Uri("ice://localhost"));

// The service address URI includes the protocol to use (ice).
var greeter = new GreeterProxy(connection, new Uri("ice:/greeter"));

string greeting = await greeter.GreetAsync(Environment.UserName);

Console.WriteLine(greeting);

await connection.ShutdownAsync();

// Server application

using IceRpc;
using IceRpc.Features;
using VisitorCenter;

// Use the ice protocol for compatibility with ZeroC Ice.
await using var server = new Server(new Chatbot(), new Uri("ice://[::0]"));

// Start accepting requests on the default port for the ice protocol, 4061.
server.Listen();

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

// IGreeterService is an interface generated by slice2cs (Ice's Slice compiler for C#).
// The [Service] attribute instructs the Service 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}!");
    }
}