added comparator versions of distinct operation, too

Author: Joachim Hofer

rxjava-core/src/main/java/rx/Observable.java

@@ -2956,7 +2956,7 @@ public <U> Observable<T> distinctUntilChanged(Func1<? super T, ? extends U> keyS
      * @param equalityComparator
      *            a comparator for deciding whether two emitted items are equal or not
      * @return an Observable of sequentially distinct items
-     * @see <a href="http://msdn.microsoft.com/en-us/library/hh229508%28v=vs.103%29.aspx">MSDN: Observable.distinctUntilChanged</a>
+     * @see <a href="http://msdn.microsoft.com/en-us/library/hh229776%28v=vs.103%29.aspx">MSDN: Observable.distinctUntilChanged</a>
      */
     public <U> Observable<T> distinctUntilChanged(Comparator<T> equalityComparator) {
         return create(OperationDistinctUntilChanged.distinctUntilChanged(this, equalityComparator));
@@ -2972,7 +2972,7 @@ public <U> Observable<T> distinctUntilChanged(Comparator<T> equalityComparator)
      * @param equalityComparator
      *            a comparator for deciding whether two emitted item keys are equal or not
      * @return an Observable of sequentially distinct items
-     * @see <a href="http://msdn.microsoft.com/en-us/library/hh229508%28v=vs.103%29.aspx">MSDN: Observable.distinctUntilChanged</a>
+     * @see <a href="http://msdn.microsoft.com/en-us/library/hh229533%28v=vs.103%29.aspx">MSDN: Observable.distinctUntilChanged</a>
      */
     public <U> Observable<T> distinctUntilChanged(Func1<? super T, ? extends U> keySelector, Comparator<U> equalityComparator) {
         return create(OperationDistinctUntilChanged.distinctUntilChanged(this, keySelector, equalityComparator));
@@ -2988,6 +2988,19 @@ public Observable<T> distinct() {
         return create(OperationDistinct.distinct(this));
     }
 
+    /**
+     * Returns an Observable that forwards all items emitted from the source Observable that are distinct according to
+     * a comparator.
+     * 
+     * @param equalityComparator
+     *            a comparator for deciding whether two emitted items are equal or not
+     * @return an Observable of distinct items
+     * @see <a href="http://msdn.microsoft.com/en-us/library/hh211630(v=vs.103).aspx">MSDN: Observable.distinct</a>
+     */
+    public <U> Observable<T> distinct(Comparator<T> equalityComparator) {
+        return create(OperationDistinct.distinct(this, equalityComparator));
+    }
+    
     /**
      * Returns an Observable that forwards all items emitted from the source Observable that are distinct according to
      * a key selector function.
@@ -3002,6 +3015,22 @@ public <U> Observable<T> distinct(Func1<? super T, ? extends U> keySelector) {
         return create(OperationDistinct.distinct(this, keySelector));
     }
 
+    /**
+     * Returns an Observable that forwards all items emitted from the source Observable that are distinct according to
+     * a key selector function and a comparator.
+     * 
+     * @param keySelector
+     *            a function that projects an emitted item to a key value which is used for deciding whether an item is
+     *            distinct from another one or not
+     * @param equalityComparator
+     *            a comparator for deciding whether two emitted item keys are equal or not
+     * @return an Observable of distinct items
+     * @see <a href="http://msdn.microsoft.com/en-us/library/hh229050(v=vs.103).aspx">MSDN: Observable.distinct</a>
+     */
+    public <U> Observable<T> distinct(Func1<? super T, ? extends U> keySelector, Comparator<U> equalityComparator) {
+        return create(OperationDistinct.distinct(this, keySelector, equalityComparator));
+    }
+    
     /**
      * Registers an {@link Action0} to be called when this Observable invokes {@link Observer#onCompleted onCompleted} or {@link Observer#onError onError}.
      * <p>

rxjava-core/src/main/java/rx/operators/OperationDistinct.java

@@ -22,7 +22,10 @@
 import static rx.Observable.empty;
 import static rx.Observable.from;
 
+import java.util.ArrayList;
+import java.util.Comparator;
 import java.util.HashSet;
+import java.util.List;
 import java.util.Set;
 
 import org.junit.Before;
@@ -57,6 +60,30 @@ public static <T, U> OnSubscribeFunc<T> distinct(Observable<? extends T> source,
         return new Distinct<T, U>(source, keySelector);
     }
 
+    /**
+     * Returns an Observable that emits all distinct items emitted by the source
+     * @param source
+     *            The source Observable to emit the distinct items for.
+     * @param equalityComparator
+     *            The comparator to use for deciding whether to consider two items as equal or not.
+     * @return A subscription function for creating the target Observable.
+     */
+    public static <T> OnSubscribeFunc<T> distinct(Observable<? extends T> source, Comparator<T> equalityComparator) {
+        return new DistinctWithComparator<T, T>(source, Functions.<T>identity(), equalityComparator);
+    }
+    
+    /**
+     * Returns an Observable that emits all distinct items emitted by the source
+     * @param source
+     *            The source Observable to emit the distinct items for.
+     * @param equalityComparator
+     *            The comparator to use for deciding whether to consider the two item keys as equal or not.
+     * @return A subscription function for creating the target Observable.
+     */
+    public static <T, U> OnSubscribeFunc<T> distinct(Observable<? extends T> source, Func1<? super T, ? extends U> keySelector, Comparator<U> equalityComparator) {
+        return new DistinctWithComparator<T, U>(source, keySelector, equalityComparator);
+    }
+    
     /**
      * Returns an Observable that emits all distinct items emitted by the source
      * @param source
@@ -115,6 +142,67 @@ public void call() {
         }
     }
 
+    private static class DistinctWithComparator<T, U> implements OnSubscribeFunc<T> {
+        private final Observable<? extends T> source;
+        private final Func1<? super T, ? extends U> keySelector;
+        private final Comparator<U> equalityComparator;
+        
+        private DistinctWithComparator(Observable<? extends T> source, Func1<? super T, ? extends U> keySelector, Comparator<U> equalityComparator) {
+            this.source = source;
+            this.keySelector = keySelector;
+            this.equalityComparator = equalityComparator;
+        }
+
+        @Override
+        public Subscription onSubscribe(final Observer<? super T> observer) {
+            final Subscription sourceSub = source.subscribe(new Observer<T>() {
+                
+                // due to the totally arbitrary equality comparator, we can't use anything more efficient than lists here 
+                private final List<U> emittedKeys = new ArrayList<U>();
+                
+                @Override
+                public void onCompleted() {
+                    observer.onCompleted();
+                }
+
+                @Override
+                public void onError(Throwable e) {
+                    observer.onError(e);
+                }
+
+                @Override
+                public void onNext(T next) {
+                    try {
+                        U nextKey = keySelector.call(next);
+                        if (!alreadyEmitted(nextKey)) {
+                            emittedKeys.add(nextKey);
+                            observer.onNext(next);
+                        }
+                    } catch (Throwable t) {
+                        // keySelector and comparator are user functions, may throw something
+                        observer.onError(t);
+                    }
+                }
+                
+                private boolean alreadyEmitted(U newKey) {
+                    for (U key: emittedKeys) {
+                        if (equalityComparator.compare(key, newKey) == 0) {
+                            return true;
+                        }
+                    }
+                    return false;
+                }
+            });
+            
+            return Subscriptions.create(new Action0() {
+                @Override
+                public void call() {
+                    sourceSub.unsubscribe();
+                }
+            });
+        }
+    }
+    
     public static class UnitTest {
         @Mock
         Observer<? super String> w;
@@ -123,10 +211,20 @@ public static class UnitTest {
         final Func1<String, String> TO_UPPER_WITH_EXCEPTION = new Func1<String, String>() {
             @Override
             public String call(String s) {
+                if (s.equals("x")) {
+                    return "XX";
+                }
                 return s.toUpperCase();
             }
         };
 
+        final Comparator<String> COMPARE_LENGTH = new Comparator<String>() {
+            @Override
+            public int compare(String s1, String s2) {
+                return s1.length() - s2.length();
+            }
+        };
+        
         @Before
         public void before() {
             initMocks(this);
@@ -182,6 +280,36 @@ public void testDistinctOfNormalSourceWithKeySelector() {
             verify(w, never()).onError(any(Throwable.class));
         }
 
+        @Test
+        public void testDistinctOfNormalSourceWithComparator() {
+            Observable<String> src = from("1", "12", "123", "aaa", "321", "12", "21", "1", "12345");
+            create(distinct(src, COMPARE_LENGTH)).subscribe(w);
+
+            InOrder inOrder = inOrder(w); 
+            inOrder.verify(w, times(1)).onNext("1");
+            inOrder.verify(w, times(1)).onNext("12");
+            inOrder.verify(w, times(1)).onNext("123");
+            inOrder.verify(w, times(1)).onNext("12345");
+            inOrder.verify(w, times(1)).onCompleted();
+            inOrder.verify(w, never()).onNext(anyString());
+            verify(w, never()).onError(any(Throwable.class));
+        }
+
+        @Test
+        public void testDistinctOfNormalSourceWithKeySelectorAndComparator() {
+            Observable<String> src = from("a", "x", "ab", "abc", "cba", "de", "x", "a", "abcd");
+            create(distinct(src, TO_UPPER_WITH_EXCEPTION, COMPARE_LENGTH)).subscribe(w);
+
+            InOrder inOrder = inOrder(w); 
+            inOrder.verify(w, times(1)).onNext("a");
+            inOrder.verify(w, times(1)).onNext("x");
+            inOrder.verify(w, times(1)).onNext("abc");
+            inOrder.verify(w, times(1)).onNext("abcd");
+            inOrder.verify(w, times(1)).onCompleted();
+            inOrder.verify(w, never()).onNext(anyString());
+            verify(w, never()).onError(any(Throwable.class));
+        }
+
         @Test
         public void testDistinctOfSourceWithNulls() {
             Observable<String> src = from(null, "a", "a", null, null, "b", null);