Hot Rod .NET/C# clients allow C# runtime applications to connect and interact with remote Infinispan clusters.

1. Installing and configuring the Hot Rod .NET/C# client

Install the Hot Rod .NET/C# client on Microsoft Windows systems where you use .NET Framework to interact with Infinispan clusters via the RemoteCache API.

1.1. Installing Hot Rod .NET/C# clients

Infinispan provides an installation package to install the Hot Rod .NET/C# client on Windows.

Prerequisites
  • Any operating system on which Microsoft supports the .NET Framework

  • .NET Framework 4.6.2 or later

  • Windows Visual Studio 2015 or later

Procedure
  1. Download the installation package for the Hot Rod .NET/C# from the Hot Rod client downloads.

  2. Launch the MSI installer for the Hot Rod .NET/C# client and follow the interactive wizard through the installation process.

1.2. Configuration and Remote Cache Manager APIs

Use the ConfigurationBuilder API to configure Hot Rod .NET/C# client connections and the RemoteCacheManager API to obtain and configure remote caches.

Configuration builder
using Infinispan.HotRod;
using Infinispan.HotRod.Config;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
namespace simpleapp
{
    class Program
    {
        static void Main(string[] args)
        {
            ConfigurationBuilder builder = new ConfigurationBuilder();
            // Connect to a server at localhost with the default port.
            builder.AddServer()
                .Host(args.Length > 1 ? args[0] : "127.0.0.1")
                .Port(args.Length > 2 ? int.Parse(args[1]) : 11222);
            Configuration config = builder.Build();
            // Create and start a RemoteCacheManager to interact with caches.
            RemoteCacheManager remoteManager = new RemoteCacheManager(conf);
            remoteManager.Start();
            IRemoteCache<string,string> cache=remoteManager.GetCache<string, string>();
            cache.Put("key", "value");
            Console.WriteLine("key = {0}", cache.Get("key"));
            remoteManager.Stop();
        }
    }
}
Cross-site replication
ConfigurationBuilder builder = new ConfigurationBuilder();
  builder.AddServer().Host("127.0.0.1").Port(11222);
  // Configure a remote cluster and node when using cross-site replication.
  builder.AddCluster("nyc").AddClusterNode("192.0.2.0", 11322);
Near caching
ConfigurationBuilder builder = new ConfigurationBuilder();
  builder.AddServer().Host("127.0.0.1").Port(11222);
  // Enable near-caching for the client.
  builder.NearCache().Mode(NearCacheMode.INVALIDATED).MaxEntries(10);