Put/Get/Remove Example

The native client release contains an example written for .NET showing how a client application can establish a connection to a cluster and then use that connection to perform basic operations on a remote server. The example is located in ../examples/dotnet/putgetremove.

The example performs a sequence of operations, displaying simple log entries as they run.

  • To run the example, follow the instructions in the README.md file in the example directory.
  • Review the source code in the example directory to see exactly how it operates.

  • Begin by running a script that sets up the server-side environment by invoking gfsh commands to create a region, simply called “example_userinfo.”

  • Run the example client application, which performs the following steps:

    • Connects to the server
    • Performs region put operations using key/value pairs
    • Uses region get to retrieve the values
    • Uses region remove to remove the values

Put/Get/Remove Example Code

This section contains code snippets showing highlights of the .NET put/get/remove example. They are not intended for cut-and-paste execution. For the complete source, see the example source directory.

The .NET example creates a cache, then uses it to create a connection pool and a region object (of class IRegion).

   var cacheFactory = new CacheFactory()
       .Set("log-level", "none");
   var cache = cacheFactory.Create();

   var poolFactory = cache.GetPoolFactory()
       .AddLocator("localhost", 10334);

   var regionFactory = cache.CreateRegionFactory(RegionShortcut.PROXY)
   var region = regionFactory.Create<string, string("example_userinfo");

After declaring some keys and values, the client then populates the data store with two key/value pairs.

      region.Put(rtimmonsKey, rtimmonsValue);
      region.Put(scharlesKey, scharlesValue);

Next, the application retrieves the stored values using Get operations.

      var user1 = region.Get(rtimmonsKey, null);
      var user2 = region.Get(scharlesKey, null);

Finally, the application deletes one of the stored values using the Remove method.

      if (region.Remove(rtimmonsKey))
        Console.WriteLine("Info for " + rtimmonsKey + " has been deleted");
        Console.WriteLine("Info for " + rtimmonsKey + " has not been deleted");