WebObjects 5.2

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:
ActionListener, EOAction.Enabling, EOAssociationConnector, EOComponentController.EndEditing, EOControllerFactory.Query, EOObjectDisplay, EOObserving, EOQueryObjectDisplay, EOWidgetController.DefaultAction, EOWidgetController.DefaultAction.CommonWidgetHandler, EventListener, NSDisposable, NSKeyValueCoding, NSKeyValueCoding.ErrorHandling, NSKeyValueCodingAdditions

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


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.eogeneration.EOWidgetController.DefaultAction
EOWidgetController.DefaultAction.CommonWidgetHandler
 
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.foundation.NSKeyValueCoding
NullValue
 
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
 

Constructor Detail

EOQueryController

public EOQueryController()

EOQueryController

public EOQueryController(EOXMLUnarchiver unarchiver)
Method Detail

actionPerformed

public void actionPerformed(ActionEvent event)
Specified by:
actionPerformed in interface ActionListener

append

public void append()

canTakeResposibilityForDefaultActionWithActionWidget

public boolean canTakeResposibilityForDefaultActionWithActionWidget(JComponent actionWidget)
Specified by:
canTakeResposibilityForDefaultActionWithActionWidget in interface EOWidgetController.DefaultAction.CommonWidgetHandler

clear

public void clear()

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
Following copied from class: com.webobjects.eoapplication.EOController
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
Following copied from class: com.webobjects.eoapplication.EOEntityController
Parameters:
namedObjects - dictionary with all named objects from the interface file archive (keys: names, values: objects)
See Also:
EOArchiveController.loadArchive()

defaultAction

public void defaultAction()
Specified by:
defaultAction in interface EOWidgetController.DefaultAction

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
Following copied from class: com.webobjects.eoapplication.EOController
Returns:
an array of the receiver's default actions
See Also:
EOController.actions(), EOController.resetActions()

dispose

public void dispose()
Description copied from class: EOEntityController
Prepares the receiver so it is disposed when Java performs garbage collection.
Overrides:
dispose in class EOEntityController

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.
Overrides:
endEditing in class EOEntityController
Following copied from class: com.webobjects.eoapplication.EOEntityController
Returns:
true if all uncommitted changes were successfully flushed; false otherwise

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
Following copied from class: com.webobjects.eoapplication.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)

find

public void find()

findAll

public void findAll()

newQueryDataSource

public EODataSource newQueryDataSource()

newQueryDisplayGroup

public EODisplayGroup newQueryDisplayGroup()

newQueryEditingContext

public EOEditingContext newQueryEditingContext()

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
Following copied from class: com.webobjects.eoapplication.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()

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
Following copied from class: com.webobjects.eoapplication.EOEntityController
Parameters:
prepareSubcontrollersForNewTask - true if the method should be forwarded to all subcontrollers; false otherwise

qualifier

public EOQualifier qualifier()

queryDisplayGroup

public EODisplayGroup queryDisplayGroup()
Specified by:
queryDisplayGroup in interface EOQueryObjectDisplay

queryEditingContext

public EOEditingContext queryEditingContext()
Specified by:
queryEditingContext in interface EOQueryObjectDisplay

queryObjectsWithFetchSpecification

public void queryObjectsWithFetchSpecification(EOFetchSpecification fetchSpecification)
Specified by:
queryObjectsWithFetchSpecification in interface EOControllerFactory.Query

runsConfirmDialogForEmptyQualifiers

public boolean runsConfirmDialogForEmptyQualifiers()

setQueryDisplayGroup

public void setQueryDisplayGroup(EODisplayGroup displayGroup)

setQueryEditingContext

public void setQueryEditingContext(EOEditingContext editingContext)

setRunsConfirmDialogForEmptyQualifiers

public void setRunsConfirmDialogForEmptyQualifiers(boolean flag)

takeResposibilityForDefaultActionWithActionWidget

public void takeResposibilityForDefaultActionWithActionWidget(JComponent actionWidget)
Specified by:
takeResposibilityForDefaultActionWithActionWidget in interface EOWidgetController.DefaultAction.CommonWidgetHandler

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

Copyright © 2003 Apple Computer, Inc.