com.atlassian.bamboo.specs.api.builders.plan.artifact

Class Artifact

java.lang.Object

com.atlassian.bamboo.specs.api.builders.EntityPropertiesBuilder<ArtifactProperties>

com.atlassian.bamboo.specs.api.builders.plan.artifact.Artifact

public class Artifact
extends EntityPropertiesBuilder<ArtifactProperties>

Represents Bamboo artifact definition.

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	HTTP_COMPRESSION_ON_BY_DEFAULT
static boolean	REQUIRED_BY_DEFAULT
static boolean	SHARED_BY_DEFAULT

Constructor Summary

Constructors

Constructor and Description
Artifact()
Artifact(@NotNull String name) Specify an artifact with given name.

Method Summary

Modifier and Type	Method and Description
protected ArtifactProperties	build()
Artifact	copyPattern(@NotNull String copyPattern) Deprecated. since 8.3, use copyPatterns(String...)
Artifact	copyPatterns(String... copyPatterns) Specify the pattern according to which Bamboo should copy files when creating an actual artifact.
Artifact	exclusionPatterns(String... exclusionPatterns) Specify the pattern according to which Bamboo should exclude files when creating an actual artifact.
@NotNull String	getName() Returns defined artifact name, which serves as identifier for this object.
Artifact	httpCompressionOn(boolean httpCompressionOn) Specifies if artifact should be compressed before transfer.
Artifact	location(@NotNull String location) Specifies a path in which Bamboo should look for the files when creating an actual artifact.
Artifact	name(@NotNull String name) Sets an artifact name.
Artifact	required() Set artifact to be required.
Artifact	required(boolean mandatory) Specifies if artifact is required.
Artifact	shared(boolean shared) Specifies if artifact is shared.

Methods inherited from class java.lang.Object

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

Field Detail

SHARED_BY_DEFAULT

public static final boolean SHARED_BY_DEFAULT

REQUIRED_BY_DEFAULT

public static final boolean REQUIRED_BY_DEFAULT

HTTP_COMPRESSION_ON_BY_DEFAULT

public static final boolean HTTP_COMPRESSION_ON_BY_DEFAULT

Constructor Detail

Artifact

public Artifact()

Artifact

public Artifact(@NotNull
                @NotNull String name)
         throws PropertiesValidationException

Specify an artifact with given name. Name must be unique within the job; if artifact is shared it must be unique within the plan.

In the absence of oid, the name is used to identify the artifact. If the artifact with given name does not exist, a new one is created, otherwise existing one is updated.

Throws:

PropertiesValidationException

Method Detail

name

public Artifact name(@NotNull
                     @NotNull String name)
              throws PropertiesValidationException

Sets an artifact name. Name must be unique within the job; if artifact is shared it must be unique within the plan.

In the absence of oid, the name is used to identify the artifact. If the artifact with given name does not exist, a new one is created, otherwise existing one is updated.

Throws:

PropertiesValidationException

copyPattern

@Deprecated
public Artifact copyPattern(@NotNull
                                        @NotNull String copyPattern)
                                 throws PropertiesValidationException

Deprecated. since 8.3, use copyPatterns(String...)

Specify the pattern according to which Bamboo should copy files when creating an actual artifact. This erases previously specified patterns.

Parameters:

copyPattern - a copy pattern in Ant file pattern format

Throws:

PropertiesValidationException

copyPatterns

public Artifact copyPatterns(@NotNull
                             String... copyPatterns)
                      throws PropertiesValidationException

Specify the pattern according to which Bamboo should copy files when creating an actual artifact.

Parameters:

copyPatterns - a set of copy patterns in Ant file pattern format

Throws:

PropertiesValidationException

Since:

8.3

exclusionPatterns

public Artifact exclusionPatterns(@NotNull
                                  String... exclusionPatterns)
                           throws PropertiesValidationException

Specify the pattern according to which Bamboo should exclude files when creating an actual artifact.

Parameters:

exclusionPatterns - a set of exclusion patterns in Ant file pattern format

Throws:

PropertiesValidationException

Since:

8.3

shared

public Artifact shared(boolean shared)

Specifies if artifact is shared. Shared artifacts can be downloaded by jobs in subsequent stages as well as other plans and deployments. False by default.

required

public Artifact required()

Set artifact to be required. Build will fail if can't publish required artifact.

required

public Artifact required(boolean mandatory)

Specifies if artifact is required. Build will fail if can't publish required artifact. False by default.

httpCompressionOn

public Artifact httpCompressionOn(boolean httpCompressionOn)

Specifies if artifact should be compressed before transfer. True by default.

location

public Artifact location(@NotNull
                         @NotNull String location)
                  throws PropertiesValidationException

Specifies a path in which Bamboo should look for the files when creating an actual artifact.

Throws:

PropertiesValidationException

getName

@NotNull
public @NotNull String getName()

Returns defined artifact name, which serves as identifier for this object.

Throws:

IllegalStateException - if name is undefined

build

protected ArtifactProperties build()
                            throws PropertiesValidationException

Specified by:

build in class EntityPropertiesBuilder<ArtifactProperties>

Throws:

PropertiesValidationException