Documentation Archive Developer
Search
PATH Documentation > WebObjects

Table of Contents

EOInterfaceController


Inherits from:
EODocumentController : EOEntityController : EOComponentController : EOController : Object
Package:
com.webobjects.eoapplication


Class Description


EOInterfaceController serves as a convenient base class for logic related to the interface of client-side applications. When the WebObjectsApplication wizard in Project Builder creates a new client-side interface, it adds (to the client-side subproject) an Interface Builder nib file representing this interface and a skeletal EOInterfaceController subclass defined as the nib file's root object or "owner."

In an application constructed in conformance to the Model-View-Controller paradigm, EOInterfaceController plays the role of controller. It has four special outlets (defined in the EOEntityController superclass): its editingContext, its component, its displayGroup, and its controllerDisplayGroup, all of which you can configure using Interface Builder. The object identified by component is an AWT JComponent that functions as the view, since it is the main entry point into the user interface. Because an enterprise object must always inhabit an editing context, editingContext and its contents serve as the "model." The displayGroup is an EODisplayGroup containing the enterprise objects manipulated by the controller's user interface (which may will involve other display groups). The controllerDisplayGroup is a convenience instance containing nothing but the interface controller itself.


XML Tag Default Rule System Controller Type
INTERFACECONTROLLER entityController




Method Types


All methods
EOInterfaceController
archiveName
collectChangesFromServer
generateComponent


Constructors



EOInterfaceController

public EOInterfaceController()

public EOInterfaceController(com.webobjects.eocontrol.EOEditingContext editingContext)

Initializes a new instance then attempts to load the nib file matching the class name. The one-argument and two-argument constructors allow you to specify the editing context used as the nib file's substitution editing context during the load.

public EOInterfaceController( com.webobjects.eocontrol.EOEditingContext editingContext, String archiveName)

Initializes a new instance then attempts to load the associated nib file identified by archiveName. The editingContext argument is used as the nib file's substitution editing context during the load.

public EOInterfaceController(EOXMLUnarchiver unarchiver)

Initializes a new instance with the contents of the unarchiver EOXMLUnarchiver.


Instance Methods



archiveName

public String archiveName()

Returns the name of the nib file that specifies the receiver's user interface. Defaults to the receiver's class name.

collectChangesFromServer

public void collectChangesFromServer()

Updates the receiver's editing context to reflect any changes to enterprise objects pending on the server.

generateComponent

protected void generateComponent()

Since an EOInterfaceController requires a nib file, this method is overridden to raise a NSInternalInconsistencyException.

© 2001 Apple Computer, Inc. (Last Published April 14, 2001)


Table of Contents