Documenting a possible incompatibility in a try...catch statement.
diff --git a/src/site/apt/migration.apt.vm b/src/site/apt/migration.apt.vm
index d443e1f..d362496 100644
--- a/src/site/apt/migration.apt.vm
+++ b/src/site/apt/migration.apt.vm
@@ -33,7 +33,7 @@
2. In your dependency declaration, change the groupId to org.apache.commons, the artifactId to
commons-fileupload2, and the version number to ${project.version}.
- 2. Change namespace org.apache.commons.fileupload to org.apache.commons.fileupload2.
+ 3. Change namespace org.apache.commons.fileupload to org.apache.commons.fileupload2.
Example: Change
@@ -47,6 +47,24 @@
import org.apache.commons.fileupload2.servlet.ServletFileUpload;
+-------------------------------------------
+ 4. Existing code like the following might give compiler errors, although it
+ looks perfectly valid:
+
++-------------------------------------------
+ try {
+ // Parse a Fileupload request here.
+ } catch (IOException e) {
+ // Handle the IOException
+ } catch (FileUploadException e) {
+ // Handle the FileUploadException
+ }
++-------------------------------------------
+
+ With FileUpload 2, this is invalid, because the FileUploadException is now a
+ subclass of the IOException. The solution is simple: Just switch the order,
+ and handle the FileUploadException in the first catch clause, and the IOException
+ in the second clause.
+
# Migrating to Jakarta Servlet API, Version 5, or later.
Most existing projects, that are using Commons Fileupload, are based on the Java Servlet API, version
