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

Nested Class Summary

Nested classes inherited from class com.webobjects.eoapplication.EOComponentController

EOComponentController.ActionCollector, EOComponentController.Activation, EOComponentController.EndEditing, EOComponentController.Modal, EOComponentController.ResetUserInterface

Nested classes inherited from class com.webobjects.eoapplication.EOController

EOController.Enumeration

Nested classes inherited from class com.webobjects.foundation.NSKeyValueCoding

NSKeyValueCoding.DefaultImplementation, NSKeyValueCoding.ErrorHandling, NSKeyValueCoding.Null, NSKeyValueCoding.UnknownKeyException, NSKeyValueCoding.Utility, NSKeyValueCoding.ValueAccessor

Nested classes inherited from class com.webobjects.foundation.NSKeyValueCodingAdditions

NSKeyValueCodingAdditions.DefaultImplementation, NSKeyValueCodingAdditions.Utility

Field Summary

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.

Specified by:

canPerformActionNamed in interface EOAction.Enabling

Overrides:

canPerformActionNamed in class EOEditingController

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

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

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

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

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

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

Returns:

true if the save succeeded; false otherwise

See Also:

EODocument.saveIfUserConfirms(String, String)