com.webobjects.eogeneration
Class EOQueryController

java.lang.Object
  com.webobjects.eoapplication.EOController
      com.webobjects.eoapplication.EOComponentController
          com.webobjects.eoapplication.EOArchiveController
              com.webobjects.eoapplication.EOEntityController
                  com.webobjects.eogeneration.EOQueryController

All Implemented Interfaces:

EOAction.Enabling, EOAssociationConnector, EOComponentController.EndEditing, EOObjectDisplay, EOObserving, EOControllerFactory.Query, EOQueryObjectDisplay, EOWidgetController.DefaultAction, EOWidgetController.DefaultAction.CommonWidgetHandler, NSDisposable, NSKeyValueCoding, NSKeyValueCoding.ErrorHandling, NSKeyValueCodingAdditions, ActionListener, EventListener

public class EOQueryController
extends EOEntityController
implements ActionListener, EOWidgetController.DefaultAction, EOWidgetController.DefaultAction.CommonWidgetHandler, EOControllerFactory.Query, EOQueryObjectDisplay

Nested Class Summary

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

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

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

EOController.Enumeration

Nested classes/interfaces inherited from interface com.webobjects.eogeneration.EOWidgetController.DefaultAction

EOWidgetController.DefaultAction.CommonWidgetHandler

Nested classes/interfaces inherited from interface 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.foundation.NSKeyValueCodingAdditions

KeyPathSeparator

Constructor Summary

EOQueryController()

EOQueryController(EOXMLUnarchiver unarchiver)

Method Summary

void	actionPerformed(ActionEvent event)
void	append()
boolean	canTakeResposibilityForDefaultActionWithActionWidget(JComponent actionWidget)
void	clear()
protected void	connectionWasEstablished() Reacts to the connection for the receiver being established, taking care of association connecting and fetching if necessary.
protected void	controllerDidLoadArchive(NSDictionary namedObjects) Invoked from loadArchive to notify the receiver that its interface file has been loaded completely.
void	defaultAction()
protected NSArray	defaultActions() Returns an array of the receiver's default actions (EOAction objects).
void	dispose() Prepares the receiver so it is disposed when Java performs garbage collection.
boolean	endEditing() Ensures that all editors of the receiver's display groups end editing (flush current user edits to the enterprise object graph if necessary).
boolean	fetchesOnConnect() Returns whether the receiver should fetch its display group content next time its connection is established.
EOFetchSpecification	fetchSpecification()
void	find()
void	findAll()
EODataSource	newQueryDataSource()
EODisplayGroup	newQueryDisplayGroup()
EOEditingContext	newQueryEditingContext()
Object	objectForOutletPath(EOArchive archive, String outletPath) Returns an object for an outlet path to be substituted in an interface file archive loaded by the receiver.
void	prepareForNewTask(boolean prepareSubcontrollersForNewTask) Prepares the receiver for performing a new task by resetting any data and refetching objects if necessary.
EOQualifier	qualifier()
EODisplayGroup	queryDisplayGroup()
EOEditingContext	queryEditingContext()
void	queryObjectsWithFetchSpecification(EOFetchSpecification fetchSpecification)
boolean	runsConfirmDialogForEmptyQualifiers()
void	setQueryDisplayGroup(EODisplayGroup displayGroup)
void	setQueryEditingContext(EOEditingContext editingContext)
void	setRunsConfirmDialogForEmptyQualifiers(boolean flag)
void	takeResposibilityForDefaultActionWithActionWidget(JComponent actionWidget)

Methods inherited from class com.webobjects.eoapplication.EOEntityController

connectionWasBroken, controllerWillLoadArchive, displayGroup, displayGroupProviderMethodName, displayGroupSortOrderings, editingContext, editingContextProviderMethodName, entityName, establishConnection, handleEditingContextNotification, isFetchesOnConnectEnabled, isRootEntityController, nestedEditingContext, newDataSource, newDisplayGroup, newDisplayGroupUsingOptimisticRefresh, newEditingContext, resetsEditingContextWhenPreparingForNewTask, selectedObject, selectedObjectGlobalID, selectedObjects, selectedObjectsGlobalIDs, setDisplayGroup, setDisplayGroupProviderMethodName, setEditingContext, setEditingContextProviderMethodName, setEntityName, setFetchesOnConnect, setFetchesOnConnectEnabled, setObjectsWithFetchSpecification, setObjectsWithGlobalIDs, setObjectWithGlobalID, setResetsEditingContextWhenPreparingForNewTask, startListeningToDisplayGroup, startListeningToEditingContext, stopListeningToDisplayGroup, stopListeningToEditingContext, takeResposibilityForConnectionOfAssociation, toString

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, canPerformActionNamed, controllerEnumeration, controllersInEnumeration, controllersWithKeyValuePair, controllersWithKeyValuePairs, controllerWithKeyValuePair, controllerWithKeyValuePairs, disableActionNamed, disposableRegistry, disposeIfTransient, 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.EOObjectDisplay

controllerDisplayGroup, displayGroup, editingContext, entityName

Constructor Detail

EOQueryController

public EOQueryController()

EOQueryController

public EOQueryController(EOXMLUnarchiver unarchiver)

Method Detail

dispose

public void dispose()

Description copied from class: EOEntityController

Prepares the receiver so it is disposed when Java performs garbage collection.

Specified by:

dispose in interface NSDisposable

Overrides:

dispose in class EOEntityController

prepareForNewTask

public void prepareForNewTask(boolean prepareSubcontrollersForNewTask)

Description copied from class: EOEntityController

Prepares the receiver for performing a new task by resetting any data and refetching objects if necessary.

Overrides:

prepareForNewTask in class EOEntityController

Parameters:

prepareSubcontrollersForNewTask - true if the method should be forwarded to all subcontrollers; false otherwise

connectionWasEstablished

protected void connectionWasEstablished()

Description copied from class: EOEntityController

Reacts to the connection for the receiver being established, taking care of association connecting and fetching if necessary.

Overrides:

connectionWasEstablished in class EOEntityController

See Also:

EOController.establishConnection()

controllerDidLoadArchive

protected void controllerDidLoadArchive(NSDictionary namedObjects)

Description copied from class: EOEntityController

Invoked from loadArchive to notify the receiver that its interface file has been loaded completely. You can override this method to perform additional initialization for the objects loaded from the interface file archive.

Overrides:

controllerDidLoadArchive in class EOEntityController

Parameters:

namedObjects - dictionary with all named objects from the interface file archive (keys: names, values: objects)

See Also:

EOArchiveController.loadArchive()

objectForOutletPath

public Object objectForOutletPath(EOArchive archive,
                                  String outletPath)

Description copied from class: EOEntityController

Returns an object for an outlet path to be substituted in an interface file archive loaded by the receiver. This methods allows you to substitute objects for all objects that can be reached through an outlet connection from the file's owner, for example the editingContext of the receiver (which is the file's owner of the archive) or displayGroup.dataSource. If no substitution object is needed, this method returns null.

Overrides:

objectForOutletPath in class EOEntityController

Parameters:

archive - the archive currently loaded

outletPath - the outlet path to find a substitution object for

Returns:

the substituation object or null if no substitution object is needed

See Also:

EOArchiveController.loadArchive()

newQueryEditingContext

public EOEditingContext newQueryEditingContext()

setQueryEditingContext

public void setQueryEditingContext(EOEditingContext editingContext)

queryEditingContext

public EOEditingContext queryEditingContext()

Specified by:

queryEditingContext in interface EOQueryObjectDisplay

newQueryDataSource

public EODataSource newQueryDataSource()

newQueryDisplayGroup

public EODisplayGroup newQueryDisplayGroup()

setQueryDisplayGroup

public void setQueryDisplayGroup(EODisplayGroup displayGroup)

queryDisplayGroup

public EODisplayGroup queryDisplayGroup()

Specified by:

queryDisplayGroup in interface EOQueryObjectDisplay

qualifier

public EOQualifier qualifier()

fetchSpecification

public EOFetchSpecification fetchSpecification()

fetchesOnConnect

public boolean fetchesOnConnect()

Description copied from class: EOEntityController

Returns whether the receiver should fetch its display group content next time its connection is established. This value changes often: Whenever an entity controller prepares for a new task, it sets this flag to true. Once it retrieves objects explicitly (for example from a global ID) or actually performs the fetch while connecting, it sets this flag to false.

Overrides:

fetchesOnConnect in class EOEntityController

Returns:

true if the controller should fetch its display group content next time its connection is established; false otherwise

See Also:

EOEntityController.setFetchesOnConnect(boolean)

endEditing

public boolean endEditing()

Description copied from class: EOEntityController

Ensures that all editors of the receiver's display groups end editing (flush current user edits to the enterprise object graph if necessary). This method is invoked automatically before saving or reverting changes in subclasses.

Specified by:

endEditing in interface EOComponentController.EndEditing

Overrides:

endEditing in class EOEntityController

Returns:

true if all uncommitted changes were successfully flushed; false otherwise

setRunsConfirmDialogForEmptyQualifiers

public void setRunsConfirmDialogForEmptyQualifiers(boolean flag)

runsConfirmDialogForEmptyQualifiers

public boolean runsConfirmDialogForEmptyQualifiers()

defaultActions

protected NSArray defaultActions()

Description copied from class: EOController

Returns an array of the receiver's default actions (EOAction objects). A subclass of EOController should override this method to return the actions it defines merged with the actions of its superclass. Never invoke this method directly. Instead, invoke actions, which caches the results of defaultActions and is therefore more efficient.

Overrides:

defaultActions in class EOController

Returns:

an array of the receiver's default actions

See Also:

EOController.actions(), EOController.resetActions()

defaultAction

public void defaultAction()

Specified by:

defaultAction in interface EOWidgetController.DefaultAction

canTakeResposibilityForDefaultActionWithActionWidget

public boolean canTakeResposibilityForDefaultActionWithActionWidget(JComponent actionWidget)

Specified by:

canTakeResposibilityForDefaultActionWithActionWidget in interface EOWidgetController.DefaultAction.CommonWidgetHandler

takeResposibilityForDefaultActionWithActionWidget

public void takeResposibilityForDefaultActionWithActionWidget(JComponent actionWidget)

Specified by:

takeResposibilityForDefaultActionWithActionWidget in interface EOWidgetController.DefaultAction.CommonWidgetHandler

find

public void find()

append

public void append()

findAll

public void findAll()

clear

public void clear()

queryObjectsWithFetchSpecification

public void queryObjectsWithFetchSpecification(EOFetchSpecification fetchSpecification)

Specified by:

queryObjectsWithFetchSpecification in interface EOControllerFactory.Query

actionPerformed

public void actionPerformed(ActionEvent event)

Specified by:

actionPerformed in interface ActionListener