com.atlassian.bamboo.plugins.rest.service

Interface PlanRestService

All Known Implementing Classes:

PlanRestServiceImpl

public interface PlanRestService

Method Summary

Modifier and Type	Method and Description
void	assertPlanExistsAndVisible(PlanKey planKey) Checks if Plan exists and is visible for calling user
void	assertPlanExistsAndVisible(PlanKey planKey, Class<? extends ImmutablePlan> clazz) Checks if Plan exists, has correct type and is visible for calling user
RestBranchLatestActive	createLatestActiveBranchResult(ImmutablePlan branch)
RestPlanBranchList	createPaginatedBranchResponse(List<? extends ImmutablePlan> branches, com.atlassian.user.User user, javax.ws.rs.core.UriInfo uriInfo, boolean allBranches)
RestPlans	createPaginatedPlanResponse(List<? extends ImmutablePlan> plans, com.atlassian.user.User user, javax.ws.rs.core.UriInfo uriInfo)
ImmutablePlan	getBranchByName(ImmutablePlan plan, String branchName) Get branch of a given plan by name.
List<ImmutableChainBranch>	getBranchesForChain(ImmutablePlan plan)
List<ImmutableJob>	getBranchesForJob(ImmutableJob job)
ImmutableChain	getChainByKey(PlanKey planKey) Returns a Plan if plan exists and is visible for calling user
List<ImmutableJob>	getJobsForPlan(PlanKey planKey, javax.ws.rs.core.UriInfo uriInfo, com.atlassian.plugins.rest.common.security.AuthenticationContext authenticationContext) Get a list of jobs of specified plan.
ImmutablePlan	getPlanByKey(PlanKey planKey) Returns a Plan if plan exists and is visible for calling user
ImmutablePlan	getPlanByKeyUnchecked(PlanKey planKey) Returns a Plan if plan exists.
<T extends ImmutablePlan> List<T>	getPlans(Class<T> planType, javax.ws.rs.core.UriInfo uriInfo, com.atlassian.plugins.rest.common.security.AuthenticationContext authenticationContext) Get a list of plans.
List<ImmutablePlan>	getPlans(javax.ws.rs.core.UriInfo uriInfo, com.atlassian.plugins.rest.common.security.AuthenticationContext authenticationContext) Get a list of plans.
List<ImmutablePlan>	getPlansByProject(Project project, javax.ws.rs.core.UriInfo uriInfo) Get a list of plans that belong to a project.
List<ImmutablePlan>	getPlansByProject(Project project, javax.ws.rs.core.UriInfo uriInfo, com.atlassian.plugins.rest.common.security.AuthenticationContext authenticationContext) Get a list of plans that belong to a project.
List<ImmutablePlan>	getRunnablePlans(Project project, javax.ws.rs.core.UriInfo uriInfo) Get a list of plans that can be run currently logged in user.
List<ImmutableChainStage>	getStagesForPlan(PlanKey planKey, javax.ws.rs.core.UriInfo uriInfo, com.atlassian.plugins.rest.common.security.AuthenticationContext authenticationContext) Get a list of stages of specified plan.
boolean	isPlanCreationAllowed() Check whether or not a plan can be created or not (based on licensing etc)

Method Detail

getBranchesForChain

List<ImmutableChainBranch> getBranchesForChain(ImmutablePlan plan)

getBranchesForJob

List<ImmutableJob> getBranchesForJob(ImmutableJob job)

createPaginatedBranchResponse

RestPlanBranchList createPaginatedBranchResponse(List<? extends ImmutablePlan> branches,
                                                 @Nullable
                                                 com.atlassian.user.User user,
                                                 javax.ws.rs.core.UriInfo uriInfo,
                                                 boolean allBranches)

Parameters:

branches -

user -

uriInfo -

allBranches - return all branches, even if expand has 'favourites' parameter. This is because 'favourites' is about plans not branches and all branches of a favourite plan are to be shown

Returns:

filtered list of branches

createLatestActiveBranchResult

@Nullable
RestBranchLatestActive createLatestActiveBranchResult(ImmutablePlan branch)

getBranchByName

@Nullable
ImmutablePlan getBranchByName(@NotNull
                                        ImmutablePlan plan,
                                        @NotNull
                                        String branchName)

Get branch of a given plan by name. If passed plan is Chain method will look after properly named chain branch. If passed plan is a Job method will look after corresponding job in a found chain branch.

Parameters:

plan - plan

branchName - name of the branch to be fetched

Returns:

ImmutableChainBranch, ImmutableJob or null if not found

createPaginatedPlanResponse

RestPlans createPaginatedPlanResponse(List<? extends ImmutablePlan> plans,
                                      @Nullable
                                      com.atlassian.user.User user,
                                      javax.ws.rs.core.UriInfo uriInfo)

getPlans

List<ImmutablePlan> getPlans(@NotNull
                             javax.ws.rs.core.UriInfo uriInfo,
                             @NotNull
                             com.atlassian.plugins.rest.common.security.AuthenticationContext authenticationContext)

Get a list of plans. This method provides filtering using the following query params:

favourite

if specified return only favourite plans

permission

if specified return only plans that user has this specific permission for

type

if specifies return only plans of specified type

Parameters:

uriInfo -

authenticationContext -

Returns:

Filtered list of plans belonging to a project.

getPlans

<T extends ImmutablePlan> List<T> getPlans(Class<T> planType,
                                           @NotNull
                                           javax.ws.rs.core.UriInfo uriInfo,
                                           @NotNull
                                           com.atlassian.plugins.rest.common.security.AuthenticationContext authenticationContext)

Get a list of plans. This method provides filtering using the following query params:

favourite

if specified return only favourite plans

permission

if specified return only plans that user has this specific permission for

Parameters:

planType - type of plans

uriInfo -

authenticationContext -

Returns:

Filtered list of plans belonging to a project.

getJobsForPlan

List<ImmutableJob> getJobsForPlan(@NotNull
                                  PlanKey planKey,
                                  @NotNull
                                  javax.ws.rs.core.UriInfo uriInfo,
                                  @NotNull
                                  com.atlassian.plugins.rest.common.security.AuthenticationContext authenticationContext)

Get a list of jobs of specified plan.

Parameters:

planKey - planKey

uriInfo -

authenticationContext -

Returns:

Filtered list of jobs belonging to a plan.

getStagesForPlan

List<ImmutableChainStage> getStagesForPlan(@NotNull
                                           PlanKey planKey,
                                           @NotNull
                                           javax.ws.rs.core.UriInfo uriInfo,
                                           @NotNull
                                           com.atlassian.plugins.rest.common.security.AuthenticationContext authenticationContext)

Get a list of stages of specified plan.

Parameters:

planKey - planKey

uriInfo -

authenticationContext -

Returns:

Filtered list of stages belonging to a plan.

getPlansByProject

List<ImmutablePlan> getPlansByProject(@NotNull
                                      Project project,
                                      @NotNull
                                      javax.ws.rs.core.UriInfo uriInfo)

Get a list of plans that belong to a project.

Parameters:

project -

uriInfo -

Returns:

Filtered list of plans belonging to a project.

getPlansByProject

List<ImmutablePlan> getPlansByProject(@NotNull
                                      Project project,
                                      @NotNull
                                      javax.ws.rs.core.UriInfo uriInfo,
                                      @NotNull
                                      com.atlassian.plugins.rest.common.security.AuthenticationContext authenticationContext)

Get a list of plans that belong to a project. This method provides favourite filtering.

Parameters:

project -

uriInfo -

authenticationContext -

Returns:

Filtered list of plans belonging to a project.

getRunnablePlans

List<ImmutablePlan> getRunnablePlans(@NotNull
                                     Project project,
                                     @NotNull
                                     javax.ws.rs.core.UriInfo uriInfo)

Get a list of plans that can be run currently logged in user.

Parameters:

project -

uriInfo -

Returns:

A list of plans that the current user can run.

assertPlanExistsAndVisible

void assertPlanExistsAndVisible(@NotNull
                                PlanKey planKey)

Checks if Plan exists and is visible for calling user

Parameters:

planKey -

Throws:

NotFoundException, - AccessDeniedException

assertPlanExistsAndVisible

void assertPlanExistsAndVisible(@NotNull
                                PlanKey planKey,
                                @NotNull
                                Class<? extends ImmutablePlan> clazz)

Checks if Plan exists, has correct type and is visible for calling user

Parameters:

planKey -

clazz -

Throws:

NotFoundException, - AccessDeniedException

getChainByKey

@NotNull
ImmutableChain getChainByKey(@NotNull
                                      PlanKey planKey)

Returns a Plan if plan exists and is visible for calling user

Parameters:

planKey -

Returns:

the chain matching the given planKey

Throws:

NotFoundException, - AccessDeniedException

getPlanByKey

@NotNull
ImmutablePlan getPlanByKey(@NotNull
                                    PlanKey planKey)

Returns a Plan if plan exists and is visible for calling user

Parameters:

planKey - key of a plan to search for

Returns:

ImmutablePlan

Throws:

NotFoundException - when plan was not found

org.acegisecurity.AccessDeniedException - when authenticated user has no permission to the plan

getPlanByKeyUnchecked

@Nullable
ImmutablePlan getPlanByKeyUnchecked(@NotNull
                                              PlanKey planKey)

Returns a Plan if plan exists. No permission check is performed.

Parameters:

planKey - key of a plan to search for

Returns:

ImmutablePlan or null if not found

isPlanCreationAllowed

boolean isPlanCreationAllowed()

Check whether or not a plan can be created or not (based on licensing etc)

Returns:

true if a plan can be created otherwise false;