You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by gg...@apache.org on 2023/06/05 22:46:58 UTC
[commons-fileupload] 03/05: Drop @since Javadoc tags for 2.0
This is an automated email from the ASF dual-hosted git repository.
ggregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-fileupload.git
commit 507db9947f28505857f6778a3b92ec5fd75ce66a
Author: Gary Gregory <ga...@gmail.com>
AuthorDate: Mon Jun 5 17:11:52 2023 -0400
Drop @since Javadoc tags for 2.0
@since tags are not helpful since we are not binary and source
compatible with 1.x
---
.../main/java/org/apache/commons/fileupload2/AbstractFileUpload.java | 1 -
.../java/org/apache/commons/fileupload2/AbstractRequestContext.java | 1 -
.../src/main/java/org/apache/commons/fileupload2/FileItem.java | 2 --
.../src/main/java/org/apache/commons/fileupload2/FileItemHeaders.java | 2 --
.../java/org/apache/commons/fileupload2/FileItemHeadersSupport.java | 1 -
.../src/main/java/org/apache/commons/fileupload2/FileUpload.java | 1 -
.../src/main/java/org/apache/commons/fileupload2/MultipartStream.java | 1 -
.../src/main/java/org/apache/commons/fileupload2/RequestContext.java | 3 ---
.../main/java/org/apache/commons/fileupload2/disk/DiskFileItem.java | 2 --
.../java/org/apache/commons/fileupload2/disk/DiskFileItemFactory.java | 2 --
.../java/org/apache/commons/fileupload2/util/FileItemHeadersImpl.java | 2 --
.../java/org/apache/commons/fileupload2/util/mime/MimeUtility.java | 2 --
.../java/org/apache/commons/fileupload2/util/mime/ParseException.java | 1 -
.../apache/commons/fileupload2/util/mime/QuotedPrintableDecoder.java | 1 -
14 files changed, 22 deletions(-)
diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/AbstractFileUpload.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/AbstractFileUpload.java
index a7d6ab4..65974e7 100644
--- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/AbstractFileUpload.java
+++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/AbstractFileUpload.java
@@ -386,7 +386,6 @@ public abstract class AbstractFileUpload {
* @param ctx The context for the request to be parsed.
* @return A map of {@code FileItem} instances parsed from the request.
* @throws FileUploadException if there are problems reading/parsing the request or storing files.
- * @since 1.3
*/
public Map<String, List<FileItem>> parseParameterMap(final RequestContext ctx) throws FileUploadException {
final List<FileItem> items = parseRequest(ctx);
diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/AbstractRequestContext.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/AbstractRequestContext.java
index f8f9c9f..8cf9d67 100644
--- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/AbstractRequestContext.java
+++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/AbstractRequestContext.java
@@ -54,7 +54,6 @@ public abstract class AbstractRequestContext<T> implements RequestContext {
* Gets the content length of the request.
*
* @return The content length of the request.
- * @since 1.3
*/
@Override
public long getContentLength() {
diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileItem.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileItem.java
index 0477cfc..ff3da7f 100644
--- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileItem.java
+++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileItem.java
@@ -38,8 +38,6 @@ import java.io.UnsupportedEncodingException;
* specifically defined with the same signatures as methods in that interface. This allows an implementation of this interface to also implement
* {@code javax.activation.DataSource} with minimal additional work.
* </p>
- *
- * @since 1.3 additionally implements FileItemHeadersSupport
*/
public interface FileItem extends FileItemHeadersSupport {
diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileItemHeaders.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileItemHeaders.java
index ab258da..06af484 100644
--- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileItemHeaders.java
+++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileItemHeaders.java
@@ -20,8 +20,6 @@ import java.util.Iterator;
/**
* This class provides support for accessing the headers for a file or form item that was received within a {@code multipart/form-data} POST request.
- *
- * @since 1.2.1
*/
public interface FileItemHeaders {
diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileItemHeadersSupport.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileItemHeadersSupport.java
index 54b14f5..4928efc 100644
--- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileItemHeadersSupport.java
+++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileItemHeadersSupport.java
@@ -21,7 +21,6 @@ package org.apache.commons.fileupload2;
*
* @see FileItem
* @see FileItemStream
- * @since 1.2.1
*/
public interface FileItemHeadersSupport {
diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileUpload.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileUpload.java
index 32753cc..ed8e9ef 100644
--- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileUpload.java
+++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileUpload.java
@@ -86,7 +86,6 @@ public abstract class FileUpload<T> extends AbstractFileUpload {
* @param request The servlet request to be parsed.
* @return A map of {@code FileItem} instances parsed from the request.
* @throws FileUploadException if there are problems reading/parsing the request or storing files.
- * @since 1.3
*/
public abstract Map<String, List<FileItem>> parseParameterMap(T request) throws FileUploadException;
diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/MultipartStream.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/MultipartStream.java
index 2f0360e..5a3a37b 100644
--- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/MultipartStream.java
+++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/MultipartStream.java
@@ -569,7 +569,6 @@ public class MultipartStream {
* @param bufferSize The size of the buffer to be used, in bytes.
* @param notifier The notifier, which is used for calling the progress listener, if any.
* @throws IllegalArgumentException If the buffer size is too small.
- * @since 1.3.1
*/
public MultipartStream(final InputStream input, final byte[] boundary, final int bufferSize, final ProgressNotifier notifier) {
if (boundary == null) {
diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/RequestContext.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/RequestContext.java
index 66c44bb..b463497 100644
--- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/RequestContext.java
+++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/RequestContext.java
@@ -24,8 +24,6 @@ import java.io.InputStream;
* <p>
* This interface should be implemented for each type of request that may be handled by FileUpload, such as servlets and portlets.
* </p>
- *
- * @since 1.1
*/
public interface RequestContext {
@@ -40,7 +38,6 @@ public interface RequestContext {
* Gets the content length of the request.
*
* @return The content length of the request.
- * @since 1.3
*/
long getContentLength();
diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/disk/DiskFileItem.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/disk/DiskFileItem.java
index b4fe13d..8a21c53 100644
--- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/disk/DiskFileItem.java
+++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/disk/DiskFileItem.java
@@ -56,8 +56,6 @@ import org.apache.commons.io.output.DeferredFileOutputStream;
* {@link org.apache.commons.io.FileCleaningTracker} when there are files to be tracked. It might make sense to terminate that thread, for example, if your web
* application ends. See the section on "Resource cleanup" in the users guide of Commons FileUpload.
* </p>
- *
- * @since 1.1
*/
public class DiskFileItem implements FileItem {
diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/disk/DiskFileItemFactory.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/disk/DiskFileItemFactory.java
index 7bdc817..399c19a 100644
--- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/disk/DiskFileItemFactory.java
+++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/disk/DiskFileItemFactory.java
@@ -50,8 +50,6 @@ import org.apache.commons.io.FileCleaningTracker;
* the so-called reaper thread, which is started and stopped automatically by the {@link FileCleaningTracker} when there are files to be tracked. It might make
* sense to terminate that thread, for example, if your web application ends. See the section on "Resource cleanup" in the users guide of commons-fileupload.
* </p>
- *
- * @since 1.1
*/
public class DiskFileItemFactory implements FileItemFactory {
diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/FileItemHeadersImpl.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/FileItemHeadersImpl.java
index 1cc98ca..d3c0c8f 100644
--- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/FileItemHeadersImpl.java
+++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/FileItemHeadersImpl.java
@@ -28,8 +28,6 @@ import org.apache.commons.fileupload2.FileItemHeaders;
/**
* Default implementation of the {@link FileItemHeaders} interface.
- *
- * @since 1.2.1
*/
public class FileItemHeadersImpl implements FileItemHeaders {
diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/mime/MimeUtility.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/mime/MimeUtility.java
index 79b83bb..18fd9d8 100644
--- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/mime/MimeUtility.java
+++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/mime/MimeUtility.java
@@ -27,8 +27,6 @@ import java.util.Map;
/**
* Utility class to decode MIME texts.
- *
- * @since 1.3
*/
public final class MimeUtility {
diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/mime/ParseException.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/mime/ParseException.java
index ee82700..6ea1efc 100644
--- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/mime/ParseException.java
+++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/mime/ParseException.java
@@ -17,7 +17,6 @@
package org.apache.commons.fileupload2.util.mime;
/**
- * @since 1.3
*/
final class ParseException extends Exception {
diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/mime/QuotedPrintableDecoder.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/mime/QuotedPrintableDecoder.java
index 09d227e..9ca256f 100644
--- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/mime/QuotedPrintableDecoder.java
+++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/mime/QuotedPrintableDecoder.java
@@ -20,7 +20,6 @@ import java.io.IOException;
import java.io.OutputStream;
/**
- * @since 1.3
*/
final class QuotedPrintableDecoder {