com.atlassian.bamboo.build.artifact.handlers

Class ArtifactHandlerPackagingDecorator

java.lang.Object

com.atlassian.bamboo.build.artifact.ArtifactHandlerDecoratorSupport

com.atlassian.bamboo.build.artifact.handlers.ArtifactHandlerPackagingDecorator

All Implemented Interfaces:

ArtifactHandler, RepublishingArtifactHandler, BambooPluginModule

public class ArtifactHandlerPackagingDecorator
extends ArtifactHandlerDecoratorSupport
implements RepublishingArtifactHandler

A decorator for an ArtifactHandler that adds packaging of artifact files when certain conditions are met.

This decorator checks the ArtifactHandler.getMaxUnarchivedFilesPerArtifact(Map) threshold when publishing artifacts and if it is exceeded, it packages all artifact files into a single archive, which is then published instead.

Artifacts are automatically unpacked during retrieval, which means that for artifact dependency consumers (e.g. different build stages, different build plans or deployment projects) the packaging will be transparent.

Field Summary

Fields inherited from interface com.atlassian.bamboo.build.artifact.ArtifactHandler

LAN_SPEED, LOCAL_SPEED, NEVER_ARCHIVE, WAN_SPEED

Constructor Summary

Constructors

Constructor and Description
ArtifactHandlerPackagingDecorator(ArtifactHandler delegate)

Method Summary

Modifier and Type	Method and Description
static com.google.common.base.Function<ArtifactHandler,ArtifactHandler>	addFilePackaging() A function that decorates ArtifactHandler with conditional file packaging using ArtifactHandlerPackagingDecorator.
protected ArtifactHandler	delegate() Returns the delegate instance that methods are forwarded to.
boolean	isRepublishingSupported() If republishing is really supported.
ArtifactHandlerPublishingResult	publish(ResultKey resultKey, ArtifactDefinitionContext artifact, ArtifactPublishingConfig artifactPublishingConfig)
ArtifactHandlerPublishingResult	republish(ArtifactHandlerPublishingResult previousPublishingResult, ResultKey resultKey, ArtifactDefinitionContext artifact, ArtifactHandlerConfigProvider artifactHandlerConfigProvider) Method called when remote agent tries to recover from result publishing failures.
ArtifactRetrievalStatus	retrieve(ResultKey clientKey, Artifact artifact, ArtifactSubscriptionContext artifactSubscription, ArtifactRetrievalConfig artifactRetrievalConfig) Retrieve arbitrary Artifact.

Methods inherited from class com.atlassian.bamboo.build.artifact.ArtifactHandlerDecoratorSupport

canHandleArtifact, getArtifactLinkDataProvider, getArtifactLinkDataProvider, getDefaultConfiguration, getMaxUnarchivedFilesPerArtifact, getModuleDescriptor, getSpeed, getSupportedAgents, moveArtifactToGlobalStorage, removeArtifactFromStorage, removeArtifactFromStorage, removeArtifactFromStorage, removeArtifactsFromStorage, removeArtifactsFromStorage, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.atlassian.bamboo.build.artifact.ArtifactHandler

canHandleArtifact, getArtifactLinkDataProvider, getArtifactLinkDataProvider, getDefaultConfiguration, getMaxUnarchivedFilesPerArtifact, getModuleDescriptor, getSpeed, getSupportedAgents, moveArtifactToGlobalStorage, publish, removeArtifactFromStorage, removeArtifactFromStorage, removeArtifactFromStorage, removeArtifactsFromStorage, removeArtifactsFromStorage

Constructor Detail

ArtifactHandlerPackagingDecorator

public ArtifactHandlerPackagingDecorator(@NotNull
                                         ArtifactHandler delegate)

Method Detail

delegate

@NotNull
protected ArtifactHandler delegate()

Description copied from class: ArtifactHandlerDecoratorSupport

Returns the delegate instance that methods are forwarded to. Subclasses should override this method to supply the instance being decorated.

Specified by:

delegate in class ArtifactHandlerDecoratorSupport

addFilePackaging

@NotNull
public static com.google.common.base.Function<ArtifactHandler,ArtifactHandler> addFilePackaging()

A function that decorates ArtifactHandler with conditional file packaging using ArtifactHandlerPackagingDecorator.

publish

@NotNull
public ArtifactHandlerPublishingResult publish(@NotNull
                                                        ResultKey resultKey,
                                                        @NotNull
                                                        ArtifactDefinitionContext artifact,
                                                        @NotNull
                                                        ArtifactPublishingConfig artifactPublishingConfig)
                                                 throws Exception

Specified by:

publish in interface ArtifactHandler

Overrides:

publish in class ArtifactHandlerDecoratorSupport

Throws:

Exception

republish

@NotNull
public ArtifactHandlerPublishingResult republish(@NotNull
                                                          ArtifactHandlerPublishingResult previousPublishingResult,
                                                          @NotNull
                                                          ResultKey resultKey,
                                                          @NotNull
                                                          ArtifactDefinitionContext artifact,
                                                          @NotNull
                                                          ArtifactHandlerConfigProvider artifactHandlerConfigProvider)
                                                   throws Exception

Description copied from interface: RepublishingArtifactHandler

Method called when remote agent tries to recover from result publishing failures. It is called if the previous attempt of transferring the artifact returned status ArtifactHandlerPublishingResult.Status.DEFERRED.

Specified by:

republish in interface RepublishingArtifactHandler

Throws:

Exception

isRepublishingSupported

public boolean isRepublishingSupported()

Description copied from interface: RepublishingArtifactHandler

If republishing is really supported. Necessary because of handlers that wrap other handlers.

Specified by:

isRepublishingSupported in interface RepublishingArtifactHandler

Returns:

true iff republishing is actually supported

retrieve

@NotNull
public ArtifactRetrievalStatus retrieve(@NotNull
                                                 ResultKey clientKey,
                                                 @NotNull
                                                 Artifact artifact,
                                                 @NotNull
                                                 ArtifactSubscriptionContext artifactSubscription,
                                                 @NotNull
                                                 ArtifactRetrievalConfig artifactRetrievalConfig)
                                          throws Exception

Description copied from interface: ArtifactHandler

Retrieve arbitrary Artifact. Artifact is found by the information in artifact parameter.

Specified by:

retrieve in interface ArtifactHandler

Overrides:

retrieve in class ArtifactHandlerDecoratorSupport

Parameters:

clientKey - identifier of plan or deployment doing the download

artifact - artifact information

artifactSubscription - download details (e.g. target path, copy pattern)

artifactRetrievalConfig - handler specific configuration

Throws:

Exception