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