bazaar.assoc.AssociationReferenceProxy

Package bazaar :: Module assoc :: Class AssociationReferenceProxy

[show private | hide private]

Class AssociationReferenceProxy

object --+
         |
        AssociationReferenceProxy

Known Subclasses:: List, OneToOne

Association reference proxy class for application objects.

Reference proxy allows to get (upon foreign key value of object's column) and set (upon primary key value of referenced object) reference to other application object (referenced object).

There should be one reference proxy object per association between application classes.

It is allowed to set reference to:

application object with primary key
application object without primary key (object is not completed nor stored in database)
None (NULL) value

When referenced object has no primary key, then reference proxy buffers the object as value with reference buffer.

Application class attribute col defines parameters of association.

Method Summary
	`__init__(self, col, ref_buf)` Create association reference proxy.
	`save(self, obj, value)` Assign referenced object.
	`saveForeignKey(self, obj, vkey)` Abstract method to save referenced object's primary key value.
Inherited from object
	`__delattr__(...)` x.__delattr__('name') <==> del x.name
	`__getattribute__(...)` x.__getattribute__('name') <==> x.name
	`__hash__(x)` x.__hash__() <==> hash(x)
	`__reduce__(...)` helper for pickle
	`__reduce_ex__(...)` helper for pickle
	`__repr__(x)` x.__repr__() <==> repr(x)
	`__setattr__(...)` x.__setattr__('name', value) <==> x.name = value
	`__str__(x)` x.__str__() <==> str(x)
Inherited from type
	`__new__(T, S, ...)` T.__new__(S, ...) -> a new object with type S, a subtype of T

Instance Variable Summary
	`association`: Referenced class' association object of bi-directional association.
	`broker`: Broker of application class.
	`col`: Application object's class attribute.
	`vbroker`: Broker of referenced application objects' class.

Method Details

init(self, col, ref_buf=None)
(Constructor)

Create association reference proxy.

Brokers are not initialized with the constructor. Instead, they are set when Bazaar layer is started up.

Parameters:: col - Application object's class attribute.

Overrides:: __builtin__.object.__init__

save(self, obj, value)

Assign referenced object.

If primary key value of referenced object is not defined, then it is stored in reference buffer, otherwise it's set with saveForeignKey method.

Parameters:: obj - Application object.; value - Referenced object.

saveForeignKey(self, obj, vkey)

Abstract method to save referenced object's primary key value.

Parameters:: obj - Application object.; vkey - Referenced object primary key value.

Instance Variable Details

association

Referenced class' association object of bi-directional association.

broker

Broker of application class.

col

Application object's class attribute.

vbroker

Broker of referenced application objects' class.

Generated by Epydoc 2.0 on Sun May 23 19:11:16 2004

http://epydoc.sf.net