hudson.tasks

Class ArtifactArchiver

java.lang.Object

hudson.tasks.BuildStepCompatibilityLayer

hudson.tasks.Publisher

hudson.tasks.Recorder

hudson.tasks.ArtifactArchiver

All Implemented Interfaces:

ExtensionPoint, Describable<Publisher>, BuildStep, SimpleBuildStep

public class ArtifactArchiver
extends Recorder
implements SimpleBuildStep

Copies the artifacts into an archive directory.

Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ArtifactArchiver.DescriptorImpl
static class	ArtifactArchiver.Migrator

Nested classes/interfaces inherited from class hudson.tasks.Publisher

Publisher.DescriptorExtensionListImpl

Nested classes/interfaces inherited from interface jenkins.tasks.SimpleBuildStep

SimpleBuildStep.LastBuildAction, SimpleBuildStep.LastBuildActionFactory

Nested classes/interfaces inherited from interface hudson.tasks.BuildStep

BuildStep.PublisherList

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Field Summary

Fields

Modifier and Type	Field and Description
static ArtifactArchiver.DescriptorImpl	DESCRIPTOR Deprecated. as of 1.286 Some plugin depends on this, so this field is left here and points to the last created instance. Use Jenkins.getDescriptorByType(Class) instead.

Fields inherited from interface hudson.tasks.BuildStep

BUILDERS, PUBLISHERS

Constructor Summary

Constructors

Constructor and Description
ArtifactArchiver(String artifacts)
ArtifactArchiver(String artifacts, String excludes, boolean latestOnly) Deprecated.
ArtifactArchiver(String artifacts, String excludes, boolean latestOnly, boolean allowEmptyArchive) Deprecated.
ArtifactArchiver(String artifacts, String excludes, boolean latestOnly, boolean allowEmptyArchive, boolean onlyIfSuccessful) Deprecated.
ArtifactArchiver(String artifacts, String excludes, boolean latestOnly, boolean allowEmptyArchive, boolean onlyIfSuccessful, Boolean defaultExcludes) Deprecated.

Method Summary

Modifier and Type	Method and Description
boolean	getAllowEmptyArchive()
String	getArtifacts()
String	getExcludes()
BuildStepMonitor	getRequiredMonitorService() Declares the scope of the synchronization monitor this BuildStep expects from outside.
boolean	isCaseSensitive()
boolean	isDefaultExcludes()
boolean	isFingerprint()
boolean	isFollowSymlinks()
boolean	isLatestOnly() Deprecated.
boolean	isOnlyIfSuccessful()
void	perform(Run<?,?> build, FilePath ws, EnvVars environment, Launcher launcher, TaskListener listener) Run this step.
protected Object	readResolve()
void	setAllowEmptyArchive(boolean allowEmptyArchive)
void	setCaseSensitive(boolean caseSensitive)
void	setDefaultExcludes(boolean defaultExcludes)
void	setExcludes(String excludes)
void	setFingerprint(boolean fingerprint) Whether to fingerprint the artifacts after we archive them.
void	setFollowSymlinks(boolean followSymlinks)
void	setOnlyIfSuccessful(boolean onlyIfSuccessful)

Methods inherited from class hudson.tasks.Recorder

getDescriptor

Methods inherited from class hudson.tasks.Publisher

all, getProjectAction, needsToRunAfterFinalized, prebuild

Methods inherited from class hudson.tasks.BuildStepCompatibilityLayer

getProjectAction, getProjectActions, perform, perform, prebuild

Methods inherited from class java.lang.Object

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

Methods inherited from interface jenkins.tasks.SimpleBuildStep

perform

Methods inherited from interface hudson.tasks.BuildStep

getProjectAction, getProjectActions, perform, prebuild

Field Detail

DESCRIPTOR

@Deprecated
public static volatile ArtifactArchiver.DescriptorImpl DESCRIPTOR

Deprecated. as of 1.286 Some plugin depends on this, so this field is left here and points to the last created instance. Use Jenkins.getDescriptorByType(Class) instead.

Constructor Detail

ArtifactArchiver

@DataBoundConstructor
public ArtifactArchiver(String artifacts)

ArtifactArchiver

@Deprecated
public ArtifactArchiver(String artifacts,
                                    String excludes,
                                    boolean latestOnly)

Deprecated.

ArtifactArchiver

@Deprecated
public ArtifactArchiver(String artifacts,
                                    String excludes,
                                    boolean latestOnly,
                                    boolean allowEmptyArchive)

Deprecated.

ArtifactArchiver

@Deprecated
public ArtifactArchiver(String artifacts,
                                    String excludes,
                                    boolean latestOnly,
                                    boolean allowEmptyArchive,
                                    boolean onlyIfSuccessful)

Deprecated.

ArtifactArchiver

@Deprecated
public ArtifactArchiver(String artifacts,
                                    String excludes,
                                    boolean latestOnly,
                                    boolean allowEmptyArchive,
                                    boolean onlyIfSuccessful,
                                    Boolean defaultExcludes)

Deprecated.

Method Detail

readResolve

protected Object readResolve()

getArtifacts

public String getArtifacts()

getExcludes

@CheckForNull
public String getExcludes()

setExcludes

@DataBoundSetter
public final void setExcludes(@CheckForNull
                                               String excludes)

isLatestOnly

@Deprecated
public boolean isLatestOnly()

Deprecated.

isOnlyIfSuccessful

public boolean isOnlyIfSuccessful()

setOnlyIfSuccessful

@DataBoundSetter
public final void setOnlyIfSuccessful(boolean onlyIfSuccessful)

isFingerprint

public boolean isFingerprint()

setFingerprint

@DataBoundSetter
public void setFingerprint(boolean fingerprint)

Whether to fingerprint the artifacts after we archive them.

getAllowEmptyArchive

public boolean getAllowEmptyArchive()

setAllowEmptyArchive

@DataBoundSetter
public final void setAllowEmptyArchive(boolean allowEmptyArchive)

isDefaultExcludes

public boolean isDefaultExcludes()

setDefaultExcludes

@DataBoundSetter
public final void setDefaultExcludes(boolean defaultExcludes)

isCaseSensitive

public boolean isCaseSensitive()

setCaseSensitive

@DataBoundSetter
public final void setCaseSensitive(boolean caseSensitive)

isFollowSymlinks

public boolean isFollowSymlinks()

setFollowSymlinks

@DataBoundSetter
public final void setFollowSymlinks(boolean followSymlinks)

perform

public void perform(Run<?,?> build,
                    FilePath ws,
                    EnvVars environment,
                    Launcher launcher,
                    TaskListener listener)
             throws IOException,
                    InterruptedException

Description copied from interface: SimpleBuildStep

Run this step.

Specified by:

perform in interface SimpleBuildStep

Parameters:

build - a build this is running as a part of

ws - a workspace to use for any file operations

environment - environment variables applicable to this step

launcher - a way to start processes

listener - a place to send output

Throws:

IOException - if something goes wrong; use AbortException for a polite error

InterruptedException - if the step is interrupted

getRequiredMonitorService

public BuildStepMonitor getRequiredMonitorService()

Description copied from interface: BuildStep

Declares the scope of the synchronization monitor this BuildStep expects from outside.

This method is introduced for preserving compatibility with plugins written for earlier versions of Hudson, which never run multiple builds of the same job in parallel. Such plugins often assume that the outcome of the previous build is completely available, which is no longer true when we do concurrent builds.

To minimize the necessary code change for such plugins, BuildStep implementations can request Hudson to externally perform synchronization before executing them. This behavior is as follows:

BuildStepMonitor.BUILD

This BuildStep is only executed after the previous build is fully completed (thus fully restoring the earlier semantics of one build at a time.)

BuildStepMonitor.STEP

This BuildStep is only executed after the same step in the previous build is completed. For build steps that use a weaker assumption and only rely on the output from the same build step of the early builds, this improves the concurrency.

BuildStepMonitor.NONE

No external synchronization is performed on this build step. This is the most efficient, and thus the recommended value for newer plugins. Wherever necessary, you can directly use CheckPoints to perform necessary synchronizations.

Migrating Older Implementation

If you are migrating BuildStep implementations written for earlier versions of Hudson, here's what you can do:

• To demand the backward compatible behavior from Jenkins, leave this method unoverridden, and make no other changes to the code. This will prevent users from reaping the benefits of concurrent builds, but at least your plugin will work correctly, and therefore this is a good easy first step.
• If your build step doesn't use anything from a previous build (for example, if you don't even call Run.getPreviousBuild()), then you can return BuildStepMonitor.NONE without making further code changes and you are done with migration.
• If your build step only depends on Actions that you added in the previous build by yourself, then you only need BuildStepMonitor.STEP scope synchronization. Return it from this method ,and you are done with migration without any further code changes.
• If your build step makes more complex assumptions, return BuildStepMonitor.NONE and use CheckPoints directly in your code. The general idea is to call CheckPoint.block() before you try to access the state from the previous build.

Specified by:

getRequiredMonitorService in interface BuildStep