JavaDoc only @return org.hamcrest.collection

Author: nhojpatrick

hamcrest/src/main/java/org/hamcrest/collection/ArrayMatching.java

@@ -26,6 +26,7 @@ public class ArrayMatching {
    *
    * @param elementMatcher
    *     the matcher to apply to elements in examined arrays
+   * @return The matcher.
    */
   public static <T> Matcher<T[]> hasItemInArray(Matcher<? super T> elementMatcher) {
       return new HasItemInArray<>(elementMatcher);
@@ -40,6 +41,7 @@ public static <T> Matcher<T[]> hasItemInArray(Matcher<? super T> elementMatcher)
    *
    * @param element
    *     the element that should be present in examined arrays
+   * @return The matcher.
    */
   public static <T> Matcher<T[]> hasItemInArray(T element) {
     return hasItemInArray(equalTo(element));
@@ -64,6 +66,7 @@ public static <T> Matcher<T[]> hasItemInArray(T element) {
    *
    * @param itemMatchers
    *     a list of matchers, each of which must be satisfied by an entry in an examined array
+   * @return The matcher.
    */
   @SafeVarargs
   public static <E> Matcher<E[]> arrayContainingInAnyOrder(Matcher<? super E>... itemMatchers) {
@@ -89,6 +92,7 @@ public static <E> Matcher<E[]> arrayContainingInAnyOrder(Matcher<? super E>... i
    *
    * @param itemMatchers
    *     a list of matchers, each of which must be satisfied by an item provided by an examined array
+   * @return The matcher.
    */
   public static <E> Matcher<E[]> arrayContainingInAnyOrder(Collection<Matcher<? super E>> itemMatchers) {
     return new ArrayAsIterableMatcher<>(new IsIterableContainingInAnyOrder<>(itemMatchers), itemMatchers, "in any order");
@@ -111,6 +115,7 @@ public static <E> Matcher<E[]> arrayContainingInAnyOrder(Collection<Matcher<? su
    *
    * @param items
    *     the items that must equal the entries of an examined array, in any order
+   * @return The matcher.
    */
   @SafeVarargs
   public static <E> Matcher<E[]> arrayContainingInAnyOrder(E... items) {
@@ -126,6 +131,7 @@ public static <E> Matcher<E[]> arrayContainingInAnyOrder(E... items) {
    *
    * @param items
    *     the items that must equal the items within an examined array
+   * @return The matcher.
    */
   @SafeVarargs
   public static <E> Matcher<E[]> arrayContaining(E... items) {
@@ -140,6 +146,7 @@ public static <E> Matcher<E[]> arrayContaining(E... items) {
    *
    * @param itemMatchers
    *     the matchers that must be satisfied by the items in the examined array
+   * @return The matcher.
    */
   @SafeVarargs
   public static <E> Matcher<E[]> arrayContaining(Matcher<? super E>... itemMatchers) {
@@ -159,6 +166,7 @@ public static <E> Matcher<E[]> arrayContaining(Matcher<? super E>... itemMatcher
    *
    * @param itemMatchers
    *     a list of matchers, each of which must be satisfied by the corresponding item in an examined array
+   * @return The matcher.
    */
   public static <E> Matcher<E[]> arrayContaining(List<Matcher<? super E>> itemMatchers) {
       return new ArrayAsIterableMatcher<>(new IsIterableContainingInOrder<>(itemMatchers), itemMatchers, "");

hamcrest/src/main/java/org/hamcrest/collection/IsArray.java

@@ -55,6 +55,8 @@ public void describeTo(Description description) {
      *
      * Can be overridden in subclasses to customise how the matcher is
      * described.
+     *
+     * @return The description prefix.
      */
     protected String descriptionStart() {
         return "[";
@@ -65,6 +67,8 @@ protected String descriptionStart() {
      *
      * Can be overridden in subclasses to customise how the matcher is
      * described.
+     *
+     * @return The description separator.
      */
     protected String descriptionSeparator() {
         return ", ";
@@ -75,6 +79,8 @@ protected String descriptionSeparator() {
      *
      * Can be overridden in subclasses to customise how the matcher is
      * described.
+     *
+     * @return The description suffix.
      */
     protected String descriptionEnd() {
         return "]";
@@ -89,6 +95,7 @@ protected String descriptionEnd() {
      *
      * @param elementMatchers
      *     the matchers that the elements of examined arrays should satisfy
+     * @return The matcher.
      */
     public static <T> IsArray<T> array(Matcher<? super T>... elementMatchers) {
         return new IsArray<T>(elementMatchers);

hamcrest/src/main/java/org/hamcrest/collection/IsArrayContainingInAnyOrder.java

@@ -57,6 +57,7 @@ public void describeTo(Description description) {
      *
      * @param itemMatchers
      *     a list of matchers, each of which must be satisfied by an entry in an examined array
+     * @return The matcher.
      */
     public static <E> Matcher<E[]> arrayContainingInAnyOrder(Matcher<? super E>... itemMatchers) {
         return arrayContainingInAnyOrder(Arrays.asList(itemMatchers));
@@ -79,6 +80,7 @@ public static <E> Matcher<E[]> arrayContainingInAnyOrder(Matcher<? super E>... i
      *
      * @param itemMatchers
      *     a list of matchers, each of which must be satisfied by an item provided by an examined array
+     * @return The matcher.
      */
     public static <E> Matcher<E[]> arrayContainingInAnyOrder(Collection<Matcher<? super E>> itemMatchers) {
         return new IsArrayContainingInAnyOrder<E>(itemMatchers);
@@ -101,6 +103,7 @@ public static <E> Matcher<E[]> arrayContainingInAnyOrder(Collection<Matcher<? su
      *
      * @param items
      *     the items that must equal the entries of an examined array, in any order
+     * @return The matcher.
      */
     public static <E> Matcher<E[]> arrayContainingInAnyOrder(E... items) {
       List<Matcher<? super E>> matchers = new ArrayList<Matcher<? super E>>();

hamcrest/src/main/java/org/hamcrest/collection/IsArrayContainingInOrder.java

@@ -50,6 +50,7 @@ public void describeTo(Description description) {
      *
      * @param items
      *     the items that must equal the items within an examined array
+     * @return The matcher.
      */
     public static <E> Matcher<E[]> arrayContaining(E... items) {
         List<Matcher<? super E>> matchers = new ArrayList<Matcher<? super E>>();
@@ -71,6 +72,7 @@ public static <E> Matcher<E[]> arrayContaining(E... items) {
      *
      * @param itemMatchers
      *     the matchers that must be satisfied by the items in the examined array
+     * @return The matcher.
      */
     public static <E> Matcher<E[]> arrayContaining(Matcher<? super E>... itemMatchers) {
         return arrayContaining(asList(itemMatchers));
@@ -88,6 +90,7 @@ public static <E> Matcher<E[]> arrayContaining(Matcher<? super E>... itemMatcher
      *
      * @param itemMatchers
      *     a list of matchers, each of which must be satisfied by the corresponding item in an examined array
+     * @return The matcher.
      */
     public static <E> Matcher<E[]> arrayContaining(List<Matcher<? super E>> itemMatchers) {
         return new IsArrayContainingInOrder<E>(itemMatchers);

hamcrest/src/main/java/org/hamcrest/collection/IsArrayWithSize.java

@@ -27,6 +27,7 @@ protected Integer featureValueOf(E[] actual) {
      *
      * @param sizeMatcher
      *     a matcher for the length of an examined array
+     * @return The matcher.
      */
     public static <E> Matcher<E[]> arrayWithSize(Matcher<? super Integer> sizeMatcher) {
         return new IsArrayWithSize<>(sizeMatcher);
@@ -40,6 +41,7 @@ public static <E> Matcher<E[]> arrayWithSize(Matcher<? super Integer> sizeMatche
      *
      * @param size
      *     the length that an examined array must have for a positive match
+     * @return The matcher.
      */
     public static <E> Matcher<E[]> arrayWithSize(int size) {
         return arrayWithSize(equalTo(size));
@@ -50,6 +52,8 @@ public static <E> Matcher<E[]> arrayWithSize(int size) {
      * is zero.
      * For example:
      * <pre>assertThat(new String[0], emptyArray())</pre>
+     *
+     * @return The matcher.
      */
     public static <E> Matcher<E[]> emptyArray() {
         return describedAs("an empty array", IsArrayWithSize.<E>arrayWithSize(0));

hamcrest/src/main/java/org/hamcrest/collection/IsCollectionWithSize.java

@@ -28,6 +28,7 @@ protected Integer featureValueOf(Collection<? extends E> actual) {
      *
      * @param sizeMatcher
      *     a matcher for the size of an examined {@link java.util.Collection}
+     * @return The matcher.
      */
     public static <E> Matcher<Collection<? extends E>> hasSize(Matcher<? super Integer> sizeMatcher) {
         return new IsCollectionWithSize<E>(sizeMatcher);
@@ -41,6 +42,7 @@ public static <E> Matcher<Collection<? extends E>> hasSize(Matcher<? super Integ
      *
      * @param size
      *     the expected size of an examined {@link java.util.Collection}
+     * @return The matcher.
      */
     @SuppressWarnings({ "rawtypes", "unchecked" })
     public static <E> Matcher<Collection<? extends E>> hasSize(int size) {

hamcrest/src/main/java/org/hamcrest/collection/IsEmptyCollection.java

@@ -31,6 +31,8 @@ public void describeTo(Description description) {
      * method returns <code>true</code>.
      * For example:
      * <pre>assertThat(new ArrayList&lt;String&gt;(), is(empty()))</pre>
+     *
+     * @return The matcher.
      */
     public static <E> Matcher<Collection<? extends E>> empty() {
         return new IsEmptyCollection<E>();
@@ -44,6 +46,7 @@ public static <E> Matcher<Collection<? extends E>> empty() {
      *
      * @param unusedToForceReturnType
      *     the type of the collection's content
+     * @return The matcher.
      */
     @SuppressWarnings({"unchecked", "UnusedParameters"})
     public static <E> Matcher<Collection<E>> emptyCollectionOf(Class<E> unusedToForceReturnType) {

hamcrest/src/main/java/org/hamcrest/collection/IsEmptyIterable.java

@@ -27,6 +27,8 @@ public void describeTo(Description description) {
      * Creates a matcher for {@link Iterable}s matching examined iterables that yield no items.
      * For example:
      * <pre>assertThat(new ArrayList&lt;String&gt;(), is(emptyIterable()))</pre>
+     *
+     * @return The matcher.
      */
     public static <E> Matcher<Iterable<? extends E>> emptyIterable() {
         return new IsEmptyIterable<E>();
@@ -39,6 +41,7 @@ public static <E> Matcher<Iterable<? extends E>> emptyIterable() {
      *
      * @param unusedToForceReturnType
      *     the type of the iterable's content
+     * @return The matcher.
      */
     @SuppressWarnings({"unchecked", "UnusedParameters"})
     public static <E> Matcher<Iterable<E>> emptyIterableOf(Class<E> unusedToForceReturnType) {

hamcrest/src/main/java/org/hamcrest/collection/IsIn.java

@@ -40,6 +40,7 @@ public void describeTo(Description buffer) {
      *
      * @param collection
      *     the collection in which matching items must be found
+     * @return The matcher.
      */
     @Deprecated
     public static <T> Matcher<T> isIn(Collection<T> collection) {
@@ -54,6 +55,7 @@ public static <T> Matcher<T> isIn(Collection<T> collection) {
      *
      * @param collection
      *     the collection in which matching items must be found
+     * @return The matcher.
      */
     public static <T> Matcher<T> in(Collection<T> collection) {
         return new IsIn<>(collection);
@@ -69,6 +71,7 @@ public static <T> Matcher<T> in(Collection<T> collection) {
      *
      * @param elements
      *     the array in which matching items must be found
+     * @return The matcher.
      */
     @Deprecated
     public static <T> Matcher<T> isIn(T[] elements) {
@@ -83,6 +86,7 @@ public static <T> Matcher<T> isIn(T[] elements) {
      *
      * @param elements
      *     the array in which matching items must be found
+     * @return The matcher.
      */
     public static <T> Matcher<T> in(T[] elements) {
         return new IsIn<>(elements);
@@ -97,7 +101,8 @@ public static <T> Matcher<T> in(T[] elements) {
      * @deprecated use is(oneOf(...)) instead
      *
      * @param elements
-     *     the elements amongst which matching items will be found 
+     *     the elements amongst which matching items will be found
+     * @return The matcher.
      */
     @SafeVarargs
     @Deprecated
@@ -112,7 +117,8 @@ public static <T> Matcher<T> isOneOf(T... elements) {
      * <pre>assertThat("foo", is(oneOf("bar", "foo")))</pre>
      *
      * @param elements
-     *     the elements amongst which matching items will be found 
+     *     the elements amongst which matching items will be found
+     * @return The matcher.
      */
     @SafeVarargs
     public static <T> Matcher<T> oneOf(T... elements) {

hamcrest/src/main/java/org/hamcrest/collection/IsIterableContainingInAnyOrder.java

@@ -95,6 +95,7 @@ private boolean isMatched(S item) {
      *
      * @param itemMatchers
      *     a list of matchers, each of which must be satisfied by an item provided by an examined {@link Iterable}
+     * @return The matcher.
      */
     @SafeVarargs
     public static <T> Matcher<Iterable<? extends T>> containsInAnyOrder(Matcher<? super T>... itemMatchers) {
@@ -120,6 +121,7 @@ public static <T> Matcher<Iterable<? extends T>> containsInAnyOrder(Matcher<? su
      *
      * @param items
      *     the items that must equal the items provided by an examined {@link Iterable} in any order
+     * @return The matcher.
      */
     @SafeVarargs
     public static <T> Matcher<Iterable<? extends T>> containsInAnyOrder(T... items) {
@@ -148,6 +150,7 @@ public static <T> Matcher<Iterable<? extends T>> containsInAnyOrder(T... items)
      *
      * @param itemMatchers
      *     a list of matchers, each of which must be satisfied by an item provided by an examined {@link Iterable}
+     * @return The matcher.
      */
     public static <T> Matcher<Iterable<? extends T>> containsInAnyOrder(Collection<Matcher<? super T>> itemMatchers) {
         return new IsIterableContainingInAnyOrder<>(itemMatchers);