com.atlassian.jira.scheme

Interface SchemeManager

All Known Subinterfaces:

IssueSecuritySchemeManager, NotificationSchemeManager, PermissionSchemeManager, WorkflowSchemeManager

All Known Implementing Classes:

AbstractSchemeManager, DefaultNotificationSchemeManager, DefaultPermissionSchemeManager, DefaultWorkflowSchemeManager, EagerWorkflowSchemeManager, IssueSecuritySchemeManagerImpl, WorkflowBasedPermissionSchemeManager

public interface SchemeManager

Field Summary

Fields

Modifier and Type	Field and Description
static String	PROJECT_ASSOCIATION The one and only "association type".

Method Summary

Modifier and Type	Method and Description
void	addDefaultSchemeToProject(org.ofbiz.core.entity.GenericValue project) Deprecated. Use addDefaultSchemeToProject(com.atlassian.jira.project.Project) instead. Since v5.0.
void	addDefaultSchemeToProject(Project project) Adds the default scheme to a particular project
void	addSchemeToProject(org.ofbiz.core.entity.GenericValue project, org.ofbiz.core.entity.GenericValue scheme) Deprecated. Use addSchemeToProject(com.atlassian.jira.project.Project, Scheme) instead. Since v5.0.
void	addSchemeToProject(Project project, Scheme scheme) Adds a scheme to a particular project
org.ofbiz.core.entity.GenericValue	copyScheme(org.ofbiz.core.entity.GenericValue scheme) Deprecated. Use copyScheme(Scheme) instead. Since v5.0.
Scheme	copyScheme(Scheme scheme) Copys a scheme, giving the new scheme the same entities as the original one
org.ofbiz.core.entity.GenericValue	createDefaultScheme() Creates a default scheme, with an id of 0
org.ofbiz.core.entity.GenericValue	createScheme(String name, String description) Deprecated. Use createSchemeObject(String, String) instead. Since v5.0.
Scheme	createSchemeAndEntities(Scheme scheme)
org.ofbiz.core.entity.GenericValue	createSchemeEntity(org.ofbiz.core.entity.GenericValue scheme, SchemeEntity entity)
Scheme	createSchemeObject(String name, String description) Creates a new scheme
void	deleteEntities(Iterable<Long> ids) Deletes a collection of entities from the database.
void	deleteEntity(Long id) Deletes an entity with the given id from the database.
void	deleteScheme(Long id) Deletes a scheme from the database
List<Scheme>	getAssociatedSchemes(boolean withEntitiesComparable) Gets all schemes of this type in the database taht are associated with at least one project.
org.ofbiz.core.entity.GenericValue	getDefaultScheme() Deprecated. Use getDefaultSchemeObject() instead. Since v5.0.
Scheme	getDefaultSchemeObject() Gets the default scheme.
List<org.ofbiz.core.entity.GenericValue>	getEntities(org.ofbiz.core.entity.GenericValue scheme) Get all Scheme entity records for a particular scheme
List<org.ofbiz.core.entity.GenericValue>	getEntities(org.ofbiz.core.entity.GenericValue scheme, Long entityTypeId)
List<org.ofbiz.core.entity.GenericValue>	getEntities(org.ofbiz.core.entity.GenericValue scheme, Long entityTypeId, String parameter)
List<org.ofbiz.core.entity.GenericValue>	getEntities(org.ofbiz.core.entity.GenericValue scheme, String entityTypeId)
List<org.ofbiz.core.entity.GenericValue>	getEntities(org.ofbiz.core.entity.GenericValue scheme, String type, Long entityTypeId)
List<org.ofbiz.core.entity.GenericValue>	getEntities(String type, String parameter) Get all entity records with a particular parameter
List<org.ofbiz.core.entity.GenericValue>	getEntitiesByIds(List<Long> ids) Get all entity records for a list of ids
org.ofbiz.core.entity.GenericValue	getEntity(Long id) Gets a scheme entity based on the id of the entity
Collection<com.atlassian.crowd.embedded.api.Group>	getGroups(Long permissionId, org.ofbiz.core.entity.GenericValue project) Deprecated. Use getGroups(Long, com.atlassian.jira.project.Project) instead. Since v5.0.
Collection<com.atlassian.crowd.embedded.api.Group>	getGroups(Long permissionId, Project project)
List<Project>	getProjects(Scheme scheme) Gets all projects that are associated with that scheme
org.ofbiz.core.entity.GenericValue	getScheme(Long id) Deprecated. Use getSchemeObject(Long) instead. Since v5.0.
org.ofbiz.core.entity.GenericValue	getScheme(String name) Deprecated. use getSchemeObject(String) instead. Since 2010.
Scheme	getSchemeFor(Project project) Get the scheme of this type attached to the given project.
Long	getSchemeIdFor(Project project) Get the scheme of this type attached to the given project.
Scheme	getSchemeObject(Long id) Gets a scheme by id from the database.
Scheme	getSchemeObject(String name) Gets a scheme by name from the database.
List<Scheme>	getSchemeObjects() Gets all scheme objects in the database.
List<org.ofbiz.core.entity.GenericValue>	getSchemes() Deprecated. use getSchemeObjects(). Since 2010.
List<org.ofbiz.core.entity.GenericValue>	getSchemes(org.ofbiz.core.entity.GenericValue project) Deprecated. Use getSchemeFor(com.atlassian.jira.project.Project) instead. Since v5.0.
List<Scheme>	getUnassociatedSchemes() Will return all @link Scheme objects that are not currently associated with any projects.
Collection<ApplicationUser>	getUsers(Long permissionId, org.ofbiz.core.entity.GenericValue issueOrProject) Deprecated. Use getUsers(Long, com.atlassian.jira.permission.PermissionContext) instead. Since 2006.
Collection<ApplicationUser>	getUsers(Long permissionId, Issue issue)
Collection<ApplicationUser>	getUsers(Long permissionId, PermissionContext ctx)
Collection<ApplicationUser>	getUsers(Long permissionId, Project project)
boolean	removeEntities(org.ofbiz.core.entity.GenericValue scheme, Long entityTypeId) Deprecated. Use getEntities(org.ofbiz.core.entity.GenericValue, Long) and deleteEntity(Long) instead. Since v5.0.
boolean	removeEntities(String type, String parameter) Removes all scheme entities with this parameter and type
void	removeSchemesFromProject(org.ofbiz.core.entity.GenericValue project) Deprecated. Use removeSchemesFromProject(com.atlassian.jira.project.Project) instead. Since v4.4.
void	removeSchemesFromProject(Project project) Removes all schemes from a project
boolean	schemeExists(String name) Determine if the given scheme name exists.
void	swapParameterForEntitiesOfType(String type, String parameter, String resultingParameter) Swaps all parameters of entities with the given type scheme to the given resulting parameter
void	updateScheme(org.ofbiz.core.entity.GenericValue entity) Deprecated. Use updateScheme(Scheme) instead. Since v5.0.
void	updateScheme(Scheme scheme) Updates any changes to the scheme object.

Field Detail

PROJECT_ASSOCIATION

static final String PROJECT_ASSOCIATION

The one and only "association type".

See Also:

Constant Field Values

Method Detail

getScheme

org.ofbiz.core.entity.GenericValue getScheme(Long id)
                                      throws org.ofbiz.core.entity.GenericEntityException

Deprecated. Use getSchemeObject(Long) instead. Since v5.0.

Gets a scheme based on the Id of the scheme

Parameters:

id - Id of the scheme

Returns:

The scheme

Throws:

org.ofbiz.core.entity.GenericEntityException - DB Error

getSchemeObject

Scheme getSchemeObject(Long id)
                throws DataAccessException

Gets a scheme by id from the database.

Parameters:

id - the id of the scheme to get.

Returns:

the Scheme

Throws:

DataAccessException - if there is trouble retrieving from the database.

getSchemes

List<org.ofbiz.core.entity.GenericValue> getSchemes()
                                             throws org.ofbiz.core.entity.GenericEntityException

Deprecated. use getSchemeObjects(). Since 2010.

Gets all the Schemes (of the type defined by the subclass) from the database.

Returns:

the schemes.

Throws:

org.ofbiz.core.entity.GenericEntityException - DB Error

getSchemeObjects

List<Scheme> getSchemeObjects()
                       throws DataAccessException

Gets all scheme objects in the database.

Returns:

the schemes.

Throws:

DataAccessException - if the database is down or equivalent.

getAssociatedSchemes

List<Scheme> getAssociatedSchemes(boolean withEntitiesComparable)

Gets all schemes of this type in the database taht are associated with at least one project.

Parameters:

withEntitiesComparable - if true then the scheme entites will be logically comparable (they will not include database specific information such as the pk id). Otherwise the object will be a full representation of the row stored in the database.

Returns:

List of associated schemes

getScheme

org.ofbiz.core.entity.GenericValue getScheme(String name)
                                      throws org.ofbiz.core.entity.GenericEntityException

Deprecated. use getSchemeObject(String) instead. Since 2010.

Gets a scheme by name from the database.

Parameters:

name - the name of the scheme to get.

Returns:

the Scheme

Throws:

org.ofbiz.core.entity.GenericEntityException - DB error

getSchemeObject

Scheme getSchemeObject(String name)
                throws DataAccessException

Gets a scheme by name from the database.

Parameters:

name - the name of the scheme to get.

Returns:

the Scheme

Throws:

DataAccessException - if there is trouble retrieving from the database.

getSchemes

List<org.ofbiz.core.entity.GenericValue> getSchemes(org.ofbiz.core.entity.GenericValue project)
                                             throws org.ofbiz.core.entity.GenericEntityException

Deprecated. Use getSchemeFor(com.atlassian.jira.project.Project) instead. Since v5.0.

Get all schemes of this type attached to the given project.

Parameters:

project - The project that the schemes are attached to

Returns:

List of schemes

Throws:

org.ofbiz.core.entity.GenericEntityException - If a DB error occurs

getSchemeFor

@Nullable
Scheme getSchemeFor(Project project)

Get the scheme of this type attached to the given project.

Parameters:

project - The project

Returns:

The scheme associated with this project.

See Also:

getSchemeIdFor(Project)

getSchemeIdFor

@Nullable
Long getSchemeIdFor(Project project)

Get the scheme of this type attached to the given project.

Parameters:

project - The project

Returns:

The ID of the scheme associated with this project.

Since:

6.4

See Also:

getSchemeFor(Project)

schemeExists

boolean schemeExists(String name)
              throws org.ofbiz.core.entity.GenericEntityException

Determine if the given scheme name exists.

Parameters:

name - The name of the scheme

Returns:

true is the schem exists.

Throws:

org.ofbiz.core.entity.GenericEntityException - If a DB error occurs

createScheme

@Deprecated
org.ofbiz.core.entity.GenericValue createScheme(String name,
                                                            String description)
                                                     throws org.ofbiz.core.entity.GenericEntityException

Deprecated. Use createSchemeObject(String, String) instead. Since v5.0.

Creates a new scheme

Parameters:

name - The name of the new scheme

description - The description of the new scheme

Returns:

The new scheme object

Throws:

org.ofbiz.core.entity.GenericEntityException - If a DB error occurs

createSchemeObject

Scheme createSchemeObject(String name,
                          String description)

Creates a new scheme

Parameters:

name - The name of the new scheme

description - The description of the new scheme

Returns:

The new scheme object

createSchemeAndEntities

Scheme createSchemeAndEntities(Scheme scheme)
                        throws DataAccessException

Throws:

DataAccessException

getEntity

org.ofbiz.core.entity.GenericValue getEntity(Long id)
                                      throws org.ofbiz.core.entity.GenericEntityException

Gets a scheme entity based on the id of the entity

Parameters:

id - The id of the entity

Returns:

The scheme entity object

Throws:

org.ofbiz.core.entity.GenericEntityException - If a DB error occurs

getEntities

List<org.ofbiz.core.entity.GenericValue> getEntities(org.ofbiz.core.entity.GenericValue scheme)
                                              throws org.ofbiz.core.entity.GenericEntityException

Get all Scheme entity records for a particular scheme

Parameters:

scheme - The scheme that the entities belong to

Returns:

List of (GenericValue) entities

Throws:

org.ofbiz.core.entity.GenericEntityException - If a DB error occurs

getEntities

List<org.ofbiz.core.entity.GenericValue> getEntities(org.ofbiz.core.entity.GenericValue scheme,
                                                     Long entityTypeId)
                                              throws org.ofbiz.core.entity.GenericEntityException

Throws:

org.ofbiz.core.entity.GenericEntityException

getEntities

List<org.ofbiz.core.entity.GenericValue> getEntities(org.ofbiz.core.entity.GenericValue scheme,
                                                     String entityTypeId)
                                              throws org.ofbiz.core.entity.GenericEntityException

Throws:

org.ofbiz.core.entity.GenericEntityException

getEntities

List<org.ofbiz.core.entity.GenericValue> getEntities(org.ofbiz.core.entity.GenericValue scheme,
                                                     Long entityTypeId,
                                                     String parameter)
                                              throws org.ofbiz.core.entity.GenericEntityException

Throws:

org.ofbiz.core.entity.GenericEntityException

getEntities

List<org.ofbiz.core.entity.GenericValue> getEntities(org.ofbiz.core.entity.GenericValue scheme,
                                                     String type,
                                                     Long entityTypeId)
                                              throws org.ofbiz.core.entity.GenericEntityException

Throws:

org.ofbiz.core.entity.GenericEntityException

updateScheme

void updateScheme(org.ofbiz.core.entity.GenericValue entity)
           throws org.ofbiz.core.entity.GenericEntityException

Deprecated. Use updateScheme(Scheme) instead. Since v5.0.

Updates any changes to the given scheme

Parameters:

entity - The modified scheme

Throws:

org.ofbiz.core.entity.GenericEntityException - If a DB error occurs

updateScheme

void updateScheme(Scheme scheme)

Updates any changes to the scheme object. This does not include changes to the scheme entities.

Parameters:

scheme - The modified scheme object

deleteScheme

void deleteScheme(Long id)
           throws org.ofbiz.core.entity.GenericEntityException

Deletes a scheme from the database

Parameters:

id - Id of the scheme to be deleted

Throws:

org.ofbiz.core.entity.GenericEntityException - If a DB error occurs

addSchemeToProject

void addSchemeToProject(org.ofbiz.core.entity.GenericValue project,
                        org.ofbiz.core.entity.GenericValue scheme)
                 throws org.ofbiz.core.entity.GenericEntityException

Deprecated. Use addSchemeToProject(com.atlassian.jira.project.Project, Scheme) instead. Since v5.0.

Adds a scheme to a particular project

Parameters:

project - The project that the scheme is to be added to

scheme - The scheme to be added

Throws:

org.ofbiz.core.entity.GenericEntityException - If a DB error occurs

addSchemeToProject

void addSchemeToProject(Project project,
                        Scheme scheme)

Adds a scheme to a particular project

Parameters:

project - The project that the scheme is to be added to

scheme - The scheme to be added

removeSchemesFromProject

void removeSchemesFromProject(org.ofbiz.core.entity.GenericValue project)
                       throws org.ofbiz.core.entity.GenericEntityException

Deprecated. Use removeSchemesFromProject(com.atlassian.jira.project.Project) instead. Since v4.4.

Removes all schemes from a project

Parameters:

project - The project that all schemes are to be deleted from

Throws:

org.ofbiz.core.entity.GenericEntityException - If a DB error occurs

removeSchemesFromProject

void removeSchemesFromProject(Project project)

Removes all schemes from a project

Parameters:

project - The project that all schemes are to be deleted from

createSchemeEntity

org.ofbiz.core.entity.GenericValue createSchemeEntity(org.ofbiz.core.entity.GenericValue scheme,
                                                      SchemeEntity entity)
                                               throws org.ofbiz.core.entity.GenericEntityException

Throws:

org.ofbiz.core.entity.GenericEntityException

deleteEntity

void deleteEntity(Long id)
           throws org.ofbiz.core.entity.GenericEntityException

Deletes an entity with the given id from the database.

Parameters:

id - The id of the entity to be deleted

Throws:

org.ofbiz.core.entity.GenericEntityException - If a DB error occurs

deleteEntities

void deleteEntities(Iterable<Long> ids)

Deletes a collection of entities from the database.

Parameters:

ids - a collection entity ids to be deleted.

Throws:

org.ofbiz.core.entity.GenericEntityException

getProjects

List<Project> getProjects(Scheme scheme)

Gets all projects that are associated with that scheme

Parameters:

scheme - The scheme used to get all projects

Returns:

List of Project's

createDefaultScheme

org.ofbiz.core.entity.GenericValue createDefaultScheme()
                                                throws org.ofbiz.core.entity.GenericEntityException

Creates a default scheme, with an id of 0

Returns:

The new permission scheme object

Throws:

org.ofbiz.core.entity.GenericEntityException - If a DB error occurs

getDefaultScheme

org.ofbiz.core.entity.GenericValue getDefaultScheme()
                                             throws org.ofbiz.core.entity.GenericEntityException

Deprecated. Use getDefaultSchemeObject() instead. Since v5.0.

Gets the default scheme. This should have an id of 0

This does not work for the Default Notification scheme as it does not have an id of 0.

Returns:

The default scheme

Throws:

org.ofbiz.core.entity.GenericEntityException - If a DB error occurs

getDefaultSchemeObject

Scheme getDefaultSchemeObject()

Gets the default scheme. This should have an id of 0

This does not work for the Default Notification scheme as it does not have an id of 0.

Returns:

The default scheme

addDefaultSchemeToProject

void addDefaultSchemeToProject(org.ofbiz.core.entity.GenericValue project)
                        throws org.ofbiz.core.entity.GenericEntityException

Deprecated. Use addDefaultSchemeToProject(com.atlassian.jira.project.Project) instead. Since v5.0.

Adds the default scheme to a particular project

Parameters:

project - The project that the scheme is to be added to

Throws:

org.ofbiz.core.entity.GenericEntityException - If a DB error occurs

addDefaultSchemeToProject

void addDefaultSchemeToProject(Project project)

Adds the default scheme to a particular project

Parameters:

project - The project that the scheme is to be added to

copyScheme

org.ofbiz.core.entity.GenericValue copyScheme(org.ofbiz.core.entity.GenericValue scheme)
                                       throws org.ofbiz.core.entity.GenericEntityException

Deprecated. Use copyScheme(Scheme) instead. Since v5.0.

Copys a scheme, giving the new scheme the same entities as the original one

Parameters:

scheme - The permission scheme to be copied

Returns:

The new permission scheme

Throws:

org.ofbiz.core.entity.GenericEntityException - If a DB error occurs

copyScheme

Scheme copyScheme(Scheme scheme)

Copys a scheme, giving the new scheme the same entities as the original one

Parameters:

scheme - The permission scheme to be copied

Returns:

The new permission scheme

removeEntities

boolean removeEntities(org.ofbiz.core.entity.GenericValue scheme,
                       Long entityTypeId)
                throws RemoveException

Deprecated. Use getEntities(org.ofbiz.core.entity.GenericValue, Long) and deleteEntity(Long) instead. Since v5.0.

Retrieves all the entites for this permission and then removes them.

Parameters:

scheme - to remove entites from must NOT be null

entityTypeId - to remove

Returns:

True all the time (legacy)

Throws:

RemoveException - if the delete fails (DB error)

getEntities

List<org.ofbiz.core.entity.GenericValue> getEntities(String type,
                                                     String parameter)
                                              throws org.ofbiz.core.entity.GenericEntityException

Get all entity records with a particular parameter

Parameters:

type - The type of entity you wish to retrieve, eg 'user', 'group', 'projectrole'

parameter - The parameter in the entity

Returns:

List of (GenericValue) entities

Throws:

org.ofbiz.core.entity.GenericEntityException - If a DB error occurs

removeEntities

boolean removeEntities(String type,
                       String parameter)
                throws RemoveException

Removes all scheme entities with this parameter and type

Parameters:

type - the 'type' of entity you are deleting, eg 'group', 'user', 'projectrole'

parameter - must NOT be null

Returns:

true always (legacy)

Throws:

RemoveException - if the delete fails (DB error)

swapParameterForEntitiesOfType

void swapParameterForEntitiesOfType(String type,
                                    String parameter,
                                    String resultingParameter)

Swaps all parameters of entities with the given type scheme to the given resulting parameter

Parameters:

type - the 'type' of entity you are swapping, eg 'group', 'user', 'projectrole'

parameter - must NOT be null

Throws:

RemoveException - if the swap fails (DB error)

getGroups

Collection<com.atlassian.crowd.embedded.api.Group> getGroups(Long permissionId,
                                                             org.ofbiz.core.entity.GenericValue project)

Deprecated. Use getGroups(Long, com.atlassian.jira.project.Project) instead. Since v5.0.

getGroups

Collection<com.atlassian.crowd.embedded.api.Group> getGroups(Long permissionId,
                                                             Project project)

getUsers

Collection<ApplicationUser> getUsers(Long permissionId,
                                     Project project)

getUsers

Collection<ApplicationUser> getUsers(Long permissionId,
                                     Issue issue)

getUsers

@Deprecated
Collection<ApplicationUser> getUsers(Long permissionId,
                                                 org.ofbiz.core.entity.GenericValue issueOrProject)

Deprecated. Use getUsers(Long, com.atlassian.jira.permission.PermissionContext) instead. Since 2006.

getUsers

Collection<ApplicationUser> getUsers(Long permissionId,
                                     PermissionContext ctx)

getUnassociatedSchemes

List<Scheme> getUnassociatedSchemes()
                             throws DataAccessException

Will return all @link Scheme objects that are not currently associated with any projects.

Returns:

list of @link Scheme objects

Throws:

DataAccessException - if the database is down or equivalent.

getEntitiesByIds

List<org.ofbiz.core.entity.GenericValue> getEntitiesByIds(List<Long> ids)

Get all entity records for a list of ids

Parameters:

ids - a collection of entity ids that should be retrieved

Returns:

List of (GenericValue) entities - can be an empty list if no entities match the given ids