Return to ValidatingDelegate.h CVS log

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

Annotation of Examples/EnterpriseObjects/Validation/Validation.subproj/ValidatingDelegate.h, revision 1.1

1.1     ! root        1: #import <eointerface/eointerface.h>
        !             2: 
        !             3: @interface ValidatingDelegate : Object
        !             4: {
        !             5:     BOOL validatesImmediately;   // validate when change is made, or only when they 
        !             6:                                  // try to save?
        !             7: }
        !             8: 
        !             9: - (void)setValidatesImmediately:(BOOL)yn;
        !            10: - (BOOL)validatesImmediately;
        !            11:     // retuns whether the delegate will perform validation checks on user changes
        !            12:     // on a per-field basis.  If not, check are performed before insert/update/delete.
        !            13: 
        !            14: - (NSDictionary *)controller:(EOController *)controller willSaveEdits: (NSDictionary *)edits toObject:object;
        !            15:     // to perform validation on changes to objects as they are made.
        !            16: 
        !            17: - (EODataSourceOperationDelegateResponse)controller:(EOController *)controller
        !            18:     willInsertObject:object
        !            19:     inDataSource:dataSource;
        !            20:     // Used to ask object if it's ready to be inserted.
        !            21:     // By default we will try to validate all of its properties.
        !            22: 
        !            23: - (EODataSourceOperationDelegateResponse)controller:(EOController *)controller
        !            24:     willUpdateObject:object
        !            25:     inDataSource:dataSource;
        !            26:     // Used to ask object if it's ready to be updated.
        !            27:     // By default we will try to validate all of its properties.
        !            28: 
        !            29: - (EODataSourceOperationDelegateResponse)controller:(EOController *)controller
        !            30:     willDeleteObject:object
        !            31:     inDataSource:dataSource;
        !            32:     // to ask object if it can be deleted.
        !            33: 
        !            34: - (void)reportValidationErrors:(NSDictionary *)errors forObject:object
        !            35:                   inController:(EOController *)controller;
        !            36:     // Called by delegate to report validate error.  Default implementation displays
        !            37:     // a panel.  Subclassers may want to update a status line in the window, or
        !            38:     // just beep.
        !            39: @end
        !            40: 
        !            41: 
        !            42: @interface NSObject (ValidationProtocols)
        !            43: // An EO can implement some or all of these methods to play a roll in its validation
        !            44: - (NSArray *)keysToValidate;
        !            45:     // Return list of property names that must be valid before object can be
        !            46:     // inserted or updated.  Default implementation returns an empty array.
        !            47:     // Better implementations might scan the runtime information in the
        !            48:     // receiver for methods of the form validateXXXX:.
        !            49:     // For EOs that keep a pointer to their entity (provided in
        !            50:     // initWithPrimaryKey:entity) this method could return the classPropertyNames.
        !            51: 
        !            52: - (NSDictionary *)validForDataSource:(id <EODataSources>)dataSource;
        !            53:     // should return nil if object is valid for insert and update,
        !            54:     // or a dictionary of key/error message pair describing the problem if not.
        !            55:     // The default implementation returns
        !            56:     // [self validateValuesInDictionary:[self valuesForKeys:[self keysToValidate]]]
        !            57: - (NSDictionary *)validForInsertInDataSource:(id <EODataSources>)dataSource;
        !            58:     // should return nil if object is valid for insert, or a dictionary of key/error message
        !            59:     // pair describing the problem if not.  The default implementation calls
        !            60:     // [self validForDataSource:dataSource]
        !            61: 
        !            62: - (NSDictionary *)validForUpdateInDataSource:(id <EODataSources>)dataSource;
        !            63:     // should return nil if object is valid for update, or a dictionary of key/error message
        !            64:     // pair describing the problem if not.  The default implementation calls
        !            65:     // [self validForDataSource:dataSource]
        !            66: 
        !            67: - (NSDictionary *)validForDeleteInDataSource:(id <EODataSources>)dataSource;
        !            68:     // should return nil if object is valid for insert, or a dictionary of key/error message
        !            69:     // pair describing the problem if not.  The default implementation returns nil.
        !            70: @end

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