{section}
{column:width=30%}
{panel:borderStyle=outset|borderColor=#ff9900|bgColor=#ffffff}
*+[Home]+*
*+[Read Me First]+*
*+[Purpose and Policy]+*
*+[Frequently Asked Questions]+*
*+[Recently Updated Pages]+*
{panel}
{panel:borderStyle=outset|borderColor=#ff9900|bgColor=#ffffff}
{livesearch:spaceKey=WebServerdocs}
{panel}
{panel:borderStyle=outset|borderColor=#ff9900|titleBGColor=#BDBEC0|bgColor=#ffffff}
*{color:black}Table of Contents{color}*
----
{toc:minLevel=2|maxLevel=5|indent=15px}
{panel}
\\
{panel:borderStyle=outset|borderColor=#ff9900|bgColor=#ffffff}
*{color:black}Top Contributors {color}*
----
{contributors-summary:columns=edits,comments|order=edits|labels=+jwadguide}
{panel}
{column}
{column}
h1. Sun Java System Web Server 7.0 Update 5 Developer's Guide to Java Web Applications {anchor:jwadguide}
||[Download this book|^Developer's Guide to Java Web Applications.tar.gz ]||
This book explains how Web Applications are created, deployed, and supported in Sun Java™ System Web Server 7.0. The book also includes basic information about Web Services.
{panel:borderStyle=outset|borderColor=#ff9900|title=Related Documents|titleBGColor=#ff9900|bgColor=#ffffff}
*[Sun Java System Web Server 7.0 Update 5 Documentation Center|http://docs.sun.com/app/docs/doc/820-7340]*
*[Sun Java System Web Server 7.0 Update 5 Release Notes|Release Notes]*
*[Sun Java System Web Server 7.0 Update 5 Administrator's Configuration File Reference|Administrator's Configuration File Reference]*
*[Sun Java System Web Server 7.0 Update 5 Performance Tuning, Sizing and Scaling Guide|Performance Tuning, Sizing and Scaling Guide]*
*[Sun Java System Web Server 7.0 Update 5 Developer's Guide|Developer's Guide]*
*[Sun Java System Web Server 7.0 Update 5 Troubleshooting Guide|Troubleshooting Guide]*
*[Sun Java System Web Server 7.0 Update 5 NSAPI Developer's Guide|NSAPI Developer's Guide]*
*[Sun Java System Web Server 7.0 Update 5 Installation and Migration Guide|Installation and Migration Guide]*
*[Sun Java System Web Server 7.0 Update 5 Administrator's Guide|Administrator's Guide]*
*[Sun Java System Web Server 7.0 Update 5 CLI Reference Manual|http://docs.sun.com/app/docs/doc/820-7337]*
{panel}
h2. Web Server Technologies Overview {anchor:chapt1}
This chapter provides a basic overview on various technologies that are supported in the Web Server.
This chapter contains the following section:
* h6. [Technologies and Enhancements in Web Server 7.0]
h2. Web Applications Overview {anchor:chapt2}
Web Server supports the Java™ Servlet 2.5 API specification and the JavaServer Pages™ (JSP™) 2.1 specification, which allows servlets and JSPs to be included in web applications.
A web application is a collection of servlets, JavaServer Pages, HTML documents, and other web resources that include image files, compressed archives, and other data. A web application can be packaged into a web archive (WAR) file or exist in an open directory structure.
Web Server 7.0 also supports, SHTML and CGI, which are not Java Platform, Enterprise Edition (Java EE) application components. For more information about APIs and programming technologies, see [Sun Java System Web Server Developer's Guide|Developer's Guide].
This chapter provides a basic overview of how web applications are supported in Web Server.
This chapter contains the following sections:
* h6. [Developing and Deploying Web Applications]
* h6. [Sample Applications in Web Server 7.0]
\[*Back to* *[top|#jwadguide]*\]
h2. Web Services Overview {anchor:chapt3}
Web Services uses a Web Services Description Language (WSDL) file to describe the service and registry service to register and look up the services. The Simple Object Access Protocol (SOAP) binding is the standard interoperable binding for accessing Web Services. Several registry protocols available, butUDDI (Universal Description, Discovery and Integration) is probably the most recognizable based on Java Web ServicesDeveloper Pack, Web Server because it supports integrated Java Web Services runtime and tools, and therefore supports portable Web Services implementations, making it interoperable with .NET clients and services using the WS-I Basic Profile. For more information on Web Services, see http://java.sun.com/webservices/docs/2.0/tutorial/doc/index.html.
WS-Security is an OASIS proposal for adding message-layer security to SOAP messages. It defines standardized locations and syntax by which security tokens such as X.509 certificates and Kerberos tickets can be carried within SOAP Headers in order to secure the contents of the SOAP message exchanges. WS-Security leverages the existing XML Digital Signature and XML
Encryption specifications for capturing the results of signing and encryption operations in XML syntax. In essence, WS-Security standardizes the XML Signature and XML Encryption data blocks that are carried with a SOAP message. Web Server supports the integrated WS-Security standard. In addition, this release supports JSR-196 as applicable to Web Services.
Web Server provides the ability to bind SOAP-layer message-security providers and message-protection policies to the container. This binding allows the container to enforce the security on behalf of the applications.
This chapter focuses on web services tasks that are performed by developers. For administrator tasks, including configuration and management information, see _Appendix C, Web Services_, in [Sun Java System Web Server Administrator's Guide|Administrator's Guide].
This chapter contains the following sections:
* h6. [Technologies Supported in Web Server 7.0]
* h6. [Creating Web Services]
* h6. [Securing Web Services]
* h6. [Deploying and Testing Web Services]
h2. Developing Servlets {anchor:chapt4}
This chapter describes how to create servlets to control web application interactions running on a Web Server. In addition, this chapter describes the Web Server features used to augment the Java Servlet 2.5 standards.
This chapter has the following sections:
* h6. [About Servlets]
* h6. [Caching Servlet Results]
* h6. [Maximizing Servlet Performance]
* h6. [Servlet Internationalization Issues]
* h6. [Migrating Legacy Servlets]
\[*Back to* *[top|#jwadguide]*\]
h2. Developing JavaServer Pages {anchor:chapt5}
This chapter describes how to use JavaServer Pages (JSP™) page templates in a Web Server application.
This chapter has the following sections:
* h6. [Introducing JSPs]
* h6. [Compiling and Debugging JSPs]
* h6. [JSP Tag Libraries and Standard Portable Tags]
h2. Session Managers {anchor:chapt6}
Session objects maintain state and user identity across multiple page requests over the normally stateless HTTP protocol. A session persists for a specified period of time, across more than one connection or page request from the user. A session usually corresponds to one user, who might visit a site many times. The server can maintain a session either by using cookies or by rewriting URLs. Servlets can access the session objects to retrieve state information about the session.
This chapter describes sessions and session managers, and has the following sections:
* h6. [Introducing Sessions]
* h6. [Using Sessions]
* h6. [Session Managers]
h2. Developing Lifecycle Listeners {anchor:chapt7}
This chapter provides a basic overview, and a description of various features of lifecycle listeners in Web Server. It includes the following section:
* h6. [Web Server Lifecycle Listeners]
h2. Securing Web Applications {anchor:chapt8}
This chapter describes the basic goals and features of Web Server security features related to the Java Servlet Container. It also describes how to write secure Java web applications containing components that perform user authentication and access authorization tasks.
This chapter has the following sections:
* h6. [Supported Features and Terminology]
* h6. [Security Features]
* h6. [User Authentication and Authorization]
* h6. [Using Web Services Message Security]
* h6. [Programmatic Login]
* h6. [Enabling the Java Security Manager]
* h6. [The server.policy File]
* h6. [Related Information]
\[*Back to* *[top|#jwadguide]*\]
h2. Deploying Web Applications {anchor:chapt9}
This chapter describes how web applications are assembled and deployed in Web Server. The chapter has the following sections:
* h6. [Web Application Structure]
* h6. [Deployment Tools]
* h6. [Deploying Web Applications]
* h6. [Auto-Deploying Web Applications]
* h6. [Managing Web Applications]
* h6. [Dynamic Reloading of Web Applications]
* h6. [Classloaders]
h2. Debugging Web Applications {anchor:chapt10}
This chapter provides guidelines for debugging web applications in Web Server. The chapter includes the following sections:
* h6. [Debugging Web Applications]
Debugging applications requires you to edit the server.xml file. For more general information, see [Sun Java System Web Server Administrator's Configuration File Reference|Administrator's Configuration File Reference].
h2. Appendix A: Deployment Descriptor Files {anchor:appendA}
The deployment descriptor conveys the elements and configuration information of a web application between application developers, application assemblers, and deployers. For Java Servlets v.2.5, the deployment descriptor is defined in terms of an XML schema document.
This chapter includes the following sections:
* h6. [Extension to Standard Descriptors]
* h6. [Sun Java System Web Server Descriptors]
* h6. [Elements in the default-web.xml File]
* h6. [Elements in the sun-web.xml File]
** [General Elements]
** [Security Elements]
** [Session Elements]
** [Reference Elements]
** [Caching Elements]
** [Classloader Element]
** [JSP Element]
** [Internationalization Elements]
** [Alphabetical List of sun-web.xml Elements]
* h6. [Sample Web Application XML Files]
\[*Back to* *[top|#jwadguide]*\]
{column}
{section}
{column:width=30%}
{panel:borderStyle=outset|borderColor=#ff9900|bgColor=#ffffff}
*+[Home]+*
*+[Read Me First]+*
*+[Purpose and Policy]+*
*+[Frequently Asked Questions]+*
*+[Recently Updated Pages]+*
{panel}
{panel:borderStyle=outset|borderColor=#ff9900|bgColor=#ffffff}
{livesearch:spaceKey=WebServerdocs}
{panel}
{panel:borderStyle=outset|borderColor=#ff9900|titleBGColor=#BDBEC0|bgColor=#ffffff}
*{color:black}Table of Contents{color}*
----
{toc:minLevel=2|maxLevel=5|indent=15px}
{panel}
\\
{panel:borderStyle=outset|borderColor=#ff9900|bgColor=#ffffff}
*{color:black}Top Contributors {color}*
----
{contributors-summary:columns=edits,comments|order=edits|labels=+jwadguide}
{panel}
{column}
{column}
h1. Sun Java System Web Server 7.0 Update 5 Developer's Guide to Java Web Applications {anchor:jwadguide}
||[Download this book|^Developer's Guide to Java Web Applications.tar.gz ]||
This book explains how Web Applications are created, deployed, and supported in Sun Java™ System Web Server 7.0. The book also includes basic information about Web Services.
{panel:borderStyle=outset|borderColor=#ff9900|title=Related Documents|titleBGColor=#ff9900|bgColor=#ffffff}
*[Sun Java System Web Server 7.0 Update 5 Documentation Center|http://docs.sun.com/app/docs/doc/820-7340]*
*[Sun Java System Web Server 7.0 Update 5 Release Notes|Release Notes]*
*[Sun Java System Web Server 7.0 Update 5 Administrator's Configuration File Reference|Administrator's Configuration File Reference]*
*[Sun Java System Web Server 7.0 Update 5 Performance Tuning, Sizing and Scaling Guide|Performance Tuning, Sizing and Scaling Guide]*
*[Sun Java System Web Server 7.0 Update 5 Developer's Guide|Developer's Guide]*
*[Sun Java System Web Server 7.0 Update 5 Troubleshooting Guide|Troubleshooting Guide]*
*[Sun Java System Web Server 7.0 Update 5 NSAPI Developer's Guide|NSAPI Developer's Guide]*
*[Sun Java System Web Server 7.0 Update 5 Installation and Migration Guide|Installation and Migration Guide]*
*[Sun Java System Web Server 7.0 Update 5 Administrator's Guide|Administrator's Guide]*
*[Sun Java System Web Server 7.0 Update 5 CLI Reference Manual|http://docs.sun.com/app/docs/doc/820-7337]*
{panel}
h2. Web Server Technologies Overview {anchor:chapt1}
This chapter provides a basic overview on various technologies that are supported in the Web Server.
This chapter contains the following section:
* h6. [Technologies and Enhancements in Web Server 7.0]
h2. Web Applications Overview {anchor:chapt2}
Web Server supports the Java™ Servlet 2.5 API specification and the JavaServer Pages™ (JSP™) 2.1 specification, which allows servlets and JSPs to be included in web applications.
A web application is a collection of servlets, JavaServer Pages, HTML documents, and other web resources that include image files, compressed archives, and other data. A web application can be packaged into a web archive (WAR) file or exist in an open directory structure.
Web Server 7.0 also supports, SHTML and CGI, which are not Java Platform, Enterprise Edition (Java EE) application components. For more information about APIs and programming technologies, see [Sun Java System Web Server Developer's Guide|Developer's Guide].
This chapter provides a basic overview of how web applications are supported in Web Server.
This chapter contains the following sections:
* h6. [Developing and Deploying Web Applications]
* h6. [Sample Applications in Web Server 7.0]
\[*Back to* *[top|#jwadguide]*\]
h2. Web Services Overview {anchor:chapt3}
Web Services uses a Web Services Description Language (WSDL) file to describe the service and registry service to register and look up the services. The Simple Object Access Protocol (SOAP) binding is the standard interoperable binding for accessing Web Services. Several registry protocols available, butUDDI (Universal Description, Discovery and Integration) is probably the most recognizable based on Java Web ServicesDeveloper Pack, Web Server because it supports integrated Java Web Services runtime and tools, and therefore supports portable Web Services implementations, making it interoperable with .NET clients and services using the WS-I Basic Profile. For more information on Web Services, see http://java.sun.com/webservices/docs/2.0/tutorial/doc/index.html.
WS-Security is an OASIS proposal for adding message-layer security to SOAP messages. It defines standardized locations and syntax by which security tokens such as X.509 certificates and Kerberos tickets can be carried within SOAP Headers in order to secure the contents of the SOAP message exchanges. WS-Security leverages the existing XML Digital Signature and XML
Encryption specifications for capturing the results of signing and encryption operations in XML syntax. In essence, WS-Security standardizes the XML Signature and XML Encryption data blocks that are carried with a SOAP message. Web Server supports the integrated WS-Security standard. In addition, this release supports JSR-196 as applicable to Web Services.
Web Server provides the ability to bind SOAP-layer message-security providers and message-protection policies to the container. This binding allows the container to enforce the security on behalf of the applications.
This chapter focuses on web services tasks that are performed by developers. For administrator tasks, including configuration and management information, see _Appendix C, Web Services_, in [Sun Java System Web Server Administrator's Guide|Administrator's Guide].
This chapter contains the following sections:
* h6. [Technologies Supported in Web Server 7.0]
* h6. [Creating Web Services]
* h6. [Securing Web Services]
* h6. [Deploying and Testing Web Services]
h2. Developing Servlets {anchor:chapt4}
This chapter describes how to create servlets to control web application interactions running on a Web Server. In addition, this chapter describes the Web Server features used to augment the Java Servlet 2.5 standards.
This chapter has the following sections:
* h6. [About Servlets]
* h6. [Caching Servlet Results]
* h6. [Maximizing Servlet Performance]
* h6. [Servlet Internationalization Issues]
* h6. [Migrating Legacy Servlets]
\[*Back to* *[top|#jwadguide]*\]
h2. Developing JavaServer Pages {anchor:chapt5}
This chapter describes how to use JavaServer Pages (JSP™) page templates in a Web Server application.
This chapter has the following sections:
* h6. [Introducing JSPs]
* h6. [Compiling and Debugging JSPs]
* h6. [JSP Tag Libraries and Standard Portable Tags]
h2. Session Managers {anchor:chapt6}
Session objects maintain state and user identity across multiple page requests over the normally stateless HTTP protocol. A session persists for a specified period of time, across more than one connection or page request from the user. A session usually corresponds to one user, who might visit a site many times. The server can maintain a session either by using cookies or by rewriting URLs. Servlets can access the session objects to retrieve state information about the session.
This chapter describes sessions and session managers, and has the following sections:
* h6. [Introducing Sessions]
* h6. [Using Sessions]
* h6. [Session Managers]
h2. Developing Lifecycle Listeners {anchor:chapt7}
This chapter provides a basic overview, and a description of various features of lifecycle listeners in Web Server. It includes the following section:
* h6. [Web Server Lifecycle Listeners]
h2. Securing Web Applications {anchor:chapt8}
This chapter describes the basic goals and features of Web Server security features related to the Java Servlet Container. It also describes how to write secure Java web applications containing components that perform user authentication and access authorization tasks.
This chapter has the following sections:
* h6. [Supported Features and Terminology]
* h6. [Security Features]
* h6. [User Authentication and Authorization]
* h6. [Using Web Services Message Security]
* h6. [Programmatic Login]
* h6. [Enabling the Java Security Manager]
* h6. [The server.policy File]
* h6. [Related Information]
\[*Back to* *[top|#jwadguide]*\]
h2. Deploying Web Applications {anchor:chapt9}
This chapter describes how web applications are assembled and deployed in Web Server. The chapter has the following sections:
* h6. [Web Application Structure]
* h6. [Deployment Tools]
* h6. [Deploying Web Applications]
* h6. [Auto-Deploying Web Applications]
* h6. [Managing Web Applications]
* h6. [Dynamic Reloading of Web Applications]
* h6. [Classloaders]
h2. Debugging Web Applications {anchor:chapt10}
This chapter provides guidelines for debugging web applications in Web Server. The chapter includes the following sections:
* h6. [Debugging Web Applications]
Debugging applications requires you to edit the server.xml file. For more general information, see [Sun Java System Web Server Administrator's Configuration File Reference|Administrator's Configuration File Reference].
h2. Appendix A: Deployment Descriptor Files {anchor:appendA}
The deployment descriptor conveys the elements and configuration information of a web application between application developers, application assemblers, and deployers. For Java Servlets v.2.5, the deployment descriptor is defined in terms of an XML schema document.
This chapter includes the following sections:
* h6. [Extension to Standard Descriptors]
* h6. [Sun Java System Web Server Descriptors]
* h6. [Elements in the default-web.xml File]
* h6. [Elements in the sun-web.xml File]
** [General Elements]
** [Security Elements]
** [Session Elements]
** [Reference Elements]
** [Caching Elements]
** [Classloader Element]
** [JSP Element]
** [Internationalization Elements]
** [Alphabetical List of sun-web.xml Elements]
* h6. [Sample Web Application XML Files]
\[*Back to* *[top|#jwadguide]*\]
{column}
{section}