This is an automated email from the ASF dual-hosted git repository.
garydgregory pushed a commit to branch 1.x
in repository https://gitbox.apache.org/repos/asf/commons-fileupload.git
The following commit(s) were added to refs/heads/1.x by this push:
new d2b78a52 Javadoc
d2b78a52 is described below
commit d2b78a52f5f231e84526eb904c615e2ac9bca52a
Author: Gary Gregory <[email protected]>
AuthorDate: Sun Aug 2 15:41:07 2026 -0400
Javadoc
---
src/main/java/org/apache/commons/fileupload/FileItem.java | 6 +++---
src/main/java/org/apache/commons/fileupload/MultipartStream.java | 4 ++--
src/main/java/org/apache/commons/fileupload/RequestContext.java | 2 +-
src/main/java/org/apache/commons/fileupload/disk/DiskFileItem.java | 6 +++---
.../apache/commons/fileupload/portlet/PortletRequestContext.java | 2 +-
.../apache/commons/fileupload/servlet/ServletRequestContext.java | 2 +-
.../apache/commons/fileupload/util/mime/QuotedPrintableDecoder.java | 4 ++--
7 files changed, 13 insertions(+), 13 deletions(-)
diff --git a/src/main/java/org/apache/commons/fileupload/FileItem.java
b/src/main/java/org/apache/commons/fileupload/FileItem.java
index 391b8423..321e97b9 100644
--- a/src/main/java/org/apache/commons/fileupload/FileItem.java
+++ b/src/main/java/org/apache/commons/fileupload/FileItem.java
@@ -84,7 +84,7 @@ public interface FileItem extends FileItemHeadersSupport {
* @return An {@link java.io.InputStream InputStream} that can be
* used to retrieve the contents of the file.
*
- * @throws IOException if an error occurs.
+ * @throws IOException Thrown if an error occurs.
*/
InputStream getInputStream() throws IOException;
@@ -109,7 +109,7 @@ public interface FileItem extends FileItemHeadersSupport {
* @return An {@link java.io.OutputStream OutputStream} that can be used
* for storing the contents of the file.
*
- * @throws IOException if an error occurs.
+ * @throws IOException Thrown if an error occurs.
*/
OutputStream getOutputStream() throws IOException;
@@ -189,7 +189,7 @@ public interface FileItem extends FileItemHeadersSupport {
* @param file The {@code File} into which the uploaded item should
* be stored.
*
- * @throws Exception if an error occurs.
+ * @throws Exception Thrown if an error occurs.
*/
void write(File file) throws Exception;
diff --git a/src/main/java/org/apache/commons/fileupload/MultipartStream.java
b/src/main/java/org/apache/commons/fileupload/MultipartStream.java
index 5240e135..32599877 100644
--- a/src/main/java/org/apache/commons/fileupload/MultipartStream.java
+++ b/src/main/java/org/apache/commons/fileupload/MultipartStream.java
@@ -887,7 +887,7 @@ public class MultipartStream {
* necessary.
*
* @return The next byte from the input stream.
- * @throws IOException if there is no more data available.
+ * @throws IOException Thrown if there is no more data available.
*/
public byte readByte() throws IOException {
// Buffer depleted ?
@@ -1013,7 +1013,7 @@ public class MultipartStream {
* @return {@code true} if an {@code encapsulation} was found in
* the stream.
*
- * @throws IOException if an i/o error occurs.
+ * @throws IOException Thrown if an i/o error occurs.
*/
public boolean skipPreamble() throws IOException {
// First delimiter may be not preceded with a CRLF.
diff --git a/src/main/java/org/apache/commons/fileupload/RequestContext.java
b/src/main/java/org/apache/commons/fileupload/RequestContext.java
index 92075418..9ebed0f1 100644
--- a/src/main/java/org/apache/commons/fileupload/RequestContext.java
+++ b/src/main/java/org/apache/commons/fileupload/RequestContext.java
@@ -55,7 +55,7 @@ public interface RequestContext {
* Gets the input stream for the request.
*
* @return The input stream for the request.
- * @throws IOException if a problem occurs.
+ * @throws IOException Thrown if a problem occurs.
*/
InputStream getInputStream() throws IOException;
diff --git a/src/main/java/org/apache/commons/fileupload/disk/DiskFileItem.java
b/src/main/java/org/apache/commons/fileupload/disk/DiskFileItem.java
index 131a5210..83edf526 100644
--- a/src/main/java/org/apache/commons/fileupload/disk/DiskFileItem.java
+++ b/src/main/java/org/apache/commons/fileupload/disk/DiskFileItem.java
@@ -297,7 +297,7 @@ public class DiskFileItem implements FileItem {
*
* @return An {@link java.io.InputStream InputStream} that can be used to
retrieve the contents of the file.
*
- * @throws IOException if an error occurs.
+ * @throws IOException Thrown if an error occurs.
*/
@Override
public InputStream getInputStream() throws IOException {
@@ -329,7 +329,7 @@ public class DiskFileItem implements FileItem {
*
* @return An {@link java.io.OutputStream OutputStream} that can be used
for storing the contents of the file.
*
- * @throws IOException if an error occurs (never happens).
+ * @throws IOException Thrown if an error occurs (never happens).
*/
@Override
public OutputStream getOutputStream() throws IOException {
@@ -536,7 +536,7 @@ public class DiskFileItem implements FileItem {
*
* @param file The {@code File} into which the uploaded item should
* be stored.
- * @throws Exception if an error occurs.
+ * @throws Exception Thrown if an error occurs.
*/
@Override
public void write(final File file) throws Exception {
diff --git
a/src/main/java/org/apache/commons/fileupload/portlet/PortletRequestContext.java
b/src/main/java/org/apache/commons/fileupload/portlet/PortletRequestContext.java
index 1a5cbd29..3ef6fd13 100644
---
a/src/main/java/org/apache/commons/fileupload/portlet/PortletRequestContext.java
+++
b/src/main/java/org/apache/commons/fileupload/portlet/PortletRequestContext.java
@@ -101,7 +101,7 @@ public class PortletRequestContext implements UploadContext
{
* Retrieve the input stream for the request.
*
* @return The input stream for the request.
- * @throws IOException if a problem occurs.
+ * @throws IOException Thrown if a problem occurs.
*/
@Override
public InputStream getInputStream() throws IOException {
diff --git
a/src/main/java/org/apache/commons/fileupload/servlet/ServletRequestContext.java
b/src/main/java/org/apache/commons/fileupload/servlet/ServletRequestContext.java
index 27902896..cc21e82c 100644
---
a/src/main/java/org/apache/commons/fileupload/servlet/ServletRequestContext.java
+++
b/src/main/java/org/apache/commons/fileupload/servlet/ServletRequestContext.java
@@ -99,7 +99,7 @@ public class ServletRequestContext implements UploadContext {
* Retrieve the input stream for the request.
*
* @return The input stream for the request.
- * @throws IOException if a problem occurs.
+ * @throws IOException Thrown if a problem occurs.
*/
@Override
public InputStream getInputStream() throws IOException {
diff --git
a/src/main/java/org/apache/commons/fileupload/util/mime/QuotedPrintableDecoder.java
b/src/main/java/org/apache/commons/fileupload/util/mime/QuotedPrintableDecoder.java
index 176e85c6..8d009850 100644
---
a/src/main/java/org/apache/commons/fileupload/util/mime/QuotedPrintableDecoder.java
+++
b/src/main/java/org/apache/commons/fileupload/util/mime/QuotedPrintableDecoder.java
@@ -61,7 +61,7 @@ final class QuotedPrintableDecoder {
* @param data The array of byte data to decode.
* @param out The output stream used to return the decoded data.
* @return The number of bytes produced.
- * @throws IOException if an IO error occurs
+ * @throws IOException Thrown if an IO error occurs
*/
public static int decode(final byte[] data, final OutputStream out) throws
IOException {
int off = 0;
@@ -115,7 +115,7 @@ final class QuotedPrintableDecoder {
*
* @param b The ASCII hex byte to convert (0-0, A-F, a-f)
* @return The int value of the hex byte, 0-15
- * @throws IOException if the byte is not a valid hex digit.
+ * @throws IOException Thrown if the byte is not a valid hex digit.
*/
private static int hexToBinary(final byte b) throws IOException {
// CHECKSTYLE IGNORE MagicNumber FOR NEXT 1 LINE
