Java EE 6 SDK

Samples Main Page

# The Programmatic Configuration of HTTP Session Cookies Sample Application

This sample application demonstrates the new programmatic configuration support for session cookies available with Servlet 3.0.

## Description

This sample application declares a `javax.servlet.ServletContextListener` (of type `web.servlet.sessioncookieconfig_war.ConfigListener`) in its deployment descriptor. This ServletContextListener configures, via the `javax.servlet.SessionCookieConfig` interface that is newly available with Servlet 3.0, various aspects of the application's cookies that will be used for HTTP session tracking purposes. Note that this application has cookies enabled.

The test client accesses the `CreateSession` servlet of the application, which creates an HTTP session, retrieves the value of the corresponding `Set-Cookie` header from the response, and makes sure that it matches the configuration that was applied by the ServletContextListener during the application's initialization phase.

## Building, Deploying, and Running the Application

Perform the following steps to build, deploy, and run the application:

1. Set up your build environment and configure the application server with which the build system has to work by following the common build instructions.
2. `app_dir` is the sample application base directory: `samples_install_dir/javaee6/web/servlet/sessioncookieconfig-war`.
3. ````Change directory to `app_dir.
   `
4. Build, deploy and run the sample application using the `all` target``

`app_dir>` `ant all
`

You can replace the `ant all` command with the following set of commands:
``

`app_dir> ant default` compiles and packages the application

`app_dir> ant deploy` deploys it to application server

`app_dir> ant run` runs the test

5. Note: You can run the test in one of the following ways:
   - Use the browser to access http:<javaee.server.name>:<javaee.server.port>/sessioncookieconfig-war
     The following output is expected in the browser:
     SUCCESS
   - `app_dir> ant run`
6. Use the target `undeploy` to undeploy the application.

   `app_dir> ant undeploy`

7. Use the target `clean` to remove the temporary directories like build and dist.

   `app_dir> ant clean`

## Building, Deploying, and Running the Application in NetBeans IDE

Perform the following steps to build, deploy, and run the application using NetBeans IDE:

1. Refer to the common build instructions for setting up NetBeans IDE and Java EE 6 SDK.
2. In the NetBeans IDE, choose File → Open Project (Ctrl-Shift-O), navigate to the `samples_install_dir/javaee6/web/servlet/` directory, select `sessioncookieconfig-war`, and click Open Project.
3. In the Projects tab, right click `sessioncookieconfig-war` and select Run to build, deploy, and run the project.

## Troubleshooting

If you have problems when running the application, refer the troubleshooting document.

Copyright © 1997-2010 Oracle and/or its affiliates. All rights reserved.