# Infinispan.Hotrod.Core

This package allows the user application to perform operation on a remote Infinispan cluster via the Hotrod protocol.

The main use case is the following:

1. import this package in the project description

   <Project Sdk="Microsoft.NET.Sdk">
    
     <PropertyGroup>
       <OutputType>Exe</OutputType>
       <TargetFramework>net6.0</TargetFramework>
     </PropertyGroup>
    
     <ItemGroup>
       <PackageReference Include="Infinispan.Hotrod.Core" Version="*-*" />
     </ItemGroup>
    
   </Project>

2. Create a cluster

               InfinispanDG dg = new InfinispanDG();
               // Use a non-authenticated non-encrypted cluster;
               dg.AddHost("127.0.0.1", 11222);

   The InfinispanDG class allows several cluster configuration: tls, authentication, nodes address setup, clusters for failover. See below.
3. Create a cache

               var cache = dg.NewCache<string, string>(new StringMarshaller(), new StringMarshaller(), "default");

   A Cache object allows to execute operation on remote cluster. To create a cache object a marshaller for both key and value must be provided. See Marshaller.
4. Write application code

               await cache.Put(myKey, "some value");
               string result = await cache.Get(myKey);
               Console.WriteLine("Getting my entry with key {0} from the cache. Result value is: {1}", myKey, result);

A full working example with a basic put/get session:

using System;
using System.Threading.Tasks;
using Infinispan.Hotrod.Core;
namespace Infinispan.Hotrod.Application
{
 
    class Program
    {
        static async Task Main(string[] args)
        {
            var myKey = "myKey";
            InfinispanDG dg = new InfinispanDG();
            // Use a non-authenticated non-encrypted cluster;
            dg.AddHost("127.0.0.1", 11222);
            var cache = dg.NewCache<string, string>(new StringMarshaller(), new StringMarshaller(), "default");
            await cache.Put(myKey, "some value");
            string result = await cache.Get(myKey);
            Console.WriteLine("Getting my entry with key {0} from the cache. Result value is: {1}", myKey, result);
        }
    }
}

Cluster configuration

The following are cluster wide settings.

Connection properties

• enable disable TLS (InfinispanDG.UseTLS). With or without server cert verification (InfinispanDG.CACert).
• enable disable authentication providing user/password and the SASL mechanism (InfinispanDG.User, InfinispanDG.Password, InfinispanDG.AuthMech).

Cluster topology

• add a node to the default cluster (InfinispanDG.AddHost(string, int)).
• add a node to a specific cluster for failover configuration (InfinispanDG.AddHost(string, string, int)).