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
void	delete(Change.Id id) Synchronously delete a change.
com.google.common.util.concurrent.ListenableFuture<?>	deleteAsync(Change.Id id) Start deleting a change.
void	index(Change change) Synchronously index a change.
void	index(ChangeData cd) Synchronously index a change, then check if the index is stale due to a race condition.
void	index(Project.NameKey project, Change.Id changeId) Synchronously index a change.
com.google.common.util.concurrent.ListenableFuture<?>	indexAsync(Project.NameKey project, Change.Id id) Start indexing a change.
com.google.common.util.concurrent.ListenableFuture<?>	indexAsync(Project.NameKey project, java.util.Collection<Change.Id> ids) Start indexing multiple changes in parallel.
com.google.common.util.concurrent.ListenableFuture<java.lang.Boolean>	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

indexAsync

public com.google.common.util.concurrent.ListenableFuture<?> 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.ListenableFuture<?> 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)

Synchronously index a change, then check if the index is stale due to a race condition.

Parameters:

cd - change to index.

index

public void index(Change change)

Synchronously index a change.

Parameters:

change - change to index.

index

public void index(Project.NameKey project,
                  Change.Id changeId)

Synchronously index a change.

Parameters:

project - the project to which the change belongs.

changeId - ID of the change to index.

deleteAsync

public com.google.common.util.concurrent.ListenableFuture<?> 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)

Synchronously delete a change.

Parameters:

id - change ID to delete.

reindexIfStale

public com.google.common.util.concurrent.ListenableFuture<java.lang.Boolean> 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.