Websydian v6.1 online documentationOnline documentation - Websydian v6.5

J2EE Event Dispatcher Implementing

This document describes how to implement a J2EE application using Websydian.

Implementing a J2EE Application

A Websydian J2EE application is implemented like any other Websydian application using the EventHandler and PageGenerator patterns. The only difference is that the EventDispatcher must inherit from J2eeEventDispatcher instead of EventDispatcher.

The CA Plex 5.1 is required in order to create J2EE applications, in general we recommend using CA Plex 5.1 when creating Java programs.

Inherit from J2eeEventDispatcher

The EventDispatcher function in a Websydian J2EE application must inherit from the J2eeEventDispatcher function.

Specify the following triples to implement a J2eeEventDispatcher function

MyDispatcher is a FNC J2eeEventDispatcher
  impl name NME MyJ2EEDisp
  file name NME MyJ2EEDisp

The file name of the MyDispatcher function is used when configuring the J2eeProxy servlet as it needs to know the name of the J2eeEventDispatcher that it should call.

In addition to this you must perform the steps as when implementing a standard EventDispatcher function.

Set Model Options

Before generating and building it is important to ensure that the Plex model options are configured correctly.

First open the Model Configuration panel and set the variant of the group models as shown in the table below.

Model Configuration
Group Model Variant
WSYBASE DWA - Java
WSYDOM (if using TransacXML) Java parser
DATE JAVA server
STORAGE JAVA server or iSeries server (refer to the Plex documentation)
UIBASIC Java or Base (this only affects panel functions - refer to the Plex documentation)
SDSTRING Java
WSYHTTP Java

Open the Generate and Build Options panel and set the build configuration as shown in the table below. Please refer to the Plex documentation for more details.

System Definitions --> Properties --> Java Build
Option Name Value
Nmake Directory Specify the path to the folder where the Nmake executable is located.
Compiler Specify the path to the Java compiler executable.
JDK Classes Any JDK classes used by the application.
User classes Insert the path to the Websydian java runtime WsydDwa21.jar.
Java Encoding Default

See the manuals of your J2EE server for general information about deploying applications. For information on the Plex EJBs and EJBProxy consult the Plex manual. Information about deployment issues of the Websydian J2eeProxy can be found here.