Initial Creation
Figure 12.4 shows the dynamic behavior of the mechanism when a view is opened. The process can be broken down into the following steps:
1. A view is opened on a server object from a component.
2. A dynamic view subscribing to the selected server object is instantiated within the server.
3. Rogue Wave® Server triggers the notification mechanism.
4. An instance of the class IlsSwRepresentation is created in the component.
5. IlsSwTable objects are created.
6. The Properties data source is filled in.
7. IlsSwRow objects are created.
Opening a View
The first step consists in opening a view on a server object. To do so, we use an instance of the class IlsSwComponent, which is a subclass of IlsMvComponent. This component is designed to manage Rogue Wave Views mapping views.
Two cases may arise:
No Server data source represents your view in the component application yet.
In this case, the Server data source and its corresponding holder panel will be instantiated by Rogue Wave Server when the view is opened on the component side.
A Server data source already exists for this view in one of the panel of the component application.
In this case, you must specify the Server data source you want to use when opening the view.
Instantiating a Dynamic View
During the second step, a dynamic view subscribing to the selected object is instantiated within the server. This view is a standard Rogue Wave Server dynamic view whose specification as been parsed by the server.
Notification
The third step is performed by the Rogue Wave Server notification mechanism. Notification is propagated to the part of the model you are interested in and all representation objects are created according to the view specification.
Creating a Representation
In the fourth step, an instance of the class lsSwRepresentation is created in the component. This representation either creates in turn a Server data source and its corresponding panel or retrieves the Server data source you specified when opening the view.
When the Server data source is instantiated, it creates all Views data sources required by the view specification—that is, one Properties data source and one Main data source—for each IlsSwTable object found in the view specification.
Creating IlsSwTable Representation Objects
When an IlsSwTable representation object is created, it establishes a connection to its corresponding Properties data source and Main data source.
Filling in the Properties Data Source
As IlsSwTable objects also represent the attributes of the relation origin in the Properties data source, the values of those attribute are notified in the first row of the Properties data source.
Creating IlsSwRow Representation Objects
All notified objects that are marked in the view specification as represented by IlsSwRow objects create an instance of this class in the component application. Because rows reference an IlsSwTable object, they use that table to retrieve the Main data source to be filled. As a result, a new row is added to this data source and its columns are filled with data received through the notification mechanism.
Version 5.8
Copyright © 2014, Rogue Wave Software, Inc. All Rights Reserved.