Java EE 7 SDK

The File Upload Servlet Sample Application

This sample application demonstrates how to use the support for multipart (also known as file upload) defined in the Servlet specification.

Description

This sample application demonstrates the multipart feature of Servlet 3.0. The sample contains a simple web page that promts the user for the names of two files to upload them to the web container. The files are uploaded to a servlet, then the client is redirected to a JSP page.

Servlet 3.0 enables you to get the contents and attributes of each part directly using the HttpServletRequest interface.

The getParts.jsp file demonstrates how to use the basic functionality from the Part interface.

Key Features

This sample demonstrates how to access the attributes and contents of parts directly from the HttpServletRequest interface.

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/multipart-war.
Change directory to app_dir.
Build, deploy, the sample application using the mvn target:
Use the command below to run this sample using the 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 and deploy the sample application without Cargo:

app_dir> mvn install

app_dir> asadmin deploy ./target/<app_name>.war
Test the sample application as follows:
- Use the browser to access http://<javaee.server.name>:<javaee.server.port>/multipart-war/
Use the Glassfish asadmin command line utility to undeploy the application.
app_dir> asadmin undeploy <app_name>
Use the clean target 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 multipart-war, and click Open Project.
In the Projects tab, right click multipart-war and select Run to build, deploy, and run the project.

Troubleshooting

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