WebObjects 5.4.2

com.webobjects.eogeneration
Class EOAssociationController

java.lang.Object
  extended by com.webobjects.eoapplication.EOController
      extended by com.webobjects.eoapplication.EOComponentController
          extended by com.webobjects.eogeneration.EOWidgetController
              extended by com.webobjects.eogeneration.EOAssociationController
All Implemented Interfaces:
EOAction.Enabling, EOAssociationConnector, EOEditable, NSDisposable, NSKeyValueCoding, NSKeyValueCoding.ErrorHandling, NSKeyValueCodingAdditions
Direct Known Subclasses:
EODefaultActionTrigger, EOQuickTimeViewController, EOTitlesController, EOValueController

public abstract class EOAssociationController
extends EOWidgetController
implements EOEditable, EOAssociationConnector


Nested Class Summary
 
Nested classes/interfaces inherited from class com.webobjects.eogeneration.EOWidgetController
EOWidgetController.DefaultAction, EOWidgetController.FormatWidget, EOWidgetController.QueryWidget, EOWidgetController.TableWidget
 
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.foundation.NSKeyValueCodingAdditions
NSKeyValueCodingAdditions.DefaultImplementation, NSKeyValueCodingAdditions.Utility
 
Field Summary
static String ControllerDisplayGroupProviderMethodName
           
 
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.NSKeyValueCodingAdditions
KeyPathSeparator
 
Constructor Summary
EOAssociationController()
           
EOAssociationController(EOXMLUnarchiver unarchiver)
           
 
Method Summary
 EOAssociation association()
           
protected  void connectionWasBroken()
          Invoked from breakConnection to notify the receiver that its connection to its supercontroller has been broken, giving the receiver the opportunity to clean up after its become idle.
protected  void connectionWasEstablished()
          Invoked from establishConnection to notify the receiver that its connection to the controller hierarchy has been established, giving the receiver the opportunity to prepare itself (for example, setting delegates).
 EODisplayGroup controllerDisplayGroup()
           
 EODisplayGroup displayGroup()
           
 String displayGroupProviderMethodName()
           
 void dispose()
          Prepares the receiver so it is disposed when Java performs garbage collection.
protected  void disposeAssociations()
           
protected  boolean disposeIfTransient()
          Disposes the receiver if it's transient, first removing it from its supercontroller with removeTransientSubcontroller If the receiver's supercontroller is non-null, this method also attempts to dispose of the supercontroller if it's transient.
 int editability()
          Returns the editability of the receiver.
 EODisplayGroup enabledDisplayGroup()
           
 String enabledDisplayGroupProviderMethodName()
           
 String enabledKey()
           
 boolean isEditable()
          Returns whether the receiver is currently editable.
protected abstract  EOAssociation newAssociation(JComponent widget, EODisplayGroup displayGroup, String enabledKey, EODisplayGroup enabledDisplayGroup)
           
 boolean prefersContinuousChangeNotification()
           
 void setAssociation(EOAssociation association)
           
 void setDisplayGroup(EODisplayGroup displayGroup)
           
 void setDisplayGroupProviderMethodName(String string)
           
 void setEditability(int editability)
          Sets the editability of the receiver to editability.
 void setEnabledDisplayGroup(EODisplayGroup displayGroup)
           
 void setEnabledDisplayGroupProviderMethodName(String string)
           
 void setEnabledKey(String string)
           
 void setPrefersContinuousChangeNotification(boolean flag)
           
 void setSuppressesAssociation(boolean flag)
           
 void supercontrollerEditabilityDidChange()
          Invoked to notify the receiver that the editability of its supercontroller changed, giving the receiver the opportunity to update its user interface to match the editability of the supercontroller.
 boolean suppressesAssociation()
           
 void takeResponsibilityForEditabilityOfAssociation(EOAssociation association)
          Invoked when one of the receiver's subcontrollers is disposed as a transient controller.
 void takeResposibilityForConnectionOfAssociation(EOAssociation association)
          Invoked when one of the receiver's subcontrollers is disposed as a transient controller.
 String toString()
          Returns the receiver as a string that states the receiver's class name and type name, whether the receiver is connected, the number of subcontrollers, whether or not the receiver has been prepared, whether or not the receiver is visible, information about widget sizing and alignment behavior, and so on.
 
Methods inherited from class com.webobjects.eogeneration.EOWidgetController
generateComponent, highlightsLabel, labelComponent, labelComponentAlignment, labelComponentPosition, labelComponentWidth, minimumWidgetSize, newLabelComponent, newWidget, preferredLabelComponentPosition, preferredUsesLabelComponent, preferredWidgetAutosizingMask, setAlignmentForWidget, setHighlightsLabel, setLabelComponent, setLabelComponentAlignment, setLabelComponentPosition, setLabelComponentWidth, setMinimumWidgetSize, setUsesLabelComponent, setWidget, setWidgetAlignment, startListeningToWidget, stopListeningToWidget, toolTipComponent, usesLabelComponent, widget, widgetAlignment
 
Methods inherited from class com.webobjects.eoapplication.EOComponentController
activateFirstFocusComponent, addComponentOfSubcontroller, alignsComponents, canBeTransient, canResizeHorizontally, canResizeVertically, component, componentDidBecomeInvisible, componentDidBecomeVisible, defaultComponentSize, ensureMinimumComponentSizeWithoutSubcontrollers, ensureMinimumSubcontrollerAreaSize, firstFocusComponent, handleTakeValueForUnboundKey, hideInSupercontroller, hideSubcontroller, icon, insets, integrationComponent, integrationComponentDidBecomeInvisible, integrationComponentDidBecomeVisible, isComponentPrepared, isRootComponentController, isVisible, label, lastFocusComponent, makeInvisible, makeVisible, minimumComponentSize, minimumComponentSizeWithoutSubcontrollers, minimumIntegrationComponentSize, minimumSubcontrollerAreaSize, prefersIconOnly, prepareComponent, removeComponentOfSubcontroller, removeTransientSubcontroller, setAlignsComponents, setCanResizeHorizontally, setCanResizeVertically, setComponent, setDefaultComponentSize, setFirstFocusComponent, setIcon, setInsets, setLabel, setLastFocusComponent, setPrefersIconOnly, setSubcontrollerArea, setToolTip, setUsesHorizontalLayout, setVisible, showInSupercontroller, showSubcontroller, subcontrollerArea, subcontrollerMinimumSizeDidChange, subcontrollerWasAdded, subcontrollerWasRemoved, toolTip, 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, defaultActions, disableActionNamed, disposableRegistry, enableActionNamed, enabledActions, establishConnection, establishConnectionToSupercontrollers, handleQueryWithUnboundKey, hierarchicalControllerForKey, hierarchicalValueForKey, invokeMethod, isActionNamedEnabled, isAncestorOfController, isConnected, isSupercontrollerOfController, isTransientExplicitlyForbidden, prepareForNewTask, 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
 

Field Detail

ControllerDisplayGroupProviderMethodName

public static final String ControllerDisplayGroupProviderMethodName
See Also:
Constant Field Values
Constructor Detail

EOAssociationController

public EOAssociationController()

EOAssociationController

public EOAssociationController(EOXMLUnarchiver unarchiver)
Method Detail

disposeAssociations

protected void disposeAssociations()

dispose

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

Specified by:
dispose in interface NSDisposable
Overrides:
dispose in class EOWidgetController

disposeIfTransient

protected boolean disposeIfTransient()
Description copied from class: EOController
Disposes the receiver if it's transient, first removing it from its supercontroller with removeTransientSubcontroller If the receiver's supercontroller is non-null, this method also attempts to dispose of the supercontroller if it's transient. Supercontrollers can prevent a controller from becoming transient, in which case this method returns false. Subclasses should first invoke the super implementation and only continue disposing if the super implementation returns true.

Overrides:
disposeIfTransient in class EOController
Returns:
true if the receiver can be transient and has been disposed; false otherwise
See Also:
EOController.removeTransientSubcontroller(EOController)

connectionWasEstablished

protected void connectionWasEstablished()
Description copied from class: EOController
Invoked from establishConnection to notify the receiver that its connection to the controller hierarchy has been established, giving the receiver the opportunity to prepare itself (for example, setting delegates).

Overrides:
connectionWasEstablished in class EOController
See Also:
EOController.establishConnection()

connectionWasBroken

protected void connectionWasBroken()
Description copied from class: EOController
Invoked from breakConnection to notify the receiver that its connection to its supercontroller has been broken, giving the receiver the opportunity to clean up after its become idle.

Overrides:
connectionWasBroken in class EOController
See Also:
EOController.breakConnection()

setSuppressesAssociation

public void setSuppressesAssociation(boolean flag)

suppressesAssociation

public boolean suppressesAssociation()

setPrefersContinuousChangeNotification

public void setPrefersContinuousChangeNotification(boolean flag)

prefersContinuousChangeNotification

public boolean prefersContinuousChangeNotification()

setDisplayGroupProviderMethodName

public void setDisplayGroupProviderMethodName(String string)

displayGroupProviderMethodName

public String displayGroupProviderMethodName()

setEnabledDisplayGroupProviderMethodName

public void setEnabledDisplayGroupProviderMethodName(String string)

enabledDisplayGroupProviderMethodName

public String enabledDisplayGroupProviderMethodName()

setEnabledKey

public void setEnabledKey(String string)

enabledKey

public String enabledKey()

setEditability

public void setEditability(int editability)
Description copied from interface: EOEditable
Sets the editability of the receiver to editability. See the method description of setEditability in the interface specification for EOEditable.

Specified by:
setEditability in interface EOEditable
Parameters:
editability - the editability, one of EOEditable.NeverEditable, EOEditable.AlwaysEditable, or EOEditable.IfSupercontrollerEditable

editability

public int editability()
Description copied from interface: EOEditable
Returns the editability of the receiver. The default behavior should be to return EOEditable.IfSupercontrollerEditable.

Specified by:
editability in interface EOEditable
Returns:
the editability, one of EOEditable.NeverEditable, EOEditable.AlwaysEditable, or EOEditable.IfSupercontrollerEditable

isEditable

public boolean isEditable()
Description copied from interface: EOEditable
Returns whether the receiver is currently editable. A receiver is editable if its editability is EOEditable.AlwaysEditable or its editability is EOEditable.IfSupercontrollerEditable and sending EOEditable.isEditable to the first EOEditable supercontroller of the receiver returns true.

Specified by:
isEditable in interface EOEditable
Returns:
true if the controller is currently editable; false otherwise

supercontrollerEditabilityDidChange

public void supercontrollerEditabilityDidChange()
Description copied from interface: EOEditable
Invoked to notify the receiver that the editability of its supercontroller changed, giving the receiver the opportunity to update its user interface to match the editability of the supercontroller. This method is only sent to connected subcontrollers whose editability is EOEditable.IfSupercontrollerEditable.

Specified by:
supercontrollerEditabilityDidChange in interface EOEditable

takeResponsibilityForEditabilityOfAssociation

public void takeResponsibilityForEditabilityOfAssociation(EOAssociation association)
Description copied from interface: EOEditable
Invoked when one of the receiver's subcontrollers is disposed as a transient controller. This method instructs the receiver to assume responsibility for managing the editability of the subcontroller's EOAssociation, association.

Specified by:
takeResponsibilityForEditabilityOfAssociation in interface EOEditable
Parameters:
association - the transient subcontroller's association

controllerDisplayGroup

public EODisplayGroup controllerDisplayGroup()

setDisplayGroup

public void setDisplayGroup(EODisplayGroup displayGroup)

displayGroup

public EODisplayGroup displayGroup()

setEnabledDisplayGroup

public void setEnabledDisplayGroup(EODisplayGroup displayGroup)

enabledDisplayGroup

public EODisplayGroup enabledDisplayGroup()

takeResposibilityForConnectionOfAssociation

public void takeResposibilityForConnectionOfAssociation(EOAssociation association)
Description copied from interface: EOAssociationConnector
Invoked when one of the receiver's subcontrollers is disposed as a transient controller. Instructs the receiver to assume responsibility for managing the subcontroller's EOAssociation, association.

Specified by:
takeResposibilityForConnectionOfAssociation in interface EOAssociationConnector
Parameters:
association - the transient subcontroller's EOAssociation

newAssociation

protected abstract EOAssociation newAssociation(JComponent widget,
                                                EODisplayGroup displayGroup,
                                                String enabledKey,
                                                EODisplayGroup enabledDisplayGroup)

setAssociation

public void setAssociation(EOAssociation association)

association

public EOAssociation association()

toString

public String toString()
Description copied from class: EOComponentController
Returns the receiver as a string that states the receiver's class name and type name, whether the receiver is connected, the number of subcontrollers, whether or not the receiver has been prepared, whether or not the receiver is visible, information about widget sizing and alignment behavior, and so on.

Overrides:
toString in class EOComponentController
Returns:
the String representation of the receiver

Last updated June 2008

Copyright © 2000-2008 Apple Inc.