Table of Contents

Previous Section

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.

In a database application, you use entity-relationship models. A model associates database columns with instance variables of objects. You create a model with the EOModeler application, or you can specify one when you use the Wizard to set up your application (when you add a model to your project, it is added to the Resources suitcase). A model is stored in a model file. For more information on creating models, see the chapter "Using EOModeler" in Enterprise Objects Framework Developer's Guide.

A model contains entities, attributes, and relationships. An entity associates a database table with an enterprise object class. Display groups manage objects associated with a single entity. An attribute associates a database column with an instance variable. A relationship is a link between two entities that's based on attributes of the entities.

If you used the Wizard to set up your application, a display group was set up for you based on the model you specified. There are several other ways to create a display group:

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