er.extensions.eof

Class ERXCustomObject

java.lang.Object

com.webobjects.eocontrol.EOCustomObject

er.extensions.eof.ERXCustomObject

All Implemented Interfaces:

_EOPrivateMemento, EODeferredFaulting, EOEnterpriseObject, EOFaulting, EOKeyValueCoding, EOKeyValueCoding._BestBindingCreation._ForwardingBindingCheck, EOKeyValueCoding._KeyBindingCreation, EOKeyValueCodingAdditions, EORelationshipManipulation, EOValidation, NSKeyValueCoding, NSKeyValueCoding._KeyBindingCreation, NSKeyValueCoding._ReflectionKeyBindingCreation.Callback, NSKeyValueCoding.ErrorHandling, NSKeyValueCodingAdditions, NSValidation, ERXEnterpriseObject, ERXGeneratesPrimaryKeyInterface, ERXGuardedObjectInterface, Serializable

public class ERXCustomObject
extends EOCustomObject
implements ERXGuardedObjectInterface, ERXGeneratesPrimaryKeyInterface, ERXEnterpriseObject

This class contains a bunch of extensions to the regular EOCustomObject class. Of notable interest it contains built in support for generating primary keys via the ERXGeneratesPrimaryKeyInterface, support for an augmented transaction methods like willUpdate and didDelete and a bunch of handy utility methods like committedSnapshotValueForKey . At the moment it is required that those wishing to take advantage of templatized and localized validation exceptions need to subclass this class. Hopefully in the future we can get rid of this requirement. Also, this class supports auto-updating of inverse relationships. You can simply call eo.setFoo(other), eo.takeValueForKey(other), eo.addObjectToBothSidesOfRelationshipWithKey(other, "foo") or eo.addToFoos(other) and the inverse relationship will get updated for you automagically, so that you don't need to call other.addToBars(eo) or other.setBar(eo). Doing so doesn't hurt, though. Giving a null value of removing the object from a to-many will result in the inverse relationship getting cleared.

This feature should greatly help readability and reduce the number errors you make when you forget to update an inverse relationship. To turn this feature on, you must set the system default er.extensions.ERXEnterpriseObject.updateInverseRelationships=true.

See Also:

Serialized Form

Properties

Name	Description
er.extensions.ERXCustomObject.shouldTrimSpaces	er.extensions.ERXCustomObject.shouldTrimSpaces

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ERXCustomObject.ERXCustomObjectClazz<T extends EOEnterpriseObject> Clazz object implementation for ERXCustomObject.

Nested classes/interfaces inherited from class com.webobjects.eocontrol.EOCustomObject

EOCustomObject._BooleanFieldBinding, EOCustomObject._FieldBinding, EOCustomObject._LazyFieldBinding, EOCustomObject._NumberFieldBinding

Nested classes/interfaces inherited from interface er.extensions.eof.ERXEnterpriseObject

ERXEnterpriseObject.Observer, ERXEnterpriseObject.Processor

Nested classes/interfaces inherited from interface com.webobjects.eocontrol.EOKeyValueCodingAdditions

EOKeyValueCodingAdditions.DefaultImplementation, EOKeyValueCodingAdditions.Utility

Nested classes/interfaces inherited from interface com.webobjects.eocontrol.EOKeyValueCoding

EOKeyValueCoding._BestBindingCreation, EOKeyValueCoding._KeyBindingCreation, EOKeyValueCoding._StoredForwardingBinding

Nested classes/interfaces inherited from interface com.webobjects.foundation.NSKeyValueCoding

NSKeyValueCoding._BooleanFieldBinding, NSKeyValueCoding._BooleanMethodBinding, NSKeyValueCoding._FieldBinding, NSKeyValueCoding._ForwardingBinding, NSKeyValueCoding._KeyBinding, NSKeyValueCoding._MethodBinding, NSKeyValueCoding._NumberFieldBinding, NSKeyValueCoding._NumberMethodBinding, NSKeyValueCoding._ReflectionKeyBindingCreation, NSKeyValueCoding.ErrorHandling, NSKeyValueCoding.MapImplementation, NSKeyValueCoding.Null<T>, NSKeyValueCoding.UnknownKeyException, NSKeyValueCoding.ValueAccessor

Nested classes/interfaces inherited from interface com.webobjects.foundation.NSValidation

NSValidation._MethodBinding, NSValidation._ValidationBinding, NSValidation.ValidationException

Nested classes/interfaces inherited from interface com.webobjects.eocontrol._EOPrivateMemento

_EOPrivateMemento.DefaultImplementation

Field Summary

Fields

Modifier and Type	Field and Description
protected String	_primaryKey
String	insertionStackTrace
protected boolean	wasInitialized

Fields inherited from class com.webobjects.eocontrol.EOCustomObject

__readOnly, _CLASS

Fields inherited from interface er.extensions.eof.ERXEnterpriseObject

applyRestrictingQualifierOnInsert, DidDeleteProcessor, DidInsertProcessor, DidRevertProcessor, DidUpdateProcessor, FlushCachesProcessor, insertionTrackingLog, KEY_MARKER, log, logMod, tranLogDidDelete, tranLogDidInsert, tranLogDidRevert, tranLogDidUpdate, tranLogMightDelete, tranLogWillDelete, tranLogWillInsert, tranLogWillRevert, tranLogWillUpdate, validation, validationException, WillDeleteProcessor, WillInsertProcessor, WillRevertProcessor, WillUpdateProcessor

Fields inherited from interface com.webobjects.eocontrol.EOEnterpriseObject

_CLASS

Fields inherited from interface com.webobjects.foundation.NSKeyValueCodingAdditions

_KeyPathSeparatorChar, KeyPathSeparator

Fields inherited from interface com.webobjects.foundation.NSKeyValueCoding

NullValue

Constructor Summary

Constructors

Constructor and Description
ERXCustomObject()

Method Summary

Modifier and Type	Method and Description
boolean	_setUpdateInverseRelationships(boolean newValue) Toggles whether or not inverse relationships should be updates.
void	addObjectsToBothSidesOfRelationshipWithKey(NSArray objects, String key) Adds a collection of objects to a given relationship by calling addObjectToBothSidesOfRelationshipWithKey for all objects in the collection.
void	addObjectToBothSidesOfRelationshipWithKey(EORelationshipManipulation eo, String key) Adds a check to make sure that both the object being added and this object are in the same editing context.
void	awakeFromClientUpdate(EOEditingContext editingContext) Checks the editing context delegate before calling super's implementation.
void	awakeFromFetch(EOEditingContext editingContext) Checks the editing context delegate before calling super's implementation.
void	awakeFromInsertion(EOEditingContext editingContext) Checks the editing context delegate before calling super's implementation.
boolean	canDelete() Implementation of ERXGuardedObjectInterface.
boolean	canUpdate() Implementation of ERXGuardedObjectInterface.
NSDictionary	changesFromCommittedSnapshot() Computes the current set of changes that this object has from the currently committed snapshot.
Object	committedSnapshotValueForKey(String key) Determines what the value of the given key is in the committed snapshot
void	delete() Implementation of ERXGuardedObjectInterface.
void	didDelete(EOEditingContext ec) Called on the object after is has been deleted.
void	didInsert() Called on the object after is has successfully been inserted into the database.
void	didRevert(EOEditingContext ec) Called on the object after it has been reverted.
void	didUpdate() Called on the object after is has successfully been updated in the database.
String	encryptedPrimaryKey() Takes the primary key of the object and encrypts it with the blowfish cipher using ERXCrypto.
protected void	excludeObjectFromPropertyWithKey(Object o, String key) Overridden to support two-way relationship setting.
void	flushCaches() This is called when an object has had changes merged into it by the editing context.
Object	foreignKeyForRelationshipWithKey(String rel) Returns the foreign key for a given relationship.
org.apache.log4j.Logger	getClassLog() This methods checks if we already have created an Logger for this class If not, one will be created, stored and returned on next request.
protected void	includeObjectIntoPropertyWithKey(Object o, String key) Overridden to support two-way relationship setting.
protected void	init(EOEditingContext ec) used for initialization stuff instead of awakeFromInsertion.
boolean	isDeletedEO() Determines if this object is a deleted object by checking to see if it is included in the deletedObjects array of the editing context or - if it's editing context is null - it already has a global id.
boolean	isNewObject() Determines if this object is a new object and hasn't been saved to the database yet.
EOEnterpriseObject	localInstanceIn(EOEditingContext ec) Returns this EO in the supplied editing context.
EOEnterpriseObject	localInstanceOf(EOEnterpriseObject eo) Returns an EO in the same editing context as the caller.
NSArray	localInstancesOf(NSArray eos) Returns an array of EOs in the same editing context as the caller.
void	mightDelete() Called as part of the augmented transaction process.
boolean	parentObjectStoreIsObjectStoreCoordinator() Simple method that will return if the parent object store of this object's editing context is an instance of EOObjectStoreCoordinator.
String	primaryKey() Primary key of the object as a String.
NSArray	primaryKeyAttributeNames() Returns the names of all primary key attributes.
String	primaryKeyInTransaction() Calling this method will return the primary key of the given enterprise object or if one has not been assigned to it yet, then it will have the adaptor channel generate one for it, cache it and then use that primary key when it is saved to the database.
Object	rawPrimaryKey() Gives the raw primary key of the object.
NSDictionary<String,Object>	rawPrimaryKeyDictionary(boolean inTransaction) Implementation of the interface ERXGeneratesPrimaryKeyInterface.
Object	rawPrimaryKeyInTransaction() Calling this method will return the primary key of the given enterprise object or if one has not been assigned to it yet, then it will have the adaptor channel generate one for it, cache it and then use that primary key when it is saved to the database.
ERXEnterpriseObject	refetchObjectFromDBinEditingContext(EOEditingContext ec) Method that will make sure to fetch an eo from the Database and place it in the editingContext provided as an argument
void	removeObjectsFromBothSidesOfRelationshipWithKey(NSArray objects, String key) Removes a collection of objects to a given relationship by calling removeObjectFromBothSidesOfRelationshipWithKey for all objects in the collection.
void	removeObjectsFromPropertyWithKey(NSArray objects, String key) Removes a collection of objects to a given relationship by calling removeObjectFromPropertyWithKey for all objects in the collection.
ERXEnterpriseObject	self() self is useful for D2W purposes
static boolean	shouldTrimSpaces()
void	takeStoredValueForKey(Object value, String key)
void	takeValueForKey(Object value, String key)
String	toLongString() Returns the super classes implementation of toString which prints out the current key-value pairs for all of the attributes and relationships for the current object.
String	toString() Overrides the EOGenericRecord's implementation to provide a slightly less verbose output.
void	trimSpaces() This method will trim the leading and trailing white space from any attributes that are mapped to a String object.
static boolean	usesDeferredFaultCreation()
void	validateForDelete() Calls up validateForUpdate() on the class description if it supports it.
void	validateForInsert() Calls up validateForInsert() on the class description if it supports it.
void	validateForSave() This method performs a few checks before invoking super's implementation.
void	validateForUpdate() Calls up validateForUpdate() on the class description if it supports it.
Object	validateValueForKey(Object value, String key) Overrides the default validation mechanisms to provide a few checks before invoking super's implementation, which incidently just invokes validateValueForKey on the object's class description.
void	willDelete() Called as part of the augmented transaction process.
void	willInsert() Called as part of the augmented transaction process.
void	willRevert() Called on the object before it will be reverted.
void	willUpdate() Called as part of the augmented transaction process.

Methods inherited from class com.webobjects.eocontrol.EOCustomObject

__classDescription, __clearPendingChanges, __editingContext, __globalID, __hasAuxillaryObservers, __hasPendingChanges, __hasPendingUpdate, __isInitialized, __isPendingDeletion, __isPendingInsertion, __isShared, __lastSnapshot, __originalSnapshot, __retainCount, __setAuxillaryObservers, __setClassDescription, __setEditingContext, __setGlobalID, __setInitialized, __setLastSnapshot, __setOriginalSnapshot, __setPendingDeletion, __setPendingInsertion, __setPendingUpdate, __setRetainCount, __setShared, _createKeyGetBindingForKey, _createKeySetBindingForKey, _createStoredKeyGetBindingForKey, _createStoredKeySetBindingForKey, _fieldKeyBinding, _forwardingBindingNeededForClass, _keyGetBindingForKey, _keySetBindingForKey, _methodKeyGetBinding, _methodKeySetBinding, _otherStorageBinding, _storedKeyGetBindingForKey, _storedKeySetBindingForKey, addObjectToPropertyWithKey, allPropertyKeys, attributeKeys, canAccessFieldsDirectly, changesFromSnapshot, classDescription, classDescriptionForDestinationKey, clearFault, clearProperties, deleteRuleForRelationshipKey, editingContext, entityName, eoDescription, eoShallowDescription, equals, faultHandler, handleQueryWithUnboundKey, handleTakeValueForUnboundKey, hashCode, inverseForRelationshipKey, invokeRemoteMethod, isFault, isReadOnly, isToManyKey, opaqueState, ownsDestinationObjectsForRelationshipKey, prepareValuesForClient, propagateDeleteWithEditingContext, readResolve, reapplyChangesFromDictionary, removeObjectFromBothSidesOfRelationshipWithKey, removeObjectFromPropertyWithKey, shouldUseStoredAccessors, snapshot, storedValueForKey, takeValueForKeyPath, takeValuesFromDictionary, takeValuesFromDictionaryWithMapping, toManyRelationshipKeys, toOneRelationshipKeys, turnIntoFault, unableToSetNullForKey, updateFromSnapshot, userPresentableDescription, validateClientUpdate, validateTakeValueForKeyPath, valueForKey, valueForKeyPath, valuesForKeys, valuesForKeysWithMapping, willChange, willRead, willReadRelationship

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.webobjects.eocontrol.EOEnterpriseObject

allPropertyKeys, attributeKeys, changesFromSnapshot, classDescription, classDescriptionForDestinationKey, clearProperties, deleteRuleForRelationshipKey, editingContext, entityName, eoDescription, eoShallowDescription, inverseForRelationshipKey, invokeRemoteMethod, isReadOnly, isToManyKey, opaqueState, ownsDestinationObjectsForRelationshipKey, prepareValuesForClient, propagateDeleteWithEditingContext, reapplyChangesFromDictionary, snapshot, toManyRelationshipKeys, toOneRelationshipKeys, updateFromSnapshot, userPresentableDescription, willChange

Methods inherited from interface com.webobjects.eocontrol.EOKeyValueCodingAdditions

takeValuesFromDictionary, takeValuesFromDictionaryWithMapping, valuesForKeys, valuesForKeysWithMapping

Methods inherited from interface com.webobjects.foundation.NSKeyValueCodingAdditions

takeValueForKeyPath, valueForKeyPath

Methods inherited from interface com.webobjects.eocontrol.EOKeyValueCoding

storedValueForKey

Methods inherited from interface com.webobjects.foundation.NSKeyValueCoding

valueForKey

Methods inherited from interface com.webobjects.foundation.NSKeyValueCoding.ErrorHandling

handleQueryWithUnboundKey, handleTakeValueForUnboundKey, unableToSetNullForKey

Methods inherited from interface com.webobjects.eocontrol.EORelationshipManipulation

addObjectToPropertyWithKey, removeObjectFromBothSidesOfRelationshipWithKey, removeObjectFromPropertyWithKey

Methods inherited from interface com.webobjects.eocontrol.EOValidation

validateClientUpdate

Methods inherited from interface com.webobjects.foundation.NSValidation

validateTakeValueForKeyPath

Methods inherited from interface com.webobjects.eocontrol.EODeferredFaulting

willReadRelationship

Methods inherited from interface com.webobjects.eocontrol.EOFaulting

clearFault, faultHandler, isFault, turnIntoFault, willRead

Field Detail

insertionStackTrace

public String insertionStackTrace

wasInitialized

protected boolean wasInitialized

_primaryKey

protected String _primaryKey

Constructor Detail

ERXCustomObject

public ERXCustomObject()

Method Detail

shouldTrimSpaces

public static boolean shouldTrimSpaces()

_setUpdateInverseRelationships

public boolean _setUpdateInverseRelationships(boolean newValue)

Description copied from interface: ERXEnterpriseObject

Toggles whether or not inverse relationships should be updates. This is called by ERXGenericRecord.InverseRelationshipUpdater to prevent infinite loops and should not be called by anything else unless you know exactly what you are doing.

Specified by:

_setUpdateInverseRelationships in interface ERXEnterpriseObject

Parameters:

newValue - whether or not inverse relationships should be updated

Returns:

the previous setting of the updateInverseRelationships setting

getClassLog

public org.apache.log4j.Logger getClassLog()

Description copied from interface: ERXEnterpriseObject

This methods checks if we already have created an Logger for this class If not, one will be created, stored and returned on next request. This method eliminates individual static variables for Logger's in all subclasses. We use an NSDictionary here because static fields are class specific and thus something like lazy initialization would not work in this case.

Specified by:

getClassLog in interface ERXEnterpriseObject

Returns:

an Logger for this objects class

self

public ERXEnterpriseObject self()

Description copied from interface: ERXEnterpriseObject

self is useful for D2W purposes

Specified by:

self in interface ERXEnterpriseObject

Returns:

the EO itself

canDelete

public boolean canDelete()

Implementation of ERXGuardedObjectInterface. This is checked before the object is deleted in the willDelete method which is in turn called by ERXEditingContextDelegate. The default implementation returns true.

Specified by:

canDelete in interface ERXGuardedObjectInterface

Returns:

true

canUpdate

public boolean canUpdate()

Implementation of ERXGuardedObjectInterface. This is checked before the object is deleted in the willUpdate method which is in turn called by ERXEditingContextDelegate. The default implementation returns true.

Specified by:

canUpdate in interface ERXGuardedObjectInterface

Returns:

true

delete

public void delete()

Implementation of ERXGuardedObjectInterface. This is used to work around a bug in EOF that doesn't refresh the relationship in the parent editingContext for the object.

Specified by:

delete in interface ERXGuardedObjectInterface

mightDelete

public void mightDelete()

Description copied from interface: ERXEnterpriseObject

Called as part of the augmented transaction process. This method is called when deleteObject() is called on the editing context. The benefit over willDelete() is that in this method, the relationships are still intact. Mostly, at least, as it's also called when the deletes cascade.

Specified by:

mightDelete in interface ERXEnterpriseObject

willDelete

public void willDelete()
                throws NSValidation.ValidationException

Description copied from interface: ERXEnterpriseObject

Called as part of the augmented transaction process. This method is called after saveChanges is called on the editing context, but before the object is actually deleted from the database. This method is also called before validateForDelete is called on this object. This method is called by the editing context delegate ERXDefaultEditingContextDelegate.

Specified by:

willDelete in interface ERXEnterpriseObject

Throws:

NSValidation.ValidationException - to stop the object from being deleted.

willInsert

public void willInsert()

Description copied from interface: ERXEnterpriseObject

Called as part of the augmented transaction process. This method is called after saveChanges is called on the editing context, but before the object is actually inserted into the database. This method is also called before validateForInsert is called on this object. This method is called by the editing context delegate ERXDefaultEditingContextDelegate.

Specified by:

willInsert in interface ERXEnterpriseObject

willUpdate

public void willUpdate()

Description copied from interface: ERXEnterpriseObject

Called as part of the augmented transaction process. This method is called after saveChanges is called on the editing context, but before the object is actually updated in the database. This method is also called before validateForSave is called on this object. This method is called by the editing context delegate ERXDefaultEditingContextDelegate.

Specified by:

willUpdate in interface ERXEnterpriseObject

flushCaches

public void flushCaches()

Description copied from interface: ERXEnterpriseObject

This is called when an object has had changes merged into it by the editing context. This is called by ERXDefaultEditingContextDelegate after it merges changes. Any caches that an object keeps based on any of it's values it should flush. The default implementation of this method does nothing.

Specified by:

flushCaches in interface ERXEnterpriseObject

didDelete

public void didDelete(EOEditingContext ec)

Description copied from interface: ERXEnterpriseObject

Called on the object after is has been deleted. The editing context is passed to the object since by this point the editingContext of the object is null. You should check if the ec is a child context when doing something here that can't be undone.

Specified by:

didDelete in interface ERXEnterpriseObject

Parameters:

ec - editing context that used to be associated with the object.

didUpdate

public void didUpdate()

Description copied from interface: ERXEnterpriseObject

Called on the object after is has successfully been updated in the database.

Specified by:

didUpdate in interface ERXEnterpriseObject

didInsert

public void didInsert()

Description copied from interface: ERXEnterpriseObject

Called on the object after is has successfully been inserted into the database.

Specified by:

didInsert in interface ERXEnterpriseObject

willRevert

public void willRevert()

Description copied from interface: ERXEnterpriseObject

Called on the object before it will be reverted. Default implementation does nothing other than log.

Specified by:

willRevert in interface ERXEnterpriseObject

didRevert

public void didRevert(EOEditingContext ec)

Description copied from interface: ERXEnterpriseObject

Called on the object after it has been reverted. The editing context is passed to the object because if the object was in the insertedObjects list before the revert, the object has had its editingContext nulled. Default implementation calls flushCaches.

Specified by:

didRevert in interface ERXEnterpriseObject

Parameters:

ec - editing context that is either currently associated with the object if the object was marked as changed or deleted before the revert, otherwise the editing context that was associated with the object before the revert.

addObjectsToBothSidesOfRelationshipWithKey

public void addObjectsToBothSidesOfRelationshipWithKey(NSArray objects,
                                                       String key)

Description copied from interface: ERXEnterpriseObject

Adds a collection of objects to a given relationship by calling addObjectToBothSidesOfRelationshipWithKey for all objects in the collection.

Specified by:

addObjectsToBothSidesOfRelationshipWithKey in interface ERXEnterpriseObject

Parameters:

objects - objects to add to both sides of the given relationship

key - relationship key

removeObjectsFromBothSidesOfRelationshipWithKey

public void removeObjectsFromBothSidesOfRelationshipWithKey(NSArray objects,
                                                            String key)

Description copied from interface: ERXEnterpriseObject

Removes a collection of objects to a given relationship by calling removeObjectFromBothSidesOfRelationshipWithKey for all objects in the collection.

Specified by:

removeObjectsFromBothSidesOfRelationshipWithKey in interface ERXEnterpriseObject

Parameters:

objects - objects to be removed from both sides of the given relationship

key - relationship key

removeObjectsFromPropertyWithKey

public void removeObjectsFromPropertyWithKey(NSArray objects,
                                             String key)

Description copied from interface: ERXEnterpriseObject

Removes a collection of objects to a given relationship by calling removeObjectFromPropertyWithKey for all objects in the collection.

Specified by:

removeObjectsFromPropertyWithKey in interface ERXEnterpriseObject

Parameters:

objects - objects to be removed from both sides of the given relationship

key - relationship key

awakeFromClientUpdate

public void awakeFromClientUpdate(EOEditingContext editingContext)

Checks the editing context delegate before calling super's implementation. See the method _checkEditingContextDelegate for an explanation as to what this check does.

Specified by:

awakeFromClientUpdate in interface EOEnterpriseObject

Overrides:

awakeFromClientUpdate in class EOCustomObject

Parameters:

editingContext - to be checked to make sure it has the correct type of delegate set.

awakeFromInsertion

public void awakeFromInsertion(EOEditingContext editingContext)

Checks the editing context delegate before calling super's implementation. See the method _checkEditingContextDelegate for an explanation as to what this check does.

Specified by:

awakeFromInsertion in interface EOEnterpriseObject

Overrides:

awakeFromInsertion in class EOCustomObject

Parameters:

editingContext - to be checked to make sure it has the correct type of delegate set.

init

protected void init(EOEditingContext ec)

used for initialization stuff instead of awakeFromInsertion. awakeFromInsertions is buggy because if an EO is deleted and then its EOEditingContext is reverted using 'revert' for example then EOF will -insert- this EO again in its EOEditingContext which in turn calls awakeFromInsertion again.

Parameters:

ec - the EOEditingContext in which this new EO is inserted

awakeFromFetch

public void awakeFromFetch(EOEditingContext editingContext)

Checks the editing context delegate before calling super's implementation. See the method _checkEditingContextDelegate for an explanation as to what this check does.

Specified by:

awakeFromFetch in interface EOEnterpriseObject

Overrides:

awakeFromFetch in class EOCustomObject

Parameters:

editingContext - to be checked to make sure it has the correct type of delegate set.

addObjectToBothSidesOfRelationshipWithKey

public void addObjectToBothSidesOfRelationshipWithKey(EORelationshipManipulation eo,
                                                      String key)

Adds a check to make sure that both the object being added and this object are in the same editing context. If not then a runtime exception is thrown instead of getting the somewhat cryptic NSInternalInconsistency excpetion that is thrown when you attempt to save changes to the database.

Specified by:

addObjectToBothSidesOfRelationshipWithKey in interface EORelationshipManipulation

Overrides:

addObjectToBothSidesOfRelationshipWithKey in class EOCustomObject

Parameters:

eo - enterprise object to be added to the relationship

key - relationship to add the object to.

primaryKey

public String primaryKey()

Description copied from interface: ERXEnterpriseObject

Primary key of the object as a String.

Specified by:

primaryKey in interface ERXEnterpriseObject

Returns:

primary key for the given object as a String

rawPrimaryKeyInTransaction

public Object rawPrimaryKeyInTransaction()

Description copied from interface: ERXEnterpriseObject

Calling this method will return the primary key of the given enterprise object or if one has not been assigned to it yet, then it will have the adaptor channel generate one for it, cache it and then use that primary key when it is saved to the database. If you just want the primary key of the object or null if it doesn't have one yet, use the method rawPrimaryKey.

Specified by:

rawPrimaryKeyInTransaction in interface ERXEnterpriseObject

Returns:

the primary key of this object.

primaryKeyInTransaction

public String primaryKeyInTransaction()

Description copied from interface: ERXEnterpriseObject

Calling this method will return the primary key of the given enterprise object or if one has not been assigned to it yet, then it will have the adaptor channel generate one for it, cache it and then use that primary key when it is saved to the database. This method returns the string representation of the primary key. If you just want the primary key of the object or null if it doesn't have one yet, use the method primaryKey.

Specified by:

primaryKeyInTransaction in interface ERXEnterpriseObject

Returns:

string representation of the primary key of this object.

rawPrimaryKey

public Object rawPrimaryKey()

Description copied from interface: ERXEnterpriseObject

Gives the raw primary key of the object. This could be anything from an NSData to a BigDecimal.

Specified by:

rawPrimaryKey in interface ERXEnterpriseObject

Returns:

the raw primary key of this object.

encryptedPrimaryKey

public String encryptedPrimaryKey()

Description copied from interface: ERXEnterpriseObject

Takes the primary key of the object and encrypts it with the blowfish cipher using ERXCrypto.

Specified by:

encryptedPrimaryKey in interface ERXEnterpriseObject

Returns:

blowfish encrypted primary key

foreignKeyForRelationshipWithKey

public Object foreignKeyForRelationshipWithKey(String rel)

Description copied from interface: ERXEnterpriseObject

Returns the foreign key for a given relationship.

Specified by:

foreignKeyForRelationshipWithKey in interface ERXEnterpriseObject

Parameters:

rel - relationship key

Returns:

foreign key for a given relationship.

primaryKeyAttributeNames

public NSArray primaryKeyAttributeNames()

Description copied from interface: ERXEnterpriseObject

Returns the names of all primary key attributes.

Specified by:

primaryKeyAttributeNames in interface ERXEnterpriseObject

Returns:

list of attribute names

rawPrimaryKeyDictionary

public NSDictionary<String,Object> rawPrimaryKeyDictionary(boolean inTransaction)

Implementation of the interface ERXGeneratesPrimaryKeyInterface. This implementation operates in the following fashion. If it is called passing in 'false' and it has not yet been saved to the database, meaning this object does not yet have a primary key assigned, then it will have the adaptor channel generate a primary key for it. Then when the object is saved to the database it will use the previously generated primary key instead of having the adaptor channel generate another primary key. If 'true' is passed in then this method will either return the previously generated primaryKey dictionary or null if it does not have one. Typically you should only call this method with the 'false' parameter seeing as unless you are doing something really funky you won't be dealing with this object when it is in the middle of a transaction. The delegate ERXDatabaseContextDelegate is the only class that should be calling this method and passing in 'true'.

Specified by:

rawPrimaryKeyDictionary in interface ERXGeneratesPrimaryKeyInterface

Parameters:

inTransaction - boolean flag to tell the object if it is currently in the middle of a transaction.

Returns:

primary key dictionary for the current object, if the object does not have a primary key assigned yet and is not in the middle of a transaction then a new primary key dictionary is created, cached and returned.

committedSnapshotValueForKey

public Object committedSnapshotValueForKey(String key)

Description copied from interface: ERXEnterpriseObject

Determines what the value of the given key is in the committed snapshot

Specified by:

committedSnapshotValueForKey in interface ERXEnterpriseObject

Parameters:

key - to be checked in committed snapshot

Returns:

the committed snapshot value for the given key

localInstanceOf

public EOEnterpriseObject localInstanceOf(EOEnterpriseObject eo)

Description copied from interface: ERXEnterpriseObject

Returns an EO in the same editing context as the caller.

Specified by:

localInstanceOf in interface ERXEnterpriseObject

Parameters:

eo - to local instance

Returns:

an EO in the same editing context as the caller.

localInstanceIn

public EOEnterpriseObject localInstanceIn(EOEditingContext ec)

Description copied from interface: ERXEnterpriseObject

Returns this EO in the supplied editing context.

Specified by:

localInstanceIn in interface ERXEnterpriseObject

Parameters:

ec - editing context to local instance in

Returns:

this EO in the supplied editing context.

localInstancesOf

public NSArray localInstancesOf(NSArray eos)

Description copied from interface: ERXEnterpriseObject

Returns an array of EOs in the same editing context as the caller.

Specified by:

localInstancesOf in interface ERXEnterpriseObject

Parameters:

eos - array of EOs to local instance

Returns:

array of EOs in the same editing context as the caller.

changesFromCommittedSnapshot

public NSDictionary changesFromCommittedSnapshot()

Description copied from interface: ERXEnterpriseObject

Computes the current set of changes that this object has from the currently committed snapshot.

Specified by:

changesFromCommittedSnapshot in interface ERXEnterpriseObject

Returns:

a dictionary holding the changed values from the currently committed snapshot.

parentObjectStoreIsObjectStoreCoordinator

public boolean parentObjectStoreIsObjectStoreCoordinator()

Description copied from interface: ERXEnterpriseObject

Simple method that will return if the parent object store of this object's editing context is an instance of EOObjectStoreCoordinator. The reason this is important is because if this condition evaluates to true then when changes are saved in this editing context they will be propagated to the database.

Specified by:

parentObjectStoreIsObjectStoreCoordinator in interface ERXEnterpriseObject

Returns:

if the parent object store of this object's editing context is an EOObjectStoreCoordinator.

refetchObjectFromDBinEditingContext

public ERXEnterpriseObject refetchObjectFromDBinEditingContext(EOEditingContext ec)

Description copied from interface: ERXEnterpriseObject

Method that will make sure to fetch an eo from the Database and place it in the editingContext provided as an argument

Specified by:

refetchObjectFromDBinEditingContext in interface ERXEnterpriseObject

Parameters:

ec - the editing context in which the result will be placed

Returns:

fresh instance of an EO fetched from the DB and placed in the editing context argument

toString

public String toString()

Overrides the EOGenericRecord's implementation to provide a slightly less verbose output. A typical output for an object mapped to the class com.foo.User with a primary key of 50 would look like: <com.foo.User pk:"50"> EOGenericRecord's implementation is preserved in the method toLongString. To restore the original verbose logging in your subclasses override this method and return toLongString.

Overrides:

toString in class EOCustomObject

Returns:

much less verbose description of an enterprise object.

toLongString

public String toLongString()

Description copied from interface: ERXEnterpriseObject

Returns the super classes implementation of toString which prints out the current key-value pairs for all of the attributes and relationships for the current object. Very verbose.

Specified by:

toLongString in interface ERXEnterpriseObject

Returns:

super's implementation of toString.

trimSpaces

public void trimSpaces()

Description copied from interface: ERXEnterpriseObject

This method will trim the leading and trailing white space from any attributes that are mapped to a String object. This method is called before the object is saved to the database. Override this method to do nothing if you wish to preserve your leading and trailing white space.

Specified by:

trimSpaces in interface ERXEnterpriseObject

isDeletedEO

public boolean isDeletedEO()

Description copied from interface: ERXEnterpriseObject

Determines if this object is a deleted object by checking to see if it is included in the deletedObjects array of the editing context or - if it's editing context is null - it already has a global id.

Specified by:

isDeletedEO in interface ERXEnterpriseObject

Returns:

if the object is a deleted object

isNewObject

public boolean isNewObject()

Description copied from interface: ERXEnterpriseObject

Determines if this object is a new object and hasn't been saved to the database yet. This method just calls the method ERExtensions.isNewObject passing in this object as the current parameter. Note that an object that has been successfully deleted will also look as if it is a new object because it will have a null editing context.

Specified by:

isNewObject in interface ERXEnterpriseObject

Returns:

if the object is a new enterprise object.

validateValueForKey

public Object validateValueForKey(Object value,
                                  String key)
                           throws NSValidation.ValidationException

Overrides the default validation mechanisms to provide a few checks before invoking super's implementation, which incidently just invokes validateValueForKey on the object's class description. The class description for this object should be an ERXEntityClassDescription or subclass. It is that class that provides the hooks to convert model throw validation exceptions into ERXValidationException objects.

Specified by:

validateValueForKey in interface NSValidation

Overrides:

validateValueForKey in class EOCustomObject

Parameters:

value - to be validated for a given attribute or relationship

key - corresponding to an attribute or relationship

Returns:

the validated value

Throws:

NSValidation.ValidationException - if the value fails validation

validateForSave

public void validateForSave()
                     throws NSValidation.ValidationException

This method performs a few checks before invoking super's implementation.

Specified by:

validateForSave in interface EOValidation

Overrides:

validateForSave in class EOCustomObject

Throws:

NSValidation.ValidationException - if the object does not pass validation for saving to the database.

validateForInsert

public void validateForInsert()
                       throws NSValidation.ValidationException

Calls up validateForInsert() on the class description if it supports it.

Specified by:

validateForInsert in interface EOValidation

Overrides:

validateForInsert in class EOCustomObject

Throws:

NSValidation.ValidationException - if the object does not pass validation for saving to the database.

validateForUpdate

public void validateForUpdate()
                       throws NSValidation.ValidationException

Calls up validateForUpdate() on the class description if it supports it.

Specified by:

validateForUpdate in interface EOValidation

Overrides:

validateForUpdate in class EOCustomObject

Throws:

NSValidation.ValidationException - if the object does not pass validation for saving to the database.

validateForDelete

public void validateForDelete()
                       throws NSValidation.ValidationException

Calls up validateForUpdate() on the class description if it supports it.

Specified by:

validateForDelete in interface EOValidation

Overrides:

validateForDelete in class EOCustomObject

Throws:

NSValidation.ValidationException - if the object does not pass validation for saving to the database.

includeObjectIntoPropertyWithKey

protected void includeObjectIntoPropertyWithKey(Object o,
                                                String key)

Overridden to support two-way relationship setting.

Overrides:

includeObjectIntoPropertyWithKey in class EOCustomObject

excludeObjectFromPropertyWithKey

protected void excludeObjectFromPropertyWithKey(Object o,
                                                String key)

Overridden to support two-way relationship setting.

Overrides:

excludeObjectFromPropertyWithKey in class EOCustomObject

takeValueForKey

public void takeValueForKey(Object value,
                            String key)

Specified by:

takeValueForKey in interface NSKeyValueCoding

Overrides:

takeValueForKey in class EOCustomObject

takeStoredValueForKey

public void takeStoredValueForKey(Object value,
                                  String key)

Specified by:

takeStoredValueForKey in interface EOKeyValueCoding

Overrides:

takeStoredValueForKey in class EOCustomObject

usesDeferredFaultCreation

public static boolean usesDeferredFaultCreation()