Java EE 6 SDK

Samples Main Page

# The Access JAR-Bundled JSP Resource Sample Application

This sample application demonstrates how dynamic and static resources bundled inside the `META-INF/resources` directory of a JAR file inside the application's `WEB-INF/lib` directory may be accessed in the same way as if they had been placed in the application's document root.

## Description

This sample application bundles a JAR file with name `dynamicResources.jar` in its `WEB-INF/lib` directory. This JAR file contains a JSP resource with path `jsp/helloWorld.jsp` in its `META-INF/resources` directory.

The test client accesses the JSP resource at its `jsp/helloWorld.jsp` path, as if it had been placed in the application's document root. Prior to Servlet 3.0, this would have resulted in a 404 response.

## 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/jsp-resource-in-bundled-jar-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>/jsp-resource-in-bundled-jar-war/jsp/helloWorld.jsp
     The following output is expected in the browser:
     Hello World
   - `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 `jsp-resource-in-bundled-jar-war`, and click Open Project.
3. In the Projects tab, right click `jsp-resource-in-bundled-jar-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.