hudson.maven

Interface MavenBuildProxy

All Known Subinterfaces:

MavenBuildProxy2

All Known Implementing Classes:

AbstractMavenBuilder.FilterImpl, MavenBuild.ProxyImpl2, MavenBuildProxy.Filter, MavenBuildProxy2.Filter

public interface MavenBuildProxy

Remoting proxy interface for MavenReporters to talk to MavenBuild during the build. That is, this represents MavenBuild objects in the master's JVM to code running inside Maven JVM.

Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	MavenBuildProxy.BuildCallable<V,T extends Throwable>
static class	MavenBuildProxy.Filter<CORE extends MavenBuildProxy> Filter for MavenBuildProxy.

Method Summary

Modifier and Type	Method and Description
<V,T extends Throwable> V	execute(MavenBuildProxy.BuildCallable<V,T> program) Executes the given MavenBuildProxy.BuildCallable on the master, where one has access to MavenBuild and all the other Hudson objects.
void	executeAsync(MavenBuildProxy.BuildCallable<?,?> program) Executes the given MavenBuildProxy.BuildCallable asynchronously on the master.
hudson.FilePath	getArtifactsDir() Deprecated. Does not work with ArtifactManager.
MavenBuildInformation	getMavenBuildInformation()
long	getMilliSecsSinceBuildStart() # of milliseconds elapsed since getTimestamp().
hudson.FilePath	getModuleSetRootDir() Root directory of the owner MavenModuleSet
hudson.FilePath	getProjectRootDir() Root directory of the parent of this build.
hudson.FilePath	getRootDir() Root directory of the build.
Calendar	getTimestamp()
boolean	isArchivingDisabled() If true, artifacts will not actually be archived to master.
boolean	isSiteArchivingDisabled() If true, artifacts will not actually be archived to master during site deploy.
void	queueArchiving(String artifactPath, String artifact)
void	registerAsAggregatedProjectAction(MavenReporter reporter) Nominates that the reporter will contribute a project action for this build by using MavenReporter.getAggregatedProjectAction(MavenModuleSet).
void	registerAsProjectAction(MavenProjectActionBuilder builder) Nominates that the reporter will contribute a project action for this build by using MavenReporter.getProjectActions(MavenModule).
void	registerAsProjectAction(MavenReporter reporter) Nominates that the reporter will contribute a project action for this build by using MavenReporter.getProjectActions(MavenModule).
void	setExecutedMojos(List<ExecutedMojo> executedMojos) Called at the end of the build to record what mojos are executed.
void	setResult(hudson.model.Result result)

Method Detail

execute

<V,T extends Throwable> V execute(MavenBuildProxy.BuildCallable<V,T> program)
                           throws T extends Throwable,
                                  IOException,
                                  InterruptedException

Executes the given MavenBuildProxy.BuildCallable on the master, where one has access to MavenBuild and all the other Hudson objects.

The parameter, return value, and exception are all transfered by using Java serialization.

Returns:

the value that MavenBuildProxy.BuildCallable returned.

Throws:

T - if MavenBuildProxy.BuildCallable throws this exception.

IOException - if the remoting failed.

InterruptedException - if the remote execution is aborted.

T extends Throwable

See Also:

executeAsync(BuildCallable)

executeAsync

void executeAsync(MavenBuildProxy.BuildCallable<?,?> program)
           throws IOException

Executes the given MavenBuildProxy.BuildCallable asynchronously on the master.

This method works like execute(BuildCallable) except that the method returns immediately and doesn't wait for the completion of the program.

The completions of asynchronous executions are accounted for before the build completes. If they throw exceptions, they'll be reported and the build will be marked as a failure.

Throws:

IOException

getRootDir

hudson.FilePath getRootDir()

Root directory of the build.

See Also:

Run.getRootDir()

getProjectRootDir

hudson.FilePath getProjectRootDir()

Root directory of the parent of this build.

getModuleSetRootDir

hudson.FilePath getModuleSetRootDir()

Root directory of the owner MavenModuleSet

getArtifactsDir

@Deprecated
hudson.FilePath getArtifactsDir()

Deprecated. Does not work with ArtifactManager.

queueArchiving

void queueArchiving(String artifactPath,
                    String artifact)

Parameters:

artifactPath - a relative /-separated path

artifact - absolute path name on the slave in the workspace

Since:

1.532

See Also:

ArtifactManager.archive(hudson.FilePath, hudson.Launcher, hudson.model.BuildListener, java.util.Map<java.lang.String, java.lang.String>)

setResult

void setResult(hudson.model.Result result)

See Also:

Run.setResult(Result)

getTimestamp

Calendar getTimestamp()

See Also:

Run.getTimestamp()

getMilliSecsSinceBuildStart

long getMilliSecsSinceBuildStart()

# of milliseconds elapsed since getTimestamp(). Where the clock skew is involved between the master and the Maven JVM, comparing current time on Maven JVM with getTimestamp() could be problematic, but this value is more robust.

isArchivingDisabled

boolean isArchivingDisabled()

If true, artifacts will not actually be archived to master. Calls MavenModuleSet.isArchivingDisabled().

isSiteArchivingDisabled

boolean isSiteArchivingDisabled()

If true, artifacts will not actually be archived to master during site deploy. Calls MavenModuleSet.isSiteArchivingDisabled().

registerAsProjectAction

void registerAsProjectAction(MavenReporter reporter)

Nominates that the reporter will contribute a project action for this build by using MavenReporter.getProjectActions(MavenModule).

The specified MavenReporter object will be transfered to the master and will become a persisted part of the MavenBuild.

registerAsProjectAction

void registerAsProjectAction(MavenProjectActionBuilder builder)

Nominates that the reporter will contribute a project action for this build by using MavenReporter.getProjectActions(MavenModule).

The specified MavenReporter object will be transferred to the master and will become a persisted part of the MavenBuild.

Since:

1.372

registerAsAggregatedProjectAction

void registerAsAggregatedProjectAction(MavenReporter reporter)

Nominates that the reporter will contribute a project action for this build by using MavenReporter.getAggregatedProjectAction(MavenModuleSet).

The specified MavenReporter object will be transfered to the master and will become a persisted part of the MavenModuleSetBuild.

setExecutedMojos

void setExecutedMojos(List<ExecutedMojo> executedMojos)

Called at the end of the build to record what mojos are executed.

getMavenBuildInformation

MavenBuildInformation getMavenBuildInformation()