Registering Classes for Portable Data Sharing
There are situations when applications form the same/different platforms are interested to share cached data among them. For this purpose, dynamic data sharing can be used. It shares the data between various versions of an object, either from the same platforms or different platforms at runtime.
Add Data Sharing Configuration
Using NCache Manager
Click on the cache name in Cache Explorer to open cache settings.
Go to the Data Sharing tab.
Click on Add Shared Types button.
Select Data Sharing Classes wizard will open.
Specify the name of data sharing type.
Click Browse to browse for required assembly (.exe, .dll or .jar file).
Selected Assembly and all its classes will appear in Loaded Classes section.
Select the required class and add it in List of selected Classes section using Add Class button.
Repeat step 5 and 6 to select jar file and java class.
Click OK after adding classes of .NET and Java.
The opened wizard will close and selected classes of both platforms will appear in Shared Types section under your given data type name.
Now map the attributes of both platforms classes. Click on the added data share type ‘Customer’, all of its attributes will be listed in Common Attributes section.
Click on a class listed under ‘Customer’ data type. Its attributes will be listed down in Selected Class Attributes section.
A drop down will appear in the Selected Class Attributes section in front of each attribute of common attributes list. If .NET class is selected, select the required Java attribute of the Java class to map it against .NET attribute. Data types of attributes to be mapped should be same or compatible. The compatible .NET and Java data types mapping tables are given below:
Important
.NET class should be mapped with Java class, not vice versa.
.NET Class (Left side) Java Class (Right side).
Do not map both classes individually, only map one class if there are two classes to be mapped.
Map all attributes using the drop down list.
Right click on the cache name in Cache Explorer and select Apply Configuration option.
Using Windows PowerShell
Add-PortableType
cmdlet enables the user to register different custom classes and different data types for data sharing
The following command configures shared types from the provided xml file.
Add-PortableType demoLocalcache -ConfigPath C:/temp/SharedTypes.xml
This command configures the objects of shared types for a cache named demoLocalCache existing on the server node ’20.200.21.95’ in the configuration file placed at the path specified.
Add-PortableType -CacheName demoLocalCache -Path C:\config.xml –Server 20.200.21.95
Import/Export Data Sharing Configuration
Export Data Share Configuration
Click on the cache name in Cache Explorer to open cache settings.
Go to the Data Sharing tab.
Click on the Export button and save the data sharing configuration in an xml file.
Provide a file name and click Save.
Import Data Share Configuration
Click on the cache name in Cache Explorer to open cache settings.
Go to the Data Sharing tab.
Click Import to get data sharing configuration from an xml file.
Browse the saved data share configuration file and click Open.
Right click on the cache name in Cache Explorer and select Apply Configuration option.
Note
You should have an exported xml file containing mapping of attributes.
Remove Classes For Portable Data Sharing
Pre-defined shared data types can be removed by the user. Following are the steps to remove pre-defined shared data types.
Using NCache Manager
Select the cache name from Cache Explorer tab.
Go to the Data Sharing tab.
The pre-defined shared data types will be visible
Click on the Remove button and then click yes to the confirmation message.
Using Windows PowerShell
Remove-PortableType
cmdlet enables the user to remove already defined shared
data types.
The following command removes defined shared types for a cache name demoClusteredCache using default port 8250.
Remove-PortableType -CacheName demoClusteredCache
This command removes defined shared types for a cache name demoClusteredCache existing on the server 20.200.21.95.
Remove-PortableType -CacheName demoCache –server 20.200.21.95