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 00:40:18 UTC
svn commit: r1747099 - in
/commons/proper/collections/branches/COLLECTIONS_3_2_X/src:
java/org/apache/commons/collections/
java/org/apache/commons/collections/comparators/
java/org/apache/commons/collections/iterators/
test/org/apache/commons/collections/
Author: ggregory
Date: Tue Jun 7 00:40:18 2016
New Revision: 1747099
URL: http://svn.apache.org/viewvc?rev=1747099&view=rev
Log:
Update old school @exception with new school @throws.
Modified:
commons/proper/collections/branches/COLLECTIONS_3_2_X/src/java/org/apache/commons/collections/CursorableLinkedList.java
commons/proper/collections/branches/COLLECTIONS_3_2_X/src/java/org/apache/commons/collections/FastArrayList.java
commons/proper/collections/branches/COLLECTIONS_3_2_X/src/java/org/apache/commons/collections/comparators/ComparatorChain.java
commons/proper/collections/branches/COLLECTIONS_3_2_X/src/java/org/apache/commons/collections/comparators/NullComparator.java
commons/proper/collections/branches/COLLECTIONS_3_2_X/src/java/org/apache/commons/collections/iterators/EnumerationIterator.java
commons/proper/collections/branches/COLLECTIONS_3_2_X/src/test/org/apache/commons/collections/AbstractTestObject.java
Modified: commons/proper/collections/branches/COLLECTIONS_3_2_X/src/java/org/apache/commons/collections/CursorableLinkedList.java
URL: http://svn.apache.org/viewvc/commons/proper/collections/branches/COLLECTIONS_3_2_X/src/java/org/apache/commons/collections/CursorableLinkedList.java?rev=1747099&r1=1747098&r2=1747099&view=diff
==============================================================================
--- commons/proper/collections/branches/COLLECTIONS_3_2_X/src/java/org/apache/commons/collections/CursorableLinkedList.java (original)
+++ commons/proper/collections/branches/COLLECTIONS_3_2_X/src/java/org/apache/commons/collections/CursorableLinkedList.java Tue Jun 7 00:40:18 2016
@@ -664,7 +664,7 @@ public class CursorableLinkedList implem
* be stored, if it is big enough; otherwise, a new array of the
* same runtime type is allocated for this purpose.
* @return an array containing the elements of this list.
- * @exception ArrayStoreException
+ * @throws ArrayStoreException
* if the runtime type of the specified array
* is not a supertype of the runtime type of every element in
* this list.
Modified: commons/proper/collections/branches/COLLECTIONS_3_2_X/src/java/org/apache/commons/collections/FastArrayList.java
URL: http://svn.apache.org/viewvc/commons/proper/collections/branches/COLLECTIONS_3_2_X/src/java/org/apache/commons/collections/FastArrayList.java?rev=1747099&r1=1747098&r2=1747099&view=diff
==============================================================================
--- commons/proper/collections/branches/COLLECTIONS_3_2_X/src/java/org/apache/commons/collections/FastArrayList.java (original)
+++ commons/proper/collections/branches/COLLECTIONS_3_2_X/src/java/org/apache/commons/collections/FastArrayList.java Tue Jun 7 00:40:18 2016
@@ -178,7 +178,7 @@ public class FastArrayList extends Array
* @param index Index at which to insert this element
* @param element The element to be inserted
*
- * @exception IndexOutOfBoundsException if the index is out of range
+ * @throws IndexOutOfBoundsException if the index is out of range
*/
public void add(int index, Object element) {
@@ -230,7 +230,7 @@ public class FastArrayList extends Array
* @param index Index at which insertion takes place
* @param collection The collection to be added
*
- * @exception IndexOutOfBoundsException if the index is out of range
+ * @throws IndexOutOfBoundsException if the index is out of range
*/
public boolean addAll(int index, Collection collection) {
@@ -254,7 +254,7 @@ public class FastArrayList extends Array
* Remove all of the elements from this list. The list will be empty
* after this call returns.
*
- * @exception UnsupportedOperationException if <code>clear()</code>
+ * @throws UnsupportedOperationException if <code>clear()</code>
* is not supported by this list
*/
public void clear() {
@@ -405,7 +405,7 @@ public class FastArrayList extends Array
*
* @param index The index of the element to return
*
- * @exception IndexOutOfBoundsException if the index is out of range
+ * @throws IndexOutOfBoundsException if the index is out of range
*/
public Object get(int index) {
@@ -576,7 +576,7 @@ public class FastArrayList extends Array
*
* @param index The starting position of the iterator to return
* @return the list iterator
- * @exception IndexOutOfBoundsException if the index is out of range
+ * @throws IndexOutOfBoundsException if the index is out of range
*/
public ListIterator listIterator(int index) {
if (fast) {
@@ -593,7 +593,7 @@ public class FastArrayList extends Array
*
* @param index Index of the element to be removed
*
- * @exception IndexOutOfBoundsException if the index is out of range
+ * @throws IndexOutOfBoundsException if the index is out of range
*/
public Object remove(int index) {
@@ -643,7 +643,7 @@ public class FastArrayList extends Array
*
* @param collection Collection containing elements to be removed
*
- * @exception UnsupportedOperationException if this optional operation
+ * @throws UnsupportedOperationException if this optional operation
* is not supported by this list
*/
public boolean removeAll(Collection collection) {
@@ -670,7 +670,7 @@ public class FastArrayList extends Array
*
* @param collection Collection containing elements to be retained
*
- * @exception UnsupportedOperationException if this optional operation
+ * @throws UnsupportedOperationException if this optional operation
* is not supported by this list
*/
public boolean retainAll(Collection collection) {
@@ -702,7 +702,7 @@ public class FastArrayList extends Array
* @param index Index of the element to replace
* @param element The new element to be stored
*
- * @exception IndexOutOfBoundsException if the index is out of range
+ * @throws IndexOutOfBoundsException if the index is out of range
*/
public Object set(int index, Object element) {
@@ -743,7 +743,7 @@ public class FastArrayList extends Array
* @param fromIndex The starting index of the sublist view
* @param toIndex The index after the end of the sublist view
*
- * @exception IndexOutOfBoundsException if an index is out of range
+ * @throws IndexOutOfBoundsException if an index is out of range
*/
public List subList(int fromIndex, int toIndex) {
if (fast) {
@@ -780,7 +780,7 @@ public class FastArrayList extends Array
*
* @param array Array defining the element type of the returned list
*
- * @exception ArrayStoreException if the runtime type of <code>array</code>
+ * @throws ArrayStoreException if the runtime type of <code>array</code>
* is not a supertype of the runtime type of every element in this list
*/
public Object[] toArray(Object array[]) {
Modified: commons/proper/collections/branches/COLLECTIONS_3_2_X/src/java/org/apache/commons/collections/comparators/ComparatorChain.java
URL: http://svn.apache.org/viewvc/commons/proper/collections/branches/COLLECTIONS_3_2_X/src/java/org/apache/commons/collections/comparators/ComparatorChain.java?rev=1747099&r1=1747098&r2=1747099&view=diff
==============================================================================
--- commons/proper/collections/branches/COLLECTIONS_3_2_X/src/java/org/apache/commons/collections/comparators/ComparatorChain.java (original)
+++ commons/proper/collections/branches/COLLECTIONS_3_2_X/src/java/org/apache/commons/collections/comparators/ComparatorChain.java Tue Jun 7 00:40:18 2016
@@ -168,7 +168,7 @@ public class ComparatorChain implements
*
* @param index index of the Comparator to replace
* @param comparator Comparator to place at the given index
- * @exception IndexOutOfBoundsException
+ * @throws IndexOutOfBoundsException
* if index < 0 or index >= size()
*/
public void setComparator(int index, Comparator comparator)
@@ -260,7 +260,7 @@ public class ComparatorChain implements
* @param o1 the first object to compare
* @param o2 the second object to compare
* @return -1, 0, or 1
- * @exception UnsupportedOperationException
+ * @throws UnsupportedOperationException
* if the ComparatorChain does not contain at least one
* Comparator
*/
Modified: commons/proper/collections/branches/COLLECTIONS_3_2_X/src/java/org/apache/commons/collections/comparators/NullComparator.java
URL: http://svn.apache.org/viewvc/commons/proper/collections/branches/COLLECTIONS_3_2_X/src/java/org/apache/commons/collections/comparators/NullComparator.java?rev=1747099&r1=1747098&r2=1747099&view=diff
==============================================================================
--- commons/proper/collections/branches/COLLECTIONS_3_2_X/src/java/org/apache/commons/collections/comparators/NullComparator.java (original)
+++ commons/proper/collections/branches/COLLECTIONS_3_2_X/src/java/org/apache/commons/collections/comparators/NullComparator.java Tue Jun 7 00:40:18 2016
@@ -65,7 +65,7 @@ public class NullComparator implements C
* non-<code>null</code> objects. This argument cannot be
* <code>null</code>
*
- * @exception NullPointerException if <code>nonNullComparator</code> is
+ * @throws NullPointerException if <code>nonNullComparator</code> is
* <code>null</code>
**/
public NullComparator(Comparator nonNullComparator) {
@@ -104,7 +104,7 @@ public class NullComparator implements C
* that <code>null</code> should be compared as lower than a
* non-<code>null</code> object.
*
- * @exception NullPointerException if <code>nonNullComparator</code> is
+ * @throws NullPointerException if <code>nonNullComparator</code> is
* <code>null</code>
**/
public NullComparator(Comparator nonNullComparator, boolean nullsAreHigh) {
Modified: commons/proper/collections/branches/COLLECTIONS_3_2_X/src/java/org/apache/commons/collections/iterators/EnumerationIterator.java
URL: http://svn.apache.org/viewvc/commons/proper/collections/branches/COLLECTIONS_3_2_X/src/java/org/apache/commons/collections/iterators/EnumerationIterator.java?rev=1747099&r1=1747098&r2=1747099&view=diff
==============================================================================
--- commons/proper/collections/branches/COLLECTIONS_3_2_X/src/java/org/apache/commons/collections/iterators/EnumerationIterator.java (original)
+++ commons/proper/collections/branches/COLLECTIONS_3_2_X/src/java/org/apache/commons/collections/iterators/EnumerationIterator.java Tue Jun 7 00:40:18 2016
@@ -103,8 +103,8 @@ public class EnumerationIterator impleme
* If so, the first occurrence of the last returned object from this
* iterator will be removed from the collection.
*
- * @exception IllegalStateException <code>next()</code> not called.
- * @exception UnsupportedOperationException if no associated collection
+ * @throws IllegalStateException <code>next()</code> not called.
+ * @throws UnsupportedOperationException if no associated collection
*/
public void remove() {
if (collection != null) {
Modified: commons/proper/collections/branches/COLLECTIONS_3_2_X/src/test/org/apache/commons/collections/AbstractTestObject.java
URL: http://svn.apache.org/viewvc/commons/proper/collections/branches/COLLECTIONS_3_2_X/src/test/org/apache/commons/collections/AbstractTestObject.java?rev=1747099&r1=1747098&r2=1747099&view=diff
==============================================================================
--- commons/proper/collections/branches/COLLECTIONS_3_2_X/src/test/org/apache/commons/collections/AbstractTestObject.java (original)
+++ commons/proper/collections/branches/COLLECTIONS_3_2_X/src/test/org/apache/commons/collections/AbstractTestObject.java Tue Jun 7 00:40:18 2016
@@ -259,7 +259,7 @@ public abstract class AbstractTestObject
*
* @param o Object to serialize
* @param path path to write the serialized Object
- * @exception IOException
+ * @throws IOException
*/
protected void writeExternalFormToDisk(Serializable o, String path) throws IOException {
FileOutputStream fileStream = new FileOutputStream(path);
@@ -272,7 +272,7 @@ public abstract class AbstractTestObject
*
* @param o Object to convert to bytes
* @return serialized form of the Object
- * @exception IOException
+ * @throws IOException
*/
protected byte[] writeExternalFormToBytes(Serializable o) throws IOException {
ByteArrayOutputStream byteStream = new ByteArrayOutputStream();
@@ -287,8 +287,8 @@ public abstract class AbstractTestObject
*
* @param path path to the serialized Object
* @return the Object at the given path
- * @exception IOException
- * @exception ClassNotFoundException
+ * @throws IOException
+ * @throws ClassNotFoundException
*/
protected Object readExternalFormFromDisk(String path) throws IOException, ClassNotFoundException {
FileInputStream stream = new FileInputStream(path);
@@ -301,8 +301,8 @@ public abstract class AbstractTestObject
*
* @param b byte array containing a serialized Object
* @return Object contained in the bytes
- * @exception IOException
- * @exception ClassNotFoundException
+ * @throws IOException
+ * @throws ClassNotFoundException
*/
protected Object readExternalFormFromBytes(byte[] b) throws IOException, ClassNotFoundException {
ByteArrayInputStream stream = new ByteArrayInputStream(b);