pl.project13.core

Class GitDataProvider

java.lang.Object

pl.project13.core.GitDataProvider

All Implemented Interfaces:

GitProvider

Direct Known Subclasses:

JGitProvider, NativeGitProvider

public abstract class GitDataProvider
extends java.lang.Object
implements GitProvider

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	GitDataProvider.SupplierEx<T>

Field Summary

Fields

Modifier and Type	Field and Description
protected int	abbrevLength
protected CommitIdGenerationMode	commitIdGenerationMode
protected java.lang.String	dateFormat
protected java.lang.String	dateFormatTimeZone
protected java.lang.String	evaluateOnCommit
protected java.util.List<java.lang.String>	excludeProperties
protected GitDescribeConfig	gitDescribe
protected java.util.List<java.lang.String>	includeOnlyProperties
protected LoggerBridge	log
protected boolean	offline
protected java.lang.String	prefixDot
protected boolean	useBranchNameFromBuildEnvironment

Constructor Summary

Constructors

Constructor and Description
GitDataProvider(LoggerBridge log)

Method Summary

Modifier and Type	Method and Description
protected java.lang.String	determineBranchName(java.util.Map<java.lang.String,java.lang.String> env) If running within Jenkins/Hudson, honor the branch name passed via GIT_BRANCH env var.
protected java.text.SimpleDateFormat	getSimpleDateFormatWithTimeZone()
void	loadGitData(java.lang.String evaluateOnCommit, java.util.Properties properties)
protected void	loadShortDescribe(java.util.Properties properties)
protected void	maybePut(java.util.Properties properties, java.lang.String key, GitDataProvider.SupplierEx<java.lang.String> value)
static <T> GitDataProvider.SupplierEx<T>	memoize(GitDataProvider.SupplierEx<T> delegate)
GitDataProvider	setAbbrevLength(int abbrevLength)
GitDataProvider	setCommitIdGenerationMode(CommitIdGenerationMode commitIdGenerationMode)
GitDataProvider	setDateFormat(java.lang.String dateFormat)
GitDataProvider	setDateFormatTimeZone(java.lang.String dateFormatTimeZone)
GitDataProvider	setExcludeProperties(java.util.List<java.lang.String> excludeProperties)
GitDataProvider	setGitDescribe(GitDescribeConfig gitDescribe)
GitDataProvider	setIncludeOnlyProperties(java.util.List<java.lang.String> includeOnlyProperties)
GitDataProvider	setOffline(boolean offline)
GitDataProvider	setPrefixDot(java.lang.String prefixDot)
GitDataProvider	setUseBranchNameFromBuildEnvironment(boolean useBranchNameFromBuildEnvironment)
protected java.lang.String	stripCredentialsFromOriginUrl(java.lang.String gitRemoteString) If the git remote value is a URI and contains a user info component, strip the password from it if it exists.

Methods inherited from class java.lang.Object

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

Methods inherited from interface pl.project13.core.GitProvider

finalCleanUp, getAbbrevCommitId, getAheadBehind, getBranchName, getBuildAuthorEmail, getBuildAuthorName, getClosestTagCommitCount, getClosestTagName, getCommitAuthorEmail, getCommitAuthorName, getCommitId, getCommitMessageFull, getCommitMessageShort, getCommitTime, getGitDescribe, getRemoteOriginUrl, getTags, getTotalCommitCount, init, isDirty, prepareGitToExtractMoreDetailedRepoInformation

Field Detail

log

@Nonnull
protected final LoggerBridge log

prefixDot

protected java.lang.String prefixDot

abbrevLength

protected int abbrevLength

dateFormat

protected java.lang.String dateFormat

dateFormatTimeZone

protected java.lang.String dateFormatTimeZone

gitDescribe

protected GitDescribeConfig gitDescribe

commitIdGenerationMode

protected CommitIdGenerationMode commitIdGenerationMode

evaluateOnCommit

protected java.lang.String evaluateOnCommit

useBranchNameFromBuildEnvironment

protected boolean useBranchNameFromBuildEnvironment

excludeProperties

protected java.util.List<java.lang.String> excludeProperties

includeOnlyProperties

protected java.util.List<java.lang.String> includeOnlyProperties

offline

protected boolean offline

Constructor Detail

GitDataProvider

public GitDataProvider(@Nonnull
                       LoggerBridge log)

Method Detail

setGitDescribe

public GitDataProvider setGitDescribe(GitDescribeConfig gitDescribe)

setPrefixDot

public GitDataProvider setPrefixDot(java.lang.String prefixDot)

setAbbrevLength

public GitDataProvider setAbbrevLength(int abbrevLength)

setDateFormat

public GitDataProvider setDateFormat(java.lang.String dateFormat)

setCommitIdGenerationMode

public GitDataProvider setCommitIdGenerationMode(CommitIdGenerationMode commitIdGenerationMode)

setDateFormatTimeZone

public GitDataProvider setDateFormatTimeZone(java.lang.String dateFormatTimeZone)

setUseBranchNameFromBuildEnvironment

public GitDataProvider setUseBranchNameFromBuildEnvironment(boolean useBranchNameFromBuildEnvironment)

setExcludeProperties

public GitDataProvider setExcludeProperties(java.util.List<java.lang.String> excludeProperties)

setIncludeOnlyProperties

public GitDataProvider setIncludeOnlyProperties(java.util.List<java.lang.String> includeOnlyProperties)

setOffline

public GitDataProvider setOffline(boolean offline)

loadGitData

public void loadGitData(@Nonnull
                        java.lang.String evaluateOnCommit,
                        @Nonnull
                        java.util.Properties properties)
                 throws GitCommitIdExecutionException

Throws:

GitCommitIdExecutionException

loadShortDescribe

protected void loadShortDescribe(@Nonnull
                                 java.util.Properties properties)
                          throws GitCommitIdExecutionException

Throws:

GitCommitIdExecutionException

determineBranchName

protected java.lang.String determineBranchName(@Nonnull
                                               java.util.Map<java.lang.String,java.lang.String> env)
                                        throws GitCommitIdExecutionException

If running within Jenkins/Hudson, honor the branch name passed via GIT_BRANCH env var. This is necessary because Jenkins/Hudson always invoke build in a detached head state.

Parameters:

env - environment settings

Returns:

results of getBranchName() or, if in Jenkins/Hudson, value of GIT_BRANCH

Throws:

GitCommitIdExecutionException

getSimpleDateFormatWithTimeZone

protected java.text.SimpleDateFormat getSimpleDateFormatWithTimeZone()

maybePut

protected void maybePut(@Nonnull
                        java.util.Properties properties,
                        java.lang.String key,
                        GitDataProvider.SupplierEx<java.lang.String> value)
                 throws GitCommitIdExecutionException

Throws:

GitCommitIdExecutionException

memoize

public static <T> GitDataProvider.SupplierEx<T> memoize(GitDataProvider.SupplierEx<T> delegate)

stripCredentialsFromOriginUrl

protected java.lang.String stripCredentialsFromOriginUrl(java.lang.String gitRemoteString)
                                                  throws GitCommitIdExecutionException

If the git remote value is a URI and contains a user info component, strip the password from it if it exists.

Parameters:

gitRemoteString - The value of the git remote

Returns:

returns the gitRemoteUri with stripped password (might be used in http or https)

Throws:

GitCommitIdExecutionException - Exception when URI is invalid