Chapter 20 Creating Java Servlets

Web application support

Java servlets support packaging and deploying Web applications. A Web application archive (WAR) file contains all the components of a Web application including servlets, HTML files, JavaServer Pages (JSPs), classes, and other resources. See Chapter 19, "Creating Web Applications" for more information.

EAServer includes a servlet container that provides network services for requests and responses, decodes MIME-based requests, formats MIME-based responses, and manages servlets.

Adding servlets to a Web application

To add servlets to a Web application, copy the servlet class files under %JAGUAR%\Repository\WebApplication\<web-app>\WEB-INF\classes, and use Jaguar Manager to add the servlet to your Web application.

Adding a servlet to a Web application

1. In Jaguar Manager, select either Web Applications | <Web application> or Applications | <application> | Web Applications | <Web application>.
2. Right-click and select New Web Component, and enter the name of the servlet.
3. Select the servlet, right-click, and select Web Application Component Properties.
4. Enter values for the servlet properties described in "Configuring servlet properties".

Mapping a Web application's servlet to a URL

1. In Jaguar Manager, select either Web Applications | <Web application> or Applications | <Application> | Web Applications | <Web application>.
2. Right-click and select Web Application Properties.
3. Select the Servlet Mapping tab and click Add. A new row is added to the mapping table.
4. Place the cursor in the Servlet cell and enter the servlet name that displays in Jaguar Manager.
5. Place the cursor in the URL Pattern cell and enter a string to invoke the servlet from an HTTP URL. For example, if the Web application name is WebApp1 and the URL Pattern string for the servlet is /MyServlet , this URL invokes the servlet:

   http://host:port/WebApp1/MyServlet
   

6. Place the cursor in the Description field and enter a description of the servlet.
7. Click OK.

   Servlets installed in a Web application have no default URL mappings. To invoke a servlet, clients must use the path mapped to the servlet in the Web application properties.

In the normal configuration, you cannot run servlets without using an alias or Web application name in the request URL. You can configure servlets to run with no alias as follows:

1. Install the servlets of interest in your server's Installed Servlets folder, as described in the EAServer Programmer's Guide, Chapter 20, "Creating Java Servlets."
2. Display the Server Properties dialog for your server, then display the All Properties tab.
3. Search for com.sybase.jaguar.server.servlet.servlet-mapping in the list. If the property is present, highlight it and click Modify. Otherwise, click Add and enter the property name.
4. For the property value, enter a comma-separated list of entries with this format:

   (url-pattern=/pattern,servlet-name=servlet)
   

   
   
   Where:
   • pattern is the alias to invoke the servlet, for example, MyServlet .
   • servlet is the servlet name, as defined in Jaguar Manager.
5. For example, to map MyServlet to the path /myservlet, and HelloServlet to the path /hello, enter this value (on one line):

   (url-pattern=/myservlet,servlet-name=MyServlet),(url-pattern=/hello,servlet-name=HelloServlet)
   

   
   
   With these settings, HelloServlet can be invoked with this URL:

   http://host:port/hello
   

Copyright © 2002 Sybase, Inc. All rights reserved.