com.google.gerrit.server.index.change

Class ChangeIndexer

java.lang.Object

com.google.gerrit.server.index.change.ChangeIndexer

public class ChangeIndexer
extends java.lang.Object

Helper for (re)indexing a change document.

Indexing is run in the background, as it may require substantial work to compute some of the fields and/or update the index.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ChangeIndexer.Factory

Method Summary

Modifier and Type	Method and Description
static com.google.common.util.concurrent.CheckedFuture<?,java.io.IOException>	allAsList(java.util.List<? extends com.google.common.util.concurrent.ListenableFuture<?>> futures)
void	delete(Change.Id id) Synchronously delete a change.
com.google.common.util.concurrent.CheckedFuture<?,java.io.IOException>	deleteAsync(Change.Id id) Start deleting a change.
void	index(ChangeData cd) Synchronously index a change.
void	index(ReviewDb db, Change change) Synchronously index a change.
void	index(ReviewDb db, Project.NameKey project, Change.Id changeId) Synchronously index a change.
com.google.common.util.concurrent.CheckedFuture<?,java.io.IOException>	indexAsync(Project.NameKey project, Change.Id id) Start indexing a change.
com.google.common.util.concurrent.CheckedFuture<?,java.io.IOException>	indexAsync(Project.NameKey project, java.util.Collection<Change.Id> ids) Start indexing multiple changes in parallel.
com.google.common.util.concurrent.CheckedFuture<java.lang.Boolean,java.io.IOException>	reindexIfStale(Project.NameKey project, Change.Id id) Asynchronously check if a change is stale, and reindex if it is.

Methods inherited from class java.lang.Object

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

Method Detail

allAsList

public static com.google.common.util.concurrent.CheckedFuture<?,java.io.IOException> allAsList(java.util.List<? extends com.google.common.util.concurrent.ListenableFuture<?>> futures)

indexAsync

public com.google.common.util.concurrent.CheckedFuture<?,java.io.IOException> indexAsync(Project.NameKey project,
                                                                                         Change.Id id)

Start indexing a change.

Parameters:

id - change to index.

Returns:

future for the indexing task.

indexAsync

public com.google.common.util.concurrent.CheckedFuture<?,java.io.IOException> indexAsync(Project.NameKey project,
                                                                                         java.util.Collection<Change.Id> ids)

Start indexing multiple changes in parallel.

Parameters:

ids - changes to index.

Returns:

future for completing indexing of all changes.

index

public void index(ChangeData cd)
           throws java.io.IOException

Synchronously index a change.

Parameters:

cd - change to index.

Throws:

java.io.IOException

index

public void index(ReviewDb db,
                  Change change)
           throws java.io.IOException,
                  com.google.gwtorm.server.OrmException

Synchronously index a change.

Parameters:

db - review database.

change - change to index.

Throws:

java.io.IOException

com.google.gwtorm.server.OrmException

index

public void index(ReviewDb db,
                  Project.NameKey project,
                  Change.Id changeId)
           throws java.io.IOException,
                  com.google.gwtorm.server.OrmException

Synchronously index a change.

Parameters:

db - review database.

project - the project to which the change belongs.

changeId - ID of the change to index.

Throws:

java.io.IOException

com.google.gwtorm.server.OrmException

deleteAsync

public com.google.common.util.concurrent.CheckedFuture<?,java.io.IOException> deleteAsync(Change.Id id)

Start deleting a change.

Parameters:

id - change to delete.

Returns:

future for the deleting task.

delete

public void delete(Change.Id id)
            throws java.io.IOException

Synchronously delete a change.

Parameters:

id - change ID to delete.

Throws:

java.io.IOException

reindexIfStale

public com.google.common.util.concurrent.CheckedFuture<java.lang.Boolean,java.io.IOException> reindexIfStale(Project.NameKey project,
                                                                                                             Change.Id id)

Asynchronously check if a change is stale, and reindex if it is.

Always run on the batch executor, even if this indexer instance is configured to use a different executor.

Parameters:

project - the project to which the change belongs.

id - ID of the change to index.

Returns:

future for reindexing the change; returns true if the change was stale.