kv-4.0.9.src.oracle.kv.ParallelScanIterator Maven / Gradle / Ivy
Show all versions of oracle-nosql-client Show documentation
/*-
*
* This file is part of Oracle NoSQL Database
* Copyright (C) 2011, 2016 Oracle and/or its affiliates. All rights reserved.
*
* If you have received this file as part of Oracle NoSQL Database the
* following applies to the work as a whole:
*
* Oracle NoSQL Database server software is free software: you can
* redistribute it and/or modify it under the terms of the GNU Affero
* General Public License as published by the Free Software Foundation,
* version 3.
*
* Oracle NoSQL Database is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Affero General Public License for more details.
*
* If you have received this file as part of Oracle NoSQL Database Client or
* distributed separately the following applies:
*
* Oracle NoSQL Database client software is free software: you can
* redistribute it and/or modify it under the terms of the Apache License
* as published by the Apache Software Foundation, version 2.0.
*
* You should have received a copy of the GNU Affero General Public License
* and/or the Apache License in the LICENSE file along with Oracle NoSQL
* Database client or server distribution. If not, see
* .
*
* An active Oracle commercial licensing agreement for this product supersedes
* these licenses and in such case the license notices, but not the copyright
* notice, may be removed by you in connection with your distribution that is
* in accordance with the commercial licensing terms.
*
* For more information please contact:
*
* [email protected]
*
*/
package oracle.kv;
import java.util.Iterator;
import java.util.List;
import java.util.NoSuchElementException;
import java.util.concurrent.TimeUnit;
import oracle.kv.stats.DetailedMetrics;
/**
* Interface to the specialized Iterator type returned by the {@link
* KVStore#storeIterator(Direction, int, Key, KeyRange, Depth, Consistency, long,
* TimeUnit, StoreIteratorConfig) Parallel Scan version} of storeIterator().
*
* This Iterator adds the ability to close (terminate) a ParallelScan as well
* gather per-partition and per-shard statistics about the scan.
*
* Iterators implementing this interface can only be used safely by one thread
* at a time unless synchronized externally.
*/
public interface ParallelScanIterator extends Iterator {
/**
* Close (terminate) a Parallel Scan. This shutdowns down all related
* threads and tasks, and awaits up to 60 seconds for threads to exit.
*/
public void close();
/**
* Gets the per-partition metrics for this Parallel Scan. This may be
* called at any time during the iteration in order to obtain metrics to
* that point or it may be called at the end to obtain metrics for the
* entire scan. If there are no metrics available yet for a particular
* partition, then there will not be an entry in the list.
*
* @return the per-partition metrics for this Parallel Scan.
*/
public List getPartitionMetrics();
/**
* Gets the per-shard metrics for this Parallel Scan. This may be called at
* any time during the iteration in order to obtain metrics to that point
* or it may be called at the end to obtain metrics for the entire scan.
* If there are no metrics available yet for a particular shard, then there
* will not be an entry in the list.
*
* @return the per-shard metrics for this Parallel Scan.
*/
public List getShardMetrics();
/**
* Returns the next element in the iteration.
*
* @return the next element in the iteration.
*
* @throws NoSuchElementException - iteration has no more elements.
*
* @throws StoreIteratorException - an exception occurred during a
* retrieval as part of a multi-record iteration method. This exception
* does not necessarily close or invalidate the iterator. Repeated calls to
* next() may or may not cause an exception to be thrown. It is incumbent
* on the caller to determine the type of exception and act accordingly.
*/
@Override
public K next();
}