org.janusgraph.graphdb.olap.job

Class GhostVertexRemover

java.lang.Object

org.janusgraph.graphdb.olap.AbstractScanJob

org.janusgraph.graphdb.olap.job.GhostVertexRemover

All Implemented Interfaces:

Cloneable, ScanJob

public class GhostVertexRemover
extends AbstractScanJob

Author:

Matthias Broecheler ([email protected])

Field Summary

Fields

Modifier and Type	Field and Description
static String	REMOVED_RELATION_COUNT
static String	REMOVED_VERTEX_COUNT
static String	SKIPPED_GHOST_LIMIT_COUNT

Fields inherited from class org.janusgraph.graphdb.olap.AbstractScanJob

graph, tx

Constructor Summary

Constructors

Modifier	Constructor and Description
	GhostVertexRemover()
protected	GhostVertexRemover(GhostVertexRemover copy)
	GhostVertexRemover(JanusGraph graph)

Method Summary

Modifier and Type	Method and Description
GhostVertexRemover	clone() Returns a clone of this ScanJob.
List<SliceQuery>	getQueries() Returns one or more SliceQuery instances belonging to this ScanJob.
void	process(StaticBuffer key, Map<SliceQuery,EntryList> entries, ScanMetrics metrics) Run this ScanJob's computation on the supplied row-key and entries.
protected StandardJanusGraphTx	startTransaction(StandardJanusGraph graph)
void	workerIterationEnd(ScanMetrics metrics) Invoked after a block of computation (i.e.
void	workerIterationStart(Configuration jobConfig, Configuration graphConfig, ScanMetrics metrics) Invoked before a block of computation (i.e.

Methods inherited from class org.janusgraph.graphdb.olap.AbstractScanJob

close, getVertexId, isGhostVertex, open

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.janusgraph.diskstorage.keycolumnvalue.scan.ScanJob

getKeyFilter

Field Detail

REMOVED_RELATION_COUNT

public static final String REMOVED_RELATION_COUNT

See Also:

Constant Field Values

REMOVED_VERTEX_COUNT

public static final String REMOVED_VERTEX_COUNT

See Also:

Constant Field Values

SKIPPED_GHOST_LIMIT_COUNT

public static final String SKIPPED_GHOST_LIMIT_COUNT

See Also:

Constant Field Values

Constructor Detail

GhostVertexRemover

public GhostVertexRemover(JanusGraph graph)

GhostVertexRemover

public GhostVertexRemover()

GhostVertexRemover

protected GhostVertexRemover(GhostVertexRemover copy)

Method Detail

clone

public GhostVertexRemover clone()

Description copied from interface: ScanJob

Returns a clone of this ScanJob. The clone will not yet be initialized for computation but all of its internal state (if any) must match that of the original copy.

Specified by:

clone in interface ScanJob

Specified by:

clone in class AbstractScanJob

Returns:

A clone of this ScanJob

workerIterationStart

public void workerIterationStart(Configuration jobConfig,
                                 Configuration graphConfig,
                                 ScanMetrics metrics)

Description copied from interface: ScanJob

Invoked before a block of computation (i.e. multiple process() calls) is handed to this particular ScanJob. Can be used to initialize the iteration. This method is called exactly once for each before a block of computation. This method is semantically aligned with VertexProgram.workerIterationStart(Memory) This method may not be called if there is no data to be processed. Correspondingly, the end method won't be called either. No-op default implementation.

Parameters:

jobConfig - configuration for this particular job

graphConfig - configuration options for the entire graph against which this job is executed

metrics - ScanMetrics for this job

startTransaction

protected StandardJanusGraphTx startTransaction(StandardJanusGraph graph)

Specified by:

startTransaction in class AbstractScanJob

process

public void process(StaticBuffer key,
                    Map<SliceQuery,EntryList> entries,
                    ScanMetrics metrics)

Description copied from interface: ScanJob

Run this ScanJob's computation on the supplied row-key and entries.

This method will be called by a client of this interface if and only if both of the following criteria are satisfied:

• The predicate returned by ScanJob.getKeyFilter() must evaluate to true on the key.
• The entries parameter must contain an entry whose key is the first SliceQuery returned by ScanJob.getQueries() and whose value is an EntryList with at least size one. In other words, the initial query in this job's query list must have matched at least once.

Implementations may assume these two conditions are satisfied. Calling this method when either of these two conditions is false yields undefined behavior.

It is the caller's responsibility to construct an entries map that maps each SliceQuery to that query's matches. The caller is also responsible for truncating the entries values to honor BaseQuery.getLimit() when BaseQuery.hasLimit() is true. Passing in an entries value longer than the limit set in its respective key yields undefined behavior.

This method may be called by concurrent threads in a single process.

workerIterationEnd

public void workerIterationEnd(ScanMetrics metrics)

Description copied from interface: ScanJob

Invoked after a block of computation (i.e. multiple process() calls) is handed to this particular ScanJob. Can be used to close any resources held by this job. This method is called exactly once for each after a block of computation. This method is semantically aligned with VertexProgram.workerIterationEnd(Memory) This method may not be called if there is no data to be processed. Correspondingly, the start method won't be called either. No-op default implementation.

Parameters:

metrics - ScanMetrics for this job

getQueries

public List<SliceQuery> getQueries()

Description copied from interface: ScanJob

Returns one or more SliceQuery instances belonging to this ScanJob.

Before calling ScanJob.process(org.janusgraph.diskstorage.StaticBuffer, java.util.Map, ScanMetrics), users of this interface must check that the key in question contains at least one entry matching the initial SliceQuery returned by this method. See the javadoc for the process method for more information.

If this method returns more than one query, then the initial query's lower bound must be all zero bits and the initial query's upper bound must be all one bits (per the preconditions in StandardScannerExecutor, the reference ScanJob executor).

Returns:

one or more queries