com.atlassian.bamboo.plugins.script.task.export

Class ScriptTaskExporter

java.lang.Object

com.atlassian.bamboo.plugins.script.task.export.ScriptTaskExporter

All Implemented Interfaces:

TaskDefinitionExporter

public class ScriptTaskExporter
extends Object
implements TaskDefinitionExporter

Constructor Summary

Constructors

Constructor and Description
ScriptTaskExporter()

Method Summary

Modifier and Type	Method and Description
com.atlassian.bamboo.specs.builders.task.ScriptTask	fromYaml(Node node, TaskValidationContext context) Parse YAML node to Task Specs builder.
com.atlassian.bamboo.specs.builders.task.ScriptTask	toSpecsEntity(TaskDefinition taskDefinition) Create Bamboo Specs object representing this task.
Map<String,String>	toTaskConfiguration(TaskContainer taskContainer, com.atlassian.bamboo.specs.api.model.task.TaskProperties taskProperties) Converts properties to Bamboo task configuration.
<T extends com.atlassian.bamboo.specs.api.model.task.TaskProperties> Node	toYaml(T genericTaskProperties) Convert task definition to YAML node.
List<com.atlassian.bamboo.specs.api.validators.common.ValidationProblem>	validate(TaskValidationContext taskValidationContext, com.atlassian.bamboo.specs.api.model.task.TaskProperties taskProperties) Validates task properties in context of enclosing plan or deployment properties.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.atlassian.bamboo.task.export.TaskDefinitionExporter

toSpecsEntity, toTaskConfiguration, toTaskConfiguration

Constructor Detail

ScriptTaskExporter

public ScriptTaskExporter()

Method Detail

toTaskConfiguration

@NotNull
public Map<String,String> toTaskConfiguration(@NotNull
                                                       TaskContainer taskContainer,
                                                       @NotNull
                                                       com.atlassian.bamboo.specs.api.model.task.TaskProperties taskProperties)

Description copied from interface: TaskDefinitionExporter

Converts properties to Bamboo task configuration. Can use all Bamboo server side services and can access DB if necessary. Should throw a runtime exception if conversion fails.

Specified by:

toTaskConfiguration in interface TaskDefinitionExporter

Parameters:

taskContainer - current task container (a job or an environment for instance)

taskProperties - the current task

Returns:

task configuration

toSpecsEntity

@NotNull
public com.atlassian.bamboo.specs.builders.task.ScriptTask toSpecsEntity(@NotNull
                                                                                  TaskDefinition taskDefinition)

Description copied from interface: TaskDefinitionExporter

Create Bamboo Specs object representing this task. Implementors don't need to handle common task properties like e.g. enabled/disabled, but must task specific configuration.

Specified by:

toSpecsEntity in interface TaskDefinitionExporter

validate

@NotNull
public List<com.atlassian.bamboo.specs.api.validators.common.ValidationProblem> validate(@NotNull
                                                                                                  TaskValidationContext taskValidationContext,
                                                                                                  @NotNull
                                                                                                  com.atlassian.bamboo.specs.api.model.task.TaskProperties taskProperties)

Description copied from interface: TaskDefinitionExporter

Validates task properties in context of enclosing plan or deployment properties. Should check for any inconsistencies between task definition and the rest of plan or deployment content, as it is provided in the validation context. Returns list of validation errors or empty if everything is ok.

Should check RSS permissions if necessary.

Specified by:

validate in interface TaskDefinitionExporter

toYaml

@Nullable
public <T extends com.atlassian.bamboo.specs.api.model.task.TaskProperties> Node toYaml(@NotNull
                                                                                                  T genericTaskProperties)

Description copied from interface: TaskDefinitionExporter

Convert task definition to YAML node. Bamboo might modify returned node to add information about task conditions or other general task settings. To make it compatible with future versions returned value should be StringNode or MapNode (String, Map). Structure MapNode (String, String) can't be enriched with additional elements and cause runtime failures for some cases.

Specified by:

toYaml in interface TaskDefinitionExporter

Returns:

YAML representation of the task.

fromYaml

@Nullable
public com.atlassian.bamboo.specs.builders.task.ScriptTask fromYaml(@NotNull
                                                                              Node node,
                                                                              @NotNull
                                                                              TaskValidationContext context)

Description copied from interface: TaskDefinitionExporter

Parse YAML node to Task Specs builder.

Specified by:

fromYaml in interface TaskDefinitionExporter

Parameters:

node - YAML node from user input. In general case it's same node generated by TaskDefinitionExporter.toYaml(TaskProperties) method, but in some cases it might contain additional general task elements, like conditions. These elements should be ignored by method implementation and will be handled by Bamboo code. In such case MapNode handler should be implemented even if TaskDefinitionExporter.toYaml(TaskProperties) produces StringNode.

context - task validation context