Package com.google.gerrit.server.permissions

Enum ProjectPermission

java.lang.Object

java.lang.Enum<ProjectPermission>

com.google.gerrit.server.permissions.ProjectPermission

All Implemented Interfaces:

CoreOrPluginProjectPermission, GerritPermission, Serializable, Comparable<ProjectPermission>

public enum ProjectPermission
extends Enum<ProjectPermission>
implements CoreOrPluginProjectPermission

Enum Constant Summary

Enum Constants

Enum Constant	Description
ACCESS	Can access at least one reference or change within the repository.
BAN_COMMIT	Allow banning commits from Gerrit preventing pushes of these commits.
CREATE_CHANGE	Can create at least one change in the project.
CREATE_REF	Can create at least one reference in the project.
CREATE_TAG_REF	Can create at least one tag reference in the project.
PUSH_AT_LEAST_ONE_REF	Can push to at least one reference within the repository.
READ	Can read all references in the repository.
READ_CONFIG	Allow read access to refs/meta/config.
READ_REFLOG	Allow accessing the project's reflog.
RUN_RECEIVE_PACK	Can run receive pack.
RUN_UPLOAD_PACK	Can run upload pack.
WRITE_CONFIG	Allow write access to refs/meta/config.

Method Summary

Modifier and Type	Method	Description
String	describeForException()	A description in the context of an exception message.
static ProjectPermission	valueOf(String name)	Returns the enum constant of this type with the specified name.
static ProjectPermission[]	values()	Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

ACCESS

public static final ProjectPermission ACCESS

Can access at least one reference or change within the repository.

Checking this permission instead of READ may require filtering to hide specific references or changes, which can be expensive.

READ

public static final ProjectPermission READ

Can read all references in the repository.

This is a stronger form of ACCESS where no filtering is required.

CREATE_REF

public static final ProjectPermission CREATE_REF

Can create at least one reference in the project.

This project level permission only validates the user may create some type of reference within the project. The exact reference name must be checked at creation:

permissionBackend
    .user(user)
    .project(proj)
    .ref(ref)
    .check(RefPermission.CREATE);
 

CREATE_TAG_REF

public static final ProjectPermission CREATE_TAG_REF

Can create at least one tag reference in the project.

This project level permission only validates the user may create some tag reference within the project. The exact reference name must be checked at creation:

permissionBackend
    .user(user)
    .project(proj)
    .ref(ref)
    .check(RefPermission.CREATE);
 

CREATE_CHANGE

public static final ProjectPermission CREATE_CHANGE

Can create at least one change in the project.

This project level permission only validates the user may create a change for some branch within the project. The exact reference name must be checked at creation:

permissionBackend
    .user(user)
    .project(proj)
    .ref(ref)
    .check(RefPermission.CREATE_CHANGE);
 

RUN_RECEIVE_PACK

public static final ProjectPermission RUN_RECEIVE_PACK

Can run receive pack.

RUN_UPLOAD_PACK

public static final ProjectPermission RUN_UPLOAD_PACK

Can run upload pack.

READ_CONFIG

public static final ProjectPermission READ_CONFIG

Allow read access to refs/meta/config.

WRITE_CONFIG

public static final ProjectPermission WRITE_CONFIG

Allow write access to refs/meta/config.

BAN_COMMIT

public static final ProjectPermission BAN_COMMIT

Allow banning commits from Gerrit preventing pushes of these commits.

READ_REFLOG

public static final ProjectPermission READ_REFLOG

Allow accessing the project's reflog.

PUSH_AT_LEAST_ONE_REF

public static final ProjectPermission PUSH_AT_LEAST_ONE_REF

Can push to at least one reference within the repository.

Method Detail

values

public static ProjectPermission[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (ProjectPermission c : ProjectPermission.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static ProjectPermission valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

describeForException

public String describeForException()

Description copied from interface: GerritPermission

A description in the context of an exception message.

Should be grammatical when used in the construction "not permitted: [description] on [resource]", although individual PermissionBackend implementations may vary the wording.

Specified by:

describeForException in interface GerritPermission