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

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