GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  TANGRAM::TYPE (3)

.ds Aq ’

NAME

Tangram::Type - mapping individual fields

CONTENTS

DESCRIPTION

Tangram’s persistent type system is extensible, allowing you to mount your own types and make them persistent. All you have to do is to register your type and provide mapping code. See Tangram::Type::Extending.

Tangram comes with built-in support for the following types:
<B>Simple Scalar typesB> Supported are strings, integers, real numbers and dates. More types of this ilk are easily added.

string, int, real: see Tangram::Type::Scalar

date, time, datetime, dmdatetime: see Date/Type/Date/DateTime in Tangram::Type

<B>Compound Structure typesB> perl_dump: see Tangram::Type::Dump::Perl. A perl_dump structure may contain any structure which Data::Dumper can dump successfully.

storable: see Tangram::Type::Dump::Storable. Very much like perl_dump, but implemented via the ‘Storable’ serialisation engine.

yaml: see Tangram::Type::Dump::YAML. Very much like perl_dump, but implemented via the ‘YAML’ serialisation engine. Doesn’t currently work, due to inadequacies in the current Perl YAML implementation.

<B>NEW in Tangram 2.08B>:

idbif: see Tangram::Type::Dump::Any. Like the above, but can combine multiple object properties into a single database column.

<B>‘Flat’ Array & Hash typesB> Note: these are only actually required if you need to be able to query on individual fields inside the array/hash - otherwise, the perl_dump or idbif mapping is a lot faster and more flexible.

flat_array: see Array/Scalar in Tangram::Type

flat_hash: see Hash/Scalar in Tangram::Type

<B>References to other objectsB> ref: see Tangram::Type::Ref::FromMany (implementing an <B>N to 1B> relationship, in which any object can be the referant)
<B>Sets of other objectsB> Set relationships are closest to the main type of relationship used in an RDBMS. Avid CompSci students will know that the relational database model is based heavily on ‘Set Theory’, which is a subset of a more general concept of ‘Categories’ - generic couplings of a number of classes.

In Perl space, these collections are represented via the Set::Object module. Sets may not have duplicate elements, and cannot contain undef values.

set: see Tangram::Type::Set::FromMany (implementing an unordered <B>N to NB> relationship, with all objects sharing a common base class)

iset: see Tangram::Type::Set::FromOne (implementing an unordered <B>1 to NB> relationship, with all objects sharing a common base class)

<B>Arrays of other objectsB> The addition to Sets, you can have ‘Arrays’ of objects, represented by a standard Perl array in memory. Arrays may contain undef values (in the middle of the list), and the array type may contain duplicates (ie, the same element present in seperate places in the list).

array : see Tangram::Type::Array::FromMany (implementing an ordered <B>N to NB> relationship, with all objects sharing a common base class)

iarray: see Tangram::Type::Array::FromOne (implementing an ordered <B>1 to NB> relationship, with all objects sharing a common base class)

<B>Hashes of other objectsB> Much like the Array types, the Hash types are indexed via a string value, and represented as a Perl hash in memory. These hashes may not contain undef values (those are dropped). The hash type may contain duplicate elements.

hash : see Tangram::Type::Hash::FromMany (implementing a keyed <B>N to NB> relationship, with all objects sharing a common base class)

ihash: see Tangram::Type::Hash::FromOne (implementing a keyed <B>1 to NB> relationship, with all objects sharing a common base class)

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 TANGRAM::TYPE (3) 2015-10-09

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.