The WebHandler ABL Class wizard helps you create new web handler class file.

This wizard appears when you select File > New > WebHandler.

Note: If WebHandler does not appear in your File menu, click File > New > other and select Progress OpenEdge > Editor > WebHandler. You can alternatively right-click the project and select New > WebHandler.

The following controls are available:

Package root Specifies a currently open project to contain the class code and other project code. Click Browse if you want to select a project other than the current one (the default value).
Package Optionally specifies a package name that corresponds to a sub-folder of the package root, and will contain the class file. Click Browse if you want to select a project other than the current one (the default value). A period (.) must separate each subfolder from its parent folder in the path name..
WebHandler name (Required) Specifies the name of the WebHandler class.
Final If selected, specifies that inheritance from this class is not allowed. A FINAL option is included in the generated ABL code.

A Final class cannot be Abstract.
Abstract If selected, specifies that the Web handler class is abstract and cannot be instantiated. An abstract class is designed to serve as a super class from which other classes inherit and implement members. Therefore, an Abstract class cannot be Final.
Widget pool If selected, specifies that a USE-WIDGET-POOL option will be included in the generated ABL code.
Serializable If selected, marks to mark the WebHandler class as serializable by including the SERIALIZABLE modifier in the generated ABL code.
Note: If the class inherits from a super class that is not serializable, then it cannot be marked as serializable.
Inherits Optionally specifies another class in the current project as a super class (or a different project that is available in the propath) from which the new class inherits state and behavior in the Inherits field. Click Browse or enter the class path by typing. A period (.) must separate each node from its parent folder in the path name.
Note: By default, the super class name is populated as OpenEdge.Web.WebHandler. The super class cannot be generic.
Implements Lets you optionally specify one or more interfaces in the current project or a different project that is available in the propath that the class implements using the Implements section. Click Add and select the required interfaces in the Interface Selection dialog. Click Remove to remove an interface from the list after adding it.
Method stubs Specifies the methods that you want to generate in the Web handler class.
Error-handling statement Adds one of the following error-handling statements to the generated ABL code:
  • Block level: Includes the BLOCK-LEVEL ON ERROR UNDO, THROW statement
  • Routine level: Includes the ROUTINE-LEVEL ON ERROR UNDO, THROW statement
Throw a Not Implemented exception If selected, specifies that "METHOD NOT IMPLEMENTED" error code is added to stubs for members implemented via interface and stubs for inherited abstract members.
Return a default value If selected, specifies that the default return values are added to stubs for members implemented through interface and stubs for inherited abstract members.