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, BambooPluginModule

public class ArtifactHandlerPackagingDecorator
extends ArtifactHandlerDecoratorSupport

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.
ArtifactHandlerPublishingResult	publish(ResultKey resultKey, ArtifactDefinitionContext artifact, ArtifactPublishingConfig artifactPublishingConfig)
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, 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

publish

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

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