Package com.google.gerrit.server.project

Interface ProjectCache

All Known Implementing Classes:

NullProjectCache, ProjectCacheImpl

public interface ProjectCache

Cache of project information, including access rights.

Method Summary

Modifier and Type	Method	Description
com.google.common.collect.ImmutableSortedSet<Project.NameKey>	all()	Returns sorted iteration of projects.
com.google.common.collect.ImmutableSortedSet<Project.NameKey>	byName(String prefix)	Filter the set of registered project names by common prefix.
void	evict(Project.NameKey p)	Invalidate the cached information about the given project.
void	evictAndReindex(Project p)	Invalidate the cached information about the given project, and triggers reindexing for it
void	evictAndReindex(Project.NameKey p)	Invalidate the cached information about the given project, and triggers reindexing for it
Optional<ProjectState>	get(Project.NameKey projectName)	Get the cached data for a project by its unique name.
ProjectState	getAllProjects()	Returns the parent state for all projects on this server.
ProjectState	getAllUsers()	Returns the project state of the project storing meta data for all users.
Set<AccountGroup.UUID>	guessRelevantGroupUUIDs()	Returns estimated set of relevant groups extracted from hot project access rules.
static Supplier<IllegalStateException>	illegalState(Project.NameKey nameKey)	Returns a supplier to be used as a short-hand when unwrapping an Optional returned from this cache.
static Supplier<NoSuchProjectException>	noSuchProject(Project.NameKey nameKey)	Returns a supplier to be used as a short-hand when unwrapping an Optional returned from this cache.
void	onCreateProject(Project.NameKey newProjectName)	Notify the cache that a new project was constructed.
void	remove(Project p)	Remove information about the given project from the cache.
void	remove(Project.NameKey name)	Remove information about the given project from the cache.

Method Detail

illegalState

static Supplier<IllegalStateException> illegalState(Project.NameKey nameKey)

Returns a supplier to be used as a short-hand when unwrapping an Optional returned from this cache.

noSuchProject

static Supplier<NoSuchProjectException> noSuchProject(Project.NameKey nameKey)

Returns a supplier to be used as a short-hand when unwrapping an Optional returned from this cache.

getAllProjects

ProjectState getAllProjects()

Returns the parent state for all projects on this server.

getAllUsers

ProjectState getAllUsers()

Returns the project state of the project storing meta data for all users.

get

Optional<ProjectState> get(Project.NameKey projectName)
                    throws com.google.gerrit.exceptions.StorageException

Get the cached data for a project by its unique name.

Parameters:

projectName - name of the project.

Returns:

an Optional wrapping the cached data; absent if no such project exists or the projectName is null

Throws:

com.google.gerrit.exceptions.StorageException - when there was an error.

evict

void evict(Project.NameKey p)

Invalidate the cached information about the given project.

Parameters:

p - the NameKey of the project that is being evicted

evictAndReindex

void evictAndReindex(Project p)

Invalidate the cached information about the given project, and triggers reindexing for it

Parameters:

p - project that is being evicted

evictAndReindex

void evictAndReindex(Project.NameKey p)

Invalidate the cached information about the given project, and triggers reindexing for it

Parameters:

p - the NameKey of the project that is being evicted

remove

void remove(Project p)

Remove information about the given project from the cache. It will no longer be returned from all().

remove

void remove(Project.NameKey name)

Remove information about the given project from the cache. It will no longer be returned from all().

all

com.google.common.collect.ImmutableSortedSet<Project.NameKey> all()

Returns sorted iteration of projects.

guessRelevantGroupUUIDs

Set<AccountGroup.UUID> guessRelevantGroupUUIDs()

Returns estimated set of relevant groups extracted from hot project access rules. If the cache is cold or too small for the entire project set of the server, this set may be incomplete.

byName

com.google.common.collect.ImmutableSortedSet<Project.NameKey> byName(String prefix)

Filter the set of registered project names by common prefix.

Parameters:

prefix - common prefix.

Returns:

sorted iteration of projects sharing the same prefix.

onCreateProject

void onCreateProject(Project.NameKey newProjectName)
              throws IOException

Notify the cache that a new project was constructed.

Throws:

IOException