WebObjects 5.2

com.webobjects.eogeneration
Class EOAssociationController

java.lang.Object
  |
  +--com.webobjects.eoapplication.EOController
        |
        +--com.webobjects.eoapplication.EOComponentController
              |
              +--com.webobjects.eogeneration.EOWidgetController
                    |
                    +--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


Inner classes inherited from class com.webobjects.eogeneration.EOWidgetController
EOWidgetController.DefaultAction, EOWidgetController.FormatWidget, EOWidgetController.QueryWidget, EOWidgetController.TableWidget
 
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
 
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.NSKeyValueCoding
NullValue
 
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
Constructor Detail

EOAssociationController

public EOAssociationController()

EOAssociationController

public EOAssociationController(EOXMLUnarchiver unarchiver)
Method Detail

association

public EOAssociation association()

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

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

controllerDisplayGroup

public EODisplayGroup controllerDisplayGroup()

displayGroup

public EODisplayGroup displayGroup()

displayGroupProviderMethodName

public String displayGroupProviderMethodName()

dispose

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

disposeAssociations

protected void disposeAssociations()

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
Following copied from class: com.webobjects.eoapplication.EOController
Returns:
true if the receiver can be transient and has been disposed; false otherwise
See Also:
EOController.removeTransientSubcontroller(EOController)

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
Following copied from interface: com.webobjects.eoapplication.EOEditable
Returns:
the editability, one of EOEditable.NeverEditable, EOEditable.AlwaysEditable, or EOEditable.IfSupercontrollerEditable

enabledDisplayGroup

public EODisplayGroup enabledDisplayGroup()

enabledDisplayGroupProviderMethodName

public String enabledDisplayGroupProviderMethodName()

enabledKey

public String enabledKey()

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
Following copied from interface: com.webobjects.eoapplication.EOEditable
Returns:
true if the controller is currently editable; false otherwise

newAssociation

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

prefersContinuousChangeNotification

public boolean prefersContinuousChangeNotification()

setAssociation

public void setAssociation(EOAssociation association)

setDisplayGroup

public void setDisplayGroup(EODisplayGroup displayGroup)

setDisplayGroupProviderMethodName

public void setDisplayGroupProviderMethodName(String string)

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
Following copied from interface: com.webobjects.eoapplication.EOEditable
Parameters:
editability - the editability, one of EOEditable.NeverEditable, EOEditable.AlwaysEditable, or EOEditable.IfSupercontrollerEditable

setEnabledDisplayGroup

public void setEnabledDisplayGroup(EODisplayGroup displayGroup)

setEnabledDisplayGroupProviderMethodName

public void setEnabledDisplayGroupProviderMethodName(String string)

setEnabledKey

public void setEnabledKey(String string)

setPrefersContinuousChangeNotification

public void setPrefersContinuousChangeNotification(boolean flag)

setSuppressesAssociation

public void setSuppressesAssociation(boolean flag)

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

suppressesAssociation

public boolean suppressesAssociation()

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
Following copied from interface: com.webobjects.eoapplication.EOEditable
Parameters:
association - the transient subcontroller's association

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
Following copied from interface: com.webobjects.eoapplication.EOAssociationConnector
Parameters:
association - the transient subcontroller's EOAssociation

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
Following copied from class: com.webobjects.eoapplication.EOComponentController
Returns:
the String representation of the receiver

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

Copyright © 2003 Apple Computer, Inc.