MAN page from OpenSuSE perl-OpenXPKI-Core-0.9.1389-6.362.CS.i586.rpm

OpenXPKI::Serialization::Simple

Section: User Contributed Perl Documentation (3)
Updated: 2008-09-30
Index

Name

Description

Really simple serialization class for scalars, arrays and hashes.This is a platform neutral example implementation. It mainlydemonstrates the interface and can easily be ported to otherscripting languages.

Functions

new

Initializes the object.

serialize

Returns the serialization of data passed as argument.

deserialize

Returns the deserialization of data passed as argument.

Internal Functions

Serialization

__write_data

This function returns the serialization of data passed as argument by calling one or more of the following functions. Each of those functions serializes a specific data type according to the syntax (see below). An exception is thrown if the data type cannot be recognized.

__write_scalar

__write_array

__write_hash

__write_undef

Deserialization

__read_data

This function returns the deserialization of data passed as argument by calling one or more of the following functions. Each of those functions deserializes a specific data type according to the syntax (see below). An exception is thrown if the data type cannot be recognized.

Basically, the deserialization works as follows: While scalars and undefs are easily deserialized upon recognition, it's a bit more tricky with arrays and hashes. Since they can possibly contain more (complex) data, each of the functions below returns two values: ``$data'' holds the deserialized data, and ``$returnmessage'' returns the (serialized) string that was used to deserialize the data. The latter value is important to keep track of which part of the serialized string has already been deserialized.

__read_scalar

__read_array

__read_hash

__read_undef

Syntax

We support scalars, array references and hash references in any combination. The syntax is the following one:

scalar ::= 'SCALAR'.SEPARATOR.
[0-9]+.SEPARATOR. /* length of data */
data.SEPARATOR

array ::= 'ARRAY'.SEPARATOR.
[0-9]+.SEPARATOR. /* length of array data */
array_element+

array_element ::= [0-9]+.SEPARATOR. /* position in the array */
(hash|array|scalar)

hash ::= 'HASH'.SEPARATOR.
[0-9]+.SEPARATOR. /* length of hash data */
hash_element+

hash_element ::= [1-9][0-9]*.SEPARATOR. /* length of the hash key */
[a-zA-Z0-9_]+.SEPARATOR. /* the hash key */
(hash|array|undef|scalar)

undef ::= 'UNDEF'.SEPARATOR.

The SEPARATOR is one character long. It can be any non number.The default separator is newline. The important thing isthat you can parse every structure without knowing the usedSEPARATOR.

Perhaps the good mathmatics notice that the last SEPARATORin the definition of a scalar is not necessary. This SEPARATORis only used to make the resulting structure better readablefor humans.

This document was created byman2html,using the manual pages.