Java EE 7 SDK

Samples Main Page

# 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:

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/multipart-war`.
3. ````Change directory to `app_dir.
   `
4. 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`

5. Test the sample application as follows:
   - Use the browser to access `http://<javaee.server.name>:<javaee.server.port>/multipart-war/`
6. Use the Glassfish `asadmin` command line utility to undeploy the application.

   `app_dir> asadmin undeploy <app_name>`

7. 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:

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 `multipart-war`, and click Open Project.
3. 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.

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