Added: dev/commons/fileupload/2.0.0-M1-RC1/site/migration.html ============================================================================== --- dev/commons/fileupload/2.0.0-M1-RC1/site/migration.html (added) +++ dev/commons/fileupload/2.0.0-M1-RC1/site/migration.html Sat Jul 15 23:26:25 2023 @@ -0,0 +1,379 @@ +<!DOCTYPE html> +<!-- + | Generated by Apache Maven Doxia at 15 July 2023 + | Rendered using Apache Maven Fluido Skin 1.3.0 +--> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> + <head> + <meta charset="iso-8859-1" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="Date-Revision-yyyymmdd" content="20230715" /> + <meta http-equiv="Content-Language" content="en" /> + <title>FileUpload – Migrating</title> + + <link rel="stylesheet" href="./css/bootstrap.min.css" type="text/css" /> + <link rel="stylesheet" href="./css/site.css" type="text/css" /> + <link rel="stylesheet" href="./css/print.css" media="print" /> + + <script type="text/javascript" src="./js/jquery.min.js"></script> + <script type="text/javascript" src="./js/bootstrap.min.js"></script> + <script type="text/javascript" src="./js/prettify.min.js"></script> + <script type="text/javascript" src="./js/site.js"></script> + + + </head> + + <body class="composite"> + <a href="https://commons.apache.org/" id="bannerLeft" title="Apache Commons logo"> + <img class="logo-left" src=" ./images/commons-logo.png +" alt="Apache Commons logo"/> + </a> + <a href="index.html" id="bannerRight"> + <img class="logo-right" src=" images/logo.png +" alt="Commons FileUpload"/> + </a> + <div class="clear"></div> + + <div class="navbar"> + <div class="navbar-inner"> + <div class="container-fluid"> + <a class="brand" href="https://commons.apache.org/proper/commons-fileupload/">Apache Commons FileUpload ™</a> + <ul class="nav"> + + <li id="publishDate">Last Published: 15 July 2023</li> + <li class="divider">|</li> <li id="projectVersion">Version: 2.0.0-M1</li> + </ul> + <div class="pull-right"> <ul class="nav"> + <li> + <a href="https://www.apachecon.com/" class="externalLink" title="ApacheCon"> + ApacheCon</a> + </li> + <li> + <a href="https://www.apache.org" class="externalLink" title="Apache"> + Apache</a> + </li> + <li> + <a href="../../" title="Commons"> + Commons</a> + </li> + </ul> +</div> + </div> + </div> + </div> + + <div class="container-fluid"> + <table class="layout-table"> + <tr> + <td class="sidebar"> + <div class="well sidebar-nav"> + <ul class="nav nav-list"> + <li class="nav-header">Commons FileUpload</li> + <li class="none"> + <a href="index.html" title="Overview"> + Overview</a> + </li> + <li class="none"> + <a href="using.html" title="User guide"> + User guide</a> + </li> + <li class="none active"> + <a href="migration.html" title="Migration"> + Migration</a> + </li> + <li class="none"> + <a href="streaming.html" title="Streaming API"> + Streaming API</a> + </li> + <li class="none"> + <a href="faq.html" title="FAQ"> + FAQ</a> + </li> + <li class="none"> + <a href="https://javadoc.io/doc/org.apache.commons/commons-fileupload2" class="externalLink" title="Javadoc Archives v2"> + Javadoc Archives v2</a> + </li> + <li class="none"> + <a href="https://javadoc.io/doc/commons-fileupload/commons-fileupload" class="externalLink" title="Javadoc Archives v1"> + Javadoc Archives v1</a> + </li> + <li class="none"> + <a href="download_fileupload.cgi" title="Download"> + Download</a> + </li> + <li class="none"> + <a href="security-reports.html" title="Security Reports"> + Security Reports</a> + </li> + <li class="none"> + <a href="mail-lists.html" title="Mailing lists"> + Mailing lists</a> + </li> + <li class="none"> + <a href="issue-tracking.html" title="Issue Tracking"> + Issue Tracking</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">Modules</li> + <li class="none"> + <a href="commons-fileupload2-core/index.html" title="FileUpload Core"> + FileUpload Core</a> + </li> + <li class="none"> + <a href="commons-fileupload2-jakarta/index.html" title="FileUpload Jakarta"> + FileUpload Jakarta</a> + </li> + <li class="none"> + <a href="commons-fileupload2-javax/index.html" title="FileUpload Javax"> + FileUpload Javax</a> + </li> + <li class="none"> + <a href="commons-fileupload2-portlet/index.html" title="FileUpload Portlet"> + FileUpload Portlet</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header"><i class="icon-info-sign"></i>Project Documentation</li> + <li class="collapsed"> + <a href="project-info.html" title="Project Information"> + Project Information</a> + </li> + <li class="collapsed"> + <a href="project-reports.html" title="Project Reports"> + Project Reports</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">Commons</li> + <li class="none"> + <a href="../../" title="Home"> + Home</a> + </li> + <li class="none"> + <a href="https://www.apache.org/licenses/" class="externalLink" title="License"> + License</a> + </li> + <li class="collapsed"> + <a href="../../components.html" title="Components"> + Components</a> + </li> + <li class="collapsed"> + <a href="../../sandbox/index.html" title="Sandbox"> + Sandbox</a> + </li> + <li class="collapsed"> + <a href="../../dormant/index.html" title="Dormant"> + Dormant</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">General Information</li> + <li class="none"> + <a href="../../security.html" title="Security"> + Security</a> + </li> + <li class="none"> + <a href="../../volunteering.html" title="Volunteering"> + Volunteering</a> + </li> + <li class="none"> + <a href="../../patches.html" title="Contributing Patches"> + Contributing Patches</a> + </li> + <li class="none"> + <a href="../../building.html" title="Building Components"> + Building Components</a> + </li> + <li class="none"> + <a href="../../commons-parent-pom.html" title="Commons Parent POM"> + Commons Parent POM</a> + </li> + <li class="none"> + <a href="../../build-plugin/index.html" title="Commons Build Plugin"> + Commons Build Plugin</a> + </li> + <li class="none"> + <a href="release-plugin/index.html" title="Commons Release Plugin"> + Commons Release Plugin</a> + </li> + <li class="none"> + <a href="site-publish.html" title="Site Publication"> + Site Publication</a> + </li> + <li class="none"> + <a href="../../releases/index.html" title="Releasing Components"> + Releasing Components</a> + </li> + <li class="none"> + <a href="https://cwiki.apache.org/confluence/display/commons/FrontPage" class="externalLink" title="Wiki"> + Wiki</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">ASF</li> + <li class="none"> + <a href="https://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How the ASF works"> + How the ASF works</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/getinvolved.html" class="externalLink" title="Get Involved"> + Get Involved</a> + </li> + <li class="none"> + <a href="https://www.apache.org/dev/" class="externalLink" title="Developer Resources"> + Developer Resources</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/policies/conduct.html" class="externalLink" title="Code of Conduct"> + Code of Conduct</a> + </li> + <li class="none"> + <a href="https://privacy.apache.org/policies/privacy-policy-public.html" class="externalLink" title="Privacy"> + Privacy</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship"> + Sponsorship</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks"> + Thanks</a> + </li> + </ul> + </div> + <div id="poweredBy"> + <a href="https://www.apache.org/events/current-event.html" title="ApacheCon" class="builtBy"> + <img class="builtBy" alt="ApacheCon" src="https://www.apache.org/events/current-event-125x125.png" /> + </a> + <a href="https://maven.apache.org/" title="Maven" class="builtBy"> + <img class="builtBy" alt="Maven" src="https://maven.apache.org/images/logos/maven-feather.png" /> + </a> + </div> + </td> + <td class="content"> + <section> +<h2><a name="Migrating"></a>Migrating</h2> +<p>This document provides advice for migration between versions of Commons FileUpload, and between versions of the underlying Servlet API.</p><section> +<h3><a name="Migrating_to_Commons_FileUpload_2"></a>Migrating to Commons FileUpload 2</h3> +<p>Commons FileUpload 2 breaks binary and source compatibility with version 1.</p> +<p>To use version 2, you must to update your projects as follows:</p> +<ol style="list-style-type: decimal"> +<li>Use Java 8 or above.</li> +<li>Add one or more these dependencies with the <code>groupId</code> <b>org.apache.commons</b>, and set the <code>artifactId</code> to: +<ol style="list-style-type: upper-alpha"> +<li><b>commons-fileupload2-jakarta</b> to use Jakarta servlets.</li> +<li><b>commons-fileupload2-javax</b> to use Javax servlets.</li> +<li><b>commons-fileupload2-portlet</b> to use Javax portlets.</li> +<li>All of the above automatically depends on <b>commons-fileupload2-core</b>.</li></ol></li> +<li>The dependency version is <b>2.0.0-M1</b></li> +<li>Change your imports from the root <b>org.apache.commons.fileupload</b> to <b>org.apache.commons.fileupload2</b>. +<p>For example, change:</p> +<div class="source"> +<pre> import org.apache.commons.fileupload.servlet.ServletFileUpload;</pre></div> +<p>to:</p> +<div class="source"> +<pre> import org.apache.commons.fileupload2.jakarta.JakartaServletFileUpload;</pre></div> +<p>or:</p> +<div class="source"> +<pre> import org.apache.commons.fileupload2.javax.JavaxServletFileUpload;</pre></div></li></ol> +<ol style="list-style-type: decimal"> +<li>Change some catch clauses, for example: +<div class="source"> +<pre> try { + // Parse a FileUpload request here. + } catch (IOException e) { + // Handle the IOException + } catch (FileUploadException e) { + // Handle the FileUploadException + }</pre></div> +<p>In FileUpload 2, this is invalid because <code>FileUploadException</code> is a subclass of <code>IOException</code>. To address this, switch the catch order, and handle the <code>FileUploadException</code> in the first catch, and the <code>IOException</code> in the second.</p></li></ol></section><section> +<h3><a name="Migrating_to_Jakarta_Servlet_API.2C_Version_5.2C_or_later."></a>Migrating to Jakarta Servlet API, Version 5, or later.</h3> +<p>Most existing projects Commons FileUpload 1 are based on the Javax Servlet API version 2 or later. In Jakarta EE 9, this is replaced with the Jakarta Servlet API version 5.</p> +<p>User code should now import the <b>jakarta.servlet</b> package instead of the <b>javax.servlet</b> package.</p> +<p>For applications using Commons FileUpload, this means, that you need to</p> +<ol style="list-style-type: decimal"> +<li>Upgrade Commons FileUpload to version 2, or later.</li> +<li>Replace the classes from <b>org.apache.commons.fileupload.servlet</b> to either <b>org.apache.commons.fileupload2.jakarta</b> or <b>org.apache.commons.fileupload2.javax</b>. +<table border="1" class="bodyTable"> +<tr class="a"> +<td align="center"><b>Version 1 Name</b></td> +<td align="center"><b>Version 2 Jakarta Name</b></td></tr> +<tr class="b"> +<td align="center">org.apache.commons.fileupload.servlet.ServletFileUpload</td> +<td align="center">org.apache.commons.fileupload2.jakarta.JakartaServletFileUpload</td></tr> +<tr class="a"> +<td align="center">org.apache.commons.fileupload.servlet.ServletRequestContext</td> +<td align="center">org.apache.commons.fileupload2.jakarta.JakartaServletRequestContext</td></tr> +<tr class="b"> +<td align="center">org.apache.commons.fileupload2.servlet.FileCleanerCleanup</td> +<td align="center">org.apache.commons.fileupload2.jakarta.JakartaServletFileCleaner</td></tr></table> +<table border="1" class="bodyTable"> +<tr class="a"> +<td align="center"><b>Version 1 Name</b></td> +<td align="center"><b>Version 2 Javax Name</b></td></tr> +<tr class="b"> +<td align="center">org.apache.commons.fileupload.servlet.ServletFileUpload</td> +<td align="center">org.apache.commons.fileupload2.javax.JavaxServletFileUpload</td></tr> +<tr class="a"> +<td align="center">org.apache.commons.fileupload.servlet.ServletRequestContext</td> +<td align="center">org.apache.commons.fileupload2.javax.JavaxServletRequestContext</td></tr> +<tr class="b"> +<td align="center">org.apache.commons.fileupload2.servlet.FileCleanerCleanup</td> +<td align="center">org.apache.commons.fileupload2.javax.JavaxServletFileCleaner</td></tr></table></li></ol></section><section> +<h3><a name="Example"></a>Example</h3> +<p>The following example demonstrates, how to use Commons FileUpload with the Jakarta Servlet API, version 5:</p> +<div class="source"> +<pre> import java.io.IOException; + import java.util.List; + + import org.apache.commons.fileupload2.FileItem; + import org.apache.commons.fileupload2.FileItemFactory; + import org.apache.commons.fileupload2.FileUpload; + import org.apache.commons.fileupload2.FileUploadException; + import org.apache.commons.fileupload2.DiskFileItemFactory; + import org.apache.commons.fileupload2.jakarta.JakartaServletFileUpload; + import org.apache.commons.fileupload2.jakarta.JakartaServletRequestContext; + + import jakarta.servlet.ServletException; + import jakarta.servlet.http.HttpServlet; + import jakarta.servlet.http.HttpServletRequest; + import jakarta.servlet.http.HttpServletResponse; + + public class SampleServlet extends HttpServlet { + private static final long serialVersionUID = 2; + + @Override + protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { + if (JakartaServletFileUpload.isMultipartContent(req)) { + final DiskFileItemFactory fileItemfactory = new DiskFileItemFactory(); + final JakartaServletFileUpload fileUpload = new JakartaServletFileUpload(fileItemfactory); + final List<FileItem> items; + try { + items = fileUpload.parseRequest(new JavaxServletRequestContext(req)); + } catch (FileUploadException e) { + throw new ServletException(e); + } + // Process the uploaded file items here... + } + } + } +</pre></div></section><section> +<h3><a name="Using_Commons_FileUpload_2_as_a_JPMS_Module"></a>Using Commons FileUpload 2 as a JPMS Module</h3> +<p>The library provides <b>META-INF/versions/module-info.class</b> that defines the required modules and exported packages.</p></section></section> + </td> + </tr> + </table> + </div> + + <div class="footer"> + <p>Copyright © 2002-2023 + <a href="https://www.apache.org/">The Apache Software Foundation</a>. + All Rights Reserved.</p> + +<div class="center">Apache Commons, Apache Commons FileUpload, Apache, the Apache feather logo, and the Apache Commons project logos are trademarks of The Apache Software Foundation. + All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div> + </div> + </body> + +</html>
Added: dev/commons/fileupload/2.0.0-M1-RC1/site/modules.html ============================================================================== --- dev/commons/fileupload/2.0.0-M1-RC1/site/modules.html (added) +++ dev/commons/fileupload/2.0.0-M1-RC1/site/modules.html Sat Jul 15 23:26:25 2023 @@ -0,0 +1,346 @@ +<!DOCTYPE html> +<!-- + | Generated by Apache Maven Doxia at 15 July 2023 + | Rendered using Apache Maven Fluido Skin 1.3.0 +--> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> + <head> + <meta charset="iso-8859-1" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="Date-Revision-yyyymmdd" content="20230715" /> + <meta http-equiv="Content-Language" content="en" /> + <title>FileUpload – Project Modules</title> + + <link rel="stylesheet" href="./css/bootstrap.min.css" type="text/css" /> + <link rel="stylesheet" href="./css/site.css" type="text/css" /> + <link rel="stylesheet" href="./css/print.css" media="print" /> + + <script type="text/javascript" src="./js/jquery.min.js"></script> + <script type="text/javascript" src="./js/bootstrap.min.js"></script> + <script type="text/javascript" src="./js/prettify.min.js"></script> + <script type="text/javascript" src="./js/site.js"></script> + + + </head> + + <body class="composite"> + <a href="https://commons.apache.org/" id="bannerLeft" title="Apache Commons logo"> + <img class="logo-left" src=" ./images/commons-logo.png +" alt="Apache Commons logo"/> + </a> + <a href="index.html" id="bannerRight"> + <img class="logo-right" src=" images/logo.png +" alt="Commons FileUpload"/> + </a> + <div class="clear"></div> + + <div class="navbar"> + <div class="navbar-inner"> + <div class="container-fluid"> + <a class="brand" href="https://commons.apache.org/proper/commons-fileupload/">Apache Commons FileUpload ™</a> + <ul class="nav"> + + <li id="publishDate">Last Published: 15 July 2023</li> + <li class="divider">|</li> <li id="projectVersion">Version: 2.0.0-M1</li> + </ul> + <div class="pull-right"> <ul class="nav"> + <li> + <a href="https://www.apachecon.com/" class="externalLink" title="ApacheCon"> + ApacheCon</a> + </li> + <li> + <a href="https://www.apache.org" class="externalLink" title="Apache"> + Apache</a> + </li> + <li> + <a href="../../" title="Commons"> + Commons</a> + </li> + </ul> +</div> + </div> + </div> + </div> + + <div class="container-fluid"> + <table class="layout-table"> + <tr> + <td class="sidebar"> + <div class="well sidebar-nav"> + <ul class="nav nav-list"> + <li class="nav-header">Commons FileUpload</li> + <li class="none"> + <a href="index.html" title="Overview"> + Overview</a> + </li> + <li class="none"> + <a href="using.html" title="User guide"> + User guide</a> + </li> + <li class="none"> + <a href="migration.html" title="Migration"> + Migration</a> + </li> + <li class="none"> + <a href="streaming.html" title="Streaming API"> + Streaming API</a> + </li> + <li class="none"> + <a href="faq.html" title="FAQ"> + FAQ</a> + </li> + <li class="none"> + <a href="https://javadoc.io/doc/org.apache.commons/commons-fileupload2" class="externalLink" title="Javadoc Archives v2"> + Javadoc Archives v2</a> + </li> + <li class="none"> + <a href="https://javadoc.io/doc/commons-fileupload/commons-fileupload" class="externalLink" title="Javadoc Archives v1"> + Javadoc Archives v1</a> + </li> + <li class="none"> + <a href="download_fileupload.cgi" title="Download"> + Download</a> + </li> + <li class="none"> + <a href="security-reports.html" title="Security Reports"> + Security Reports</a> + </li> + <li class="none"> + <a href="mail-lists.html" title="Mailing lists"> + Mailing lists</a> + </li> + <li class="none"> + <a href="issue-tracking.html" title="Issue Tracking"> + Issue Tracking</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">Modules</li> + <li class="none"> + <a href="commons-fileupload2-core/index.html" title="FileUpload Core"> + FileUpload Core</a> + </li> + <li class="none"> + <a href="commons-fileupload2-jakarta/index.html" title="FileUpload Jakarta"> + FileUpload Jakarta</a> + </li> + <li class="none"> + <a href="commons-fileupload2-javax/index.html" title="FileUpload Javax"> + FileUpload Javax</a> + </li> + <li class="none"> + <a href="commons-fileupload2-portlet/index.html" title="FileUpload Portlet"> + FileUpload Portlet</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header"><i class="icon-info-sign"></i>Project Documentation</li> + <li class="expanded"> + <a href="project-info.html" title="Project Information"> + Project Information</a> + <ul> + <li class="none"> + <a href="index.html" title="About"> + About</a> + </li> + <li class="none"> + <a href="summary.html" title="Summary"> + Summary</a> + </li> + <li class="none active"> + <a href="modules.html" title="Project Modules"> + Project Modules</a> + </li> + <li class="none"> + <a href="team.html" title="Team"> + Team</a> + </li> + <li class="none"> + <a href="scm.html" title="Source Code Management"> + Source Code Management</a> + </li> + <li class="none"> + <a href="issue-management.html" title="Issue Management"> + Issue Management</a> + </li> + <li class="none"> + <a href="mailing-lists.html" title="Mailing Lists"> + Mailing Lists</a> + </li> + <li class="none"> + <a href="dependency-info.html" title="Dependency Information"> + Dependency Information</a> + </li> + <li class="none"> + <a href="dependency-management.html" title="Dependency Management"> + Dependency Management</a> + </li> + <li class="none"> + <a href="dependency-convergence.html" title="Dependency Convergence"> + Dependency Convergence</a> + </li> + <li class="none"> + <a href="ci-management.html" title="CI Management"> + CI Management</a> + </li> + <li class="none"> + <a href="distribution-management.html" title="Distribution Management"> + Distribution Management</a> + </li> + </ul> + </li> + <li class="collapsed"> + <a href="project-reports.html" title="Project Reports"> + Project Reports</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">Commons</li> + <li class="none"> + <a href="../../" title="Home"> + Home</a> + </li> + <li class="none"> + <a href="https://www.apache.org/licenses/" class="externalLink" title="License"> + License</a> + </li> + <li class="collapsed"> + <a href="../../components.html" title="Components"> + Components</a> + </li> + <li class="collapsed"> + <a href="../../sandbox/index.html" title="Sandbox"> + Sandbox</a> + </li> + <li class="collapsed"> + <a href="../../dormant/index.html" title="Dormant"> + Dormant</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">General Information</li> + <li class="none"> + <a href="../../security.html" title="Security"> + Security</a> + </li> + <li class="none"> + <a href="../../volunteering.html" title="Volunteering"> + Volunteering</a> + </li> + <li class="none"> + <a href="../../patches.html" title="Contributing Patches"> + Contributing Patches</a> + </li> + <li class="none"> + <a href="../../building.html" title="Building Components"> + Building Components</a> + </li> + <li class="none"> + <a href="../../commons-parent-pom.html" title="Commons Parent POM"> + Commons Parent POM</a> + </li> + <li class="none"> + <a href="../../build-plugin/index.html" title="Commons Build Plugin"> + Commons Build Plugin</a> + </li> + <li class="none"> + <a href="release-plugin/index.html" title="Commons Release Plugin"> + Commons Release Plugin</a> + </li> + <li class="none"> + <a href="site-publish.html" title="Site Publication"> + Site Publication</a> + </li> + <li class="none"> + <a href="../../releases/index.html" title="Releasing Components"> + Releasing Components</a> + </li> + <li class="none"> + <a href="https://cwiki.apache.org/confluence/display/commons/FrontPage" class="externalLink" title="Wiki"> + Wiki</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">ASF</li> + <li class="none"> + <a href="https://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How the ASF works"> + How the ASF works</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/getinvolved.html" class="externalLink" title="Get Involved"> + Get Involved</a> + </li> + <li class="none"> + <a href="https://www.apache.org/dev/" class="externalLink" title="Developer Resources"> + Developer Resources</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/policies/conduct.html" class="externalLink" title="Code of Conduct"> + Code of Conduct</a> + </li> + <li class="none"> + <a href="https://privacy.apache.org/policies/privacy-policy-public.html" class="externalLink" title="Privacy"> + Privacy</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship"> + Sponsorship</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks"> + Thanks</a> + </li> + </ul> + </div> + <div id="poweredBy"> + <a href="https://www.apache.org/events/current-event.html" title="ApacheCon" class="builtBy"> + <img class="builtBy" alt="ApacheCon" src="https://www.apache.org/events/current-event-125x125.png" /> + </a> + <a href="https://maven.apache.org/" title="Maven" class="builtBy"> + <img class="builtBy" alt="Maven" src="https://maven.apache.org/images/logos/maven-feather.png" /> + </a> + </div> + </td> + <td class="content"> + <section> +<h2><a name="Project_Modules"></a>Project Modules</h2><a name="Project_Modules"></a> +<p>This project has declared the following modules:</p> +<table border="0" class="bodyTable"> +<tr class="a"> +<th>Name</th> +<th>Description</th></tr> +<tr class="b"> +<td align="left"><a href="./commons-fileupload2-core/index.html">Apache Commons FileUpload Core</a></td> +<td>The Apache Commons FileUpload Core component provides the framework for a simple yet flexible means of adding support for multipart + file upload functionality to servlets, portlets, and web applications.</td></tr> +<tr class="a"> +<td align="left"><a href="./commons-fileupload2-jakarta/index.html">Apache Commons FileUpload Jakarta</a></td> +<td>The Apache Commons FileUpload Jakarta component provides a simple yet flexible means of adding support for multipart + file upload functionality to Jakarta servlets and web applications.</td></tr> +<tr class="b"> +<td align="left"><a href="./commons-fileupload2-javax/index.html">Apache Commons FileUpload Javax</a></td> +<td>The Apache Commons FileUpload Javax component provides a simple yet flexible means of adding support for multipart + file upload functionality to Javax servlets and web applications.</td></tr> +<tr class="a"> +<td align="left"><a href="./commons-fileupload2-portlet/index.html">Apache Commons FileUpload Portlet</a></td> +<td>The Apache Commons FileUpload Portlet component provides a simple yet flexible means of adding support for multipart + file upload functionality to portlet.</td></tr> +<tr class="b"> +<td align="left"><a href="./commons-fileupload2-distribution/index.html">Apache Commons FileUpload Distribution</a></td> +<td>Apache Commons FIleUpload Distribution archives.</td></tr></table></section> + </td> + </tr> + </table> + </div> + + <div class="footer"> + <p>Copyright © 2002-2023 + <a href="https://www.apache.org/">The Apache Software Foundation</a>. + All Rights Reserved.</p> + +<div class="center">Apache Commons, Apache Commons FileUpload, Apache, the Apache feather logo, and the Apache Commons project logos are trademarks of The Apache Software Foundation. + All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div> + </div> + </body> + +</html> Added: dev/commons/fileupload/2.0.0-M1-RC1/site/org.apache.commons_commons-fileupload2-2.0.0-M1.spdx.json ============================================================================== --- dev/commons/fileupload/2.0.0-M1-RC1/site/org.apache.commons_commons-fileupload2-2.0.0-M1.spdx.json (added) +++ dev/commons/fileupload/2.0.0-M1-RC1/site/org.apache.commons_commons-fileupload2-2.0.0-M1.spdx.json Sat Jul 15 23:26:25 2023 @@ -0,0 +1,80 @@ +{ + "SPDXID" : "SPDXRef-DOCUMENT", + "spdxVersion" : "SPDX-2.3", + "creationInfo" : { + "created" : "2023-07-15T19:25:59Z", + "creators" : [ "Tool: spdx-maven-plugin" ], + "licenseListVersion" : "3.21" + }, + "name" : "Apache Commons FileUpload", + "dataLicense" : "CC0-1.0", + "documentNamespace" : "http://spdx.org/spdxpackages/org.apache.commons_commons-fileupload2-2.0.0-M1", + "packages" : [ { + "SPDXID" : "SPDXRef-gnrtd0", + "copyrightText" : "NOASSERTION", + "description" : "The Apache Commons FileUpload component provides a simple yet flexible means of adding support for multipart\n file upload functionality to servlets and web applications.", + "downloadLocation" : "NOASSERTION", + "filesAnalyzed" : true, + "homepage" : "https://commons.apache.org/proper/commons-fileupload/", + "licenseConcluded" : "NOASSERTION", + "licenseDeclared" : "NOASSERTION", + "licenseInfoFromFiles" : [ "NOASSERTION" ], + "name" : "Apache Commons FileUpload", + "originator" : "Organization:The Apache Software Foundation", + "packageFileName" : "NOASSERTION", + "packageVerificationCode" : { + "packageVerificationCodeValue" : "960fdb5f29dc223ecf0057d1be4f1c6f579f5076" + }, + "primaryPackagePurpose" : "INSTALL", + "summary" : "The Apache Commons FileUpload component provides a simple yet flexible means of adding support for multipart\n file upload functionality to servlets and web applications.", + "supplier" : "Organization: The Apache Software Foundation", + "versionInfo" : "2.0.0-M1" + } ], + "files" : [ { + "SPDXID" : "SPDXRef-gnrtd1", + "checksums" : [ { + "algorithm" : "SHA1", + "checksumValue" : "312709931435f4ad62a7d6cf1cee3fbe46883823" + } ], + "copyrightText" : "NOASSERTION", + "fileName" : "./NOTICE.txt", + "fileTypes" : [ "TEXT" ], + "licenseConcluded" : "NOASSERTION", + "licenseInfoInFiles" : [ "NOASSERTION" ] + }, { + "SPDXID" : "SPDXRef-gnrtd2", + "checksums" : [ { + "algorithm" : "SHA1", + "checksumValue" : "2b8b815229aa8a61e483fb4ba0588b8b6c491890" + } ], + "copyrightText" : "NOASSERTION", + "fileName" : "./LICENSE.txt", + "fileTypes" : [ "TEXT" ], + "licenseConcluded" : "NOASSERTION", + "licenseInfoInFiles" : [ "NOASSERTION" ] + } ], + "relationships" : [ { + "spdxElementId" : "SPDXRef-DOCUMENT", + "relationshipType" : "DESCRIBES", + "relatedSpdxElement" : "SPDXRef-gnrtd0", + "comment" : "" + }, { + "spdxElementId" : "SPDXRef-gnrtd0", + "relationshipType" : "CONTAINS", + "relatedSpdxElement" : "SPDXRef-gnrtd1" + }, { + "spdxElementId" : "SPDXRef-gnrtd0", + "relationshipType" : "CONTAINS", + "relatedSpdxElement" : "SPDXRef-gnrtd2" + }, { + "spdxElementId" : "SPDXRef-gnrtd1", + "relationshipType" : "CONTAINED_BY", + "relatedSpdxElement" : "SPDXRef-gnrtd0", + "comment" : "" + }, { + "spdxElementId" : "SPDXRef-gnrtd2", + "relationshipType" : "CONTAINED_BY", + "relatedSpdxElement" : "SPDXRef-gnrtd0", + "comment" : "" + } ] +} \ No newline at end of file Added: dev/commons/fileupload/2.0.0-M1-RC1/site/overview.html ============================================================================== --- dev/commons/fileupload/2.0.0-M1-RC1/site/overview.html (added) +++ dev/commons/fileupload/2.0.0-M1-RC1/site/overview.html Sat Jul 15 23:26:25 2023 @@ -0,0 +1,314 @@ +<!DOCTYPE html> +<!-- + | Generated by Apache Maven Doxia at 15 July 2023 + | Rendered using Apache Maven Fluido Skin 1.3.0 +--> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> + <head> + <meta charset="iso-8859-1" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="author" content="Robert Burrell Donkin" /> + <meta name="Date-Revision-yyyymmdd" content="20230715" /> + <meta http-equiv="Content-Language" content="en" /> + <title>FileUpload – FileUpload Overview</title> + + <link rel="stylesheet" href="./css/bootstrap.min.css" type="text/css" /> + <link rel="stylesheet" href="./css/site.css" type="text/css" /> + <link rel="stylesheet" href="./css/print.css" media="print" /> + + <script type="text/javascript" src="./js/jquery.min.js"></script> + <script type="text/javascript" src="./js/bootstrap.min.js"></script> + <script type="text/javascript" src="./js/prettify.min.js"></script> + <script type="text/javascript" src="./js/site.js"></script> + + + </head> + + <body class="composite"> + <a href="https://commons.apache.org/" id="bannerLeft" title="Apache Commons logo"> + <img class="logo-left" src=" ./images/commons-logo.png +" alt="Apache Commons logo"/> + </a> + <a href="index.html" id="bannerRight"> + <img class="logo-right" src=" images/logo.png +" alt="Commons FileUpload"/> + </a> + <div class="clear"></div> + + <div class="navbar"> + <div class="navbar-inner"> + <div class="container-fluid"> + <a class="brand" href="https://commons.apache.org/proper/commons-fileupload/">Apache Commons FileUpload ™</a> + <ul class="nav"> + + <li id="publishDate">Last Published: 15 July 2023</li> + <li class="divider">|</li> <li id="projectVersion">Version: 2.0.0-M1</li> + </ul> + <div class="pull-right"> <ul class="nav"> + <li> + <a href="https://www.apachecon.com/" class="externalLink" title="ApacheCon"> + ApacheCon</a> + </li> + <li> + <a href="https://www.apache.org" class="externalLink" title="Apache"> + Apache</a> + </li> + <li> + <a href="../../" title="Commons"> + Commons</a> + </li> + </ul> +</div> + </div> + </div> + </div> + + <div class="container-fluid"> + <table class="layout-table"> + <tr> + <td class="sidebar"> + <div class="well sidebar-nav"> + <ul class="nav nav-list"> + <li class="nav-header">Commons FileUpload</li> + <li class="none"> + <a href="index.html" title="Overview"> + Overview</a> + </li> + <li class="none"> + <a href="using.html" title="User guide"> + User guide</a> + </li> + <li class="none"> + <a href="migration.html" title="Migration"> + Migration</a> + </li> + <li class="none"> + <a href="streaming.html" title="Streaming API"> + Streaming API</a> + </li> + <li class="none"> + <a href="faq.html" title="FAQ"> + FAQ</a> + </li> + <li class="none"> + <a href="https://javadoc.io/doc/org.apache.commons/commons-fileupload2" class="externalLink" title="Javadoc Archives v2"> + Javadoc Archives v2</a> + </li> + <li class="none"> + <a href="https://javadoc.io/doc/commons-fileupload/commons-fileupload" class="externalLink" title="Javadoc Archives v1"> + Javadoc Archives v1</a> + </li> + <li class="none"> + <a href="download_fileupload.cgi" title="Download"> + Download</a> + </li> + <li class="none"> + <a href="security-reports.html" title="Security Reports"> + Security Reports</a> + </li> + <li class="none"> + <a href="mail-lists.html" title="Mailing lists"> + Mailing lists</a> + </li> + <li class="none"> + <a href="issue-tracking.html" title="Issue Tracking"> + Issue Tracking</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">Modules</li> + <li class="none"> + <a href="commons-fileupload2-core/index.html" title="FileUpload Core"> + FileUpload Core</a> + </li> + <li class="none"> + <a href="commons-fileupload2-jakarta/index.html" title="FileUpload Jakarta"> + FileUpload Jakarta</a> + </li> + <li class="none"> + <a href="commons-fileupload2-javax/index.html" title="FileUpload Javax"> + FileUpload Javax</a> + </li> + <li class="none"> + <a href="commons-fileupload2-portlet/index.html" title="FileUpload Portlet"> + FileUpload Portlet</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header"><i class="icon-info-sign"></i>Project Documentation</li> + <li class="collapsed"> + <a href="project-info.html" title="Project Information"> + Project Information</a> + </li> + <li class="collapsed"> + <a href="project-reports.html" title="Project Reports"> + Project Reports</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">Commons</li> + <li class="none"> + <a href="../../" title="Home"> + Home</a> + </li> + <li class="none"> + <a href="https://www.apache.org/licenses/" class="externalLink" title="License"> + License</a> + </li> + <li class="collapsed"> + <a href="../../components.html" title="Components"> + Components</a> + </li> + <li class="collapsed"> + <a href="../../sandbox/index.html" title="Sandbox"> + Sandbox</a> + </li> + <li class="collapsed"> + <a href="../../dormant/index.html" title="Dormant"> + Dormant</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">General Information</li> + <li class="none"> + <a href="../../security.html" title="Security"> + Security</a> + </li> + <li class="none"> + <a href="../../volunteering.html" title="Volunteering"> + Volunteering</a> + </li> + <li class="none"> + <a href="../../patches.html" title="Contributing Patches"> + Contributing Patches</a> + </li> + <li class="none"> + <a href="../../building.html" title="Building Components"> + Building Components</a> + </li> + <li class="none"> + <a href="../../commons-parent-pom.html" title="Commons Parent POM"> + Commons Parent POM</a> + </li> + <li class="none"> + <a href="../../build-plugin/index.html" title="Commons Build Plugin"> + Commons Build Plugin</a> + </li> + <li class="none"> + <a href="release-plugin/index.html" title="Commons Release Plugin"> + Commons Release Plugin</a> + </li> + <li class="none"> + <a href="site-publish.html" title="Site Publication"> + Site Publication</a> + </li> + <li class="none"> + <a href="../../releases/index.html" title="Releasing Components"> + Releasing Components</a> + </li> + <li class="none"> + <a href="https://cwiki.apache.org/confluence/display/commons/FrontPage" class="externalLink" title="Wiki"> + Wiki</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">ASF</li> + <li class="none"> + <a href="https://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How the ASF works"> + How the ASF works</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/getinvolved.html" class="externalLink" title="Get Involved"> + Get Involved</a> + </li> + <li class="none"> + <a href="https://www.apache.org/dev/" class="externalLink" title="Developer Resources"> + Developer Resources</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/policies/conduct.html" class="externalLink" title="Code of Conduct"> + Code of Conduct</a> + </li> + <li class="none"> + <a href="https://privacy.apache.org/policies/privacy-policy-public.html" class="externalLink" title="Privacy"> + Privacy</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship"> + Sponsorship</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks"> + Thanks</a> + </li> + </ul> + </div> + <div id="poweredBy"> + <a href="https://www.apache.org/events/current-event.html" title="ApacheCon" class="builtBy"> + <img class="builtBy" alt="ApacheCon" src="https://www.apache.org/events/current-event-125x125.png" /> + </a> + <a href="https://maven.apache.org/" title="Maven" class="builtBy"> + <img class="builtBy" alt="Maven" src="https://maven.apache.org/images/logos/maven-feather.png" /> + </a> + </div> + </td> + <td class="content"> + + + + <section> +<h2><a name="Using_FileUpload"></a>Using FileUpload</h2> + +<p> + Your application should detect whether or not FileUpload should be + invoked, based on the HTTP method and the content type of the request. + </p> + +<p> + Assuming that you have decided that FileUpload should be invoked, you + might write the following code to handle a file upload request: +</p> +<div class="source"> +<pre>DiskFileItemFactory factory = DiskFileItemFactory.builder() + // Set upload parameters + .setBufferSize(MAX_MEMORY_SIZE) + .setPath(Paths.get(TEMP_DIR)) + .get(); + +// Create a new file upload handler +JakartaServletDiskFileUpload upload = new JakartaServletDiskFileUpload(factory); +upload.setSizeMax(MAX_UPLOAD_SIZE); + +// Parse the request +List<DiskFileItem> items = upload.parseRequest(request); + +// Process the uploaded fields +for (DiskFileItem item :items) { + if (item.isFormField()) { + processTextParameter(request, item); + } else { + processFileParameter(request, item); + } +} +</pre></div> + + </section> + + + + </td> + </tr> + </table> + </div> + + <div class="footer"> + <p>Copyright © 2002-2023 + <a href="https://www.apache.org/">The Apache Software Foundation</a>. + All Rights Reserved.</p> + +<div class="center">Apache Commons, Apache Commons FileUpload, Apache, the Apache feather logo, and the Apache Commons project logos are trademarks of The Apache Software Foundation. + All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div> + </div> + </body> + +</html> Added: dev/commons/fileupload/2.0.0-M1-RC1/site/pmd.html ============================================================================== --- dev/commons/fileupload/2.0.0-M1-RC1/site/pmd.html (added) +++ dev/commons/fileupload/2.0.0-M1-RC1/site/pmd.html Sat Jul 15 23:26:25 2023 @@ -0,0 +1,577 @@ +<!DOCTYPE html> +<!-- + | Generated by Apache Maven Doxia at 15 July 2023 + | Rendered using Apache Maven Fluido Skin 1.3.0 +--> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> + <head> + <meta charset="iso-8859-1" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="Date-Revision-yyyymmdd" content="20230715" /> + <meta http-equiv="Content-Language" content="en" /> + <title>FileUpload – PMD Results</title> + + <link rel="stylesheet" href="./css/bootstrap.min.css" type="text/css" /> + <link rel="stylesheet" href="./css/site.css" type="text/css" /> + <link rel="stylesheet" href="./css/print.css" media="print" /> + + <script type="text/javascript" src="./js/jquery.min.js"></script> + <script type="text/javascript" src="./js/bootstrap.min.js"></script> + <script type="text/javascript" src="./js/prettify.min.js"></script> + <script type="text/javascript" src="./js/site.js"></script> + + + </head> + + <body class="composite"> + <a href="https://commons.apache.org/" id="bannerLeft" title="Apache Commons logo"> + <img class="logo-left" src=" ./images/commons-logo.png +" alt="Apache Commons logo"/> + </a> + <a href="index.html" id="bannerRight"> + <img class="logo-right" src=" images/logo.png +" alt="Commons FileUpload"/> + </a> + <div class="clear"></div> + + <div class="navbar"> + <div class="navbar-inner"> + <div class="container-fluid"> + <a class="brand" href="https://commons.apache.org/proper/commons-fileupload/">Apache Commons FileUpload ™</a> + <ul class="nav"> + + <li id="publishDate">Last Published: 15 July 2023</li> + <li class="divider">|</li> <li id="projectVersion">Version: 2.0.0-M1</li> + </ul> + <div class="pull-right"> <ul class="nav"> + <li> + <a href="https://www.apachecon.com/" class="externalLink" title="ApacheCon"> + ApacheCon</a> + </li> + <li> + <a href="https://www.apache.org" class="externalLink" title="Apache"> + Apache</a> + </li> + <li> + <a href="../../" title="Commons"> + Commons</a> + </li> + </ul> +</div> + </div> + </div> + </div> + + <div class="container-fluid"> + <table class="layout-table"> + <tr> + <td class="sidebar"> + <div class="well sidebar-nav"> + <ul class="nav nav-list"> + <li class="nav-header">Commons FileUpload</li> + <li class="none"> + <a href="index.html" title="Overview"> + Overview</a> + </li> + <li class="none"> + <a href="using.html" title="User guide"> + User guide</a> + </li> + <li class="none"> + <a href="migration.html" title="Migration"> + Migration</a> + </li> + <li class="none"> + <a href="streaming.html" title="Streaming API"> + Streaming API</a> + </li> + <li class="none"> + <a href="faq.html" title="FAQ"> + FAQ</a> + </li> + <li class="none"> + <a href="https://javadoc.io/doc/org.apache.commons/commons-fileupload2" class="externalLink" title="Javadoc Archives v2"> + Javadoc Archives v2</a> + </li> + <li class="none"> + <a href="https://javadoc.io/doc/commons-fileupload/commons-fileupload" class="externalLink" title="Javadoc Archives v1"> + Javadoc Archives v1</a> + </li> + <li class="none"> + <a href="download_fileupload.cgi" title="Download"> + Download</a> + </li> + <li class="none"> + <a href="security-reports.html" title="Security Reports"> + Security Reports</a> + </li> + <li class="none"> + <a href="mail-lists.html" title="Mailing lists"> + Mailing lists</a> + </li> + <li class="none"> + <a href="issue-tracking.html" title="Issue Tracking"> + Issue Tracking</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">Modules</li> + <li class="none"> + <a href="commons-fileupload2-core/index.html" title="FileUpload Core"> + FileUpload Core</a> + </li> + <li class="none"> + <a href="commons-fileupload2-jakarta/index.html" title="FileUpload Jakarta"> + FileUpload Jakarta</a> + </li> + <li class="none"> + <a href="commons-fileupload2-javax/index.html" title="FileUpload Javax"> + FileUpload Javax</a> + </li> + <li class="none"> + <a href="commons-fileupload2-portlet/index.html" title="FileUpload Portlet"> + FileUpload Portlet</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header"><i class="icon-info-sign"></i>Project Documentation</li> + <li class="collapsed"> + <a href="project-info.html" title="Project Information"> + Project Information</a> + </li> + <li class="expanded"> + <a href="project-reports.html" title="Project Reports"> + Project Reports</a> + <ul> + <li class="none"> + <a href="changes-report.html" title="Changes"> + Changes</a> + </li> + <li class="none"> + <a href="jira-report.html" title="JIRA Report"> + JIRA Report</a> + </li> + <li class="none"> + <a href="xref/index.html" title="Source Xref"> + Source Xref</a> + </li> + <li class="none"> + <a href="xref-test/index.html" title="Test Source Xref"> + Test Source Xref</a> + </li> + <li class="none"> + <a href="surefire-report.html" title="Surefire Report"> + Surefire Report</a> + </li> + <li class="none"> + <a href="rat-report.html" title="Rat Report"> + Rat Report</a> + </li> + <li class="none"> + <a href="japicmp.html" title="japicmp"> + japicmp</a> + </li> + <li class="none"> + <a href="checkstyle.html" title="Checkstyle"> + Checkstyle</a> + </li> + <li class="none"> + <a href="checkstyle-aggregate.html" title="Checkstyle"> + Checkstyle</a> + </li> + <li class="none"> + <a href="cpd.html" title="CPD"> + CPD</a> + </li> + <li class="none active"> + <a href="pmd.html" title="PMD"> + PMD</a> + </li> + </ul> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">Commons</li> + <li class="none"> + <a href="../../" title="Home"> + Home</a> + </li> + <li class="none"> + <a href="https://www.apache.org/licenses/" class="externalLink" title="License"> + License</a> + </li> + <li class="collapsed"> + <a href="../../components.html" title="Components"> + Components</a> + </li> + <li class="collapsed"> + <a href="../../sandbox/index.html" title="Sandbox"> + Sandbox</a> + </li> + <li class="collapsed"> + <a href="../../dormant/index.html" title="Dormant"> + Dormant</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">General Information</li> + <li class="none"> + <a href="../../security.html" title="Security"> + Security</a> + </li> + <li class="none"> + <a href="../../volunteering.html" title="Volunteering"> + Volunteering</a> + </li> + <li class="none"> + <a href="../../patches.html" title="Contributing Patches"> + Contributing Patches</a> + </li> + <li class="none"> + <a href="../../building.html" title="Building Components"> + Building Components</a> + </li> + <li class="none"> + <a href="../../commons-parent-pom.html" title="Commons Parent POM"> + Commons Parent POM</a> + </li> + <li class="none"> + <a href="../../build-plugin/index.html" title="Commons Build Plugin"> + Commons Build Plugin</a> + </li> + <li class="none"> + <a href="release-plugin/index.html" title="Commons Release Plugin"> + Commons Release Plugin</a> + </li> + <li class="none"> + <a href="site-publish.html" title="Site Publication"> + Site Publication</a> + </li> + <li class="none"> + <a href="../../releases/index.html" title="Releasing Components"> + Releasing Components</a> + </li> + <li class="none"> + <a href="https://cwiki.apache.org/confluence/display/commons/FrontPage" class="externalLink" title="Wiki"> + Wiki</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">ASF</li> + <li class="none"> + <a href="https://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How the ASF works"> + How the ASF works</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/getinvolved.html" class="externalLink" title="Get Involved"> + Get Involved</a> + </li> + <li class="none"> + <a href="https://www.apache.org/dev/" class="externalLink" title="Developer Resources"> + Developer Resources</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/policies/conduct.html" class="externalLink" title="Code of Conduct"> + Code of Conduct</a> + </li> + <li class="none"> + <a href="https://privacy.apache.org/policies/privacy-policy-public.html" class="externalLink" title="Privacy"> + Privacy</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship"> + Sponsorship</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks"> + Thanks</a> + </li> + </ul> + </div> + <div id="poweredBy"> + <a href="https://www.apache.org/events/current-event.html" title="ApacheCon" class="builtBy"> + <img class="builtBy" alt="ApacheCon" src="https://www.apache.org/events/current-event-125x125.png" /> + </a> + <a href="https://maven.apache.org/" title="Maven" class="builtBy"> + <img class="builtBy" alt="Maven" src="https://maven.apache.org/images/logos/maven-feather.png" /> + </a> + </div> + </td> + <td class="content"> + <section> +<h2><a name="PMD_Results"></a>PMD Results</h2> +<p>The following document contains the results of <a class="externalLink" href="https://pmd.github.io">PMD</a> 6.55.0.</p></section><section> +<h2><a name="Violations_By_Priority"></a>Violations By Priority</h2><section> +<h3><a name="Priority_1"></a>Priority 1</h3><section> +<h4><a name="Apache_Commons_FileUpload_Core_-_org.2Fapache.2Fcommons.2Ffileupload2.2Fcore.2FFileItemInputIteratorImpl.java"></a>Apache Commons FileUpload Core - org/apache/commons/fileupload2/core/FileItemInputIteratorImpl.java</h4> +<table border="0" class="bodyTable"> +<tr class="a"> +<th>Rule</th> +<th>Violation</th> +<th>Line</th></tr> +<tr class="b"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#constructorcallsoverridablemethod">ConstructorCallsOverridableMethod</a></td> +<td>Overridable method 'getMultiPartInput' called during object construction (call stack: [findNextItem, getMultiPartInput])</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/FileItemInputIteratorImpl.html#L114">114</a></td></tr></table></section></section><section> +<h3><a name="Priority_3"></a>Priority 3</h3><section> +<h4><a name="Apache_Commons_FileUpload_Core_-_org.2Fapache.2Fcommons.2Ffileupload2.2Fcore.2FAbstractFileUpload.java"></a>Apache Commons FileUpload Core - org/apache/commons/fileupload2/core/AbstractFileUpload.java</h4> +<table border="0" class="bodyTable"> +<tr class="a"> +<th>Rule</th> +<th>Violation</th> +<th>Line</th></tr> +<tr class="b"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#avoidliteralsinifcondition">AvoidLiteralsInIfCondition</a></td> +<td>Avoid using Literals in Conditional Statements</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/AbstractFileUpload.html#L389">389</a></td></tr></table></section><section> +<h4><a name="Apache_Commons_FileUpload_Core_-_org.2Fapache.2Fcommons.2Ffileupload2.2Fcore.2FDiskFileItem.java"></a>Apache Commons FileUpload Core - org/apache/commons/fileupload2/core/DiskFileItem.java</h4> +<table border="0" class="bodyTable"> +<tr class="a"> +<th>Rule</th> +<th>Violation</th> +<th>Line</th></tr> +<tr class="b"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#avoidfieldnamematchingmethodname">AvoidFieldNameMatchingMethodName</a></td> +<td>Field isFormField has the same name as a method</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/DiskFileItem.html#L203">203</a></td></tr> +<tr class="a"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#nullassignment">NullAssignment</a></td> +<td>Assigning an Object to null is a code smell. Consider refactoring.</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/DiskFileItem.html#L283">283</a></td></tr></table></section><section> +<h4><a name="Apache_Commons_FileUpload_Core_-_org.2Fapache.2Fcommons.2Ffileupload2.2Fcore.2FFileItemInputImpl.java"></a>Apache Commons FileUpload Core - org/apache/commons/fileupload2/core/FileItemInputImpl.java</h4> +<table border="0" class="bodyTable"> +<tr class="a"> +<th>Rule</th> +<th>Violation</th> +<th>Line</th></tr> +<tr class="b"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#closeresource">CloseResource</a></td> +<td>Ensure that resources like this ItemInputStream object are closed after use</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/FileItemInputImpl.html#L98">98</a></td></tr> +<tr class="a"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#closeresource">CloseResource</a></td> +<td>Ensure that resources like this ItemInputStream object are closed after use</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/FileItemInputImpl.html#L99">99</a></td></tr></table></section><section> +<h4><a name="Apache_Commons_FileUpload_Core_-_org.2Fapache.2Fcommons.2Ffileupload2.2Fcore.2FFileItemInputIteratorImpl.java"></a>Apache Commons FileUpload Core - org/apache/commons/fileupload2/core/FileItemInputIteratorImpl.java</h4> +<table border="0" class="bodyTable"> +<tr class="a"> +<th>Rule</th> +<th>Violation</th> +<th>Line</th></tr> +<tr class="b"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#nullassignment">NullAssignment</a></td> +<td>Assigning an Object to null is a code smell. Consider refactoring.</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/FileItemInputIteratorImpl.html#L129">129</a></td></tr> +<tr class="a"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#nullassignment">NullAssignment</a></td> +<td>Assigning an Object to null is a code smell. Consider refactoring.</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/FileItemInputIteratorImpl.html#L147">147</a></td></tr> +<tr class="b"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#closeresource">CloseResource</a></td> +<td>Ensure that resources like this InputStream object are closed after use</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/FileItemInputIteratorImpl.html#L244">244</a></td></tr></table></section><section> +<h4><a name="Apache_Commons_FileUpload_Core_-_org.2Fapache.2Fcommons.2Ffileupload2.2Fcore.2FMultipartInput.java"></a>Apache Commons FileUpload Core - org/apache/commons/fileupload2/core/MultipartInput.java</h4> +<table border="0" class="bodyTable"> +<tr class="a"> +<th>Rule</th> +<th>Violation</th> +<th>Line</th></tr> +<tr class="b"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#assignmentinoperand">AssignmentInOperand</a></td> +<td>Avoid assignments in operands</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/MultipartInput.html#L883">883</a></td></tr></table></section><section> +<h4><a name="Apache_Commons_FileUpload_Core_-_org.2Fapache.2Fcommons.2Ffileupload2.2Fcore.2FParameterParser.java"></a>Apache Commons FileUpload Core - org/apache/commons/fileupload2/core/ParameterParser.java</h4> +<table border="0" class="bodyTable"> +<tr class="a"> +<th>Rule</th> +<th>Violation</th> +<th>Line</th></tr> +<tr class="b"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#nullassignment">NullAssignment</a></td> +<td>Assigning an Object to null is a code smell. Consider refactoring.</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/ParameterParser.html#L172">172</a></td></tr></table></section><section> +<h4><a name="Apache_Commons_FileUpload_Core_-_org.2Fapache.2Fcommons.2Ffileupload2.2Fcore.2FQuotedPrintableDecoder.java"></a>Apache Commons FileUpload Core - org/apache/commons/fileupload2/core/QuotedPrintableDecoder.java</h4> +<table border="0" class="bodyTable"> +<tr class="a"> +<th>Rule</th> +<th>Violation</th> +<th>Line</th></tr> +<tr class="b"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#avoidliteralsinifcondition">AvoidLiteralsInIfCondition</a></td> +<td>Avoid using Literals in Conditional Statements</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/QuotedPrintableDecoder.html#L50">50</a></td></tr> +<tr class="a"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#avoidliteralsinifcondition">AvoidLiteralsInIfCondition</a></td> +<td>Avoid using Literals in Conditional Statements</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/QuotedPrintableDecoder.html#L52">52</a></td></tr> +<tr class="b"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#avoidliteralsinifcondition">AvoidLiteralsInIfCondition</a></td> +<td>Avoid using Literals in Conditional Statements</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/QuotedPrintableDecoder.html#L63">63</a></td></tr> +<tr class="a"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#avoidliteralsinifcondition">AvoidLiteralsInIfCondition</a></td> +<td>Avoid using Literals in Conditional Statements</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/QuotedPrintableDecoder.html#L64">64</a></td></tr></table></section><section> +<h4><a name="Apache_Commons_FileUpload_Core_-_org.2Fapache.2Fcommons.2Ffileupload2.2Fcore.2FRFC2231Utils.java"></a>Apache Commons FileUpload Core - org/apache/commons/fileupload2/core/RFC2231Utils.java</h4> +<table border="0" class="bodyTable"> +<tr class="a"> +<th>Rule</th> +<th>Violation</th> +<th>Line</th></tr> +<tr class="b"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#avoidliteralsinifcondition">AvoidLiteralsInIfCondition</a></td> +<td>Avoid using Literals in Conditional Statements</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/RFC2231Utils.html#L100">100</a></td></tr></table></section></section></section><section> +<h2><a name="Files"></a>Files</h2><section> +<h3><a name="Apache_Commons_FileUpload_Core_-_org.2Fapache.2Fcommons.2Ffileupload2.2Fcore.2FAbstractFileUpload.java"></a>Apache Commons FileUpload Core - org/apache/commons/fileupload2/core/AbstractFileUpload.java</h3> +<table border="0" class="bodyTable"> +<tr class="a"> +<th>Rule</th> +<th>Violation</th> +<th>Priority</th> +<th>Line</th></tr> +<tr class="b"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#avoidliteralsinifcondition">AvoidLiteralsInIfCondition</a></td> +<td>Avoid using Literals in Conditional Statements</td> +<td>3</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/AbstractFileUpload.html#L389">389</a></td></tr></table></section><section> +<h3><a name="Apache_Commons_FileUpload_Core_-_org.2Fapache.2Fcommons.2Ffileupload2.2Fcore.2FDiskFileItem.java"></a>Apache Commons FileUpload Core - org/apache/commons/fileupload2/core/DiskFileItem.java</h3> +<table border="0" class="bodyTable"> +<tr class="a"> +<th>Rule</th> +<th>Violation</th> +<th>Priority</th> +<th>Line</th></tr> +<tr class="b"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#avoidfieldnamematchingmethodname">AvoidFieldNameMatchingMethodName</a></td> +<td>Field isFormField has the same name as a method</td> +<td>3</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/DiskFileItem.html#L203">203</a></td></tr> +<tr class="a"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#nullassignment">NullAssignment</a></td> +<td>Assigning an Object to null is a code smell. Consider refactoring.</td> +<td>3</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/DiskFileItem.html#L283">283</a></td></tr></table></section><section> +<h3><a name="Apache_Commons_FileUpload_Core_-_org.2Fapache.2Fcommons.2Ffileupload2.2Fcore.2FFileItemInputImpl.java"></a>Apache Commons FileUpload Core - org/apache/commons/fileupload2/core/FileItemInputImpl.java</h3> +<table border="0" class="bodyTable"> +<tr class="a"> +<th>Rule</th> +<th>Violation</th> +<th>Priority</th> +<th>Line</th></tr> +<tr class="b"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#closeresource">CloseResource</a></td> +<td>Ensure that resources like this ItemInputStream object are closed after use</td> +<td>3</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/FileItemInputImpl.html#L98">98</a></td></tr> +<tr class="a"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#closeresource">CloseResource</a></td> +<td>Ensure that resources like this ItemInputStream object are closed after use</td> +<td>3</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/FileItemInputImpl.html#L99">99</a></td></tr></table></section><section> +<h3><a name="Apache_Commons_FileUpload_Core_-_org.2Fapache.2Fcommons.2Ffileupload2.2Fcore.2FFileItemInputIteratorImpl.java"></a>Apache Commons FileUpload Core - org/apache/commons/fileupload2/core/FileItemInputIteratorImpl.java</h3> +<table border="0" class="bodyTable"> +<tr class="a"> +<th>Rule</th> +<th>Violation</th> +<th>Priority</th> +<th>Line</th></tr> +<tr class="b"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#constructorcallsoverridablemethod">ConstructorCallsOverridableMethod</a></td> +<td>Overridable method 'getMultiPartInput' called during object construction (call stack: [findNextItem, getMultiPartInput])</td> +<td>1</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/FileItemInputIteratorImpl.html#L114">114</a></td></tr> +<tr class="a"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#nullassignment">NullAssignment</a></td> +<td>Assigning an Object to null is a code smell. Consider refactoring.</td> +<td>3</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/FileItemInputIteratorImpl.html#L129">129</a></td></tr> +<tr class="b"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#nullassignment">NullAssignment</a></td> +<td>Assigning an Object to null is a code smell. Consider refactoring.</td> +<td>3</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/FileItemInputIteratorImpl.html#L147">147</a></td></tr> +<tr class="a"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#closeresource">CloseResource</a></td> +<td>Ensure that resources like this InputStream object are closed after use</td> +<td>3</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/FileItemInputIteratorImpl.html#L244">244</a></td></tr></table></section><section> +<h3><a name="Apache_Commons_FileUpload_Core_-_org.2Fapache.2Fcommons.2Ffileupload2.2Fcore.2FMultipartInput.java"></a>Apache Commons FileUpload Core - org/apache/commons/fileupload2/core/MultipartInput.java</h3> +<table border="0" class="bodyTable"> +<tr class="a"> +<th>Rule</th> +<th>Violation</th> +<th>Priority</th> +<th>Line</th></tr> +<tr class="b"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#assignmentinoperand">AssignmentInOperand</a></td> +<td>Avoid assignments in operands</td> +<td>3</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/MultipartInput.html#L883">883</a></td></tr></table></section><section> +<h3><a name="Apache_Commons_FileUpload_Core_-_org.2Fapache.2Fcommons.2Ffileupload2.2Fcore.2FParameterParser.java"></a>Apache Commons FileUpload Core - org/apache/commons/fileupload2/core/ParameterParser.java</h3> +<table border="0" class="bodyTable"> +<tr class="a"> +<th>Rule</th> +<th>Violation</th> +<th>Priority</th> +<th>Line</th></tr> +<tr class="b"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#nullassignment">NullAssignment</a></td> +<td>Assigning an Object to null is a code smell. Consider refactoring.</td> +<td>3</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/ParameterParser.html#L172">172</a></td></tr></table></section><section> +<h3><a name="Apache_Commons_FileUpload_Core_-_org.2Fapache.2Fcommons.2Ffileupload2.2Fcore.2FQuotedPrintableDecoder.java"></a>Apache Commons FileUpload Core - org/apache/commons/fileupload2/core/QuotedPrintableDecoder.java</h3> +<table border="0" class="bodyTable"> +<tr class="a"> +<th>Rule</th> +<th>Violation</th> +<th>Priority</th> +<th>Line</th></tr> +<tr class="b"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#avoidliteralsinifcondition">AvoidLiteralsInIfCondition</a></td> +<td>Avoid using Literals in Conditional Statements</td> +<td>3</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/QuotedPrintableDecoder.html#L50">50</a></td></tr> +<tr class="a"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#avoidliteralsinifcondition">AvoidLiteralsInIfCondition</a></td> +<td>Avoid using Literals in Conditional Statements</td> +<td>3</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/QuotedPrintableDecoder.html#L52">52</a></td></tr> +<tr class="b"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#avoidliteralsinifcondition">AvoidLiteralsInIfCondition</a></td> +<td>Avoid using Literals in Conditional Statements</td> +<td>3</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/QuotedPrintableDecoder.html#L63">63</a></td></tr> +<tr class="a"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#avoidliteralsinifcondition">AvoidLiteralsInIfCondition</a></td> +<td>Avoid using Literals in Conditional Statements</td> +<td>3</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/QuotedPrintableDecoder.html#L64">64</a></td></tr></table></section><section> +<h3><a name="Apache_Commons_FileUpload_Core_-_org.2Fapache.2Fcommons.2Ffileupload2.2Fcore.2FRFC2231Utils.java"></a>Apache Commons FileUpload Core - org/apache/commons/fileupload2/core/RFC2231Utils.java</h3> +<table border="0" class="bodyTable"> +<tr class="a"> +<th>Rule</th> +<th>Violation</th> +<th>Priority</th> +<th>Line</th></tr> +<tr class="b"> +<td><a class="externalLink" href="https://pmd.github.io/pmd-6.55.0/pmd_rules_java_errorprone.html#avoidliteralsinifcondition">AvoidLiteralsInIfCondition</a></td> +<td>Avoid using Literals in Conditional Statements</td> +<td>3</td> +<td><a href="./xref/org/apache/commons/fileupload2/core/RFC2231Utils.html#L100">100</a></td></tr></table></section></section> + </td> + </tr> + </table> + </div> + + <div class="footer"> + <p>Copyright © 2002-2023 + <a href="https://www.apache.org/">The Apache Software Foundation</a>. + All Rights Reserved.</p> + +<div class="center">Apache Commons, Apache Commons FileUpload, Apache, the Apache feather logo, and the Apache Commons project logos are trademarks of The Apache Software Foundation. + All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div> + </div> + </body> + +</html> Added: dev/commons/fileupload/2.0.0-M1-RC1/site/profile.jacoco ============================================================================== --- dev/commons/fileupload/2.0.0-M1-RC1/site/profile.jacoco (added) +++ dev/commons/fileupload/2.0.0-M1-RC1/site/profile.jacoco Sat Jul 15 23:26:25 2023 @@ -0,0 +1,17 @@ +# 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. +# ----------------------------------------------------------------------------- +# +# Empty file used to automatically trigger JaCoCo profile from commons parent pom
