~~   Licensed to the Apache Software Foundation (ASF) under one
~~   or more contributor license agreements.  See the NOTICE file
~~   distributed with this work for additional information
~~   regarding copyright ownership.  The ASF licenses this file
~~   to you under the Apache License, Version 2.0 (the
~~   "License"); you may not use this file except in compliance
~~   with the License.  You may obtain a copy of the License at
~~
~~     http://www.apache.org/licenses/LICENSE-2.0
~~
~~   Unless required by applicable law or agreed to in writing,
~~   software distributed under the License is distributed on an
~~   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
~~   KIND, either express or implied.  See the License for the
~~   specific language governing permissions and limitations
~~   under the License.

    --------------------------
    About Commons Fileupload 2
    --------------------------

Commons FileUpload 2

  The Commons <<FileUpload>> 2 package makes it easy to add robust,
  high-performance, file upload capability to your servlets and web
  applications.

  Commons <<FileUpload>> 2 parses HTTP requests which conform to
  {{{http://www.ietf.org/rfc/rfc1867.txt}RFC 1867}},
  "Form-based File Upload in HTML". That is, if an HTTP request is
  submitted using the POST method, and with a content type of
  "multipart/form-data", then FileUpload can parse that request, and
  make the results available in a manner easily used by the caller.

  Commons <<FileUpload>> 2 is implemented using the
  {{{http://james.apache.org/mime4j/}Mime4J}} parser for multipart
  requests.

* Documentation

  The following documentation is available:

  * {{{using.html}User Guide}}

  * {{{streaming.html}Streaming API}}

  * {{{faq.html}Frequently Asked Questions}}

  * {{{apidocs/index.html}JavaDoc API}}

  * {{{project-reports.html}Project Reports}}

  You can also {{{source-repository.html}browse}} the Subversion repository.

* Why Commons FileUpload 2?

  Commons <<FileUpload>> 2 replaces its popular predecessor,
  Commons <<FileUpload>> 1, which gained enormous popularity since
  its inception in 2002. However, the first implementation was
  showing its age. The necessity for binary compatibility made it
  increasingly difficult to include new features and resolve issues.
  Additionally, a number of architectural errors could only be
  removed by creating a new implementation.   

* Support

  The {{{mail-lists.html}Apache Commons mailing lists}} act as
  the main support forum. The <<user>> list is suitable for most library
  usage queries. The <<dev>> list is intended for development discussion.
  Please remember that the lists are shared between all commons components,
  so prefix your e-mail subject line with <<<[fileupload]>>>.

  Issues may be reported via {{{issue-tracking.html}ASF JIRA}}.