Adding Display Groups
A display group is an important type of variable that you use in WebObjects applications that access databases. A display group is an object that can fetch, insert, delete, display, update and search records in a database.This section describes the mechanics of adding display groups to a WebObjects project. For detailed information about display groups, see the DisplayGroup (Java) or WODisplayGroup (Objective-C) class specification in the WebObjects Class Reference. To learn more about how to create a WebObjects database application, see "Creating a WebObjects Database Application" in Getting Started With WebObjects.
WebObjects applications access databases through the Enterprise Objects Framework, which represents database rows as enterprise objects. Enterprise object classes typically correspond to database tables, and an enterprise object instance corresponds to a single row or record in a table. For detailed information on enterprise objects, read the Enterprise Objects Framework Developer's Guide.
- Drag a model (a folder with the extension .eomodeld) from the file system into the object browser in your component window, or drag an entity from the EOModeler application into the object browser.
When you do this, a panel asks you if you want to add the model to your project. If you reply Yes, the Add Display Group panel appears.
It allows you to specify a name for your display group and decide if you want to simply add the display group, or configure it as well. "Configuring the Display Group" describes the configuration process.
- Use Add Variable/Method to define a variable of type DisplayGroup (Java) or WODisplayGroup (Objective-C or WebScript), or declare the display group directly in your code:
protected DisplayGroup myDisplayGroup; //this is a Java example
When you add a display group this way, you are responsible for making sure your project contains the appropriate model file. (For example, once a model file has been added, you can create any number of display groups based on it). In addition, you need to configure the display group.
When you use the Add Variable/Method panel, you can create not only display group variables, but also enterprise objects associated with any of the entities in your project's models.
In the figure, if you choose the entity CarPackage as the variable's type, the following code gets added to your source file:
/** @TypeInfo CarPackage */ protected EnterpriseObject myCarPackage;The variable myCarPackage is declared as type EnterpriseObject. The comment /** @TypeInfo CarPackage */ is a structured comment that WebObjects Builder uses to identify the entity associated with the object. It is then able to display the attributes in the object browser as shown here:
Table of Contents Next Section