Version 8.2 (2013-03-18)
 —  Appendices  —

Appendix B - Usage of Methods Inherited from the Adapter Class

Inside the Application Designer management, adapters have to provide a defined interface to be managed correctly by the system. This interface is declared by com.softwareag.cis.Server.IAdapter. In order to have a high level of comfort during developing adapters, you should derive your adapter classes from the super-class com.softwareag.cis.Server.Adapter. This class already provides some useful methods.

This document covers the following topics:


Access to Lookup Session Context

As you know, session management defines sessions (corresponding to one browser instance) and subsessions (corresponding to one process inside the Application Designer workplace). There is the possibility to bind and look for parameters on both levels:

The result is a context supporting the interface com.softwareag.cis.context.ILookupContext. This interface provides two important methods:

public Object lookup(String s, boolean reactWithErrorIfNotExist);
public void bind(String s, Object o);

The session context is used, for example, to refer to the current user who is logged in, the chosen language, etc. The subsession context is used to share data inside a subsession.

Do not use the context as global variable buffers in a very intensive way. It will end up in programs relying on a lot of context information to be available - and sooner or later no one knows what has to be in the context when starting the program.

Via the methods

you can access the internally used representations of session ID and subsession ID.

Top of page

Access to Application Designer Session Context

Application Designer uses its own lookup session management in order to store information of a session. You can access and manipulate this information by calling your adapter's method:

Inside the session context, the following parameters are kept:

Have a look at the JavaDoc API documentation for more details.

Top of page

Access to other Adapters

Access other adapters inside the same subsession by the methods:

Use this method before navigating between pages in order to prepare the adapter that will be used by the next page.

Top of page

Error Output

You can display error messages inside the status bar (if it is defined in the page layout) by using the methods:

First, pass a string for the type of message. This is needed to display a corresponding icon inside the status bar. There are constants defined inside the Adapter for specifying the type:

The second string is the message being shown.

The third string - which is optional - is the long text description of the message. It becomes visible by a dialog if the user clicks with the mouse on the message. If you do not specify a long description, the normal message is used.

Top of page

Page Navigation

Navigate to a page by using the method:

The "pageName" is the URL - either relative or absolute - of the next page.

Top of page

Opening of Pop-up Dialogs

You can open a page inside a pop-up dialog by using the method:

The "pageName" is the URL - either relative or absolute - of the page that is displayed inside the dialog.

You can specify pop-up parameters of the pop-up you open with openPopup() by using the methods:

Top of page

Frame Communication

There are various methods to communicate to other frames:

Top of page

Closing of a Page

The default method used for closing a page is endProcess(). It is provided by the Adapter class. The tasks performed by the endProcess() method are:

Calling the endProcess() method ensures that all memory resources are released for the corresponding subsession.

The endProcess() method is called by clicking inside the page on the close icon at the top right corner of the page. You can also call it directly inside an adapter, e.g. if you want to close the subsession as reaction to the user's entered data.

Top of page

Multi Language Management

You can access the multi language management using the methods:

The application is the name for the abbreviation of a defined application area for which literals are defined. In the file-based multi language management, it represents the name of a CSV file that holds the text identified by a text ID.

Top of page