/* * Copyright 2006-2012 Amazon Technologies, Inc. or its affiliates. * Amazon, Amazon.com and Carbonado are trademarks or registered trademarks * of Amazon Technologies, Inc. or its affiliates. All rights reserved. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package com.amazon.carbonado.cursor; import java.util.Comparator; import java.util.NoSuchElementException; import com.amazon.carbonado.FetchException; import com.amazon.carbonado.Cursor; /** * Wraps two Cursors and performs a symmetric set difference * operation. In boolean logic, this is an exclusive or operation. * *

Both cursors must return results in the same order. Ordering is preserved * by the difference. * * @author Brian S O'Neill * @see UnionCursor * @see IntersectionCursor * @see DifferenceCursor */ public class SymmetricDifferenceCursor extends AbstractCursor { private final Cursor mLeftCursor; private final Cursor mRightCursor; private final Comparator mOrder; private S mNextLeft; private S mNextRight; private int mCompareResult; /** * @param left cursor to wrap * @param right cursor to wrap * @param order describes sort ordering of wrapped cursors, which must be * a total ordering */ public SymmetricDifferenceCursor(Cursor left, Cursor right, Comparator order) { if (left == null || right == null || order == null) { throw new IllegalArgumentException(); } mLeftCursor = left; mRightCursor = right; mOrder = order; } public void close() throws FetchException { mLeftCursor.close(); mRightCursor.close(); mNextLeft = null; mNextRight = null; } public boolean hasNext() throws FetchException { try { return compareNext() != 0; } catch (FetchException e) { try { close(); } catch (Exception e2) { // Don't care. } throw e; } } /** * Returns 0 if no next element available, {@literal <0} if next element is * from left source cursor, and {@literal >0} if next element is from right * source cursor. */ public int compareNext() throws FetchException { if (mCompareResult != 0) { return mCompareResult; } try { while (true) { if (mNextLeft == null && mLeftCursor.hasNext()) { mNextLeft = mLeftCursor.next(); } if (mNextRight == null && mRightCursor.hasNext()) { mNextRight = mRightCursor.next(); } if (mNextLeft == null) { return mNextRight != null ? 1 : 0; } if (mNextRight == null) { return -1; } if ((mCompareResult = mOrder.compare(mNextLeft, mNextRight)) == 0) { mNextLeft = null; mNextRight = null; } else { return mCompareResult; } } } catch (NoSuchElementException e) { return 0; } catch (FetchException e) { try { close(); } catch (Exception e2) { // Don't care. } throw e; } } public S next() throws FetchException { try { S next; int result = compareNext(); if (result < 0) { next = mNextLeft; mNextLeft = null; } else if (result > 0) { next = mNextRight; mNextRight = null; } else { throw new NoSuchElementException(); } mCompareResult = 0; return next; } catch (FetchException e) { try { close(); } catch (Exception e2) { // Don't care. } throw e; } } }