Up

EORelationship

Authors

Mirko Viviani (mirko.viviani@gmail.com)
Manuel Guesdon (mguesdon@orange-concept.com)

Version: 27916

Date: 2009-02-18 15:47:26 +0100 (Mit, 18. Feb 2009)

Copyright: (C) 2000-2002,2003,2004,2005 Free Software Foundation, Inc.


Contents -

  1. Software documentation for the EORelationship class
  2. Software documentation for the EORelationship(EORelationshipEditing) category
  3. Software documentation for the EORelationship(EORelationshipPrivate2) category
  4. Software documentation for the EORelationship(EORelationshipValueMapping) category
  5. Software documentation for the EORelationship(EORelationshipXX) category
  6. EORelationship types

Software documentation for the EORelationship class

EORelationship : NSObject

Declared in:
EOAccess/EORelationship.h
Conforms to:
EOPropertyListEncoding
Description forthcoming.

Instance Variables

Method summary

relationshipWithPropertyList: owner: 

+ (id) relationshipWithPropertyList: (NSDictionary*)propertyList owner: (id)owner;
Description forthcoming.

anyInverseRelationship 

- (EORelationship*) anyInverseRelationship;
Description forthcoming.

componentRelationships 

- (NSArray*) componentRelationships;
Returns the array of relationships composing this flattend relationship. Returns nil of the reciever isn't flattend.

definition 

- (NSString*) definition;
Description forthcoming.

deleteRule 

- (EODeleteRule) deleteRule;
Description forthcoming.

destinationAttributes 

- (NSArray*) destinationAttributes;
Description forthcoming.

destinationEntity 

- (EOEntity*) destinationEntity;
Returns the relationship's destination entity (direct destination entity or destination entity of the last relationship in definition.

docComment 

- (NSString*) docComment;
Accessing documentation comments

entity 

- (EOEntity*) entity;
Returns the relationship's source entity.

hiddenInverseRelationship 

- (EORelationship*) hiddenInverseRelationship;
Description forthcoming.

inverseRelationship 

- (EORelationship*) inverseRelationship;
"Search only already created inverse relationship in destination entity relationships. Nil if none"

isBidirectional 

- (BOOL) isBidirectional;
Description forthcoming.

isCompound 

- (BOOL) isCompound;
Returns YES if the relationship have more than 1 join (i.e. join on more that one (sourceAttribute/destinationAttribute), NO otherwise (1 or less join)

isFlattened 

- (BOOL) isFlattened;
Returns YES when the relationship traverses at least two entities (exemple: aRelationship.anotherRelationship), NO otherwise.

isMandatory 

- (BOOL) isMandatory;
Description forthcoming.

isParentRelationship 

- (BOOL) isParentRelationship;
Description forthcoming.

isToMany 

- (BOOL) isToMany;
return YES if the relation if a to-many one, NO otherwise (please read books to know what to-many mean :-)

joinSemantic 

- (EOJoinSemantic) joinSemantic;
Description forthcoming.

joinSemanticString 

- (NSString*) joinSemanticString;
Description forthcoming.

joins 

- (NSArray*) joins;
Description forthcoming.

name 

- (NSString*) name;
Description forthcoming.

numberOfToManyFaultsToBatchFetch 

- (unsigned int) numberOfToManyFaultsToBatchFetch;
Description forthcoming.

ownsDestination 

- (BOOL) ownsDestination;
Description forthcoming.

propagatesPrimaryKey 

- (BOOL) propagatesPrimaryKey;
Description forthcoming.

qualifierWithSourceRow: 

- (EOQualifier*) qualifierWithSourceRow: (NSDictionary*)sourceRow;
Description forthcoming.

referencesProperty: 

- (BOOL) referencesProperty: (id)property;
Description forthcoming.

sourceAttributes 

- (NSArray*) sourceAttributes;
Description forthcoming.

userInfo 

- (NSDictionary*) userInfo;
Description forthcoming.



Instance Variables for EORelationship Class

_batchCount

@protected unsigned int _batchCount;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_componentRelationships

@protected NSMutableArray* _componentRelationships;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_definitionArray

@protected EOExpressionArray* _definitionArray;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_destination

@protected EOEntity* _destination;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_destinationAttributes

@protected NSArray* _destinationAttributes;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_destinationNames

@protected NSMutableDictionary* _destinationNames;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_docComment

@protected NSString* _docComment;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_entity

@protected EOEntity* _entity;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_flags

@protected struct ... _flags;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_hiddenInverseRelationship

@protected EORelationship* _hiddenInverseRelationship;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_internalInfo

@protected NSDictionary* _internalInfo;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_inverseRelationship

@protected EORelationship* _inverseRelationship;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_joinSemantic

@protected EOJoinSemantic _joinSemantic;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_joins

@protected NSMutableArray* _joins;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_name

@protected NSString* _name;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_qualifier

@protected EOQualifier* _qualifier;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_sourceAttributes

@protected NSArray* _sourceAttributes;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_sourceNames

@protected NSMutableDictionary* _sourceNames;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_sourceRowToForeignKeyMapping

@protected id _sourceRowToForeignKeyMapping;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_sourceToDestinationKeyMap

@protected NSDictionary* _sourceToDestinationKeyMap;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_userInfo

@protected NSDictionary* _userInfo;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.




Software documentation for the EORelationship(EORelationshipEditing) category

EORelationship(EORelationshipEditing)

Declared in:
EOAccess/EORelationship.h
Description forthcoming.
Method summary

addJoin: 

- (void) addJoin: (EOJoin*)join;
Description forthcoming.

beautifyName 

- (void) beautifyName;
Description forthcoming.

removeJoin: 

- (void) removeJoin: (EOJoin*)join;
Description forthcoming.

setDefinition: 

- (void) setDefinition: (NSString*)definition;
Description forthcoming.

setDeleteRule: 

- (void) setDeleteRule: (EODeleteRule)deleteRule;
Description forthcoming.

setDocComment: 

- (void) setDocComment: (NSString*)docComment;
Description forthcoming.

setEntity: 

- (void) setEntity: (EOEntity*)entity;

Sets the entity of the reciever.

If the receiver already has an entity assigned to it the old relationship will will be removed first.

This method is used by [EOEntity -addRelationship:] and [EOEntity -removeRelationship:] which should be used for general relationship manipulations. This method should only be useful when creating flattend relationships programmatically.


setInternalInfo: 

- (void) setInternalInfo: (NSDictionary*)dictionary;
Description forthcoming.

setIsBidirectional: 

- (void) setIsBidirectional: (BOOL)flag;
Description forthcoming.

setIsMandatory: 

- (void) setIsMandatory: (BOOL)isMandatory;
Description forthcoming.

setJoinSemantic: 

- (void) setJoinSemantic: (EOJoinSemantic)joinSemantic;
Description forthcoming.

setName: 

- (void) setName: (NSString*)name;
Description forthcoming.

setNumberOfToManyFaultsToBatchFetch: 

- (void) setNumberOfToManyFaultsToBatchFetch: (unsigned int)size;
Description forthcoming.

setOwnsDestination: 

- (void) setOwnsDestination: (BOOL)flag;
Description forthcoming.

setPropagatesPrimaryKey: 

- (void) setPropagatesPrimaryKey: (BOOL)flag;
Description forthcoming.

setToMany: 

- (void) setToMany: (BOOL)flag;
Description forthcoming.

setUserInfo: 

- (void) setUserInfo: (NSDictionary*)dictionary;
Description forthcoming.

validateName: 

- (NSException*) validateName: (NSString*)name;
Description forthcoming.

Software documentation for the EORelationship(EORelationshipPrivate2) category

EORelationship(EORelationshipPrivate2)

Declared in:
EOAccess/EORelationship.h
Description forthcoming.
Method summary

_definitionArray 

- (EOExpressionArray*) _definitionArray;
Warning the underscore at the start of the name of this method indicates that it is private, for internal use only, and you should not use the method in your code.

_deleteRuleFromString: 

- (EODeleteRule) _deleteRuleFromString: (NSString*)deleteRuleString;
Warning the underscore at the start of the name of this method indicates that it is private, for internal use only, and you should not use the method in your code.

_flushCache 

- (void) _flushCache;
Warning the underscore at the start of the name of this method indicates that it is private, for internal use only, and you should not use the method in your code.

_foreignKeyForSourceRow: 

- (EOMutableKnownKeyDictionary*) _foreignKeyForSourceRow: (NSDictionary*)row;
Warning the underscore at the start of the name of this method indicates that it is private, for internal use only, and you should not use the method in your code.
Return dictionary of key/value for destination object of source row/object

_joinsChanged 

- (void) _joinsChanged;
Warning the underscore at the start of the name of this method indicates that it is private, for internal use only, and you should not use the method in your code.

_leftSideKeyMap 

- (NSDictionary*) _leftSideKeyMap;
Warning the underscore at the start of the name of this method indicates that it is private, for internal use only, and you should not use the method in your code.

_rightSideKeyMap 

- (NSDictionary*) _rightSideKeyMap;
Warning the underscore at the start of the name of this method indicates that it is private, for internal use only, and you should not use the method in your code.

_sourceAttributeNames 

- (NSArray*) _sourceAttributeNames;
Warning the underscore at the start of the name of this method indicates that it is private, for internal use only, and you should not use the method in your code.

_sourceRowToForeignKeyMapping 

- (EOMKKDSubsetMapping*) _sourceRowToForeignKeyMapping;
Warning the underscore at the start of the name of this method indicates that it is private, for internal use only, and you should not use the method in your code.

_stringFromDeleteRule: 

- (NSString*) _stringFromDeleteRule: (EODeleteRule)deleteRule;
Warning the underscore at the start of the name of this method indicates that it is private, for internal use only, and you should not use the method in your code.

_substitutionRelationshipForRow: 

- (EORelationship*) _substitutionRelationshipForRow: (NSDictionary*)row;
Warning the underscore at the start of the name of this method indicates that it is private, for internal use only, and you should not use the method in your code.

auxiliaryQualifier 

- (id) auxiliaryQualifier;
Description forthcoming.

isPropagatesPrimaryKeyPossible 

- (BOOL) isPropagatesPrimaryKeyPossible;
Description forthcoming.

joinForAttribute: 

- (EOJoin*) joinForAttribute: (EOAttribute*)attribute;
Description forthcoming.

qualifierOmittingAuxiliaryQualifierWithSourceRow: 

- (id) qualifierOmittingAuxiliaryQualifierWithSourceRow: (id)param0;
Description forthcoming.

setAuxiliaryQualifier: 

- (void) setAuxiliaryQualifier: (id)param0;
Description forthcoming.

Software documentation for the EORelationship(EORelationshipValueMapping) category

EORelationship(EORelationshipValueMapping)

Declared in:
EOAccess/EORelationship.h
Description forthcoming.
Method summary

validateValue: 

- (NSException*) validateValue: (id*)valueP;
If the reciever is a manditory relationship, this method returns an exception if the value pointed to by VALUEP is either nil or the EONull instance for to-one relationships or an empty NSArray for to-many relationships. Otherwise it returns nil. EOClassDescription adds further information to this exception before it gets passed to the application or user.

Software documentation for the EORelationship(EORelationshipXX) category

EORelationship(EORelationshipXX)

Declared in:
EOAccess/EORelationship.h
Description forthcoming.
Method summary

_intermediateAttributes 

- (NSArray*) _intermediateAttributes;
Warning the underscore at the start of the name of this method indicates that it is private, for internal use only, and you should not use the method in your code.

_setSourceToDestinationKeyMap: 

- (void) _setSourceToDestinationKeyMap: (id)param0;
Warning the underscore at the start of the name of this method indicates that it is private, for internal use only, and you should not use the method in your code.

_sourceToDestinationKeyMap 

- (NSDictionary*) _sourceToDestinationKeyMap;
Warning the underscore at the start of the name of this method indicates that it is private, for internal use only, and you should not use the method in your code.

firstRelationship 

- (EORelationship*) firstRelationship;
Return the 1st relationship if self is flattened, self otherwise.

foreignKeyInDestination 

- (BOOL) foreignKeyInDestination;
Description forthcoming.

intermediateEntity 

- (EOEntity*) intermediateEntity;
Description forthcoming.

isMultiHop 

- (BOOL) isMultiHop;
Description forthcoming.

isToManyToOne 

- (BOOL) isToManyToOne;
Description forthcoming.

lastRelationship 

- (EORelationship*) lastRelationship;
Return the last relationship if self is flattened, self otherwise.

primaryKeyForTargetRowFromSourceDBSnapshot: 

- (id) primaryKeyForTargetRowFromSourceDBSnapshot: (id)param0;
Description forthcoming.

qualifierForDBSnapshot: 

- (id) qualifierForDBSnapshot: (id)param0;
Description forthcoming.

relationshipPath 

- (NSString*) relationshipPath;
Return relationship path (like toRel1.toRel2) if self is flattened, slef name otherwise.

EORelationship types

EOJoinSemantic

typedef enum ... EOJoinSemantic;
Description forthcoming.


Up