WebObjects 5.2

com.webobjects.eogeneration
Class EOFormController

java.lang.Object
  |
  +--com.webobjects.eoapplication.EOController
        |
        +--com.webobjects.eoapplication.EOComponentController
              |
              +--com.webobjects.eoapplication.EOArchiveController
                    |
                    +--com.webobjects.eoapplication.EOEntityController
                          |
                          +--com.webobjects.eoapplication.EODocumentController
                                |
                                +--com.webobjects.eogeneration.EOEditingController
                                      |
                                      +--com.webobjects.eogeneration.EOFormController
All Implemented Interfaces:
EOAction.Enabling, EOAssociationConnector, EOComponentController.EndEditing, EOControllerFactory.Insert, EOControllerFactory.Open, EOControllerFactory.SelectByInserting, EODocument, EOEditable, EOModalDialogController.ModalActions, EOObjectDisplay, EOObjectDisplayDocument, EOObserving, NSDisposable, NSKeyValueCoding, NSKeyValueCoding.ErrorHandling, NSKeyValueCodingAdditions

public class EOFormController
extends EOEditingController
implements EOModalDialogController.ModalActions, EOControllerFactory.Insert, EOControllerFactory.Open, EOControllerFactory.SelectByInserting


Inner classes inherited from class com.webobjects.eoapplication.EOComponentController
EOComponentController.ActionCollector, EOComponentController.Activation, EOComponentController.EndEditing, EOComponentController.Modal, EOComponentController.ResetUserInterface
 
Inner classes inherited from class com.webobjects.eoapplication.EOController
EOController.Enumeration
 
Inner classes inherited from class com.webobjects.foundation.NSKeyValueCoding
NSKeyValueCoding.DefaultImplementation, NSKeyValueCoding.ErrorHandling, NSKeyValueCoding.Null, NSKeyValueCoding.UnknownKeyException, NSKeyValueCoding.Utility, NSKeyValueCoding.ValueAccessor
 
Inner classes inherited from class com.webobjects.foundation.NSKeyValueCodingAdditions
NSKeyValueCodingAdditions.DefaultImplementation, NSKeyValueCodingAdditions.Utility
 
Fields inherited from class com.webobjects.eoapplication.EOEntityController
NestedEditingContextProviderMethodName, NewDisplayGroupProviderMethodName, NewDisplayGroupUsingOptimisticRefreshProviderMethodName, NewEditingContextProviderMethodName
 
Fields inherited from class com.webobjects.eoapplication.EOComponentController
Bottom, BottomLeft, BottomRight, Center, Left, Right, Top, TopLeft, TopRight
 
Fields inherited from class com.webobjects.eoapplication.EOController
ControllerAndSubcontrollersEnumeration, ControllerAndSupercontrollersEnumeration, SubcontrollersEnumeration, SupercontrollersEnumeration
 
Fields inherited from interface com.webobjects.eoapplication.EOEditable
AlwaysEditable, IfSupercontrollerEditable, NeverEditable
 
Fields inherited from interface com.webobjects.foundation.NSKeyValueCoding
NullValue
 
Fields inherited from interface com.webobjects.foundation.NSKeyValueCodingAdditions
KeyPathSeparator
 
Constructor Summary
EOFormController()
           
EOFormController(EOXMLUnarchiver unarchiver)
           
 
Method Summary
 void cancel()
          The action method invoked when the user cancels the modal dialog.
 boolean canPerformActionNamed(String actionName)
          Overridden to handle editing-related action enabling and disabling.
 boolean canRevert()
          Returns whether the receiver can revert.
 boolean canSave()
          Returns whether the receiver can save.
protected  NSArray defaultActions()
          Adds actions for handling editing (like save, revert) the default actions defined by the superclass, EOEntityController (but only if the receiver is a root document controller and if it's not used in a modal dialog.
 boolean delete()
           
 void finishSelecting()
           
 boolean insert()
           
 boolean insertNewObject()
           
 boolean insertNewObjectWithRelationshipPathsFilled(NSDictionary relationshipPathToGlobalIDsMapTable)
           
 boolean insertWithTask()
           
 boolean modalDialogShouldClose()
          This method is invoked by the modal dialog controller on its subcontrollers when the user attempts to close the modal dialog with the dialog's close button (not the usual ok/cancel buttons).
 boolean ok()
          The action method invoked when the user wants to finish the modal dialog.
 void openObjectWithGlobalID(EOGlobalID globalID)
           
 boolean openWithTask()
           
 void prepareToSelectByInserting()
           
 EOGlobalID provideSelectedObjectGlobalID()
           
 boolean save()
          Saves the receiver's edits, returning whether the operation was successful.
 
Methods inherited from class com.webobjects.eogeneration.EOEditingController
connectionWasBroken, connectionWasEstablished, dispose, disposeIfTransient, entityName, fetchesOnConnect, mandatoryRelationshipPaths, masterDetailAssociation, newDisplayGroup, relationshipPath, setEntityName, setMandatoryRelationshipPaths, setMasterDetailAssociation, setRelationshipPath, toString
 
Methods inherited from class com.webobjects.eoapplication.EODocumentController
canRedo, canUndo, deleteSelectedObjects, editability, handleEditingContextNotification, insertObject, isDocumentForGlobalID, isEditable, isEdited, isRootDocumentController, prepareForNewTask, redo, revert, revertAndMakeInvisible, revertChanges, revertFailed, saveAndMakeInvisible, saveChanges, saveFailed, saveIfUserConfirms, saveIfUserConfirms, saveIfUserConfirmsAndMakeInvisible, saveIfUserConfirmsAndMakeInvisible, setEditability, setEdited, supercontrollerEditabilityDidChange, takeResponsibilityForEditabilityOfAssociation, undo, wasEdited
 
Methods inherited from class com.webobjects.eoapplication.EOEntityController
controllerDidLoadArchive, controllerWillLoadArchive, displayGroup, displayGroupProviderMethodName, displayGroupSortOrderings, editingContext, editingContextProviderMethodName, endEditing, establishConnection, isFetchesOnConnectEnabled, isRootEntityController, nestedEditingContext, newDataSource, newDisplayGroupUsingOptimisticRefresh, newEditingContext, objectForOutletPath, resetsEditingContextWhenPreparingForNewTask, selectedObject, selectedObjectGlobalID, selectedObjects, selectedObjectsGlobalIDs, setDisplayGroup, setDisplayGroupProviderMethodName, setEditingContext, setEditingContextProviderMethodName, setFetchesOnConnect, setFetchesOnConnectEnabled, setObjectsWithFetchSpecification, setObjectsWithGlobalIDs, setObjectWithGlobalID, setResetsEditingContextWhenPreparingForNewTask, startListeningToDisplayGroup, startListeningToEditingContext, stopListeningToDisplayGroup, stopListeningToEditingContext, takeResposibilityForConnectionOfAssociation
 
Methods inherited from class com.webobjects.eoapplication.EOArchiveController
archiveName, controllerDisplayGroup, hasControllerDisplayGroup, loadArchive, objectWillChange, prepareComponent, setArchiveName, setControllerDisplayGroup, willChange
 
Methods inherited from class com.webobjects.eoapplication.EOComponentController
activateFirstFocusComponent, addComponentOfSubcontroller, alignsComponents, canBeTransient, canResizeHorizontally, canResizeVertically, component, componentDidBecomeInvisible, componentDidBecomeVisible, defaultComponentSize, ensureMinimumComponentSizeWithoutSubcontrollers, ensureMinimumSubcontrollerAreaSize, firstFocusComponent, generateComponent, handleTakeValueForUnboundKey, hideInSupercontroller, hideSubcontroller, icon, insets, integrationComponent, integrationComponentDidBecomeInvisible, integrationComponentDidBecomeVisible, isComponentPrepared, isRootComponentController, isVisible, label, lastFocusComponent, makeInvisible, makeVisible, minimumComponentSize, minimumComponentSizeWithoutSubcontrollers, minimumIntegrationComponentSize, minimumSubcontrollerAreaSize, prefersIconOnly, removeComponentOfSubcontroller, removeTransientSubcontroller, setAlignsComponents, setCanResizeHorizontally, setCanResizeVertically, setComponent, setDefaultComponentSize, setFirstFocusComponent, setIcon, setInsets, setLabel, setLastFocusComponent, setPrefersIconOnly, setSubcontrollerArea, setToolTip, setUsesHorizontalLayout, setVisible, showInSupercontroller, showSubcontroller, subcontrollerArea, subcontrollerMinimumSizeDidChange, subcontrollerWasAdded, subcontrollerWasRemoved, toolTip, toolTipComponent, usesHorizontalLayout
 
Methods inherited from class com.webobjects.eoapplication.EOController
actionNames, actions, actionWithName, additionalActions, additionalKeyValuePairs, addSubcontroller, breakConnection, breakConnectionToSubcontrollers, canAccessFieldsDirectly, controllerEnumeration, controllersInEnumeration, controllersWithKeyValuePair, controllersWithKeyValuePairs, controllerWithKeyValuePair, controllerWithKeyValuePairs, disableActionNamed, disposableRegistry, enableActionNamed, enabledActions, establishConnectionToSupercontrollers, handleQueryWithUnboundKey, hierarchicalControllerForKey, hierarchicalValueForKey, invokeMethod, isActionNamedEnabled, isAncestorOfController, isConnected, isSupercontrollerOfController, isTransientExplicitlyForbidden, removeFromSupercontroller, removeSubcontroller, resetActions, setAdditionalActions, setAdditionalKeyValuePair, setAdditionalKeyValuePairs, setConnected, setSupercontroller, setTransientExplicitlyForbidden, setTypeName, subcontrollers, supercontroller, supercontroller, takeValueForKey, takeValueForKeyPath, typeName, unableToSetNullForKey, valueForKey, valueForKeyPath
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface com.webobjects.eoapplication.EOObjectDisplay
controllerDisplayGroup, displayGroup, editingContext, entityName
 
Methods inherited from interface com.webobjects.eoapplication.EODocument
isDocumentForGlobalID, isEdited, saveIfUserConfirms, setEdited
 

Constructor Detail

EOFormController

public EOFormController()

EOFormController

public EOFormController(EOXMLUnarchiver unarchiver)
Method Detail

canPerformActionNamed

public boolean canPerformActionNamed(String actionName)
Description copied from class: EODocumentController
Overridden to handle editing-related action enabling and disabling.
Overrides:
canPerformActionNamed in class EOEditingController
Following copied from class: com.webobjects.eoapplication.EODocumentController
Parameters:
actionName - the action method name
Returns:
true if the action should be enabled; false otherwise
See Also:
EOAction.Enabling

canRevert

public boolean canRevert()
Description copied from class: EODocumentController
Returns whether the receiver can revert. A document controller can revert only if it's the root document controller and if it's edited.
Overrides:
canRevert in class EODocumentController
Following copied from class: com.webobjects.eoapplication.EODocumentController
Returns:
true if the controller can revert; false otherwise

canSave

public boolean canSave()
Description copied from class: EODocumentController
Returns whether the receiver can save. A document controller can save only if it's the root document controller and if it's edited.
Overrides:
canSave in class EODocumentController
Following copied from class: com.webobjects.eoapplication.EODocumentController
Returns:
true if the controller can save; false otherwise

cancel

public void cancel()
Description copied from interface: EOModalDialogController.ModalActions
The action method invoked when the user cancels the modal dialog.
Specified by:
cancel in interface EOModalDialogController.ModalActions

defaultActions

protected NSArray defaultActions()
Description copied from class: EODocumentController
Adds actions for handling editing (like save, revert) the default actions defined by the superclass, EOEntityController (but only if the receiver is a root document controller and if it's not used in a modal dialog.
Overrides:
defaultActions in class EOEditingController
Following copied from class: com.webobjects.eoapplication.EOController
Returns:
an array of the receiver's default actions
See Also:
EOController.actions(), EOController.resetActions()

delete

public boolean delete()
Overrides:
delete in class EOEditingController

finishSelecting

public void finishSelecting()
Specified by:
finishSelecting in interface EOControllerFactory.SelectByInserting

insert

public boolean insert()
Overrides:
insert in class EOEditingController

insertNewObject

public boolean insertNewObject()
Specified by:
insertNewObject in interface EOControllerFactory.Insert

insertNewObjectWithRelationshipPathsFilled

public boolean insertNewObjectWithRelationshipPathsFilled(NSDictionary relationshipPathToGlobalIDsMapTable)
Specified by:
insertNewObjectWithRelationshipPathsFilled in interface EOControllerFactory.Insert

insertWithTask

public boolean insertWithTask()

modalDialogShouldClose

public boolean modalDialogShouldClose()
Description copied from interface: EOModalDialogController.ModalActions
This method is invoked by the modal dialog controller on its subcontrollers when the user attempts to close the modal dialog with the dialog's close button (not the usual ok/cancel buttons). Subcontrollers return whether the dialog can be closed (which corresponds to a cancel operation) or not.
Specified by:
modalDialogShouldClose in interface EOModalDialogController.ModalActions
Following copied from interface: com.webobjects.eoapplication.EOModalDialogController.ModalActions
Returns:
true if the dialog can be closed (the operation can be cancelled); false otherwise.

ok

public boolean ok()
Description copied from interface: EOModalDialogController.ModalActions
The action method invoked when the user wants to finish the modal dialog.
Specified by:
ok in interface EOModalDialogController.ModalActions
Following copied from interface: com.webobjects.eoapplication.EOModalDialogController.ModalActions
Returns:
true if the dialog can be closed (the operation was performed successfully); false otherwise.

openObjectWithGlobalID

public void openObjectWithGlobalID(EOGlobalID globalID)
Specified by:
openObjectWithGlobalID in interface EOControllerFactory.Open

openWithTask

public boolean openWithTask()
Overrides:
openWithTask in class EOEditingController

prepareToSelectByInserting

public void prepareToSelectByInserting()
Specified by:
prepareToSelectByInserting in interface EOControllerFactory.SelectByInserting

provideSelectedObjectGlobalID

public EOGlobalID provideSelectedObjectGlobalID()
Specified by:
provideSelectedObjectGlobalID in interface EOControllerFactory.SelectByInserting

save

public boolean save()
Description copied from interface: EODocument
Saves the receiver's edits, returning whether the operation was successful. The user is not given a choice to cancel the save, the save is always executed.
Specified by:
save in interface EODocument
Overrides:
save in class EODocumentController
Following copied from interface: com.webobjects.eoapplication.EODocument
Returns:
true if the save succeeded; false otherwise
See Also:
EODocument.saveIfUserConfirms(String, String)

Last updated Fri Feb 21 13:15:00 PST 2003.

Copyright © 2003 Apple Computer, Inc.