Package com.google.gerrit.server.permissions

Class PermissionBackend.ForProject

java.lang.Object

com.google.gerrit.server.permissions.PermissionBackend.AcceptsReviewDb<PermissionBackend.ForProject>

com.google.gerrit.server.permissions.PermissionBackend.ForProject

Enclosing class:

PermissionBackend

public abstract static class PermissionBackend.ForProject
extends PermissionBackend.AcceptsReviewDb<PermissionBackend.ForProject>

PermissionBackend scoped to a user and project.

Field Summary

Fields inherited from class com.google.gerrit.server.permissions.PermissionBackend.AcceptsReviewDb

db

Constructor Summary

Constructors

Constructor	Description
ForProject()

Method Summary

Modifier and Type	Method	Description
PermissionBackend.ForChange	change(ChangeNotes notes)	Returns an instance scoped for the change, and its destination ref and project.
PermissionBackend.ForChange	change(ChangeData cd)	Returns an instance scoped for the change, and its destination ref and project.
abstract void	check(ProjectPermission perm)	Verify scoped user can perm, throwing if denied.
abstract Map<String,org.eclipse.jgit.lib.Ref>	filter(Map<String,org.eclipse.jgit.lib.Ref> refs, org.eclipse.jgit.lib.Repository repo, PermissionBackend.RefFilterOptions opts)	Filter a map of references by visibility.
PermissionBackend.ForChange	indexedChange(ChangeData cd, ChangeNotes notes)	Returns an instance scoped for the change loaded from index, and its destination ref and project.
abstract PermissionBackend.ForRef	ref(String ref)	Returns an instance scoped for ref in this project.
abstract String	resourcePath()	Returns the fully qualified resource path that this instance is scoped to.
boolean	test(ProjectPermission perm)
abstract Set<ProjectPermission>	test(Collection<ProjectPermission> permSet)	Filter permSet to permissions scoped user might be able to perform.
abstract BooleanCondition	testCond(ProjectPermission perm)
boolean	testOrFalse(ProjectPermission perm)

Methods inherited from class com.google.gerrit.server.permissions.PermissionBackend.AcceptsReviewDb

database, database

Methods inherited from class java.lang.Object

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

Constructor Detail

ForProject

public ForProject()

Method Detail

resourcePath

public abstract String resourcePath()

Returns the fully qualified resource path that this instance is scoped to.

ref

public abstract PermissionBackend.ForRef ref(String ref)

Returns an instance scoped for ref in this project.

change

public PermissionBackend.ForChange change(ChangeData cd)

Returns an instance scoped for the change, and its destination ref and project.

change

public PermissionBackend.ForChange change(ChangeNotes notes)

Returns an instance scoped for the change, and its destination ref and project.

indexedChange

public PermissionBackend.ForChange indexedChange(ChangeData cd,
                                                 ChangeNotes notes)

Returns an instance scoped for the change loaded from index, and its destination ref and project. This method should only be used when database access is harmful and potentially stale data from the index is acceptable.

check

public abstract void check(ProjectPermission perm)
                    throws AuthException,
                           PermissionBackendException

Verify scoped user can perm, throwing if denied.

Throws:

AuthException

PermissionBackendException

test

public abstract Set<ProjectPermission> test(Collection<ProjectPermission> permSet)
                                     throws PermissionBackendException

Filter permSet to permissions scoped user might be able to perform.

Throws:

PermissionBackendException

test

public boolean test(ProjectPermission perm)
             throws PermissionBackendException

Throws:

PermissionBackendException

testOrFalse

public boolean testOrFalse(ProjectPermission perm)

testCond

public abstract BooleanCondition testCond(ProjectPermission perm)

filter

public abstract Map<String,org.eclipse.jgit.lib.Ref> filter(Map<String,org.eclipse.jgit.lib.Ref> refs,
                                                                  org.eclipse.jgit.lib.Repository repo,
                                                                  PermissionBackend.RefFilterOptions opts)
                                                           throws PermissionBackendException

Filter a map of references by visibility.

Parameters:

refs - a map of references to filter.

repo - an open Repository handle for this instance's project

opts - further options for filtering.

Returns:

a partition of the provided refs that are visible to the user that this instance is scoped to.

Throws:

PermissionBackendException - if failure consulting backend configuration.