You can use the .NET getting started sample application
for the following purposes:
- To verify that you have installed the WebSphere eXtreme Scale Client for .NET correctly.
- To learn how to write applications that for the .NET client that
communicate with the data grid, so you can create custom applications.
The sample demonstrates how to connect to a data grid on a remote
catalog server. The interactive mode demonstrates how to run manual
transactions using the GridMapPessimisticTx map.
The command line mode demonstrates auto-commit transactions with the GridMapPessimisticAutoTx map.
- To learn how to interoperate with the Java™ getting started sample. Both sample applications
store items in the data grid with TestKey/TestValue pairs. The .NET
sample has ClassAlias and FieldAlias attributes to create unique identifiers
for serialization and de-serialization. If an insert key operation
is run from the Java client application, the .NET client can get the
value by running a get operation on the key that was inserted.
The .NET getting started sample application has the following
limitations:
- Only pessimistic locking is supported.
- Two-phase commit operations are not supported. You can commit
operations to one partition only. If you run a commit that involves
multiple partitions, a MultiplePartitionWriteException exception results.
- The sample does not support null values. The .NET API does allow
null values, but you must use nullable types.
The SimpleClient.csproj project file
is in the net_client_home/sample/SimpleClient directory.
This project file is the client program that demonstrates how to connect
to a catalog server, obtain the ObjectGrid instance, and use the ObjectMap API.
The ObjectMap API stores data as key-value pairs
and is ideal for caching objects that have no relationships involved.
The following steps contain information about the key contents of
the SimpleClient.csproj file. You can also look
at the project file in more detail in Microsoft Visual Studio.
The tutorial
demonstrates the use of IGridMapPessimisticTx,
which is the manual transaction map that is used when the application
is run in interactive mode. If you use the application in command-line
mode, the IGridMapPessimisticAutoTx map is used.