org.janusgraph.diskstorage.util

Class MetricInstrumentedSlicesIterator

java.lang.Object

org.janusgraph.diskstorage.util.MetricInstrumentedSlicesIterator

All Implemented Interfaces:

Closeable, AutoCloseable, Iterator<StaticBuffer>, KeySlicesIterator, RecordIterator<StaticBuffer>

public class MetricInstrumentedSlicesIterator
extends Object
implements KeySlicesIterator

This class is used by MetricInstrumentedStore to measure wall clock time, method invocation counts, and exceptions thrown by the methods on RecordIterator instances returned from MetricInstrumentedStore.getSlice(org.janusgraph.diskstorage.keycolumnvalue.KeySliceQuery, org.janusgraph.diskstorage.keycolumnvalue.StoreTransaction).

Author:

Dan LaRocque (dalaro@hopcount.org)

Method Summary

Modifier and Type	Method and Description
void	close()
Map<SliceQuery,RecordIterator<Entry>>	getEntries() Returns map of iterators over all entries associated with the current key that match the column range specified in the queries.
boolean	hasNext()
StaticBuffer	next()
static MetricInstrumentedSlicesIterator	of(KeySlicesIterator keyIterator, String... prefix) If the iterator argument is non-null, then return a new MetricInstrumentedIterator wrapping it.
void	remove()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.util.Iterator

forEachRemaining

Method Detail

of

public static MetricInstrumentedSlicesIterator of(KeySlicesIterator keyIterator,
                                                  String... prefix)

If the iterator argument is non-null, then return a new MetricInstrumentedIterator wrapping it. Metrics for method calls on the wrapped instance will be prefixed with the string prefix which must be non-null. If the iterator argument is null, then return null.

Parameters:

keyIterator - the iterator to wrap with Metrics measurements

prefix - the Metrics name prefix string

Returns:

a wrapper around keyIterator or null if keyIterator is null

hasNext

public boolean hasNext()

Specified by:

hasNext in interface Iterator<StaticBuffer>

next

public StaticBuffer next()

Specified by:

next in interface Iterator<StaticBuffer>

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException

getEntries

public Map<SliceQuery,RecordIterator<Entry>> getEntries()

Description copied from interface: KeySlicesIterator

Returns map of iterators over all entries associated with the current key that match the column range specified in the queries.

Closing any of the returned sub-iterators has no effect on this iterator. Calling Iterator.next() might close previously returned RecordIterators depending on the implementation, hence it is important to iterate over (and close) the RecordIterator before calling Iterator.next() or Iterator.hasNext(). Important! Entries should be sorted inside iterators. Otherwise VertexJobConverter will not work correctly

Specified by:

getEntries in interface KeySlicesIterator

Returns:

remove

public void remove()

Specified by:

remove in interface Iterator<StaticBuffer>