JSP Proxy Page Builder

 

In this topic ...

Quick Tip

Specifying Inputs

Related Topics ...

Overview: Creating Pages

JSP Guidelines

JSP Proxy Page writes code to the specified JSP file, so that it executes the specified model action instead of what the JSP did originally.  This keeps the links in existing JSP applications from breaking, but allows you to either re-implement the functionality of the JSP page in the current model or associate builder calls with some elements of the JSP page without changing other parts of the page or application.

There are two ways in which we can use the JSP Proxy Page builder:

  • Adding a Model Action without Importing the JSP into the Model -- In this case, when the user accesses the JSP page, the specified model action runs and displays a page or executes a method or service call. You could think of this approach as "replacing" the functionality of the JSP page without changing the links to that JSP page from other pages in the JSP application.

We can re-implement the functionality of the JSP page with other pages and builder calls in the current model.

  • Modify a JSP page in an existing application by allowing builder calls to operate on it -- In this case, you access the JSP page just as you always did, except that when it runs, builder calls from the current model can act on that JSP page. We can then profile those builder calls.

By adding a JSP Proxy Page builder call for each JSP page you want to modify with builder calls, we can implement an "as needed" automation of your JSP application.

 

Quick Tips

  • Keep in mind that the users of the JSP application have access to the current model via the JSP page. Avoid exposing a highly secure model through a less secure JSP page to users.

 

Specifying Inputs

The JSP Proxy Page builder takes the inputs described in the table below. For help on inputs common to many or all builders such as those in the Properties and HTML Attributes input groups, see "Using the Builder Call Editor."

Input name Description
Name Enter a name for this builder call. The designer tool displays this name in the builder call list.
JSP File Path Enter the path to the local path to the JSP file relative to the Factory's document root directory. For example,

wpf.war/acme/mypage.jsp

Action To specify a model action to run when the specified JSP page is run, use the Action chooser to select a model action. Also, confirm that the Import JSP as Page input is disabled.

To add builder calls that operate on this JSP page, enter the name of this JSP Proxy Page builder call here. Also, confirm that the Import JSP as Page input is enabled.

Explicit Profile We can specify the profile values to use for any profiled builder calls by entering a profile name here.
Import JSP as Page Enable this checkbox if you want builder calls in your model to act on the JSP page.

Disable this checkbox if you specified an action other than the JSP page.