com.atlassian.bamboo.plugins.rest.plan.stage.job

Class JobConfigShortcutResource

java.lang.Object

com.atlassian.bamboo.plugins.rest.plan.stage.job.JobConfigShortcutResource

@ExperimentalApi
public class JobConfigShortcutResource
extends Object

Provides RESTful operations on jobs for the configuration of build plans. For operations on a specific job, we just need to specify its job key, and not the build plan and stage it belongs to. For more operations on jobs, see JobConfigResource.

Since:

5.9

Constructor Summary

Constructors

Constructor and Description
JobConfigShortcutResource(RestJobService restJobService, JobService jobService, InputParser inputParser, JobConversionFunction jobConversionFunction)

Method Summary

Modifier and Type	Method and Description
RestJob	getJob(String jobKeyString, Expansion expansion, javax.ws.rs.core.UriInfo uriInfo) Retrieves the details of a specific job of a stage of a build plan.
javax.ws.rs.core.Response	removeJob(String jobKeyString, ConfirmationToken confirmationToken, javax.ws.rs.core.UriInfo uriInfo) Deletes a specific job of a build plan.
RestJob	updateJob(String jobKeyString, ConfirmationToken confirmationToken, Expansion expansion, javax.ws.rs.core.UriInfo uriInfo, RestJob restJob) Updates a job partially, not overriding any field that it's not specified.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JobConfigShortcutResource

public JobConfigShortcutResource(RestJobService restJobService,
                                 JobService jobService,
                                 InputParser inputParser,
                                 JobConversionFunction jobConversionFunction)

Method Detail

getJob

public RestJob getJob(String jobKeyString,
                      @Context
                      Expansion expansion,
                      @Context
                      javax.ws.rs.core.UriInfo uriInfo)
               throws WebValidationException

Retrieves the details of a specific job of a stage of a build plan.

Parameters:

jobKeyString - identifier of the job to retrieve details for

expansion - represents an expansion tree of additional information we want to retrieve

Returns:

RestJob

Throws:

WebValidationException

updateJob

public RestJob updateJob(String jobKeyString,
                         @Context @Nullable
                         ConfirmationToken confirmationToken,
                         @Context
                         Expansion expansion,
                         @Context
                         javax.ws.rs.core.UriInfo uriInfo,
                         RestJob restJob)
                  throws WebValidationException

Updates a job partially, not overriding any field that it's not specified.

Parameters:

jobKeyString - identifier of the job to retrieve details for

confirmationToken - token to validate that the job being updated has not been modified in the meantime, in which case the operation would be rejected. To get this validation token see JobConfigResource.getMoveWarnings(String, long, String, long, Expansion, UriInfo). This token in optional, if not specified it won't be checked and the operation will be forced.

expansion - represents an expansion tree of additional information we want to retrieve

restJob - representation of the job to update

Returns:

RestJob

Throws:

WebValidationException - if there's validation errors, which maps into a 400 Bad Request

removeJob

public javax.ws.rs.core.Response removeJob(String jobKeyString,
                                           @Context @Nullable
                                           ConfirmationToken confirmationToken,
                                           @Context
                                           javax.ws.rs.core.UriInfo uriInfo)
                                    throws WebValidationException

Deletes a specific job of a build plan.

Parameters:

jobKeyString - identifier of the job to delete

confirmationToken - token to validate that the job being deleted has not been modified in the meantime, in which case the operation would be rejected. To get this validation token see JobConfigResource.getDeletionWarnings(String, long, String, Expansion, UriInfo). This token in optional, if not specified it won't be checked and the operation will be forced.

Returns:

Response an empty response

Throws:

WebValidationException