Veil Serialisation Functions

With modern web-based applications, database connections are often pooled, with each connection representing many different users. In order to reduce the overhead of connection functions for such applications, Veil provides a serialisation API. This allows session variables for a connected user to be saved for subsequent re-use. This is particularly effective in combination with pgmemcache http://pgfoundry.org/projects/pgmemcache/

Only session variables may be serialised.

The following functions comprise the Veil serialisatation API:

veil_serialise(text)

function veil_serialise(text) returns text
This creates a serialised textual representation of the named session variable. The results of this function may be concatenated into a single string, which can be deserialised in a single call to veil_deserialise()

veil_deserialise(text)

function veil_deserialise(text) returns text
This takes a serialised representation of one or more variables as created by concatenating the results of veil_serialise(), and de-serialises them, creating new variables as needed and resetting their values to those they had when they were serialised.

veil_serialize(text)

function veil_serialize(text) returns text
Synonym for veil_serialise()

veil_deserialize(text)

function veil_deserialize(text) returns text
Synonym for veil_deserialise()

Next: Veil Control Functions


Generated on Fri Mar 12 08:38:46 2010 for Veil by  doxygen 1.5.6