com.atlassian.bamboo.project

Interface ProjectConfigurationService

All Known Implementing Classes:

ProjectConfigurationServiceImpl

public interface ProjectConfigurationService

Utility service for seamless configuration of projects.

Since:

6.2

Method Summary

Modifier and Type	Method and Description
default Project	createProject(String projectKey, String projectName, String projectDescription) Deprecated. since 6.9.0. Use createProject(String, String, String, boolean)
Project	createProject(String projectKey, String projectName, String projectDescription, boolean grantAllUsersReadAccess) Creates and persists a new Project, throwing an exception on invalid data.
void	markProjectForDeletion(Project project) Marks a project for deletion.
void	updateProject(Project project, String projectName, String projectDescription) Updates and persists changes for an existing Project, throwing exception on invalid data.
ErrorCollection	validateProjectForCreation(String projectKey, String projectName, String projectDescription) Perform validation of data for creation of a new Project.
ErrorCollection	validateProjectForCreation(String projectKeyField, String projectKey, String projectNameField, String projectName, String projectDescriptionField, String projectDescription) Perform validation of data for creation of a new Project.
ErrorCollection	validateProjectForUpdate(String projectKey, String projectName, String projectDescription) Perform validation of data for updating details of an existing Project.
ErrorCollection	validateProjectForUpdate(String projectKey, String projectNameField, String projectName, String projectDescriptionField, String projectDescription) Perform validation of data for updating details of an existing Project.

Method Detail

validateProjectForCreation

@NotNull
ErrorCollection validateProjectForCreation(@Nullable
                                                    String projectKey,
                                                    @Nullable
                                                    String projectName,
                                                    @Nullable
                                                    String projectDescription)

Perform validation of data for creation of a new Project.

Parameters:

projectKey - key of the project

projectName - project name

projectDescription - project description

Returns:

collection of all validation errors, empty if validation was successful

validateProjectForCreation

@NotNull
ErrorCollection validateProjectForCreation(@NotNull
                                                    String projectKeyField,
                                                    @Nullable
                                                    String projectKey,
                                                    @NotNull
                                                    String projectNameField,
                                                    @Nullable
                                                    String projectName,
                                                    @NotNull
                                                    String projectDescriptionField,
                                                    @Nullable
                                                    String projectDescription)

Perform validation of data for creation of a new Project.

This is a more specific version of validateProjectForCreation(String, String, String), allowing configuration of field names to generate more accurate ErrorCollection.

Parameters:

projectKeyField - field used to configure project key

projectKey - key of the project

projectNameField - field used to configure project name

projectName - project name

projectDescriptionField - field used to configure project description

projectDescription - project description

Returns:

collection of all validation errors, empty if validation was successful

createProject

@NotNull
 @Deprecated
default Project createProject(@NotNull
                                                    String projectKey,
                                                    @NotNull
                                                    String projectName,
                                                    @Nullable
                                                    String projectDescription)
                                             throws WebValidationException

Deprecated. since 6.9.0. Use createProject(String, String, String, boolean)

Creates and persists a new Project, throwing an exception on invalid data. Prior to calling this method data should be validated by calling validateProjectForCreation(String, String, String).

Parameters:

projectKey - key of the project

projectName - project name

projectDescription - project description

Returns:

new instance of the project, after persisting it to the database

Throws:

WebValidationException - in case of validation errors

createProject

@NotNull
Project createProject(@NotNull
                               String projectKey,
                               @NotNull
                               String projectName,
                               @Nullable
                               String projectDescription,
                               boolean grantAllUsersReadAccess)
                        throws WebValidationException

Creates and persists a new Project, throwing an exception on invalid data. Prior to calling this method data should be validated by calling validateProjectForCreation(String, String, String).

Parameters:

projectKey - key of the project

projectName - project name

projectDescription - project description

grantAllUsersReadAccess - grant anonymous and logged-in users READ permissions

Returns:

new instance of the project, after persisting it to the database

Throws:

WebValidationException - in case of validation errors

validateProjectForUpdate

@NotNull
ErrorCollection validateProjectForUpdate(@NotNull
                                                  String projectKey,
                                                  @Nullable
                                                  String projectName,
                                                  @Nullable
                                                  String projectDescription)

Perform validation of data for updating details of an existing Project.

Parameters:

projectKey - key of the project

projectName - new project name

projectDescription - new project description

Returns:

collection of all validation errors, empty if validation was successful

validateProjectForUpdate

@NotNull
ErrorCollection validateProjectForUpdate(@NotNull
                                                  String projectKey,
                                                  @NotNull
                                                  String projectNameField,
                                                  @Nullable
                                                  String projectName,
                                                  @NotNull
                                                  String projectDescriptionField,
                                                  @Nullable
                                                  String projectDescription)

Perform validation of data for updating details of an existing Project.

This is a more specific version of validateProjectForUpdate(String, String, String), allowing configuration of field names to generate more accurate ErrorCollection.

Parameters:

projectKey - key of the project

projectNameField - field used to configure project name

projectName - new project name

projectDescriptionField - field used to configure project description

projectDescription - new project description

Returns:

collection of all validation errors, empty if validation was successful

updateProject

void updateProject(@NotNull
                   Project project,
                   @NotNull
                   String projectName,
                   @Nullable
                   String projectDescription)
            throws WebValidationException

Updates and persists changes for an existing Project, throwing exception on invalid data. Prior to calling this method data should be validated by calling validateProjectForUpdate(String, String, String).

Parameters:

project - project to update

projectName - new project name

projectDescription - new project description

Throws:

WebValidationException - in case of validation errors

markProjectForDeletion

void markProjectForDeletion(@NotNull
                            Project project)
                     throws IllegalStateException

Marks a project for deletion. Project will be deleted from the database according to background deletion schedule. Project must be empty prior to calling this method (there can't be any plans within the project that are not marked for deletion).

Parameters:

project - project to delete

Throws:

IllegalStateException - in case of illegal state of the project