com.atlassian.bamboo.build.artifact.handlers

Interface ArtifactHandlerConfigurator

All Superinterfaces:

BambooPluginModule, InitablePluginModule<ArtifactHandlerModuleDescriptor>

All Known Implementing Classes:

AbstractArtifactHandlerConfigurator, AgentLocalArtifactHandlerConfigurator, BambooRemoteArtifactHandlerConfigurator, S3ArtifactHandlerConfigurator, ServerLocalArtifactHandlerConfigurator

@Internal
public interface ArtifactHandlerConfigurator
extends InitablePluginModule<ArtifactHandlerModuleDescriptor>

Configurator for a ArtifactHandler.

Method Summary

Modifier and Type	Method and Description
MessageCollection	beforeSave(Map<String,String> artifactHandlersConfigurationBeforeSave, Map<String,String> existingArtifactHandlersConfiguration) Pre save action handler, allows to gather feedback from configurator before artifact handler configuration saving.
void	decorateConfigurationForRuntime(Map<String,String> artifactHandlersConfiguration) Decorate artifact handlers configuration for runtime.
Map<String,String>	getArtifactHandlerConfiguration(Map<String,String> configuration) Filter out configuration of the artifact handler from the given map.
Map<String,String>	getEncryptedArtifactHandlerConfiguration(Map<String,String> configuration) Filter out configuration of the artifact handler from the given map and encrypt sensitive field values.
boolean	isConfigurationComplete(Map<String,String> artifactHandlersConfiguration) Validate if configuration of the artifact handler is complete
void	populateContextForEdit(Map<String,Object> context)
void	postProcessConfiguration(ActionParametersMap actionParametersMap) Any configuration adjustments that need to happen before configuration is saved should be done here.
void	validateConfiguration(Map<String,String> newArtifactHandlersConfiguration, Map<String,String> oldArtifactHandlersConfiguration, ErrorCollection errorCollection) Validate configuration.

Methods inherited from interface com.atlassian.bamboo.plugin.InitablePluginModule

init

Method Detail

populateContextForEdit

void populateContextForEdit(@NotNull
                            Map<String,Object> context)

postProcessConfiguration

void postProcessConfiguration(ActionParametersMap actionParametersMap)

Any configuration adjustments that need to happen before configuration is saved should be done here.

decorateConfigurationForRuntime

void decorateConfigurationForRuntime(@NotNull
                                     Map<String,String> artifactHandlersConfiguration)

Decorate artifact handlers configuration for runtime. Implement this method to append any necessary properties which were not persisted in handler configuration.

Parameters:

artifactHandlersConfiguration - artifact handlers configuration map

validateConfiguration

void validateConfiguration(@NotNull
                           Map<String,String> newArtifactHandlersConfiguration,
                           @NotNull
                           Map<String,String> oldArtifactHandlersConfiguration,
                           @NotNull
                           ErrorCollection errorCollection)

Validate configuration.

Parameters:

newArtifactHandlersConfiguration - new configuration to be validated

oldArtifactHandlersConfiguration - existing configuration

errorCollection - error collection to be set on validation failure

isConfigurationComplete

boolean isConfigurationComplete(@NotNull
                                Map<String,String> artifactHandlersConfiguration)

Validate if configuration of the artifact handler is complete

Parameters:

artifactHandlersConfiguration - configuration to be validated

Since:

6.2

getArtifactHandlerConfiguration

Map<String,String> getArtifactHandlerConfiguration(@NotNull
                                                   Map<String,String> configuration)

Filter out configuration of the artifact handler from the given map.

Parameters:

configuration -

Returns:

Subset of given configuration that is only relevant to this artifact handler

getEncryptedArtifactHandlerConfiguration

Map<String,String> getEncryptedArtifactHandlerConfiguration(@NotNull
                                                            Map<String,String> configuration)

Filter out configuration of the artifact handler from the given map and encrypt sensitive field values.

Parameters:

configuration -

Returns:

Subset of given configuration that is only relevant to this artifact handler

beforeSave

MessageCollection beforeSave(Map<String,String> artifactHandlersConfigurationBeforeSave,
                             Map<String,String> existingArtifactHandlersConfiguration)

Pre save action handler, allows to gather feedback from configurator before artifact handler configuration saving.

Parameters:

artifactHandlersConfigurationBeforeSave - updated configuration

existingArtifactHandlersConfiguration - existing configuration

Returns:

collection of messages which should be shown to user after configuration saving