Geode PDX Serialization
Geode’s Portable Data eXchange (PDX) is a cross-language data format that can reduce the cost of distributing and serializing your objects. PDX stores data in named fields that you can access individually, to avoid the cost of deserializing the entire data object. PDX also allows you to mix versions of objects where you have added or removed fields.
Geode PDX Serialization Features
Geode PDX serialization offers several advantages in terms of functionality.
High Level Steps for Using PDX Serialization
To use PDX serialization, you can configure and use Geode’s reflection-based autoserializer, or you can program the serialization of your objects by using the PDX interfaces and classes.
Using Automatic Reflection-Based PDX Serialization
You can configure your cache to automatically serialize and deserialize domain objects without having to add any extra code to them.
Serializing Your Domain Object with a PdxSerializer
For a domain object that you cannot or do not want to modify, use the
PdxSerializerclass to serialize and deserialize the object’s fields. You use one
PdxSerializerimplementation for the entire cache, programming it for all of the domain objects that you handle in this way.
Implementing PdxSerializable in Your Domain Object
For a domain object with source that you can modify, implement the
PdxSerializableinterface in the object and use its methods to serialize and deserialize the object’s fields.
Programming Your Application to Use PdxInstances
PdxInstanceis a light-weight wrapper around PDX serialized bytes. It provides applications with run-time access to fields of a PDX serialized object.
Adding JSON Documents to the Geode Cache
JSONFormatterAPI allows you to put JSON formatted documents into regions and retrieve them later by storing the documents internally as PdxInstances.
Using PdxInstanceFactory to Create PdxInstances
You can use the
PdxInstanceFactoryinterface to create a
PdxInstancefrom raw data when the domain class is not available on the server.
Persisting PDX Metadata to Disk
Geode allows you to persist PDX metadata to disk and specify the disk store to use.
Using PDX Objects as Region Entry Keys
Using PDX objects as region entry keys is highly discouraged.