Java EE 7 SDK

Samples Main Page

# The JAR-Bundled JSP Resource Servlet 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 document root of the application.

## Description

This sample application bundles the `dynamicResources.jar` JAR file 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 client can access the JSP resource in `jsp/helloWorld.jsp`, 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.

## Key Features

This sample application demonstrates that JAR-bundled JSP resources in META-INF are accesible.

## 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/servlet/jsp-resource-in-bundled-jar-war`.
3. ````Change directory to `app_dir.
   `
4. Build and deploy the sample application using the `mvn` target:

   Use the command below to run this sample which is using Cargo framework:

   `app_dir> mvn clean verify cargo:run`

   You can point Cargo to an already installed and running Glassfish server:

   `app_dir> mvn clean verify cargo:run -Dglassfish.home=$<glassfish_dir>` (e.g. ../glassfish4)

   You can also build, deploy the sample application without Cargo:

   `app_dir> mvn install`

   `app_dir> asadmin deploy ./target/<app_name>.war`

5. Run the test as follows:
   - 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`
6. Use the glassfish command line to undeploy the application.

   `app_dir> asadmin undeploy` <app_name>

7. Use the target `clean` to remove the temporary directories like /target.

   `app_dir> mvn 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 7 SDK.
2. In the NetBeans IDE, choose File → Open Project (Ctrl-Shift-O), navigate to the `samples_install_dir/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-2013 Oracle and/or its affiliates. All rights reserved.