Package org.jenkinsci.plugins.pipeline.maven.dao

Class MonitoringPipelineMavenPluginDaoDecorator

java.lang.Object

org.jenkinsci.plugins.pipeline.maven.dao.AbstractPipelineMavenPluginDaoDecorator

org.jenkinsci.plugins.pipeline.maven.dao.MonitoringPipelineMavenPluginDaoDecorator

All Implemented Interfaces:

Closeable, AutoCloseable, PipelineMavenPluginDao

public class MonitoringPipelineMavenPluginDaoDecorator
extends AbstractPipelineMavenPluginDaoDecorator

Nested Class Summary

Nested classes/interfaces inherited from interface org.jenkinsci.plugins.pipeline.maven.dao.PipelineMavenPluginDao

PipelineMavenPluginDao.Builder

Field Summary

Fields inherited from class org.jenkinsci.plugins.pipeline.maven.dao.AbstractPipelineMavenPluginDaoDecorator

delegate

Constructor Summary

Constructors

Constructor	Description
MonitoringPipelineMavenPluginDaoDecorator(PipelineMavenPluginDao delegate)

Method Summary

Modifier and Type	Method	Description
void	cleanup()	Routine task to cleanup the database and reclaim disk space (if possible in the underlying database).
void	deleteBuild(String jobFullName, int buildNumber)	Sync database when a build is deleted (see RunListener.onDeleted(Run))
void	deleteJob(String jobFullName)	Sync database when a job is deleted (see ItemListener.onDeleted(Item))
List<MavenArtifact>	getGeneratedArtifacts(String jobFullName, int buildNumber)	Return the artifacts generated by the given build.
List<MavenDependency>	listDependencies(String jobFullName, int buildNumber)	Return the dependencies registered by the given build.
List<String>	listDownstreamJobs(String jobFullName, int buildNumber)	Deprecated.
SortedSet<String>	listDownstreamJobs(String groupId, String artifactId, String version, String baseVersion, String type, String classifier)	List the downstream jobs who have a dependency on the given artifact.
Map<MavenArtifact,SortedSet<String>>	listDownstreamJobsByArtifact(String jobFullName, int buildNumber)	List the downstream jobs who have a dependency on an artifact that has been generated by the given build (build identified by the given jobFullName, buildNumber).
Map<String,Integer>	listTransitiveUpstreamJobs(String jobFullName, int buildNumber)	List the upstream jobs who generate an artifact that the given build depends on, including transitive dependencies (build identified by the given jobFullName, buildNumber)
Map<String,Integer>	listUpstreamJobs(String jobFullName, int buildNumber)	List the upstream jobs who generate an artifact that the given build depends on (build identified by the given jobFullName, buildNumber) Doesn't return the passed job in case where a pipeline consumes an artifact it also produces
void	recordBuildUpstreamCause(String upstreamJobName, int upstreamBuildNumber, String downstreamJobName, int downstreamBuildNumber)	TODO add MavenArtifact as org.jenkinsci.plugins.pipeline.maven.cause.MavenDependencyUpstreamCause gives these details
void	recordDependency(String jobFullName, int buildNumber, String groupId, String artifactId, String version, String type, String scope, boolean ignoreUpstreamTriggers, String classifier)	Record a Maven dependency of a build.
void	recordGeneratedArtifact(String jobFullName, int buildNumber, String groupId, String artifactId, String version, String type, String baseVersion, String repositoryUrl, boolean skipDownstreamTriggers, String extension, String classifier)	Record a Maven artifact generated in a build.
void	recordParentProject(String jobFullName, int buildNumber, String parentGroupId, String parentArtifactId, String parentVersion, boolean ignoreUpstreamTriggers)	Record a Maven parent project of a pom processed by this build of a build.
static void	registerCacheStatsSupplier(Supplier<CacheStats> supplier)
void	renameJob(String oldFullName, String newFullName)	Sync database when a job is renamed (see ItemListener.onRenamed(Item, String, String))
String	toPrettyString()	Human readable toString
void	updateBuildOnCompletion(String jobFullName, int buildNumber, int buildResultOrdinal, long startTimeInMillis, long durationInMillis)	Update the database with build result details.

Methods inherited from class org.jenkinsci.plugins.pipeline.maven.dao.AbstractPipelineMavenPluginDaoDecorator

close, getBuilder, getDescription, isEnoughProductionGradeForTheWorkload, listTransitiveUpstreamJobs

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.jenkinsci.plugins.pipeline.maven.dao.PipelineMavenPluginDao

getDefaultJdbcUrl, listDownstreamJobs

Constructor Details

MonitoringPipelineMavenPluginDaoDecorator

public MonitoringPipelineMavenPluginDaoDecorator(@NonNull
 PipelineMavenPluginDao delegate)

Method Details

registerCacheStatsSupplier

public static void registerCacheStatsSupplier(Supplier<CacheStats> supplier)

recordDependency

public void recordDependency(@NonNull
 String jobFullName,
 int buildNumber,
 @NonNull
 String groupId,
 @NonNull
 String artifactId,
 @NonNull
 String version,
 @NonNull
 String type,
 @NonNull
 String scope,
 boolean ignoreUpstreamTriggers,
 String classifier)

Description copied from interface: PipelineMavenPluginDao

Record a Maven dependency of a build.

Specified by:

recordDependency in interface PipelineMavenPluginDao

Overrides:

recordDependency in class AbstractPipelineMavenPluginDaoDecorator

Parameters:

jobFullName - see Item.getFullName()

buildNumber - see Run.getNumber()

groupId - Maven dependency groupId

artifactId - Maven dependency artifactId

version - Maven dependency version

type - Maven dependency type (e.g. "jar", "war", "pom", hpi"...)

scope - Maven dependency scope ("compile", "test", "provided"...)

ignoreUpstreamTriggers - see PipelineGraphPublisher#isIgnoreUpstreamTriggers()

classifier - Maven dependency classifier

recordParentProject

public void recordParentProject(@NonNull
 String jobFullName,
 int buildNumber,
 @NonNull
 String parentGroupId,
 @NonNull
 String parentArtifactId,
 @NonNull
 String parentVersion,
 boolean ignoreUpstreamTriggers)

Description copied from interface: PipelineMavenPluginDao

Record a Maven parent project of a pom processed by this build of a build.

Specified by:

recordParentProject in interface PipelineMavenPluginDao

Overrides:

recordParentProject in class AbstractPipelineMavenPluginDaoDecorator

Parameters:

jobFullName - see Item.getFullName()

buildNumber - see Run.getNumber()

parentGroupId - Maven dependency groupId

parentArtifactId - Maven dependency artifactId

parentVersion - Maven dependency version

ignoreUpstreamTriggers - see PipelineGraphPublisher#isIgnoreUpstreamTriggers()

recordGeneratedArtifact

public void recordGeneratedArtifact(@NonNull
 String jobFullName,
 int buildNumber,
 @NonNull
 String groupId,
 @NonNull
 String artifactId,
 @NonNull
 String version,
 @NonNull
 String type,
 @NonNull
 String baseVersion,
 @Nullable
 String repositoryUrl,
 boolean skipDownstreamTriggers,
 String extension,
 String classifier)

Description copied from interface: PipelineMavenPluginDao

Record a Maven artifact generated in a build.

Specified by:

recordGeneratedArtifact in interface PipelineMavenPluginDao

Overrides:

recordGeneratedArtifact in class AbstractPipelineMavenPluginDaoDecorator

Parameters:

jobFullName - see Item.getFullName()

buildNumber - see Run.getNumber()

groupId - Maven artifact groupId

artifactId - Maven artifact artifactId

version - Maven artifact version, the "expanded version" for snapshots who have been "mvn deploy" or equivalent (e.g. "1.1-20170808.155524-66" for "1.1-SNAPSHOT" deployed to a repo)

type - Maven artifact type (e.g. "jar", "war", "pom", hpi"...)

baseVersion - Maven artifact version, the NOT "expanded version" for snapshots who have been "mvn deploy" or equivalent (e.g. baseVersion is "1.1-SNAPSHOT" for a "1.1-SNAPSHOT" artifact that has been deployed to a repo and expanded to "1.1-20170808.155524-66")

repositoryUrl - URL of the Maven repository on which the artifact is deployed ("mvn deploy"). null if the artifact was not deployed

skipDownstreamTriggers - see PipelineGraphPublisher#isSkipDownstreamTriggers()

recordBuildUpstreamCause

public void recordBuildUpstreamCause(String upstreamJobName,
 int upstreamBuildNumber,
 String downstreamJobName,
 int downstreamBuildNumber)

Description copied from interface: PipelineMavenPluginDao

TODO add MavenArtifact as org.jenkinsci.plugins.pipeline.maven.cause.MavenDependencyUpstreamCause gives these details

Specified by:

recordBuildUpstreamCause in interface PipelineMavenPluginDao

Overrides:

recordBuildUpstreamCause in class AbstractPipelineMavenPluginDaoDecorator

Parameters:

upstreamJobName - Job that triggered the build. See Item.getFullName().

upstreamBuildNumber - Job that triggered the build. See Run.getNumber().

downstreamJobName - Job that is triggered. See Item.getFullName().

downstreamBuildNumber - Job that is triggered. See Run.getNumber().

listDependencies

@NonNull
public List<MavenDependency> listDependencies(@NonNull
 String jobFullName,
 int buildNumber)

Description copied from interface: PipelineMavenPluginDao

Return the dependencies registered by the given build.

Specified by:

listDependencies in interface PipelineMavenPluginDao

Overrides:

listDependencies in class AbstractPipelineMavenPluginDaoDecorator

Parameters:

jobFullName - see Item.getFullName()

buildNumber - see Run.getNumber()

Returns:

sorted list of maven artifacts.

See Also:

• PipelineMavenPluginDao.recordDependency(String, int, String, String, String, String, String, boolean, String)

getGeneratedArtifacts

@NonNull
public List<MavenArtifact> getGeneratedArtifacts(@NonNull
 String jobFullName,
 int buildNumber)

Description copied from interface: PipelineMavenPluginDao

Return the artifacts generated by the given build.

Specified by:

getGeneratedArtifacts in interface PipelineMavenPluginDao

Overrides:

getGeneratedArtifacts in class AbstractPipelineMavenPluginDaoDecorator

Parameters:

jobFullName - see Item.getFullName()

buildNumber - see Run.getNumber()

Returns:

sorted list of generated maven artifacts.

renameJob

public void renameJob(@NonNull
 String oldFullName,
 @NonNull
 String newFullName)

Description copied from interface: PipelineMavenPluginDao

Sync database when a job is renamed (see ItemListener.onRenamed(Item, String, String))

Specified by:

renameJob in interface PipelineMavenPluginDao

Overrides:

renameJob in class AbstractPipelineMavenPluginDaoDecorator

Parameters:

oldFullName - see Item.getFullName()

newFullName - see Item.getFullName()

See Also:

• ItemListener.onRenamed(Item, String, String)

deleteJob

public void deleteJob(@NonNull
 String jobFullName)

Description copied from interface: PipelineMavenPluginDao

Sync database when a job is deleted (see ItemListener.onDeleted(Item))

Specified by:

deleteJob in interface PipelineMavenPluginDao

Overrides:

deleteJob in class AbstractPipelineMavenPluginDaoDecorator

Parameters:

jobFullName - see Item.getFullName()

See Also:

• ItemListener.onDeleted(Item)

deleteBuild

public void deleteBuild(@NonNull
 String jobFullName,
 int buildNumber)

Description copied from interface: PipelineMavenPluginDao

Sync database when a build is deleted (see RunListener.onDeleted(Run))

Specified by:

deleteBuild in interface PipelineMavenPluginDao

Overrides:

deleteBuild in class AbstractPipelineMavenPluginDaoDecorator

Parameters:

jobFullName - see Item.getFullName()

See Also:

• RunListener.onDeleted(Run)

listDownstreamJobs

@NonNull
@Deprecated
public List<String> listDownstreamJobs(@NonNull
 String jobFullName,
 int buildNumber)

Deprecated.

Description copied from interface: PipelineMavenPluginDao

List the downstream jobs who have a dependency on an artifact that has been generated by the given build (build identified by the given jobFullName, buildNumber). Doesn't return the passed job in case where a pipeline consumes an artifact it also produces

Specified by:

listDownstreamJobs in interface PipelineMavenPluginDao

Overrides:

listDownstreamJobs in class AbstractPipelineMavenPluginDaoDecorator

Parameters:

jobFullName - see Item.getFullName()

buildNumber - see Run.getNumber()

Returns:

list of job full names (see Item.getFullName())

See Also:

• Item.getFullName()

listDownstreamJobsByArtifact

@NonNull
public Map<MavenArtifact,SortedSet<String>> listDownstreamJobsByArtifact(@NonNull
 String jobFullName,
 int buildNumber)

Description copied from interface: PipelineMavenPluginDao

List the downstream jobs who have a dependency on an artifact that has been generated by the given build (build identified by the given jobFullName, buildNumber). Doesn't return the passed job in case where a pipeline consumes an artifact it also produces

Specified by:

listDownstreamJobsByArtifact in interface PipelineMavenPluginDao

Overrides:

listDownstreamJobsByArtifact in class AbstractPipelineMavenPluginDaoDecorator

Parameters:

jobFullName - see Item.getFullName()

buildNumber - see Run.getNumber()

Returns:

list of job full names (see Item.getFullName()) by MavenArtifact

See Also:

• Item.getFullName()

listDownstreamJobs

@NonNull
public SortedSet<String> listDownstreamJobs(String groupId,
 String artifactId,
 String version,
 String baseVersion,
 String type,
 String classifier)

Description copied from interface: PipelineMavenPluginDao

List the downstream jobs who have a dependency on the given artifact.

Specified by:

listDownstreamJobs in interface PipelineMavenPluginDao

Overrides:

listDownstreamJobs in class AbstractPipelineMavenPluginDaoDecorator

Parameters:

groupId - Maven artifact group ID (see Artifact#getArtifactId())

artifactId - Maven artifact id (see Artifact#getArtifactId())

version - Maven artifact version (see Artifact#getVersion())

baseVersion - Maven artifact (see Artifact#getBaseVersion())

type - Maven artifact type (see Artifact#getType())

classifier - Maven artifact classifier (see Artifact#getClassifier())

Returns:

list of job full names (see Item.getFullName()) by MavenArtifact

See Also:

• Item.getFullName()

listUpstreamJobs

@NonNull
public Map<String,Integer> listUpstreamJobs(@NonNull
 String jobFullName,
 int buildNumber)

Description copied from interface: PipelineMavenPluginDao

List the upstream jobs who generate an artifact that the given build depends on (build identified by the given jobFullName, buildNumber) Doesn't return the passed job in case where a pipeline consumes an artifact it also produces

Specified by:

listUpstreamJobs in interface PipelineMavenPluginDao

Overrides:

listUpstreamJobs in class AbstractPipelineMavenPluginDaoDecorator

Parameters:

jobFullName - see Item.getFullName()

buildNumber - see Run.getNumber()

Returns:

list of builds : key Item.getFullName(), value: Run.getNumber()

See Also:

• Item.getFullName()

listTransitiveUpstreamJobs

@NonNull
public Map<String,Integer> listTransitiveUpstreamJobs(@NonNull
 String jobFullName,
 int buildNumber)

Description copied from interface: PipelineMavenPluginDao

List the upstream jobs who generate an artifact that the given build depends on, including transitive dependencies (build identified by the given jobFullName, buildNumber)

Specified by:

listTransitiveUpstreamJobs in interface PipelineMavenPluginDao

Overrides:

listTransitiveUpstreamJobs in class AbstractPipelineMavenPluginDaoDecorator

Parameters:

jobFullName - see Item.getFullName()

buildNumber - see Run.getNumber()

Returns:

list of job full names (see Item.getFullName())

See Also:

• Item.getFullName()

cleanup

public void cleanup()

Description copied from interface: PipelineMavenPluginDao

Routine task to cleanup the database and reclaim disk space (if possible in the underlying database).

Specified by:

cleanup in interface PipelineMavenPluginDao

Overrides:

cleanup in class AbstractPipelineMavenPluginDaoDecorator

updateBuildOnCompletion

public void updateBuildOnCompletion(@NonNull
 String jobFullName,
 int buildNumber,
 int buildResultOrdinal,
 long startTimeInMillis,
 long durationInMillis)

Description copied from interface: PipelineMavenPluginDao

Update the database with build result details.

Specified by:

updateBuildOnCompletion in interface PipelineMavenPluginDao

Overrides:

updateBuildOnCompletion in class AbstractPipelineMavenPluginDaoDecorator

Parameters:

jobFullName - see Item.getFullName()

buildNumber - see Run.getNumber()

buildResultOrdinal - see Result.ordinal

startTimeInMillis - see Run.getStartTimeInMillis()

durationInMillis - see Run.getDuration()

toPrettyString

public String toPrettyString()

Description copied from interface: PipelineMavenPluginDao

Human readable toString

Specified by:

toPrettyString in interface PipelineMavenPluginDao

Overrides:

toPrettyString in class AbstractPipelineMavenPluginDaoDecorator