Package org.apache.maven.scm.provider.git

Class AbstractGitScmProvider

java.lang.Object

org.apache.maven.scm.provider.AbstractScmProvider

org.apache.maven.scm.provider.git.AbstractGitScmProvider

All Implemented Interfaces:

ScmProvider

Direct Known Subclasses:

GitExeScmProvider, JGitScmProvider

public abstract class AbstractGitScmProvider
extends AbstractScmProvider

SCM Provider for git.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static class	AbstractGitScmProvider.ScmUrlParserResult	Internal class.

Field Summary

Fields inherited from class org.apache.maven.scm.provider.AbstractScmProvider

logger

Constructor Summary

Constructors

Constructor	Description
AbstractGitScmProvider()

Method Summary

Modifier and Type	Method	Description
AddScmResult	add(ScmProviderRepository repository, ScmFileSet fileSet, CommandParameters parameters)	TODO: why public? This should be protected, no?
protected BlameScmResult	blame(ScmProviderRepository repository, ScmFileSet fileSet, CommandParameters parameters)
protected BranchScmResult	branch(ScmProviderRepository repository, ScmFileSet fileSet, CommandParameters parameters)
ChangeLogScmResult	changelog(ScmProviderRepository repository, ScmFileSet fileSet, CommandParameters parameters)
CheckInScmResult	checkin(ScmProviderRepository repository, ScmFileSet fileSet, CommandParameters parameters)
CheckInScmResult	checkIn(ScmRepository repository, ScmFileSet fileSet, CommandParameters parameters)	Save the changes you have done into the repository.
CheckOutScmResult	checkout(ScmProviderRepository repository, ScmFileSet fileSet, CommandParameters parameters)
DiffScmResult	diff(ScmProviderRepository repository, ScmFileSet fileSet, CommandParameters parameters)
protected ScmResult	executeCommand(GitCommand command, ScmProviderRepository repository, ScmFileSet fileSet, CommandParameters parameters)
protected ExportScmResult	export(ScmProviderRepository repository, ScmFileSet fileSet, CommandParameters parameters)
protected abstract GitCommand	getAddCommand()
protected abstract GitCommand	getBlameCommand()
protected abstract GitCommand	getBranchCommand()
protected abstract GitCommand	getChangeLogCommand()
protected abstract GitCommand	getCheckInCommand()
protected abstract GitCommand	getCheckOutCommand()
protected abstract GitCommand	getDiffCommand()
protected abstract GitCommand	getExportCommand()
protected abstract GitCommand	getInfoCommand()
protected abstract GitCommand	getRemoteInfoCommand()
protected abstract GitCommand	getRemoveCommand()
protected abstract java.lang.String	getRepositoryURL(java.io.File path)
java.lang.String	getScmSpecificFilename()	Returns the scm reserved file name where the SCM stores information like '.git', '.svn'.
java.lang.String	getScmType()
protected abstract GitCommand	getStatusCommand()
protected abstract GitCommand	getTagCommand()
protected abstract GitCommand	getUntagCommand()
protected abstract GitCommand	getUpdateCommand()
InfoScmResult	info(ScmProviderRepository repository, ScmFileSet fileSet, CommandParameters parameters)
ScmProviderRepository	makeProviderScmRepository(java.io.File path)	Try to create a ScmProviderRepository for this provider from the given working directory (created through a previous checkout).
ScmProviderRepository	makeProviderScmRepository(java.lang.String scmSpecificUrl, char delimiter)
private AbstractGitScmProvider.ScmUrlParserResult	parseScmUrl(java.lang.String scmSpecificUrl, char delimiter)	The git-submodule(1) command is available since Git 1.5.3, so modules will be activated in a later stage.
RemoteInfoScmResult	remoteInfo(ScmProviderRepository repository, ScmFileSet fileSet, CommandParameters parameters)
RemoveScmResult	remove(ScmProviderRepository repository, ScmFileSet fileSet, CommandParameters parameters)
StatusScmResult	status(ScmProviderRepository repository, ScmFileSet fileSet, CommandParameters parameters)
TagScmResult	tag(ScmProviderRepository repository, ScmFileSet fileSet, CommandParameters parameters)
UntagScmResult	untag(ScmRepository repository, ScmFileSet fileSet, CommandParameters parameters)	Deletes a tag.
UpdateScmResult	update(ScmProviderRepository repository, ScmFileSet fileSet, CommandParameters parameters)
java.util.List<java.lang.String>	validateScmUrl(java.lang.String scmSpecificUrl, char delimiter)	Validate the scm url.

Methods inherited from class org.apache.maven.scm.provider.AbstractScmProvider

add, add, add, blame, blame, branch, branch, branch, changeLog, changeLog, changeLog, changeLog, changeLog, changeLog, changeLog, changeLog, changeLog, checkIn, checkIn, checkIn, checkOut, checkOut, checkOut, checkOut, checkOut, checkOut, checkOut, diff, diff, edit, edit, export, export, export, export, export, list, list, list, login, mkdir, mkdir, remove, requiresEditMode, sanitizeTagName, status, tag, tag, tag, unedit, unedit, update, update, update, update, update, update, update, update, update, update, update, update, validateTagName

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.maven.scm.provider.ScmProvider

setInteractive

Constructor Detail

AbstractGitScmProvider

public AbstractGitScmProvider()

Method Detail

getScmSpecificFilename

public java.lang.String getScmSpecificFilename()

Returns the scm reserved file name where the SCM stores information like '.git', '.svn'.

Specified by:

getScmSpecificFilename in interface ScmProvider

Overrides:

getScmSpecificFilename in class AbstractScmProvider

Returns:

the scm reserved file name

makeProviderScmRepository

public ScmProviderRepository makeProviderScmRepository(java.lang.String scmSpecificUrl,
                                                       char delimiter)
                                                throws ScmRepositoryException

Throws:

ScmRepositoryException

makeProviderScmRepository

public ScmProviderRepository makeProviderScmRepository(java.io.File path)
                                                throws ScmRepositoryException,
                                                       UnknownRepositoryStructure

Try to create a ScmProviderRepository for this provider from the given working directory (created through a previous checkout). This is only successful if the working directory is recognized by this SCM provider.

Specified by:

makeProviderScmRepository in interface ScmProvider

Overrides:

makeProviderScmRepository in class AbstractScmProvider

Parameters:

path - the checkout(working) directory

Returns:

the repository bound to this provider

Throws:

ScmRepositoryException - in case the given directory does not contain a valid working directory recognized by this provider

UnknownRepositoryStructure - in case the provider does not support this way of initializing an ScmProviderRepository

getRepositoryURL

protected abstract java.lang.String getRepositoryURL(java.io.File path)
                                              throws ScmException

Throws:

ScmException

validateScmUrl

public java.util.List<java.lang.String> validateScmUrl(java.lang.String scmSpecificUrl,
                                                       char delimiter)

Validate the scm url.

Specified by:

validateScmUrl in interface ScmProvider

Overrides:

validateScmUrl in class AbstractScmProvider

Parameters:

scmSpecificUrl - the SCM url

delimiter - the delimiter used in the SCM url

Returns:

returns a list of messages if the validation failed

getScmType

public java.lang.String getScmType()

parseScmUrl

private AbstractGitScmProvider.ScmUrlParserResult parseScmUrl(java.lang.String scmSpecificUrl,
                                                              char delimiter)
                                                       throws ScmException

The git-submodule(1) command is available since Git 1.5.3, so modules will be activated in a later stage.

Throws:

ScmException

getAddCommand

protected abstract GitCommand getAddCommand()

add

public AddScmResult add(ScmProviderRepository repository,
                        ScmFileSet fileSet,
                        CommandParameters parameters)
                 throws ScmException

TODO: why public? This should be protected, no?

Overrides:

add in class AbstractScmProvider

Throws:

ScmException

getBranchCommand

protected abstract GitCommand getBranchCommand()

branch

protected BranchScmResult branch(ScmProviderRepository repository,
                                 ScmFileSet fileSet,
                                 CommandParameters parameters)
                          throws ScmException

Overrides:

branch in class AbstractScmProvider

Throws:

ScmException

getChangeLogCommand

protected abstract GitCommand getChangeLogCommand()

changelog

public ChangeLogScmResult changelog(ScmProviderRepository repository,
                                    ScmFileSet fileSet,
                                    CommandParameters parameters)
                             throws ScmException

Overrides:

changelog in class AbstractScmProvider

Throws:

ScmException

getCheckInCommand

protected abstract GitCommand getCheckInCommand()

checkin

public CheckInScmResult checkin(ScmProviderRepository repository,
                                ScmFileSet fileSet,
                                CommandParameters parameters)
                         throws ScmException

Overrides:

checkin in class AbstractScmProvider

Throws:

ScmException

checkIn

public CheckInScmResult checkIn(ScmRepository repository,
                                ScmFileSet fileSet,
                                CommandParameters parameters)
                         throws ScmException

Description copied from interface: ScmProvider

Save the changes you have done into the repository. This will create a new version of the file or directory in the repository.

When the fileSet has no entries, the fileSet.getBaseDir() is recursively committed. When the fileSet has entries, the commit is non-recursive and only the elements in the fileSet are committed.

Specified by:

checkIn in interface ScmProvider

Overrides:

checkIn in class AbstractScmProvider

Parameters:

repository - the source control system

fileSet - the files to check in (sometimes called commit)

parameters - CommandParameters

Returns:

TODO

Throws:

ScmException - if any

getCheckOutCommand

protected abstract GitCommand getCheckOutCommand()

checkout

public CheckOutScmResult checkout(ScmProviderRepository repository,
                                  ScmFileSet fileSet,
                                  CommandParameters parameters)
                           throws ScmException

Overrides:

checkout in class AbstractScmProvider

Throws:

ScmException

getDiffCommand

protected abstract GitCommand getDiffCommand()

diff

public DiffScmResult diff(ScmProviderRepository repository,
                          ScmFileSet fileSet,
                          CommandParameters parameters)
                   throws ScmException

Overrides:

diff in class AbstractScmProvider

Throws:

ScmException

getExportCommand

protected abstract GitCommand getExportCommand()

export

protected ExportScmResult export(ScmProviderRepository repository,
                                 ScmFileSet fileSet,
                                 CommandParameters parameters)
                          throws ScmException

Overrides:

export in class AbstractScmProvider

Throws:

ScmException

getRemoveCommand

protected abstract GitCommand getRemoveCommand()

remove

public RemoveScmResult remove(ScmProviderRepository repository,
                              ScmFileSet fileSet,
                              CommandParameters parameters)
                       throws ScmException

Overrides:

remove in class AbstractScmProvider

Throws:

ScmException

getStatusCommand

protected abstract GitCommand getStatusCommand()

status

public StatusScmResult status(ScmProviderRepository repository,
                              ScmFileSet fileSet,
                              CommandParameters parameters)
                       throws ScmException

Overrides:

status in class AbstractScmProvider

Throws:

ScmException

getTagCommand

protected abstract GitCommand getTagCommand()

tag

public TagScmResult tag(ScmProviderRepository repository,
                        ScmFileSet fileSet,
                        CommandParameters parameters)
                 throws ScmException

Overrides:

tag in class AbstractScmProvider

Throws:

ScmException

getUntagCommand

protected abstract GitCommand getUntagCommand()

untag

public UntagScmResult untag(ScmRepository repository,
                            ScmFileSet fileSet,
                            CommandParameters parameters)
                     throws ScmException

Deletes a tag.

Specified by:

untag in interface ScmProvider

Overrides:

untag in class AbstractScmProvider

Parameters:

repository - the source control system

fileSet - a fileset with the relevant working directory as basedir

parameters - TODO

Returns:

TODO

Throws:

ScmException - if any

getUpdateCommand

protected abstract GitCommand getUpdateCommand()

update

public UpdateScmResult update(ScmProviderRepository repository,
                              ScmFileSet fileSet,
                              CommandParameters parameters)
                       throws ScmException

Overrides:

update in class AbstractScmProvider

Throws:

ScmException

executeCommand

protected ScmResult executeCommand(GitCommand command,
                                   ScmProviderRepository repository,
                                   ScmFileSet fileSet,
                                   CommandParameters parameters)
                            throws ScmException

Throws:

ScmException

getInfoCommand

protected abstract GitCommand getInfoCommand()

info

public InfoScmResult info(ScmProviderRepository repository,
                          ScmFileSet fileSet,
                          CommandParameters parameters)
                   throws ScmException

Specified by:

info in interface ScmProvider

Overrides:

info in class AbstractScmProvider

Parameters:

repository - the source control system

fileSet - location of your local copy

parameters - some parameters (not use currently but for future use)

Returns:

if the scm implementation doesn't support "info" result will null

Throws:

ScmException - if any

blame

protected BlameScmResult blame(ScmProviderRepository repository,
                               ScmFileSet fileSet,
                               CommandParameters parameters)
                        throws ScmException

Overrides:

blame in class AbstractScmProvider

Throws:

ScmException

getBlameCommand

protected abstract GitCommand getBlameCommand()

remoteInfo

public RemoteInfoScmResult remoteInfo(ScmProviderRepository repository,
                                      ScmFileSet fileSet,
                                      CommandParameters parameters)
                               throws ScmException

Specified by:

remoteInfo in interface ScmProvider

Overrides:

remoteInfo in class AbstractScmProvider

Parameters:

repository - the source control system

fileSet - not use currently but for future use

parameters - some parameters (not use currently but for future use)

Returns:

if the scm implementation doesn't support "info" result will null

Throws:

ScmException - if any

getRemoteInfoCommand

protected abstract GitCommand getRemoteInfoCommand()