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 2016/06/07 02:22:25 UTC
svn commit: r1747119 [3/4] - in
/commons/proper/net/trunk/src/main/java/org/apache/commons/net: ./ bsd/
chargen/ daytime/ discard/ echo/ finger/ ftp/ ftp/parser/ imap/ io/ nntp/
ntp/ pop3/ smtp/ telnet/ tftp/ time/ whois/
Modified: commons/proper/net/trunk/src/main/java/org/apache/commons/net/imap/IMAPClient.java
URL: http://svn.apache.org/viewvc/commons/proper/net/trunk/src/main/java/org/apache/commons/net/imap/IMAPClient.java?rev=1747119&r1=1747118&r2=1747119&view=diff
==============================================================================
--- commons/proper/net/trunk/src/main/java/org/apache/commons/net/imap/IMAPClient.java (original)
+++ commons/proper/net/trunk/src/main/java/org/apache/commons/net/imap/IMAPClient.java Tue Jun 7 02:22:24 2016
@@ -34,7 +34,7 @@ public class IMAPClient extends IMAP
/**
* Send a CAPABILITY command to the server.
* @return {@code true} if the command was successful,{@code false} if not.
- * @exception IOException If a network I/O error occurs
+ * @throws IOException If a network I/O error occurs
*/
public boolean capability() throws IOException
{
@@ -46,7 +46,7 @@ public class IMAPClient extends IMAP
* a connection alive since most IMAP servers will timeout after 10
* minutes of inactivity.
* @return {@code true} if the command was successful,{@code false} if not.
- * @exception IOException If a network I/O error occurs.
+ * @throws IOException If a network I/O error occurs.
*/
public boolean noop() throws IOException
{
@@ -60,7 +60,7 @@ public class IMAPClient extends IMAP
* the client is in the not authenticated or authenticated state, it enters the
* logout on a successful logout.
* @return {@code true} if the command was successful,{@code false} if not.
- * @exception IOException If a network I/O error occurs.
+ * @throws IOException If a network I/O error occurs.
*/
public boolean logout() throws IOException
{
@@ -82,7 +82,7 @@ public class IMAPClient extends IMAP
* @param username The account name being logged in to.
* @param password The plain text password of the account.
* @return True if the login attempt was successful, false if not.
- * @exception IOException If a network I/O error occurs in the process of
+ * @throws IOException If a network I/O error occurs in the process of
* logging in.
*/
public boolean login(String username, String password) throws IOException
@@ -108,7 +108,7 @@ public class IMAPClient extends IMAP
* Send a SELECT command to the server.
* @param mailboxName The mailbox name to select.
* @return {@code true} if the command was successful,{@code false} if not.
- * @exception IOException If a network I/O error occurs.
+ * @throws IOException If a network I/O error occurs.
*/
public boolean select(String mailboxName) throws IOException
{
@@ -119,7 +119,7 @@ public class IMAPClient extends IMAP
* Send an EXAMINE command to the server.
* @param mailboxName The mailbox name to examine.
* @return {@code true} if the command was successful,{@code false} if not.
- * @exception IOException If a network I/O error occurs.
+ * @throws IOException If a network I/O error occurs.
*/
public boolean examine(String mailboxName) throws IOException
{
@@ -130,7 +130,7 @@ public class IMAPClient extends IMAP
* Send a CREATE command to the server.
* @param mailboxName The mailbox name to create.
* @return {@code true} if the command was successful,{@code false} if not.
- * @exception IOException If a network I/O error occurs.
+ * @throws IOException If a network I/O error occurs.
*/
public boolean create(String mailboxName) throws IOException
{
@@ -141,7 +141,7 @@ public class IMAPClient extends IMAP
* Send a DELETE command to the server.
* @param mailboxName The mailbox name to delete.
* @return {@code true} if the command was successful,{@code false} if not.
- * @exception IOException If a network I/O error occurs.
+ * @throws IOException If a network I/O error occurs.
*/
public boolean delete(String mailboxName) throws IOException
{
@@ -153,7 +153,7 @@ public class IMAPClient extends IMAP
* @param oldMailboxName The existing mailbox name to rename.
* @param newMailboxName The new mailbox name.
* @return {@code true} if the command was successful,{@code false} if not.
- * @exception IOException If a network I/O error occurs.
+ * @throws IOException If a network I/O error occurs.
*/
public boolean rename(String oldMailboxName, String newMailboxName) throws IOException
{
@@ -164,7 +164,7 @@ public class IMAPClient extends IMAP
* Send a SUBSCRIBE command to the server.
* @param mailboxName The mailbox name to subscribe to.
* @return {@code true} if the command was successful,{@code false} if not.
- * @exception IOException If a network I/O error occurs.
+ * @throws IOException If a network I/O error occurs.
*/
public boolean subscribe(String mailboxName) throws IOException
{
@@ -175,7 +175,7 @@ public class IMAPClient extends IMAP
* Send a UNSUBSCRIBE command to the server.
* @param mailboxName The mailbox name to unsubscribe from.
* @return {@code true} if the command was successful,{@code false} if not.
- * @exception IOException If a network I/O error occurs.
+ * @throws IOException If a network I/O error occurs.
*/
public boolean unsubscribe(String mailboxName) throws IOException
{
@@ -187,7 +187,7 @@ public class IMAPClient extends IMAP
* @param refName The reference name.
* @param mailboxName The mailbox name.
* @return {@code true} if the command was successful,{@code false} if not.
- * @exception IOException If a network I/O error occurs.
+ * @throws IOException If a network I/O error occurs.
*/
public boolean list(String refName, String mailboxName) throws IOException
{
@@ -199,7 +199,7 @@ public class IMAPClient extends IMAP
* @param refName The reference name.
* @param mailboxName The mailbox name.
* @return {@code true} if the command was successful,{@code false} if not.
- * @exception IOException If a network I/O error occurs.
+ * @throws IOException If a network I/O error occurs.
*/
public boolean lsub(String refName, String mailboxName) throws IOException
{
@@ -211,7 +211,7 @@ public class IMAPClient extends IMAP
* @param mailboxName The reference name.
* @param itemNames The status data item names.
* @return {@code true} if the command was successful,{@code false} if not.
- * @exception IOException If a network I/O error occurs.
+ * @throws IOException If a network I/O error occurs.
*/
public boolean status(String mailboxName, String[] itemNames) throws IOException
{
@@ -242,7 +242,7 @@ public class IMAPClient extends IMAP
* @param datetime The date/time string (optional).
* @param message The message to append.
* @return {@code true} if the command was successful,{@code false} if not.
- * @exception IOException If a network I/O error occurs.
+ * @throws IOException If a network I/O error occurs.
* @since 3.4
*/
public boolean append(String mailboxName, String flags, String datetime, String message) throws IOException
@@ -277,7 +277,7 @@ public class IMAPClient extends IMAP
* @param flags The flag parenthesized list (optional).
* @param datetime The date/time string (optional).
* @return {@code true} if the command was successful,{@code false} if not.
- * @exception IOException If a network I/O error occurs.
+ * @throws IOException If a network I/O error occurs.
* @deprecated (3.4) Does not work; the message body is not optional.
* Use {@link #append(String, String, String, String)} instead.
*/
@@ -302,7 +302,7 @@ public class IMAPClient extends IMAP
* Send an APPEND command to the server.
* @param mailboxName The mailbox name.
* @return {@code true} if the command was successful,{@code false} if not.
- * @exception IOException If a network I/O error occurs.
+ * @throws IOException If a network I/O error occurs.
* @deprecated (3.4) Does not work; the message body is not optional.
* Use {@link #append(String, String, String, String)} instead.
*/
@@ -317,7 +317,7 @@ public class IMAPClient extends IMAP
/**
* Send a CHECK command to the server.
* @return {@code true} if the command was successful,{@code false} if not.
- * @exception IOException If a network I/O error occurs.
+ * @throws IOException If a network I/O error occurs.
*/
public boolean check() throws IOException
{
@@ -327,7 +327,7 @@ public class IMAPClient extends IMAP
/**
* Send a CLOSE command to the server.
* @return {@code true} if the command was successful,{@code false} if not.
- * @exception IOException If a network I/O error occurs.
+ * @throws IOException If a network I/O error occurs.
*/
public boolean close() throws IOException
{
@@ -337,7 +337,7 @@ public class IMAPClient extends IMAP
/**
* Send an EXPUNGE command to the server.
* @return {@code true} if the command was successful,{@code false} if not.
- * @exception IOException If a network I/O error occurs.
+ * @throws IOException If a network I/O error occurs.
*/
public boolean expunge() throws IOException
{
@@ -349,7 +349,7 @@ public class IMAPClient extends IMAP
* @param charset The charset (optional).
* @param criteria The search criteria.
* @return {@code true} if the command was successful,{@code false} if not.
- * @exception IOException If a network I/O error occurs.
+ * @throws IOException If a network I/O error occurs.
*/
public boolean search(String charset, String criteria) throws IOException
{
@@ -365,7 +365,7 @@ public class IMAPClient extends IMAP
* Send a SEARCH command to the server.
* @param criteria The search criteria.
* @return {@code true} if the command was successful,{@code false} if not.
- * @exception IOException If a network I/O error occurs.
+ * @throws IOException If a network I/O error occurs.
*/
public boolean search(String criteria) throws IOException
{
@@ -379,7 +379,7 @@ public class IMAPClient extends IMAP
* @param itemNames The item names for the FETCH command. (e.g. BODY.PEEK[HEADER.FIELDS (SUBJECT)])
* If multiple item names are requested, these must be enclosed in parentheses, e.g. "(UID FLAGS BODY.PEEK[])"
* @return {@code true} if the command was successful,{@code false} if not.
- * @exception IOException If a network I/O error occurs.
+ * @throws IOException If a network I/O error occurs.
* @see #getReplyString()
* @see #getReplyStrings()
*/
@@ -394,7 +394,7 @@ public class IMAPClient extends IMAP
* @param itemNames The item name for the STORE command (i.e. [+|-]FLAGS[.SILENT])
* @param itemValues The item values for the STORE command. (e.g. (\Deleted) )
* @return {@code true} if the command was successful,{@code false} if not.
- * @exception IOException If a network I/O error occurs.
+ * @throws IOException If a network I/O error occurs.
*/
public boolean store(String sequenceSet, String itemNames, String itemValues)
throws IOException
@@ -407,7 +407,7 @@ public class IMAPClient extends IMAP
* @param sequenceSet The sequence set to fetch.
* @param mailboxName The mailbox name.
* @return {@code true} if the command was successful,{@code false} if not.
- * @exception IOException If a network I/O error occurs.
+ * @throws IOException If a network I/O error occurs.
*/
public boolean copy(String sequenceSet, String mailboxName) throws IOException
{
@@ -419,7 +419,7 @@ public class IMAPClient extends IMAP
* @param command The command for UID.
* @param commandArgs The arguments for the command.
* @return {@code true} if the command was successful,{@code false} if not.
- * @exception IOException If a network I/O error occurs.
+ * @throws IOException If a network I/O error occurs.
*/
public boolean uid(String command, String commandArgs) throws IOException
{
Modified: commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/DotTerminatedMessageReader.java
URL: http://svn.apache.org/viewvc/commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/DotTerminatedMessageReader.java?rev=1747119&r1=1747118&r2=1747119&view=diff
==============================================================================
--- commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/DotTerminatedMessageReader.java (original)
+++ commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/DotTerminatedMessageReader.java Tue Jun 7 02:22:24 2016
@@ -69,7 +69,7 @@ public final class DotTerminatedMessageR
* completeness.
* @return The next character in the message. Returns -1 if the end of the
* message has been reached.
- * @exception IOException If an error occurs while reading the underlying
+ * @throws IOException If an error occurs while reading the underlying
* stream.
*/
@Override
@@ -140,7 +140,7 @@ public final class DotTerminatedMessageR
* @param buffer The character array in which to store the characters.
* @return The number of characters read. Returns -1 if the
* end of the message has been reached.
- * @exception IOException If an error occurs in reading the underlying
+ * @throws IOException If an error occurs in reading the underlying
* stream.
*/
@Override
@@ -160,7 +160,7 @@ public final class DotTerminatedMessageR
* @param length The number of characters to read.
* @return The number of characters read. Returns -1 if the
* end of the message has been reached.
- * @exception IOException If an error occurs in reading the underlying
+ * @throws IOException If an error occurs in reading the underlying
* stream.
*/
@Override
@@ -201,7 +201,7 @@ public final class DotTerminatedMessageR
* for communicating with the server. If you do not fully read
* a message, you MUST close it, otherwise your program will likely
* hang or behave improperly.
- * @exception IOException If an error occurs while reading the
+ * @throws IOException If an error occurs while reading the
* underlying stream.
*/
@Override
Modified: commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/DotTerminatedMessageWriter.java
URL: http://svn.apache.org/viewvc/commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/DotTerminatedMessageWriter.java?rev=1747119&r1=1747118&r2=1747119&view=diff
==============================================================================
--- commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/DotTerminatedMessageWriter.java (original)
+++ commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/DotTerminatedMessageWriter.java Tue Jun 7 02:22:24 2016
@@ -68,7 +68,7 @@ public final class DotTerminatedMessageW
* is only mentioned for completeness.
*
* @param ch The character to write.
- * @exception IOException If an error occurs while writing to the
+ * @throws IOException If an error occurs while writing to the
* underlying output.
***/
@Override
@@ -111,7 +111,7 @@ public final class DotTerminatedMessageW
* @param buffer The character array to write.
* @param offset The offset into the array at which to start copying data.
* @param length The number of characters to write.
- * @exception IOException If an error occurs while writing to the underlying
+ * @throws IOException If an error occurs while writing to the underlying
* output.
***/
@Override
@@ -130,7 +130,7 @@ public final class DotTerminatedMessageW
* Writes a character array to the output.
*
* @param buffer The character array to write.
- * @exception IOException If an error occurs while writing to the underlying
+ * @throws IOException If an error occurs while writing to the underlying
* output.
***/
@Override
@@ -144,7 +144,7 @@ public final class DotTerminatedMessageW
* Writes a String to the output.
*
* @param string The String to write.
- * @exception IOException If an error occurs while writing to the underlying
+ * @throws IOException If an error occurs while writing to the underlying
* output.
***/
@Override
@@ -160,7 +160,7 @@ public final class DotTerminatedMessageW
* @param string The String to write.
* @param offset The offset into the String at which to start copying data.
* @param length The number of characters to write.
- * @exception IOException If an error occurs while writing to the underlying
+ * @throws IOException If an error occurs while writing to the underlying
* output.
***/
@Override
@@ -173,7 +173,7 @@ public final class DotTerminatedMessageW
/***
* Flushes the underlying output, writing all buffered output.
*
- * @exception IOException If an error occurs while writing to the underlying
+ * @throws IOException If an error occurs while writing to the underlying
* output.
***/
@Override
@@ -191,7 +191,7 @@ public final class DotTerminatedMessageW
* actually close the underlying stream. The underlying stream may still
* be used for communicating with the server and therefore is not closed.
*
- * @exception IOException If an error occurs while writing to the underlying
+ * @throws IOException If an error occurs while writing to the underlying
* output or closing the Writer.
***/
@Override
Modified: commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/FromNetASCIIInputStream.java
URL: http://svn.apache.org/viewvc/commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/FromNetASCIIInputStream.java?rev=1747119&r1=1747118&r2=1747119&view=diff
==============================================================================
--- commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/FromNetASCIIInputStream.java (original)
+++ commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/FromNetASCIIInputStream.java Tue Jun 7 02:22:24 2016
@@ -114,7 +114,7 @@ public final class FromNetASCIIInputStre
*
* @return The next character in the stream. Returns -1 if the end of the
* stream has been reached.
- * @exception IOException If an error occurs while reading the underlying
+ * @throws IOException If an error occurs while reading the underlying
* stream.
***/
@Override
@@ -136,7 +136,7 @@ public final class FromNetASCIIInputStre
* @param buffer The byte array in which to store the data.
* @return The number of bytes read. Returns -1 if the
* end of the message has been reached.
- * @exception IOException If an error occurs in reading the underlying
+ * @throws IOException If an error occurs in reading the underlying
* stream.
***/
@Override
@@ -157,7 +157,7 @@ public final class FromNetASCIIInputStre
* @param length The number of bytes to read.
* @return The number of bytes read. Returns -1 if the
* end of the stream has been reached.
- * @exception IOException If an error occurs while reading the underlying
+ * @throws IOException If an error occurs while reading the underlying
* stream.
***/
@Override
Modified: commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/FromNetASCIIOutputStream.java
URL: http://svn.apache.org/viewvc/commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/FromNetASCIIOutputStream.java?rev=1747119&r1=1747118&r2=1747119&view=diff
==============================================================================
--- commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/FromNetASCIIOutputStream.java (original)
+++ commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/FromNetASCIIOutputStream.java Tue Jun 7 02:22:24 2016
@@ -92,7 +92,7 @@ public final class FromNetASCIIOutputStr
* completeness.
*
* @param ch The byte to write.
- * @exception IOException If an error occurs while writing to the underlying
+ * @throws IOException If an error occurs while writing to the underlying
* stream.
***/
@Override
@@ -113,7 +113,7 @@ public final class FromNetASCIIOutputStr
* Writes a byte array to the stream.
*
* @param buffer The byte array to write.
- * @exception IOException If an error occurs while writing to the underlying
+ * @throws IOException If an error occurs while writing to the underlying
* stream.
***/
@Override
@@ -131,7 +131,7 @@ public final class FromNetASCIIOutputStr
* @param buffer The byte array to write.
* @param offset The offset into the array at which to start copying data.
* @param length The number of bytes to write.
- * @exception IOException If an error occurs while writing to the underlying
+ * @throws IOException If an error occurs while writing to the underlying
* stream.
***/
@Override
@@ -155,7 +155,7 @@ public final class FromNetASCIIOutputStr
/***
* Closes the stream, writing all pending data.
*
- * @exception IOException If an error occurs while closing the stream.
+ * @throws IOException If an error occurs while closing the stream.
***/
@Override
public synchronized void close()
Modified: commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/SocketInputStream.java
URL: http://svn.apache.org/viewvc/commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/SocketInputStream.java?rev=1747119&r1=1747118&r2=1747119&view=diff
==============================================================================
--- commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/SocketInputStream.java (original)
+++ commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/SocketInputStream.java Tue Jun 7 02:22:24 2016
@@ -56,7 +56,7 @@ public class SocketInputStream extends F
* Closes the stream and immediately afterward closes the referenced
* socket.
*
- * @exception IOException If there is an error in closing the stream
+ * @throws IOException If there is an error in closing the stream
* or socket.
***/
@Override
Modified: commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/SocketOutputStream.java
URL: http://svn.apache.org/viewvc/commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/SocketOutputStream.java?rev=1747119&r1=1747118&r2=1747119&view=diff
==============================================================================
--- commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/SocketOutputStream.java (original)
+++ commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/SocketOutputStream.java Tue Jun 7 02:22:24 2016
@@ -62,7 +62,7 @@ public class SocketOutputStream extends
* @param buffer The byte array to write.
* @param offset The offset into the array at which to start copying data.
* @param length The number of bytes to write.
- * @exception IOException If an error occurs while writing to the underlying
+ * @throws IOException If an error occurs while writing to the underlying
* stream.
***/
@Override
@@ -76,7 +76,7 @@ public class SocketOutputStream extends
* Closes the stream and immediately afterward closes the referenced
* socket.
*
- * @exception IOException If there is an error in closing the stream
+ * @throws IOException If there is an error in closing the stream
* or socket.
***/
@Override
Modified: commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/ToNetASCIIInputStream.java
URL: http://svn.apache.org/viewvc/commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/ToNetASCIIInputStream.java?rev=1747119&r1=1747118&r2=1747119&view=diff
==============================================================================
--- commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/ToNetASCIIInputStream.java (original)
+++ commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/ToNetASCIIInputStream.java Tue Jun 7 02:22:24 2016
@@ -58,7 +58,7 @@ public final class ToNetASCIIInputStream
*
* @return The next character in the stream. Returns -1 if the end of the
* stream has been reached.
- * @exception IOException If an error occurs while reading the underlying
+ * @throws IOException If an error occurs while reading the underlying
* stream.
***/
@Override
@@ -103,7 +103,7 @@ public final class ToNetASCIIInputStream
* @param buffer The byte array in which to store the data.
* @return The number of bytes read. Returns -1 if the
* end of the message has been reached.
- * @exception IOException If an error occurs in reading the underlying
+ * @throws IOException If an error occurs in reading the underlying
* stream.
***/
@Override
@@ -124,7 +124,7 @@ public final class ToNetASCIIInputStream
* @param length The number of bytes to read.
* @return The number of bytes read. Returns -1 if the
* end of the stream has been reached.
- * @exception IOException If an error occurs while reading the underlying
+ * @throws IOException If an error occurs while reading the underlying
* stream.
***/
@Override
Modified: commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/ToNetASCIIOutputStream.java
URL: http://svn.apache.org/viewvc/commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/ToNetASCIIOutputStream.java?rev=1747119&r1=1747118&r2=1747119&view=diff
==============================================================================
--- commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/ToNetASCIIOutputStream.java (original)
+++ commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/ToNetASCIIOutputStream.java Tue Jun 7 02:22:24 2016
@@ -57,7 +57,7 @@ public final class ToNetASCIIOutputStrea
* completeness.
*
* @param ch The byte to write.
- * @exception IOException If an error occurs while writing to the underlying
+ * @throws IOException If an error occurs while writing to the underlying
* stream.
***/
@Override
@@ -87,7 +87,7 @@ public final class ToNetASCIIOutputStrea
* Writes a byte array to the stream.
*
* @param buffer The byte array to write.
- * @exception IOException If an error occurs while writing to the underlying
+ * @throws IOException If an error occurs while writing to the underlying
* stream.
***/
@Override
@@ -105,7 +105,7 @@ public final class ToNetASCIIOutputStrea
* @param buffer The byte array to write.
* @param offset The offset into the array at which to start copying data.
* @param length The number of bytes to write.
- * @exception IOException If an error occurs while writing to the underlying
+ * @throws IOException If an error occurs while writing to the underlying
* stream.
***/
@Override
Modified: commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/Util.java
URL: http://svn.apache.org/viewvc/commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/Util.java?rev=1747119&r1=1747118&r2=1747119&view=diff
==============================================================================
--- commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/Util.java (original)
+++ commons/proper/net/trunk/src/main/java/org/apache/commons/net/io/Util.java Tue Jun 7 02:22:24 2016
@@ -78,7 +78,7 @@ public final class Util
* buffered streams. If you don't flush, the data will stay in
* the stream buffer.
* @return number of bytes read/written
- * @exception CopyStreamException If an error occurs while reading from the
+ * @throws CopyStreamException If an error occurs while reading from the
* source or writing to the destination. The CopyStreamException
* will contain the number of bytes confirmed to have been
* transferred before an
@@ -166,7 +166,7 @@ public final class Util
* @param listener The CopyStreamListener to notify of progress. If
* this parameter is null, notification is not attempted.
* @return number of bytes read/written
- * @exception CopyStreamException If an error occurs while reading from the
+ * @throws CopyStreamException If an error occurs while reading from the
* source or writing to the destination. The CopyStreamException
* will contain the number of bytes confirmed to have been
* transferred before an
@@ -198,7 +198,7 @@ public final class Util
* @param bufferSize The number of bytes to buffer during the copy.
* A zero or negative value means to use {@link #DEFAULT_COPY_BUFFER_SIZE}.
* @return The number of bytes read/written in the copy operation.
- * @exception CopyStreamException If an error occurs while reading from the
+ * @throws CopyStreamException If an error occurs while reading from the
* source or writing to the destination. The CopyStreamException
* will contain the number of bytes confirmed to have been
* transferred before an
@@ -254,7 +254,7 @@ public final class Util
* @param listener The CopyStreamListener to notify of progress. If
* this parameter is null, notification is not attempted.
* @return The number of characters read/written in the copy operation.
- * @exception CopyStreamException If an error occurs while reading from the
+ * @throws CopyStreamException If an error occurs while reading from the
* source or writing to the destination. The CopyStreamException
* will contain the number of bytes confirmed to have been
* transferred before an
@@ -323,7 +323,7 @@ public final class Util
* @param bufferSize The number of characters to buffer during the copy.
* A zero or negative value means to use {@link #DEFAULT_COPY_BUFFER_SIZE}.
* @return The number of characters read/written in the copy operation.
- * @exception CopyStreamException If an error occurs while reading from the
+ * @throws CopyStreamException If an error occurs while reading from the
* source or writing to the destination. The CopyStreamException
* will contain the number of bytes confirmed to have been
* transferred before an
Modified: commons/proper/net/trunk/src/main/java/org/apache/commons/net/nntp/NNTP.java
URL: http://svn.apache.org/viewvc/commons/proper/net/trunk/src/main/java/org/apache/commons/net/nntp/NNTP.java?rev=1747119&r1=1747118&r2=1747119&view=diff
==============================================================================
--- commons/proper/net/trunk/src/main/java/org/apache/commons/net/nntp/NNTP.java (original)
+++ commons/proper/net/trunk/src/main/java/org/apache/commons/net/nntp/NNTP.java Tue Jun 7 02:22:24 2016
@@ -187,7 +187,7 @@ public class NNTP extends SocketClient
* garbage collector. The reply text and code information from the
* last command is voided so that the memory it used may be reclaimed.
* <p>
- * @exception IOException If an error occurs while disconnecting.
+ * @throws IOException If an error occurs while disconnecting.
***/
@Override
public void disconnect() throws IOException
@@ -224,12 +224,12 @@ public class NNTP extends SocketClient
* set to null, then the command is sent with no argument.
* @return The integer value of the NNTP reply code returned by the server
* in response to the command.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int sendCommand(String command, String args) throws IOException
@@ -268,12 +268,12 @@ public class NNTP extends SocketClient
* @return The integer value of the NNTP reply code returned by the server
* in response to the command.
* in response to the command.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int sendCommand(int command, String args) throws IOException
@@ -292,12 +292,12 @@ public class NNTP extends SocketClient
* @return The integer value of the NNTP reply code returned by the server
* in response to the command.
* in response to the command.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int sendCommand(String command) throws IOException
@@ -317,12 +317,12 @@ public class NNTP extends SocketClient
* @return The integer value of the NNTP reply code returned by the server
* in response to the command.
* in response to the command.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int sendCommand(int command) throws IOException
@@ -353,12 +353,12 @@ public class NNTP extends SocketClient
* <p>
* @return The integer value of the reply code of the fetched NNTP reply.
* in response to the command.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while
+ * @throws IOException If an I/O error occurs while
* receiving the server reply.
***/
public int getReply() throws IOException
@@ -387,12 +387,12 @@ public class NNTP extends SocketClient
* @param messageId The message identifier of the requested article,
* including the encapsulating < and > characters.
* @return The reply code received from the server.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int article(String messageId) throws IOException
@@ -407,12 +407,12 @@ public class NNTP extends SocketClient
* @param articleNumber The number of the article to request from the
* currently selected newsgroup.
* @return The reply code received from the server.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int article(long articleNumber) throws IOException
@@ -425,12 +425,12 @@ public class NNTP extends SocketClient
* receive the initial reply, and return the reply code.
* <p>
* @return The reply code received from the server.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int article() throws IOException
@@ -447,12 +447,12 @@ public class NNTP extends SocketClient
* @param messageId The message identifier of the requested article,
* including the encapsulating < and > characters.
* @return The reply code received from the server.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int body(String messageId) throws IOException
@@ -467,12 +467,12 @@ public class NNTP extends SocketClient
* @param articleNumber The number of the article to request from the
* currently selected newsgroup.
* @return The reply code received from the server.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int body(long articleNumber) throws IOException
@@ -485,12 +485,12 @@ public class NNTP extends SocketClient
* receive the initial reply, and return the reply code.
* <p>
* @return The reply code received from the server.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int body() throws IOException
@@ -507,12 +507,12 @@ public class NNTP extends SocketClient
* @param messageId The message identifier of the requested article,
* including the encapsulating < and > characters.
* @return The reply code received from the server.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int head(String messageId) throws IOException
@@ -527,12 +527,12 @@ public class NNTP extends SocketClient
* @param articleNumber The number of the article to request from the
* currently selected newsgroup.
* @return The reply code received from the server.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int head(long articleNumber) throws IOException
@@ -545,12 +545,12 @@ public class NNTP extends SocketClient
* receive the initial reply, and return the reply code.
* <p>
* @return The reply code received from the server.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int head() throws IOException
@@ -567,12 +567,12 @@ public class NNTP extends SocketClient
* @param messageId The message identifier of the requested article,
* including the encapsulating < and > characters.
* @return The reply code received from the server.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int stat(String messageId) throws IOException
@@ -587,12 +587,12 @@ public class NNTP extends SocketClient
* @param articleNumber The number of the article to request from the
* currently selected newsgroup.
* @return The reply code received from the server.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int stat(long articleNumber) throws IOException
@@ -605,12 +605,12 @@ public class NNTP extends SocketClient
* receive the initial reply, and return the reply code.
* <p>
* @return The reply code received from the server.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int stat() throws IOException
@@ -625,12 +625,12 @@ public class NNTP extends SocketClient
* <p>
* @param newsgroup The name of the newsgroup to select.
* @return The reply code received from the server.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int group(String newsgroup) throws IOException
@@ -644,12 +644,12 @@ public class NNTP extends SocketClient
* receive the reply, and return the reply code.
* <p>
* @return The reply code received from the server.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int help() throws IOException
@@ -665,12 +665,12 @@ public class NNTP extends SocketClient
* @param messageId The article identifier,
* including the encapsulating < and > characters.
* @return The reply code received from the server.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int ihave(String messageId) throws IOException
@@ -684,12 +684,12 @@ public class NNTP extends SocketClient
* receive the reply, and return the reply code.
* <p>
* @return The reply code received from the server.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int last() throws IOException
@@ -704,12 +704,12 @@ public class NNTP extends SocketClient
* receive the reply, and return the reply code.
* <p>
* @return The reply code received from the server.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int list() throws IOException
@@ -724,12 +724,12 @@ public class NNTP extends SocketClient
* receive the reply, and return the reply code.
* <p>
* @return The reply code received from the server.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int next() throws IOException
@@ -750,12 +750,12 @@ public class NNTP extends SocketClient
* @param distributions Comma-separated distribution list to check for
* new groups. Set to null if no distributions.
* @return The reply code received from the server.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int newgroups(String date, String time, boolean GMT,
@@ -798,12 +798,12 @@ public class NNTP extends SocketClient
* @param distributions Comma-separated distribution list to check for
* new news. Set to null if no distributions.
* @return The reply code received from the server.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int newnews(String newsgroups, String date, String time, boolean GMT,
@@ -840,12 +840,12 @@ public class NNTP extends SocketClient
* receive the reply, and return the reply code.
* <p>
* @return The reply code received from the server.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int post() throws IOException
@@ -860,12 +860,12 @@ public class NNTP extends SocketClient
* receive the reply, and return the reply code.
* <p>
* @return The reply code received from the server.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int quit() throws IOException
@@ -880,12 +880,12 @@ public class NNTP extends SocketClient
* @param username A valid username.
* @return The reply code received from the server. The server should
* return a 381 or 281 for this command.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int authinfoUser(String username) throws IOException {
@@ -902,12 +902,12 @@ public class NNTP extends SocketClient
* @param password a valid password.
* @return The reply code received from the server. The server should
* return a 281 or 502 for this command.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int authinfoPass(String password) throws IOException {
@@ -927,12 +927,12 @@ public class NNTP extends SocketClient
* following articles" In this revision, the last format is not
* possible (yet).
* @return The reply code received from the server.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int xover(String selectedArticles) throws IOException {
@@ -953,12 +953,12 @@ public class NNTP extends SocketClient
* following articles" In this revision, the last format is not
* possible (yet).
* @return The reply code received from the server.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending the
+ * @throws IOException If an I/O error occurs while either sending the
* command or receiving the server reply.
***/
public int xhdr(String header, String selectedArticles) throws IOException {
Modified: commons/proper/net/trunk/src/main/java/org/apache/commons/net/nntp/NNTPClient.java
URL: http://svn.apache.org/viewvc/commons/proper/net/trunk/src/main/java/org/apache/commons/net/nntp/NNTPClient.java?rev=1747119&r1=1747118&r2=1747119&view=diff
==============================================================================
--- commons/proper/net/trunk/src/main/java/org/apache/commons/net/nntp/NNTPClient.java (original)
+++ commons/proper/net/trunk/src/main/java/org/apache/commons/net/nntp/NNTPClient.java Tue Jun 7 02:22:24 2016
@@ -347,12 +347,12 @@ public class NNTPClient extends NNTP
* returned article information.
* @return A DotTerminatedMessageReader instance from which the article
* can be read. null if the article does not exist.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending a
+ * @throws IOException If an I/O error occurs while either sending a
* command to the server or receiving a reply from the server.
***/
public BufferedReader retrieveArticle(String articleId, ArticleInfo pointer)
@@ -418,12 +418,12 @@ public class NNTPClient extends NNTP
* returned article information.
* @return A DotTerminatedMessageReader instance from which the article
* can be read. null if the article does not exist.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending a
+ * @throws IOException If an I/O error occurs while either sending a
* command to the server or receiving a reply from the server.
***/
public BufferedReader retrieveArticle(long articleNumber, ArticleInfo pointer)
@@ -478,12 +478,12 @@ public class NNTPClient extends NNTP
* returned article information.
* @return A DotTerminatedMessageReader instance from which the article
* header can be read. null if the article does not exist.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending a
+ * @throws IOException If an I/O error occurs while either sending a
* command to the server or receiving a reply from the server.
***/
public BufferedReader retrieveArticleHeader(String articleId, ArticleInfo pointer)
@@ -547,12 +547,12 @@ public class NNTPClient extends NNTP
* returned article information.
* @return A DotTerminatedMessageReader instance from which the article
* header can be read. null if the article does not exist.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending a
+ * @throws IOException If an I/O error occurs while either sending a
* command to the server or receiving a reply from the server.
***/
public BufferedReader retrieveArticleHeader(long articleNumber,
@@ -609,12 +609,12 @@ public class NNTPClient extends NNTP
* returned article information.
* @return A DotTerminatedMessageReader instance from which the article
* body can be read. null if the article does not exist.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending a
+ * @throws IOException If an I/O error occurs while either sending a
* command to the server or receiving a reply from the server.
***/
public BufferedReader retrieveArticleBody(String articleId, ArticleInfo pointer)
@@ -680,12 +680,12 @@ public class NNTPClient extends NNTP
* returned article information.
* @return A DotTerminatedMessageReader instance from which the article
* body can be read. null if the article does not exist.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending a
+ * @throws IOException If an I/O error occurs while either sending a
* command to the server or receiving a reply from the server.
***/
public BufferedReader retrieveArticleBody(long articleNumber,
@@ -718,12 +718,12 @@ public class NNTPClient extends NNTP
* the selected newsgroup contained in the server reply is returned.
* Set this to null if you do not desire this information.
* @return True if the newsgroup exists and was selected, false otherwise.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending a
+ * @throws IOException If an I/O error occurs while either sending a
* command to the server or receiving a reply from the server.
***/
public boolean selectNewsgroup(String newsgroup, NewsgroupInfo info)
@@ -755,12 +755,12 @@ public class NNTPClient extends NNTP
* List the command help from the server.
* <p>
* @return The sever help information.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending a
+ * @throws IOException If an I/O error occurs while either sending a
* command to the server or receiving a reply from the server.
***/
public String listHelp() throws IOException
@@ -816,12 +816,12 @@ public class NNTPClient extends NNTP
* set this parameter to null if you do not desire to retrieve the
* returned article information.
* @return True if successful, false if not.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending a
+ * @throws IOException If an I/O error occurs while either sending a
* command to the server or receiving a reply from the server.
***/
public boolean selectArticle(String articleId, ArticleInfo pointer)
@@ -885,12 +885,12 @@ public class NNTPClient extends NNTP
* to this particular command. You may set this parameter to null if
* you do not desire to retrieve the returned article information.
* @return True if successful, false if not.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending a
+ * @throws IOException If an I/O error occurs while either sending a
* command to the server or receiving a reply from the server.
***/
public boolean selectArticle(long articleNumber, ArticleInfo pointer)
@@ -934,12 +934,12 @@ public class NNTPClient extends NNTP
* returned article information.
* @return True if successful, false if not (e.g., there is no previous
* article).
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending a
+ * @throws IOException If an I/O error occurs while either sending a
* command to the server or receiving a reply from the server.
***/
public boolean selectPreviousArticle(ArticleInfo pointer)
@@ -981,12 +981,12 @@ public class NNTPClient extends NNTP
* returned article information.
* @return True if successful, false if not (e.g., there is no following
* article).
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending a
+ * @throws IOException If an I/O error occurs while either sending a
* command to the server or receiving a reply from the server.
***/
public boolean selectNextArticle(ArticleInfo pointer) throws IOException
@@ -1022,12 +1022,12 @@ public class NNTPClient extends NNTP
* for each newsgroup served by the NNTP server. If no newsgroups
* are served, a zero length array will be returned. If the command
* fails, null will be returned.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending a
+ * @throws IOException If an I/O error occurs while either sending a
* command to the server or receiving a reply from the server.
* @see #iterateNewsgroupListing()
* @see #iterateNewsgroups()
@@ -1049,12 +1049,12 @@ public class NNTPClient extends NNTP
* @return An iterable of NewsgroupInfo instances containing the information
* for each newsgroup served by the NNTP server. If no newsgroups
* are served, no entries will be returned.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending a
+ * @throws IOException If an I/O error occurs while either sending a
* command to the server or receiving a reply from the server.
* @since 3.0
*/
@@ -1073,12 +1073,12 @@ public class NNTPClient extends NNTP
* @return An iterable of Strings containing the raw information
* for each newsgroup served by the NNTP server. If no newsgroups
* are served, no entries will be returned.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending a
+ * @throws IOException If an I/O error occurs while either sending a
* command to the server or receiving a reply from the server.
* @since 3.0
*/
@@ -1155,12 +1155,12 @@ public class NNTPClient extends NNTP
* for each new newsgroup added to the NNTP server. If no newsgroups
* were added, a zero length array will be returned. If the command
* fails, null will be returned.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending a
+ * @throws IOException If an I/O error occurs while either sending a
* command to the server or receiving a reply from the server.
* @see #iterateNewNewsgroups(NewGroupsOrNewsQuery)
* @see #iterateNewNewsgroupListing(NewGroupsOrNewsQuery)
@@ -1188,12 +1188,12 @@ public class NNTPClient extends NNTP
* @return An iterable of Strings containing the raw information
* for each new newsgroup added to the NNTP server. If no newsgroups
* were added, no entries will be returned.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending a
+ * @throws IOException If an I/O error occurs while either sending a
* command to the server or receiving a reply from the server.
* @since 3.0
*/
@@ -1216,12 +1216,12 @@ public class NNTPClient extends NNTP
* @return An iterable of NewsgroupInfo instances containing the information
* for each new newsgroup added to the NNTP server. If no newsgroups
* were added, no entries will be returned.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending a
+ * @throws IOException If an I/O error occurs while either sending a
* command to the server or receiving a reply from the server.
* @since 3.0
*/
@@ -1245,12 +1245,12 @@ public class NNTPClient extends NNTP
* identifiers for each new article added to the NNTP server. If no
* new news is found, a zero length array will be returned. If the
* command fails, null will be returned.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending a
+ * @throws IOException If an I/O error occurs while either sending a
* command to the server or receiving a reply from the server.
*
* @see #iterateNewNews(NewGroupsOrNewsQuery)
@@ -1301,12 +1301,12 @@ public class NNTPClient extends NNTP
* @return An iterator of String instances containing the unique message
* identifiers for each new article added to the NNTP server. If no
* new news is found, no strings will be returned.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending a
+ * @throws IOException If an I/O error occurs while either sending a
* command to the server or receiving a reply from the server.
* @since 3.0
*/
@@ -1343,12 +1343,12 @@ public class NNTPClient extends NNTP
* </pre>
* <p>
* @return True if successfully completed, false if not.
- * @exception NNTPConnectionClosedException
+ * @throws NNTPConnectionClosedException
* If the NNTP server prematurely closes the connection as a result
* of the client being idle or some other reason causing the server
* to send NNTP reply code 400. This exception may be caught either
* as an IOException or independently as itself.
- * @exception IOException If an I/O error occurs while either sending a
+ * @throws IOException If an I/O error occurs while either sending a
* command to the server or receiving a reply from the server.
***/
public boolean completePendingCommand() throws IOException
@@ -1390,7 +1390,7 @@ public class NNTPClient extends NNTP
* <p>
* @return A DotTerminatedMessageWriter to which the article (including
* header) can be written. Returns null if the command fails.
- * @exception IOException If an I/O error occurs while either sending a
+ * @throws IOException If an I/O error occurs while either sending a
* command to the server or receiving a reply from the server.
***/
@@ -1420,7 +1420,7 @@ public class NNTPClient extends NNTP
* a new connection.
* <p>
* @return True if successfully completed, false if not.
- * @exception IOException If an I/O error occurs while either sending a
+ * @throws IOException If an I/O error occurs while either sending a
* command to the server or receiving a reply from the server.
***/
public boolean logout() throws IOException
@@ -1466,7 +1466,7 @@ public class NNTPClient extends NNTP
* @param articleRange
* @return Returns a DotTerminatedMessageReader if successful, null
* otherwise
- * @exception IOException
+ * @throws IOException
*/
private BufferedReader __retrieveArticleInfo(String articleRange)
throws IOException
@@ -1539,7 +1539,7 @@ public class NNTPClient extends NNTP
* @param articleRange
* @return Returns a DotTerminatedMessageReader if successful, null
* otherwise
- * @exception IOException
+ * @throws IOException
*/
private BufferedReader __retrieveHeader(String header, String articleRange)
throws IOException
Modified: commons/proper/net/trunk/src/main/java/org/apache/commons/net/ntp/NTPUDPClient.java
URL: http://svn.apache.org/viewvc/commons/proper/net/trunk/src/main/java/org/apache/commons/net/ntp/NTPUDPClient.java?rev=1747119&r1=1747118&r2=1747119&view=diff
==============================================================================
--- commons/proper/net/trunk/src/main/java/org/apache/commons/net/ntp/NTPUDPClient.java (original)
+++ commons/proper/net/trunk/src/main/java/org/apache/commons/net/ntp/NTPUDPClient.java Tue Jun 7 02:22:24 2016
@@ -55,7 +55,7 @@ public final class NTPUDPClient extends
* @param host The address of the server.
* @param port The port of the service.
* @return The time value retrieved from the server.
- * @exception IOException If an error occurs while retrieving the time.
+ * @throws IOException If an error occurs while retrieving the time.
***/
public TimeInfo getTime(InetAddress host, int port) throws IOException
{
@@ -106,7 +106,7 @@ public final class NTPUDPClient extends
* <p>
* @param host The address of the server.
* @return The time value retrieved from the server.
- * @exception IOException If an error occurs while retrieving the time.
+ * @throws IOException If an error occurs while retrieving the time.
***/
public TimeInfo getTime(InetAddress host) throws IOException
{
Modified: commons/proper/net/trunk/src/main/java/org/apache/commons/net/pop3/ExtendedPOP3Client.java
URL: http://svn.apache.org/viewvc/commons/proper/net/trunk/src/main/java/org/apache/commons/net/pop3/ExtendedPOP3Client.java?rev=1747119&r1=1747118&r2=1747119&view=diff
==============================================================================
--- commons/proper/net/trunk/src/main/java/org/apache/commons/net/pop3/ExtendedPOP3Client.java (original)
+++ commons/proper/net/trunk/src/main/java/org/apache/commons/net/pop3/ExtendedPOP3Client.java Tue Jun 7 02:22:24 2016
@@ -53,13 +53,13 @@ public class ExtendedPOP3Client extends
* @param username the user name
* @param password the password
* @return True if successfully completed, false if not.
- * @exception IOException If an I/O error occurs while either sending a
+ * @throws IOException If an I/O error occurs while either sending a
* command to the server or receiving a reply from the server.
- * @exception NoSuchAlgorithmException If the CRAM hash algorithm
+ * @throws NoSuchAlgorithmException If the CRAM hash algorithm
* cannot be instantiated by the Java runtime system.
- * @exception InvalidKeyException If the CRAM hash algorithm
+ * @throws InvalidKeyException If the CRAM hash algorithm
* failed to use the given password.
- * @exception InvalidKeySpecException If the CRAM hash algorithm
+ * @throws InvalidKeySpecException If the CRAM hash algorithm
* failed to use the given password.
***/
public boolean auth(AUTH_METHOD method,
Modified: commons/proper/net/trunk/src/main/java/org/apache/commons/net/pop3/POP3.java
URL: http://svn.apache.org/viewvc/commons/proper/net/trunk/src/main/java/org/apache/commons/net/pop3/POP3.java?rev=1747119&r1=1747118&r2=1747119&view=diff
==============================================================================
--- commons/proper/net/trunk/src/main/java/org/apache/commons/net/pop3/POP3.java (original)
+++ commons/proper/net/trunk/src/main/java/org/apache/commons/net/pop3/POP3.java Tue Jun 7 02:22:24 2016
@@ -202,7 +202,7 @@ public class POP3 extends SocketClient
* from the last issued command is voided to allow garbage collection
* of the memory used to store that information.
*
- * @exception IOException If there is an error in disconnecting.
+ * @throws IOException If there is an error in disconnecting.
***/
@Override
public void disconnect() throws IOException