IBM Support

The .NET client in WebSphere eXtreme Scale does not support the same features as the Java client

Troubleshooting


Problem

The .NET client supports different features than the Java client.

Resolving The Problem

Refer to the following table for the list of .NET client supported features in WebSphere eXtreme Scale:

The available clients are:

  • Java client
  • REST Data Service client
  • REST Gateway client
  • .NET client
Client FeatureJava Client ORBJava Client XIOREST Data
Service
REST Gateway .NET
ObjectMap APIYesYesNoYes (indirect)Yes (indirect)
ObjectQueryYesYesNA NoNo
Single partition batchYesYesNA NoYes
CRUDYesYesNA YesYes
Null ValuesYesYesNA NoYes
Generics based APIsNoNoNA NA Yes
CopyMode
CopyMode.READ_AND_COMMITYesYesNANANo
CopyMode.COMMITYesYesNANANo
CopyMode.READYesYesNANANo
CopyMode.NO_COPYYesYesNANANo
CopyMode.COPY_TO_BYTES (SerializationInfo)YesYesNANAYes
CopyMode.COPY_TO_BYTES_RAWYesYesNANANo
DataGrid APIYesYesNoNoNo
EntityManager APIYesYesYes (indirect)NoNo
Index
Client HashIndexYesYesNoNoNo
Client Inverse RangeIndex (8.6)NoYesNoNoNo
Dynamic IndexYesYesNoNoNo
GlobalHashIndex (8.6)No YesNoNoNo
Locking
Locking - NoneYesYesYesYesNo
Locking - PessimisticYesYesYesYesYes
Locking - OptimisticYesYesYesYesNo
Plug-Ins, Listeners and Extensions (Server) 3
MapSerializerPlugin plug-inYesYesNoNoNo3
ObjectTransformer plug-in (deprecated)YesYesNoNoNo3
OptimisticCallback plug-in (deprecated)YesYesNoNoNo3
MapEventListener plug-inYesYesYes4Yes4Yes3
Loader YesYesYesYesYes3
TransactionCallback plug-inYesYesYes4Yes4Yes3
ObjectGridEventListener plug-inYesYesYes4Yes4Yes3
Plug-Ins, Listeners and Extensions (Client) 3
MapSerializerPlugin plug-inYesYesNoNoNo
ObjectTransformer plug-in (deprecated)YesYesNoNoNo
OptimisticCallback plug-in (deprecated)YesYesNoNoNo
MapEventListener plug-inYesYesYesNoNo
TransactionCallback plug-inYesYesYesNoNo
ObjectGridEventListener plug-inYesYesYesNoNo
Routing
PartitionManager APIYesYesNoNo Yes
PartitionableKey (key plug-in)YesYesNoNoNo
Declaritive Partition Routing (8.6)No YesYesNoYes
Per-Container Routing (and SessionHandle)YesYesNoNoNo
Transactions
Tx - AutoCommitYesYesYesYesYes
Tx - Single partition read/writeYesYesNoNoYes
Tx - Multi-partition readYesYesNoNoNo
Tx - Multi-partition write XA (8.6) YesNoNoNo
Tx – Mult-mapYesYesYesNoNo
Client Cache (near cache)YesYesYesNoNo
Eviction - TTLYesYes Yes No No
Eviction - LRU/LFU plug-inYes Yes Yes NoNo
Eviction - CustomYes Yes Yes No No
Eviction TriggersYesYesYes NoNo
Near Cache Invalidation (8.6)NoYesYesNoNo
Security
CredentialGenerator / CredentialYesYesNoNoYes
UserPasswordCredentialGeneratorYesYesYesYesYes
WSTokenCredentialGeneratorYesYesNo NoNo
SSL/TLSYesYesYesYes Yes
Subject via SessionNoNoNoNoNo
AccessbyCreatorYesYesYesYesYes
Configuration
ClientConfiguration overrideYesYesYesNoYes
Client ObjectGrid XML overrideYesYesYesNoNo
Client Properties fileYesYesYesYes Yes
ClientProperties APIYesYesNoNoYes 1
Security Properties fileYesYesYesNoYes 2
ClientSecurityConfiguration APIYesYesNoNo No



Notes
  1. You can update or modify the SimpleClient to try the available eXtreme Scale client for .NET APIs. Locate the SimpleClient in the <installation_directory>\sample\SimpleClient in the installation directory, and load this file into Visual Studio to view the sample application that uses simple create, retrieve, update, and delete operations. Use the SimpleClient as a guide for accessing the data grid. You can modify this application or write new applications that use the eXtreme Scale for .NET client supported API set.
  2. .NET client security properties coexist with the other .NET client properties in a single client .properties file.
  3. The .NET client and REST clients do not expose any client-side plug-ins. Server-side plug-ins are supported when they don’t require any client-side plug-in counterparts. For example, an ObjectTransformer is required on both the server and client. When No is specified, the API does not support the plug-in on the server.
  4. Server-side plug-ins that are applicable to clients are instantiated by the client by default and must be added to the classpath. The REST Gateway does not currently allow an ObjectGrid client override XML file.

[{"Product":{"code":"SSTVLU","label":"WebSphere eXtreme Scale"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Not Applicable","Platform":[{"code":"PF033","label":"Windows"}],"Version":"8.6","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
15 June 2018

UID

swg21617900