You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@hc.apache.org by ol...@apache.org on 2017/05/12 08:04:28 UTC
[04/19] httpcomponents-core git commit: Replace @exception with the
more modern @throws.
Replace @exception with the more modern @throws.
git-svn-id: https://svn.apache.org/repos/asf/httpcomponents/httpcore/branches/4.4.x@1792678 13f79535-47bb-0310-9956-ffa450edef68
Project: http://git-wip-us.apache.org/repos/asf/httpcomponents-core/repo
Commit: http://git-wip-us.apache.org/repos/asf/httpcomponents-core/commit/605f0bbe
Tree: http://git-wip-us.apache.org/repos/asf/httpcomponents-core/tree/605f0bbe
Diff: http://git-wip-us.apache.org/repos/asf/httpcomponents-core/diff/605f0bbe
Branch: refs/heads/4.4.x
Commit: 605f0bbe9525931284f4e8b806bba88e8fb4086e
Parents: f6d822b
Author: Gary D. Gregory <gg...@apache.org>
Authored: Tue Apr 25 22:57:48 2017 +0000
Committer: Oleg Kalnichevski <ol...@apache.org>
Committed: Fri May 12 09:14:53 2017 +0200
----------------------------------------------------------------------
.../org/apache/http/nio/util/ContentInputBuffer.java | 2 +-
.../org/apache/http/nio/util/ContentOutputBuffer.java | 6 +++---
.../apache/http/impl/io/AbstractSessionInputBuffer.java | 4 ++--
.../http/impl/io/AbstractSessionOutputBuffer.java | 4 ++--
.../org/apache/http/impl/io/SessionInputBufferImpl.java | 4 ++--
.../apache/http/impl/io/SessionOutputBufferImpl.java | 4 ++--
.../java/org/apache/http/io/SessionInputBuffer.java | 12 ++++++------
.../java/org/apache/http/io/SessionOutputBuffer.java | 12 ++++++------
.../main/java/org/apache/http/util/CharArrayBuffer.java | 4 ++--
9 files changed, 26 insertions(+), 26 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/httpcomponents-core/blob/605f0bbe/httpcore-nio/src/main/java/org/apache/http/nio/util/ContentInputBuffer.java
----------------------------------------------------------------------
diff --git a/httpcore-nio/src/main/java/org/apache/http/nio/util/ContentInputBuffer.java b/httpcore-nio/src/main/java/org/apache/http/nio/util/ContentInputBuffer.java
index dc4608f..3ec778f 100644
--- a/httpcore-nio/src/main/java/org/apache/http/nio/util/ContentInputBuffer.java
+++ b/httpcore-nio/src/main/java/org/apache/http/nio/util/ContentInputBuffer.java
@@ -75,7 +75,7 @@ public interface ContentInputBuffer {
* @return the total number of bytes read into the buffer, or
* {@code -1} if there is no more data because the end of
* the stream has been reached.
- * @exception IOException if an I/O error occurs.
+ * @throws IOException if an I/O error occurs.
*/
int read(byte[] b, int off, int len) throws IOException;
http://git-wip-us.apache.org/repos/asf/httpcomponents-core/blob/605f0bbe/httpcore-nio/src/main/java/org/apache/http/nio/util/ContentOutputBuffer.java
----------------------------------------------------------------------
diff --git a/httpcore-nio/src/main/java/org/apache/http/nio/util/ContentOutputBuffer.java b/httpcore-nio/src/main/java/org/apache/http/nio/util/ContentOutputBuffer.java
index 8a7dae4..9fd151c 100644
--- a/httpcore-nio/src/main/java/org/apache/http/nio/util/ContentOutputBuffer.java
+++ b/httpcore-nio/src/main/java/org/apache/http/nio/util/ContentOutputBuffer.java
@@ -73,7 +73,7 @@ public interface ContentOutputBuffer {
* @param b the data.
* @param off the start offset in the data.
* @param len the number of bytes to write.
- * @exception IOException if an I/O error occurs.
+ * @throws IOException if an I/O error occurs.
*/
void write(byte[] b, int off, int len) throws IOException;
@@ -81,13 +81,13 @@ public interface ContentOutputBuffer {
* Writes the specified byte to this buffer.
*
* @param b the {@code byte}.
- * @exception IOException if an I/O error occurs.
+ * @throws IOException if an I/O error occurs.
*/
void write(int b) throws IOException;
/**
* Indicates the content has been fully written.
- * @exception IOException if an I/O error occurs.
+ * @throws IOException if an I/O error occurs.
*/
void writeCompleted() throws IOException;
http://git-wip-us.apache.org/repos/asf/httpcomponents-core/blob/605f0bbe/httpcore/src/main/java-deprecated/org/apache/http/impl/io/AbstractSessionInputBuffer.java
----------------------------------------------------------------------
diff --git a/httpcore/src/main/java-deprecated/org/apache/http/impl/io/AbstractSessionInputBuffer.java b/httpcore/src/main/java-deprecated/org/apache/http/impl/io/AbstractSessionInputBuffer.java
index 7a33671..6ce8018 100644
--- a/httpcore/src/main/java-deprecated/org/apache/http/impl/io/AbstractSessionInputBuffer.java
+++ b/httpcore/src/main/java-deprecated/org/apache/http/impl/io/AbstractSessionInputBuffer.java
@@ -248,7 +248,7 @@ public abstract class AbstractSessionInputBuffer implements SessionInputBuffer,
*
* @param charbuffer the line buffer.
* @return one line of characters
- * @exception IOException if an I/O error occurs.
+ * @throws IOException if an I/O error occurs.
*/
@Override
public int readLine(final CharArrayBuffer charbuffer) throws IOException {
@@ -302,7 +302,7 @@ public abstract class AbstractSessionInputBuffer implements SessionInputBuffer,
* to CR-LF required by the HTTP specification.
*
* @return HTTP line as a string
- * @exception IOException if an I/O error occurs.
+ * @throws IOException if an I/O error occurs.
*/
private int lineFromLineBuffer(final CharArrayBuffer charbuffer)
throws IOException {
http://git-wip-us.apache.org/repos/asf/httpcomponents-core/blob/605f0bbe/httpcore/src/main/java-deprecated/org/apache/http/impl/io/AbstractSessionOutputBuffer.java
----------------------------------------------------------------------
diff --git a/httpcore/src/main/java-deprecated/org/apache/http/impl/io/AbstractSessionOutputBuffer.java b/httpcore/src/main/java-deprecated/org/apache/http/impl/io/AbstractSessionOutputBuffer.java
index aba72ea..38c14de 100644
--- a/httpcore/src/main/java-deprecated/org/apache/http/impl/io/AbstractSessionOutputBuffer.java
+++ b/httpcore/src/main/java-deprecated/org/apache/http/impl/io/AbstractSessionOutputBuffer.java
@@ -218,7 +218,7 @@ public abstract class AbstractSessionOutputBuffer implements SessionOutputBuffer
* This method uses CR-LF as a line delimiter.
*
* @param s the line.
- * @exception IOException if an I/O error occurs.
+ * @throws IOException if an I/O error occurs.
*/
@Override
public void writeLine(final String s) throws IOException {
@@ -245,7 +245,7 @@ public abstract class AbstractSessionOutputBuffer implements SessionOutputBuffer
* This method uses CR-LF as a line delimiter.
*
* @param charbuffer the buffer containing chars of the line.
- * @exception IOException if an I/O error occurs.
+ * @throws IOException if an I/O error occurs.
*/
@Override
public void writeLine(final CharArrayBuffer charbuffer) throws IOException {
http://git-wip-us.apache.org/repos/asf/httpcomponents-core/blob/605f0bbe/httpcore/src/main/java/org/apache/http/impl/io/SessionInputBufferImpl.java
----------------------------------------------------------------------
diff --git a/httpcore/src/main/java/org/apache/http/impl/io/SessionInputBufferImpl.java b/httpcore/src/main/java/org/apache/http/impl/io/SessionInputBufferImpl.java
index 44d1da5..33d20f1 100644
--- a/httpcore/src/main/java/org/apache/http/impl/io/SessionInputBufferImpl.java
+++ b/httpcore/src/main/java/org/apache/http/impl/io/SessionInputBufferImpl.java
@@ -236,7 +236,7 @@ public class SessionInputBufferImpl implements SessionInputBuffer, BufferInfo {
*
* @param charbuffer the line buffer.
* @return one line of characters
- * @exception IOException if an I/O error occurs.
+ * @throws IOException if an I/O error occurs.
*/
@Override
public int readLine(final CharArrayBuffer charbuffer) throws IOException {
@@ -303,7 +303,7 @@ public class SessionInputBufferImpl implements SessionInputBuffer, BufferInfo {
* to CR-LF required by the HTTP specification.
*
* @return HTTP line as a string
- * @exception IOException if an I/O error occurs.
+ * @throws IOException if an I/O error occurs.
*/
private int lineFromLineBuffer(final CharArrayBuffer charbuffer)
throws IOException {
http://git-wip-us.apache.org/repos/asf/httpcomponents-core/blob/605f0bbe/httpcore/src/main/java/org/apache/http/impl/io/SessionOutputBufferImpl.java
----------------------------------------------------------------------
diff --git a/httpcore/src/main/java/org/apache/http/impl/io/SessionOutputBufferImpl.java b/httpcore/src/main/java/org/apache/http/impl/io/SessionOutputBufferImpl.java
index efa5a2f..3ed5206 100644
--- a/httpcore/src/main/java/org/apache/http/impl/io/SessionOutputBufferImpl.java
+++ b/httpcore/src/main/java/org/apache/http/impl/io/SessionOutputBufferImpl.java
@@ -199,7 +199,7 @@ public class SessionOutputBufferImpl implements SessionOutputBuffer, BufferInfo
* This method uses CR-LF as a line delimiter.
*
* @param s the line.
- * @exception IOException if an I/O error occurs.
+ * @throws IOException if an I/O error occurs.
*/
@Override
public void writeLine(final String s) throws IOException {
@@ -226,7 +226,7 @@ public class SessionOutputBufferImpl implements SessionOutputBuffer, BufferInfo
* This method uses CR-LF as a line delimiter.
*
* @param charbuffer the buffer containing chars of the line.
- * @exception IOException if an I/O error occurs.
+ * @throws IOException if an I/O error occurs.
*/
@Override
public void writeLine(final CharArrayBuffer charbuffer) throws IOException {
http://git-wip-us.apache.org/repos/asf/httpcomponents-core/blob/605f0bbe/httpcore/src/main/java/org/apache/http/io/SessionInputBuffer.java
----------------------------------------------------------------------
diff --git a/httpcore/src/main/java/org/apache/http/io/SessionInputBuffer.java b/httpcore/src/main/java/org/apache/http/io/SessionInputBuffer.java
index c3b3a22..ba0f4a9 100644
--- a/httpcore/src/main/java/org/apache/http/io/SessionInputBuffer.java
+++ b/httpcore/src/main/java/org/apache/http/io/SessionInputBuffer.java
@@ -63,7 +63,7 @@ public interface SessionInputBuffer {
* @return the total number of bytes read into the buffer, or
* {@code -1} if there is no more data because the end of
* the stream has been reached.
- * @exception IOException if an I/O error occurs.
+ * @throws IOException if an I/O error occurs.
*/
int read(byte[] b, int off, int len) throws IOException;
@@ -77,7 +77,7 @@ public interface SessionInputBuffer {
* @return the total number of bytes read into the buffer, or
* {@code -1} is there is no more data because the end of
* the stream has been reached.
- * @exception IOException if an I/O error occurs.
+ * @throws IOException if an I/O error occurs.
*/
int read(byte[] b) throws IOException;
@@ -91,7 +91,7 @@ public interface SessionInputBuffer {
*
* @return the next byte of data, or {@code -1} if the end of the
* stream is reached.
- * @exception IOException if an I/O error occurs.
+ * @throws IOException if an I/O error occurs.
*/
int read() throws IOException;
@@ -108,7 +108,7 @@ public interface SessionInputBuffer {
*
* @param buffer the line buffer.
* @return one line of characters
- * @exception IOException if an I/O error occurs.
+ * @throws IOException if an I/O error occurs.
*/
int readLine(CharArrayBuffer buffer) throws IOException;
@@ -123,7 +123,7 @@ public interface SessionInputBuffer {
* specific implementations of this interface.
*
* @return HTTP line as a string
- * @exception IOException if an I/O error occurs.
+ * @throws IOException if an I/O error occurs.
*/
String readLine() throws IOException;
@@ -134,7 +134,7 @@ public interface SessionInputBuffer {
* @param timeout in milliseconds.
* @return {@code true} if some data is available in the session
* buffer or {@code false} otherwise.
- * @exception IOException if an I/O error occurs.
+ * @throws IOException if an I/O error occurs.
*
* @deprecated (4.3) do not use. This function should be provided at the
* connection level
http://git-wip-us.apache.org/repos/asf/httpcomponents-core/blob/605f0bbe/httpcore/src/main/java/org/apache/http/io/SessionOutputBuffer.java
----------------------------------------------------------------------
diff --git a/httpcore/src/main/java/org/apache/http/io/SessionOutputBuffer.java b/httpcore/src/main/java/org/apache/http/io/SessionOutputBuffer.java
index 40ae69e..666762a 100644
--- a/httpcore/src/main/java/org/apache/http/io/SessionOutputBuffer.java
+++ b/httpcore/src/main/java/org/apache/http/io/SessionOutputBuffer.java
@@ -53,7 +53,7 @@ public interface SessionOutputBuffer {
* @param b the data.
* @param off the start offset in the data.
* @param len the number of bytes to write.
- * @exception IOException if an I/O error occurs.
+ * @throws IOException if an I/O error occurs.
*/
void write(byte[] b, int off, int len) throws IOException;
@@ -62,7 +62,7 @@ public interface SessionOutputBuffer {
* to this session buffer.
*
* @param b the data.
- * @exception IOException if an I/O error occurs.
+ * @throws IOException if an I/O error occurs.
*/
void write(byte[] b) throws IOException;
@@ -70,7 +70,7 @@ public interface SessionOutputBuffer {
* Writes the specified byte to this session buffer.
*
* @param b the {@code byte}.
- * @exception IOException if an I/O error occurs.
+ * @throws IOException if an I/O error occurs.
*/
void write(int b) throws IOException;
@@ -82,7 +82,7 @@ public interface SessionOutputBuffer {
* specific implementations of this interface.
*
* @param s the line.
- * @exception IOException if an I/O error occurs.
+ * @throws IOException if an I/O error occurs.
*/
void writeLine(String s) throws IOException;
@@ -94,7 +94,7 @@ public interface SessionOutputBuffer {
* specific implementations of this interface.
*
* @param buffer the buffer containing chars of the line.
- * @exception IOException if an I/O error occurs.
+ * @throws IOException if an I/O error occurs.
*/
void writeLine(CharArrayBuffer buffer) throws IOException;
@@ -106,7 +106,7 @@ public interface SessionOutputBuffer {
* stream, such bytes should immediately be written to their
* intended destination.
*
- * @exception IOException if an I/O error occurs.
+ * @throws IOException if an I/O error occurs.
*/
void flush() throws IOException;
http://git-wip-us.apache.org/repos/asf/httpcomponents-core/blob/605f0bbe/httpcore/src/main/java/org/apache/http/util/CharArrayBuffer.java
----------------------------------------------------------------------
diff --git a/httpcore/src/main/java/org/apache/http/util/CharArrayBuffer.java b/httpcore/src/main/java/org/apache/http/util/CharArrayBuffer.java
index 36c4d75..a97a373 100644
--- a/httpcore/src/main/java/org/apache/http/util/CharArrayBuffer.java
+++ b/httpcore/src/main/java/org/apache/http/util/CharArrayBuffer.java
@@ -410,7 +410,7 @@ public final class CharArrayBuffer implements CharSequence, Serializable {
* @param beginIndex the beginning index, inclusive.
* @param endIndex the ending index, exclusive.
* @return the specified substring.
- * @exception StringIndexOutOfBoundsException if the
+ * @throws StringIndexOutOfBoundsException if the
* {@code beginIndex} is negative, or
* {@code endIndex} is larger than the length of this
* buffer, or {@code beginIndex} is larger than
@@ -439,7 +439,7 @@ public final class CharArrayBuffer implements CharSequence, Serializable {
* @param beginIndex the beginning index, inclusive.
* @param endIndex the ending index, exclusive.
* @return the specified substring.
- * @exception IndexOutOfBoundsException if the
+ * @throws IndexOutOfBoundsException if the
* {@code beginIndex} is negative, or
* {@code endIndex} is larger than the length of this
* buffer, or {@code beginIndex} is larger than