Class Codec<TFeature>Abstract

Encodes Feature instances to an arbitrary format and decodes that arbitrary format to LuciadRIA Feature instances.

A Codec is typically used by a Store to decode the server response and to encode the LuciadRIA Features so they can be sent back to the server. Consult the class documentation of the Store class for more information.

Note: most of the methods in the API are optional. The presence of such an optional method indicates support for that feature. For instance a Store which is read-only only needs a Codec which provides a decode method but does not need an encode method. It is up to the Store implementations to clearly document which methods they require to be present on the Codec.

Users of this class should always check whether such an optional method is available before calling the method, as illustrated below:

  if ( typeof codec.encode === "function" ){
    // encode method is available and can be called
    codec.encode( ... );
 }
Copy