Java EE 7 SDK

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:

Set up your build environment and configure the application server with which the build system has to work by following the common build instructions.
app_dir is the sample application base directory: samples_install_dir/servlet/jsp-resource-in-bundled-jar-war.
Change directory to app_dir.
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
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
Use the glassfish command line to undeploy the application.
app_dir> asadmin undeploy <app_name>
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:

Refer to the common build instructions for setting up NetBeans IDE and Java EE 7 SDK.
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.
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.