Error handling  Chapter 25: Sending Result Sets

Chapter 24: Creating JavaServer Pages

Using JSPs in EAServer

For JSPs to run in EAServer, they must belong to a Web application. In addition, you can map servlets to JSPs. When the servlet is called, the corresponding JSP is invoked. This section discusses:

JSP and EAServer overview

EAServer fully supports the features described in the JavaServer Pages 1.2 specification as well as mapping requests to JSPs as described in the Java Servlet 2.3 specification. In EAServer the JSP Engine is implemented as a generic servlet, which is referred to as the JSP servlet. The JSP servlet handles runtime translation and compilation of JSPs, if required, as well as invoking the generated servlet for a given JSP.

The JSP servlet supports translation of JSPs containing JSP standard directives, standard actions, custom tags and scripting elements such as declarations, scriptlets and expressions. For JSPs that include custom JSP tags, a tag handler is loaded every time it is needed. Tag handlers are not pooled. The JSP servlet also supports all the semantics associated with the “extends” attribute.

A Web application is a collection of resources that is mapped to a specific Uniform Resource Identifier (URI) prefix. These resources may include JSPs, servlets, HTML files, and images. The URI that is stored in the request data structure is used to retrieve a JSP. The JSP Servlet creates a unique name for a generated servlet. Generated servlet names are stored in a hash table. For a given request URI, the JSP Servlet determines which generated servlet name it corresponds to. It then looks up the generated servlet name in the hash table; an entry in the hash table indicates that the JSP has been precompiled.

If a JSP is not precompiled, the JSP servlet invokes the compiler and saves the generated files in the appropriate directory. It then executes the page by invoking the _jspService method on the generated servlet.

If a JSP is precompiled, the JSP servlet compares the timestamp of the JSP and all its nested include files, if any, with the timestamp of the generated servlet. If any time stamp of the JSP is more recent than that of the generated servlet, the JSP is recompiled. If the generated servlet is current, the JSP Servlet creates a new instance of the precompiled servlet class and calls _jspService method on it.

The JSP Servlet uses CLASSPATH from ServletConfig for compiling the generated servlet. To change the directory where servlets are generated, set the “scratchdir” parameter as one of the parameters in ServletConfig. “scratchdir” is passed to the “init” method on the JSP Servlet; you can set it by using one of the init-args on the Servlet Properties tab.

JSP 1.2 highlights

The JSP 1.2 specification extends JSP 1.1 in a number of ways:

For detailed information about JavaServer Pages technology, see the Java software Web site.

Compiling JSPs

When you create a JSP using EAServer Manager, the load during startup option determines if your JSPs are compiled at server start-up or when the JSP is first called. You can also use a command-line utility to compile your JSPs manually. This allows you to debug and test your JSPs without running the server. This section describes the JSP compiler supplied with your EAServer installation.

jspc compiler

The %JAGUAR%\bin\jspc.bat (Windows) and $JAGUAR/bin/ (UNIX) compiler provides you with several options for compiling your JSPs. This section uses for demonstration purposes. All options are valid for both systems.

You can also compile JSPs with the jagtool or jagant compilejsp command. For details, see Chapter 12, “Using jagtool and jagant,” in the EAServer System Administration Guide.


           <options> <jsp files>|<jsp dirs> 

options include:

jsp files include any number of:


This section provides examples of the various jspc compiler options: -webapp MyWebApp /pets/cat.jsp /pets/dog.jsp

The compiler identifies the $JAGUAR/Repository/WebApplication/MyWebApp directory as the Web application directory and compiles the cat.jsp and dog.jsp files located in the $JAGUAR/Repository/WebApplication/MyWebApp/pets directory. -uriroot $JAGUAR/Repository/WebApplicaton/MyWebApp -d $JAGUAR/work /pets/cat.jsp /pets/dog.jsp

The compiler identifies the $JAGUAR/Repository/WebApplication/MyWebApp directory as the Web application directory and compiles the cat.jsp and dog.jsp files, which are located in the pets subdirectory, and outputs the results to the $JAGUAR/work directory. -uriroot $JAGUAR/Repository/WebApplicaton/MyWebApp -d $JAGUAR/work -jspdir $JAGUAR/Repository/WebApplicaton/MyWebApp

The compiler identifies the $JAGUAR/Repository/WebApplication/MyWebApp directory as the Web application directory and compiles all JSP files contained in it and any subdirectories, and outputs the results to the $JAGUAR/work directory. -uriroot $JAGUAR/Repository/WebApplicaton/MyWebApp -d $JAGUAR/work -keep /pets/dog.jsp /pets/cat.jsp

the -keep option notifies the compiler to keep all generated Java files in the output directory, along with the compiled JSP files.

JSP file locations

JSPs are contained within Web applications. JSP source code and class files are stored relative to the Web application to which it belongs.

Saving Java source code

Normally, EAServer deletes the Java source code after compiling a JSP. To keep the generated source code to view or use in a debugger:

  1. Display the properties for the Web application in which the JSP is installed.

  2. On the Advanced tab, set the property to true.

Source and class file locations

When the source code is preserved, you can find it in the same directory as the JSP class files. In the default configuration, EAServer maintains a separate JSP class directory for each server in your EAServer installation:


Where server is the name of your server, and WAName is the name of your Web application.

You can enable sharing of class files by setting the Web application property to true. If sharing is enabled, EAServer compiles and loads JSP classes from the directory:


Where WebAppName is the Web application name.

Creating and configuring JSPs in EAServer

JSPs in EAServer must be created in a Web application. If necessary, create the Web application to contain the JSPs as described in Chapter 21, “Creating Web Applications.” You can create new JSPs in EAServer Manager or import them from existing JSP source files.

StepsCreating or importing JSPs

  1. In EAServer Manager, select the Web Application folder.

  2. Select an existing Web application to which you are adding a JSP, then import the JSP or create a new one as follows:

StepsConfiguring the JSP properties

To configure your JSP, double-click the JSP or highlight the JSP and select File | Web Application Component Properties. Complete the information described below:

  1. General properties – select this tab to enter general parameters for your JSP:

  2. Init-Args – select this tab to enter the initialization parameters associated with the JSP. If your JSP uses externally configured parameters, add or modify the values with the controls on this tab:

  3. Advanced – to improve JSP performance, set the value of the property, which determines if and when the JSP runtime checks whether a JSP is current. Set the property value to an integer.

    Complete the rest of the properties as you would for a servlet.

To configure security for your JSP, see Chapter 3, “Using Web Application Security,” the EAServer Security Administration and Programming Guide.

StepsEditing the JSP source

EAServer supplies an editor for creating and modifying your JSP files; however, you can use any text editor to perform the same tasks. To edit the JSP in EAServer Manager:

  1. Open the Web Application folder and select the Web application to which the JSP belongs.

  2. Highlight the JSP.

  3. Select File | Edit JSP. An editor displays where you can view and modify your JSP. Locate other files for editing by selecting File | Open. When you are finished, select File | Save.

StepsDeleting a JSP

  1. Open the Web Application folder and select the Web application to which the JSP file belongs.

  2. Highlight the JSP.

  3. Select File | Delete Web Application Component.


EAServer supports international versions of your Web application resources: Servlets, static Web pages, and so on. For more information, see “Localizing Web applications”.

Mapping JSPs

EAServer supports path mappings as described in the Java Servlet 2.3 specification. Mappings are defined at the Web application level. Refer to Chapter 21, “Creating Web Applications” for information about Request path mappings.

Page caching

EAServer supports page caching, which improves the performance of servlet and JSP requests. When page caching is enabled for a servlet or JSP Web component, the cache is checked before invoking the Web component. For more information, see “Dynamic page caching” in Chapter 5, “Web Application Tuning,” in the EAServer Performance and Tuning Guide.


EAServer supports servlet filters as described in the Java Servlet 2.3 specification. Filters are defined at the Web application-level. For information on creating filters, see Chapter 23, “Using Filters and Event Listeners.”

Copyright © 2005. Sybase Inc. All rights reserved. Chapter 25: Sending Result Sets