Red Hat NETSCAPE ENTERPRISE SERVER 6.0 - NSAPI PROGRAMMER GUIDE Manuale Utente Pagina 1

Programmer’s Guide to ServletsiPlanet Web Server, Enterprise EditionVersion 6.0816-1381-01May 2001

Servlets10 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001ServletsJava servlets are server-side Java programs that we

Differences Between JavaScript and Java100 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001Java is a class-based progr

JavaScript to Java Class Conversions Appendix B Converting SSJS Applications 101JavaScript to Java Class ConversionsThe objects used in an SSJS applic

Conversion Steps102 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001Conversion StepsWhen converting applications, foll

Example Conversion Appendix B Converting SSJS Applications 103Example ConversionThe hangman example, which was a Server-Side JavaScript example in the

Example Conversion104 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001

105Appendix CJVM ConfigurationThe Java Virtual Machine (JVM) works by default without any additional configuration if properly set up. However, if you

Using JVM Environment Variables106 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001Here is an example jvm12.conf file.

jvm12.conf Parameter Reference Appendix C JVM Configuration 107In the myprogram.java file, the following line retrieves the system property set above:

jvm12.conf Parameter Reference108 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001jvm.verboseMode 0 (off), 1 (on) 0 En

jvm12.conf Parameter Reference Appendix C JVM Configuration 109jvm.serializeAttach 0 (off), 1 (on) 0 If on, threads that attach to the JVM are seriali

JavaServer Pages Chapter 1 Servlets and JavaServer Pages 11• by using server-side tags that include Java servletsBoth beans and servlets are Java clas

jvm12.conf Parameter Reference110 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001java.compiler Specifies the Java com

jvm12.conf Parameter Reference Appendix C JVM Configuration 111jvm.classpath A path with forward slashes onlySpecifies the path(s) to JAR files depend

jvm12.conf Parameter Reference112 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001

113Appendix DRemote Servlet ProfilingYou can use a profiler to perform remote profiling on the iPlanet Web Server to discover bottlenecks in server-si

The HPROF Profiler114 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001Also, update the PATH and NSES_CLASSPATH system

The HPROF Profiler Appendix D Remote Servlet Profiling 115The syntax of HPROF is as follows:-Xrunhprof[:help]|[:option=value,option2=value2, ...]Using

The HPROF Profiler116 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001This displays the following ASCII menu in the wi

117IndexAabout this book 7accessTimeColumnparameter for IWSSessionManager 60parameter for JdbcSessionManager 68API clarifications 71API referenceJavaB

118 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001debuggingJSPs 50servlets remotely 49default context 16default virt

Index 119installingForte for Java 51JPDA 52JRE or JDK 31, 37Internationalization 22, 74, 92Intuitive Systemsweb site 113isModifiedCheckAggressive con

JavaServer Pages12 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001

120 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001jvm.disableThreadRecycling parameter 108jvm.enableClassGC paramete

Index 121Ppackage namesfor JSPs 46parameterEncoding context property 92parameter-encoding element 22param-name element 22param-value element 22passwo

122 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001directives 95enabling legacy 80example of accessing 29example of a

Index 123parameter for JdbcSessionManager 67parameter for MMapSessionManager 63parameter for SimpleSessionManager 65timeOut attribute 21timeOutColumn

124 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001

13Chapter 2Web ApplicationsiPlanet Web Server 6.0 supports the Servlet 2.2 API specification, which allows servlets and JSPs to be included in web app

Dynamic Reconfiguration14 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001A special directory under the document root,

web.xml Clarifications Chapter 2 Web Applications 15If you add or remove a web application, servlet, or JSP, you must restart the server.web.xml Clari

The web-apps.xml File and Virtual Servers16 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001The web-apps.xml File and

The web-apps.xml File and Virtual Servers Chapter 2 Web Applications 17The following server.xml file uses these variables:<?xml version="1.0&q

The web-apps.xml File and Virtual Servers18 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001Example web-apps.xml FileN

The web-apps.xml File and Virtual Servers Chapter 2 Web Applications 19<session-tracking use-cookies="true" /> <!-- Define the web

Copyright © 2001 Sun Microsystems, Inc. Some preexisting portions Copyright © 2001 Netscape Communications Corporation. All rights reserved. Sun, Sun

The web-apps.xml File and Virtual Servers20 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001class-loaderThe class load

The web-apps.xml File and Virtual Servers Chapter 2 Web Applications 21form-login-sessionConfigures form-based authentication for single sign-on acros

The web-apps.xml File and Virtual Servers22 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001param-nameThe name of a pa

The web-apps.xml File and Virtual Servers Chapter 2 Web Applications 23If a servlet uses the ServletRequest.getParameter method to retrieve values in

The web-apps.xml File and Virtual Servers24 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001response-bufferConfigures

The web-apps.xml File and Virtual Servers Chapter 2 Web Applications 25session-cookieSets parameters for the session cookie.Subelements: noneAttribute

The web-apps.xml File and Virtual Servers26 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001tempdirA temporary directo

Deploying a Web Application using wdeploy Chapter 2 Web Applications 27Deploying a Web Application using wdeployBefore you can deploy a web applicatio

Deploying a Web Application using wdeploy28 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001• The .WAR file gets extra

Web Application Examples Chapter 2 Web Applications 29For example:http://acme.com:80/hello/index.jspor:http://acme.com/hello/Web Application Examplesi

3ContentsAbout This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Web Application Examples30 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001

31Chapter 3Using ServletsThis chapter discusses how to enable and configure servlets in iPlanet Web Server 6.0. The sections in this chapter are:• Wha

Using the User Interface32 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001Using the User InterfaceFor information abo

The <SERVLET> SHTML Tag Chapter 3 Using Servlets 33The <SERVLET> SHTML TagiPlanet Web Server 6.0 supports the <SERVLET> tag as intro

Servlet Output34 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001You would also need to include the following in your

Configuring JVM Chapter 3 Using Servlets 35Configuring JVMIf necessary, you can configure parameters for JVM either by using the Java>Configure JVM

Maximizing Servlet Performance36 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001You can set the stack space using the

37Chapter 4Using JavaServer PagesThis chapter discusses how to enable and configure JavaServer Pages (JSPs) in iPlanet Web Server 6.0. The sections in

What Does the Server Need to Run JSP?38 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001Check the iPlanet Web Server I

Configuring JRE/JDK Paths Chapter 4 Using JavaServer Pages 39When you install iPlanet Web Server 6.0, one of the dialog boxes in the installation proc

4 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001response-cookie . . . . . . . . . . . . . . . . . . . . . . . . . .

Configuring JRE/JDK Paths40 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001• JDK Runtime ClasspathThe class path incl

Using the User Interface Chapter 4 Using JavaServer Pages 41NSES_JDK should point to the installation directory for the JDK, while NSES_JRE should poi

Enabling JSPs42 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001Enabling JSPsTo enable JSPs, follow these steps:1. Ena

The JSP Command-Line Compiler Chapter 4 Using JavaServer Pages 43The cache has a Version file containing a version number that the server uses to dete

The JSP Command-Line Compiler44 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001-v[level] Enables verbose mode. The le

The JSP Command-Line Compiler Chapter 4 Using JavaServer Pages 45The -webinc and -webxml options may not be useful for JSPs in iPlanet Web Server.For

The JSP Command-Line Compiler46 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001Package Names Generated by the JSP Com

JSP Tag Libraries and Standard Portable Tags Chapter 4 Using JavaServer Pages 47Other JSP Initialization ParametersYou can include the following initi

JSP Tag Libraries and Standard Portable Tags48 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001

49Chapter 5Debugging Servlets and JSPsThis appendix gives guidelines for debugging servlets and JSPs in iPlanet Web Server 6.0. It includes the follow

Contents 5Chapter 6 Session Managers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Session

JSP Debugging50 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 20012. Set the following parameters in jvm12.conf as appro

Generating a Stack Trace for Debugging Chapter 5 Debugging Servlets and JSPs 513. To send exceptions to the client in addition to the log file, set th

Using Forte for Java to Debug Servlets and JSPs52 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 20014. iPlanet strongly

JPDA Options for Debugging Chapter 5 Debugging Servlets and JSPs 53JPDA Options for DebuggingA list of debugging options that you can include in the j

JPDA Options for Debugging54 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001

55Chapter 6Session ManagersSession objects maintain state and user identity across multiple page requests over the normally stateless HTTP protocol. A

Specifying a Session Manager56 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001iPlanet Web Server 6.0 comes with these

Specifying a Session Manager Chapter 6 Session Managers 57</init-param><init-param> <param-name>reapInterval</param-name><p

IWSSessionManager58 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001IWSSessionManagerThe IWSSessionManager is the defa

IWSSessionManager Chapter 6 Session Managers 59• maxLocks - the number of cross-process locks to use for synchronizing access to individual sessions a

6 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001contexts.properties . . . . . . . . . . . . . . . . . . . . . . .

IWSSessionManager60 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001• provider - the JDBC driver (the default is sun.j

IWSSessionManager Chapter 6 Session Managers 61• insertPool - the number of connections that perform insert operations (the default is 4 connections).

MMapSessionManager (Unix Only)62 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001• Use the Legacy Servlets>Configur

MMapSessionManager (Unix Only) Chapter 6 Session Managers 63ParametersMMapSessionManager takes the following parameters:•maxSessions - the maximum num

MMapSessionManager (Unix Only)64 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001You can also specify parameters for t

Deprecated Session Managers Chapter 6 Session Managers 65Deprecated Session ManagersThe SimpleSessionManager and the JdbcSessionManager are provided f

Deprecated Session Managers66 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001Enabling SimpleSessionManagerYou may wan

Deprecated Session Managers Chapter 6 Session Managers 67This sample JDBC session manager is not written, tested, or intended for production use. It i

Deprecated Session Managers68 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001• reaperActive - tells the session manag

Load Balancing, Session Failover, and Session IDs Chapter 6 Session Managers 69timeOut=1200,username=mysession,password=mypassword• Edit the file serv

7About This BookThis book discusses how to enable and install Java servlets and JavaServer Pages (JSP) in iPlanet™ Web Server, Enterprise Edition 6.0.

Load Balancing, Session Failover, and Session IDs70 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001NOTE The session I

71Chapter 7API ClarificationsThis appendix clarifies ways in which the Servlet 2.2 API specification is implemented in iPlanet Web Server 6.0 in the f

Clarifications for Using Methods72 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001• Make sure that the session attrib

Clarifications for Using Methods Chapter 7 API Clarifications 73HttpServlet.servicepublic void service(ServletRequest req, ServletResponse res) throws

Clarifications for Using Methods74 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001ServletRequest.getParameterpublic j

Clarifications for Using Methods Chapter 7 API Clarifications 75For JSPs, set the response content type using a page directive, for example: <%@ pa

Clarifications for Using Methods76 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001RequestDispatcher.forward and inclu

Other Useful Information Chapter 7 API Clarifications 77Other Useful InformationThis section contains information about the following topics:• Databas

Other Useful Information78 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001

79Chapter 8Legacy Servlet and JSPConfigurationThis chapter describes legacy configuration procedures and files, which are provided for backward compat

8 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001This chapter discusses methods in the Servlets API that behave margi

Enabling Servlets and JSP80 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001Enabling Servlets and JSPTo enable and dis

Configuring Servlets in the Default Virtual Server Chapter 8 Legacy Servlet and JSP Configuration 81In detail, to serve servlets in the default virtua

Configuring Servlets in the Default Virtual Server82 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001For example, if t

Configuring Servlets in the Default Virtual Server Chapter 8 Legacy Servlet and JSP Configuration 83Registering Individual ServletsThe iPlanet Web Ser

Configuring Servlets in the Default Virtual Server84 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001Note that you can

Configuring Servlets in the Default Virtual Server Chapter 8 Legacy Servlet and JSP Configuration 85In the Legacy Servlets>Configure Servlet Attrib

Using the User Interface86 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001/plans/plan1=plan1AAfter this virtual servl

Legacy Configuration Files Chapter 8 Legacy Servlet and JSP Configuration 87Legacy Configuration FilesThis section discusses the purpose and use of th

Legacy Configuration Files88 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001Here is a sample servlets.properties file

Legacy Configuration Files Chapter 8 Legacy Servlet and JSP Configuration 89Here is an example of rules.properties. # Servlet rules properties## This

9Chapter 1Servlets and JavaServer PagesiPlanet Web Server 6.0 supports servlets and JavaServer Pages (JSPs). This chapter gives a brief overview of se

Legacy Configuration Files90 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001For a way to direct files of a specific t

Legacy Configuration Files Chapter 8 Legacy Servlet and JSP Configuration 91# server checks for jsp and servlet files being modified (global # context

Legacy Configuration Files92 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001# context.global.parameterEncoding=utf8#

Legacy Examples Chapter 8 Legacy Servlet and JSP Configuration 93If a servlet uses the ServletRequest.getParameter method to retrieve values in form f

Maximizing Legacy Servlet Performance94 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001The legacy subdirectory contai

95Appendix AServlet Settings in magnus.conf andobj.confThe iPlanet Web Server 6.0 Administration Server automatically modifies the magnus.conf and obj

Objects in obj.conf96 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001for Unix, the directives are the same except for

Objects in obj.conf Appendix A Servlet Settings in magnus.conf and obj.conf 97For another way to direct files of a specific type to a specific servlet

Directives for Registered Servlet Directories98 iPlanet Web Server, Enterprise Edition Programmer’s Guide to Servlets • May 2001Directives for Registe

99Appendix BConverting SSJS ApplicationsThis appendix contains information about converting Server-Side JavaScript applications to JSPs. It has the fo