| $Id$ |
| |
| Commons FileUpload Package |
| Version 1.1 |
| Release Notes |
| |
| |
| INTRODUCTION |
| ============ |
| |
| This document contains the release notes for this version of the Commons |
| FileUpload component, and highlights changes since the previous version. |
| |
| Documentation for this release is available on the FileUpload web site: |
| |
| http://jakarta.apache.org/commons/fileupload/ |
| |
| NOTE: This release of FileUpload requires Commons IO 1.1. |
| |
| |
| UPGRADING |
| ========= |
| |
| Upgrading from FileUpload 1.0 can be as simple as recompiling your application |
| with the new version. However, it is likely that you will get deprecation |
| warnings when you do so, since changes have been made to the exposed API of |
| FileUpload to make it more suitable for use in both Servlet and Portlet |
| environments. You can, of course, elect to ignore those deprecations, and |
| leave your code changes until a subsequent version of FileUpload in which those |
| deprecated methods are removed. To upgrade your code and remove references to |
| the deprecated methods, please see the FileUpload User Guide. |
| |
| |
| NEW FEATURES |
| ============ |
| |
| * Support for Portlet environments is now available. Some restructuring was |
| necessary in order to accomplish this, which is the major cause of the |
| deprecations mentioned above. |
| |
| * If a character encoding is specified in the request, that is used instead |
| of the system default encoding. |
| |
| * The character set to be used when parsing individual parts can now be |
| specified. |
| |
| * Actual and maximum request sizes are specified when an exception is thrown |
| due to exceeding the maximum. |
| |
| * Temporary file names are now unique across class loaders. |
| |
| * DiskFileItem is now serializable. |
| |
| |
| BUG FIXES |
| ========= |
| |
| Many bugs in the code and documentation have been fixed in this release. Please |
| see the Changes report for full details. |
| |
| http://jakarta.apache.org/commons/fileupload/changes-report.html |
| |
| The following are some of the more important bug fixes: |
| |
| * A new mechanism for deleting temporary files has been added, to ensure that |
| deletions happen in a timely manner in long-running applications. |
| |
| * Quoted multipart boundaries are now handled correctly. |
| |
| * Header values are now compared case-independently. |