In C++, pointers are not appropriate to describe relations among objects. To be more specific, they do not convey semantics and do not allow you to invert a relation automatically —that is, they do not allow you to access the origin of a relation starting from its target. Rogue Wave Server makes it possible to define in C++ the idea of a relation as supported by the object-oriented methodologies, by extending the idea of a C++ pointer as a data member. You can invert such relations. Moreover, Rogue Wave Server lets you set cardinalities to automatically manage the minimum and maximum number of target objects in a relation.

In Rogue Wave Server, an object can have two kinds of relations with other objects:

In either case, these relations can be one-to-one relations or one-to-many relations, also referred to as list relations. Cardinalities can be set for one-to-many relations. For example, an object can own 0 to n objects.

An ownership relation is a relation in which an object, called the owner, owns one or several other objects, called owned objects. Owned objects, or target objects, belong to one and only one owner, or origin-object.

For example, a domain owns a set of nodes. Each node belongs to a single domain. The object Domain is called the owner of the object Node.

A use relation is a relation in which an object, called the user, uses one or several other objects, called used objects. Used objects, or target objects, can be used by several user objects, or origin-object.

For example, a line uses two nodes (an input node and an output node). A single node can be used by multiple lines. The object Line is called the user of the object Node, that is, it makes use of the node.

Rogue Wave Server provides several class templates to define relations between the objects of your model. Here are some of the class templates you can use to establish relations between objects.

For a description of these class templates, see the Rogue Wave Server Reference Manual.

The following code defines the relations between a domain and its lines and nodes, as illustrated in Figure 2.1.

The following code defines the relations between lines and nodes, as illustrated in Figure 2.1.

These declarations have the following meanings:

Server objects can be classified in two categories:

Entities are the roots of the information system. They can be used but can never be owned by other objects. Entities have a name and can be stored in a dictionary. In our example, the object Network is an entity. Entities derive from the class IlsEntity.

Basic objects can be both used and owned by other objects. In our example, the objects Line and Node are basic objects. Basic objects derive from the class IlsObject.

For more information on IlsEntity and IlsObject, see the Rogue Wave Server Reference Manual.

Relations are linked to several features implemented by Rogue Wave Server.