Return to RelationshipKeySetter.h CVS log

Up to [NeXTSTEP 3.3 examples] / Examples / EnterpriseObjects / MasteringDetails / EOFExtensions.subproj

Annotation of Examples/EnterpriseObjects/MasteringDetails/EOFExtensions.subproj/RelationshipKeySetter.h, revision 1.1.1.1

1.1       root        1: /* RelationshipKeySetter.h created by cfeder on Tue 08-Nov-1994 */
                      2: 
                      3: #import <eoaccess/eoaccess.h>
                      4: 
                      5: @interface EOEntity (attrsNamed)
                      6: - attributesNamed:(NSArray *)names;
                      7: - createObject;
                      8: @end
                      9: 
                     10: // Extensions to EORelationship to handle assigning foreign keys in
                     11: // objects when they are newly assigned to point at one another.
                     12: // For instance, if an employee is set to point at a new department object
                     13: // [toEmpRelationship updateKeysForSourceObject:theEmp destinationObject:theNewDept]
                     14: // will change to dept_id property of theEmp to the dept_id of theNewDept
                     15: // and return the modified object (theEmp) so the caller can make sure that object
                     16: // is updated in the database.
                     17: //
                     18: // The following relationship types are handled:
                     19: //
                     20: // M     Detail   Insert rule              Delete                 Types
                     21: // PK -> PK       D->PK := M->PK           delete D               to-one
                     22: // FK -> PK       M->FK := D->PK           M->FK=NULL             to-one
                     23: // PK -> FK       D->FK := M->PK           Delete D               to-many
                     24: // Many to many   create link obj          Delete link            to-many
                     25: //
                     26: // Decoding: The first line means, when a relationship joins from the
                     27: // primary key of the master entity to the primary key of the detail,
                     28: // handle and insertion by setting the primary key of the detail to match
                     29: // the primary key of the master.
                     30: //
                     31: @interface EORelationship (setPropsInDestObject)
                     32: - (NSArray *)sourceKeys;
                     33: - (NSDictionary *)destinationValuesFromSourceObject:sourceObject;
                     34: - (void)setJoinPropertiesInDestinationObject:destination fromSourceObject:source;
                     35: - (void)setJoinPropertiesInSourceObject:source fromDestinationObject:destination;
                     36: - (BOOL)hasJoinsOnPrimaryKeyOfSourceEntity;
                     37: - (void)updateMasterObject:master withNewDestinationObject:destination;
                     38: - linkObjectForSourceObject:master destinationObject:destination;
                     39: - updateKeysForSourceObject:source destinationObject:destination;
                     40:     // Sets keys on source or destination to maintain consistency for
                     41:     // the source to now map to destination for this relationship.
                     42:     // Does not actually assign destination to ivar in source (just messes
                     43:     // with the keys).
                     44:     // Returns the modified object (source or destination). In the case of
                     45:     // a many to many returns a newly created link object.
                     46: 
                     47: - updateKeysForDeleteOfDestinationObject:destination fromSourceObject:source;
                     48:     // Sets keys on source or destination to maintain consistency for
                     49:     // a delete of the destination from the source.  Returns the object
                     50:     // modified, or a synthesized link object that must be deleted to
                     51:     // affect the delete.  The caller is responsible for updating the
                     52:     // source object, or deleting the destination or link in the database.
                     53:     //
                     54:     // This does not actually update destination to ivar in source (just messes
                     55:     // with the keys).
                     56: @end
                     57: 

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.