com.google.gerrit.server.permissions

Class PermissionBackend.ForProject

java.lang.Object

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

Enclosing class:

PermissionBackend

public abstract static class PermissionBackend.ForProject
extends java.lang.Object

PermissionBackend scoped to a user and project.

Constructor Summary

Constructors

Constructor and Description
ForProject()

Method Summary

Modifier and Type	Method and Description
PermissionBackend.ForChange	change(ChangeData cd) Returns an instance scoped for the change, and its destination ref and project.
PermissionBackend.ForChange	change(ChangeNotes notes) Returns an instance scoped for the change, and its destination ref and project.
abstract void	check(CoreOrPluginProjectPermission perm) Verify scoped user can perm, throwing if denied.
java.util.Map<java.lang.String,org.eclipse.jgit.lib.Ref>	filter(java.util.List<org.eclipse.jgit.lib.Ref> refs, org.eclipse.jgit.lib.Repository repo, PermissionBackend.RefFilterOptions opts) Filter a list of references by visibility.
abstract java.util.Map<java.lang.String,org.eclipse.jgit.lib.Ref>	filter(java.util.Map<java.lang.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(java.lang.String ref) Returns an instance scoped for ref in this project.
abstract java.lang.String	resourcePath() Returns the fully qualified resource path that this instance is scoped to.
abstract <T extends CoreOrPluginProjectPermission> java.util.Set<T>	test(java.util.Collection<T> permSet) Filter permSet to permissions scoped user might be able to perform.
boolean	test(CoreOrPluginProjectPermission perm)
abstract BooleanCondition	testCond(CoreOrPluginProjectPermission perm)
boolean	testOrFalse(CoreOrPluginProjectPermission perm)

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 java.lang.String resourcePath()

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

ref

public abstract PermissionBackend.ForRef ref(java.lang.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(CoreOrPluginProjectPermission perm)
                    throws AuthException,
                           PermissionBackendException

Verify scoped user can perm, throwing if denied.

Throws:

AuthException

PermissionBackendException

test

public abstract <T extends CoreOrPluginProjectPermission> java.util.Set<T> test(java.util.Collection<T> permSet)
                                                                         throws PermissionBackendException

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

Throws:

PermissionBackendException

test

public boolean test(CoreOrPluginProjectPermission perm)
             throws PermissionBackendException

Throws:

PermissionBackendException

testOrFalse

public boolean testOrFalse(CoreOrPluginProjectPermission perm)

testCond

public abstract BooleanCondition testCond(CoreOrPluginProjectPermission perm)

filter

public abstract java.util.Map<java.lang.String,org.eclipse.jgit.lib.Ref> filter(java.util.Map<java.lang.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.

filter

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

Filter a list of references by visibility.

Parameters:

refs - a list 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.