public interface ScmManager
Modifier and Type | Method and Description |
---|---|
AddScmResult |
add(ScmRepository repository,
ScmFileSet fileSet)
Adds the given files to the source control system
|
AddScmResult |
add(ScmRepository repository,
ScmFileSet fileSet,
String message)
Adds the given files to the source control system
|
BlameScmResult |
blame(BlameScmRequest blameScmRequest) |
BlameScmResult |
blame(ScmRepository repository,
ScmFileSet fileSet,
String filename)
Returns the blame of specified file
|
BranchScmResult |
branch(ScmRepository repository,
ScmFileSet fileSet,
String branchName)
Branch (or label in some systems) will create a branch of the source file with a certain branch name
|
BranchScmResult |
branch(ScmRepository repository,
ScmFileSet fileSet,
String branchName,
String message)
Branch (or label in some systems) will create a branch of the source file with a certain branch name
|
ChangeLogScmResult |
changeLog(ChangeLogScmRequest scmRequest)
Returns the changes that have happend in the source control system in a certain period of time.
|
ChangeLogScmResult |
changeLog(ScmRepository repository,
ScmFileSet fileSet,
Date startDate,
Date endDate,
int numDays,
ScmBranch branch)
Deprecated.
|
ChangeLogScmResult |
changeLog(ScmRepository repository,
ScmFileSet fileSet,
Date startDate,
Date endDate,
int numDays,
ScmBranch branch,
String datePattern)
Deprecated.
|
ChangeLogScmResult |
changeLog(ScmRepository repository,
ScmFileSet fileSet,
ScmVersion startVersion,
ScmVersion endVersion)
Deprecated.
|
ChangeLogScmResult |
changeLog(ScmRepository repository,
ScmFileSet fileSet,
ScmVersion startRevision,
ScmVersion endRevision,
String datePattern)
Deprecated.
|
CheckInScmResult |
checkIn(ScmRepository repository,
ScmFileSet fileSet,
ScmVersion revision,
String message)
Save the changes you have done into the repository.
|
CheckInScmResult |
checkIn(ScmRepository repository,
ScmFileSet fileSet,
String message)
Save the changes you have done into the repository.
|
CheckOutScmResult |
checkOut(ScmRepository repository,
ScmFileSet fileSet)
Create a copy of the repository on your local machine
|
CheckOutScmResult |
checkOut(ScmRepository scmRepository,
ScmFileSet scmFileSet,
boolean recursive)
Create a copy of the repository on your local machine.
|
CheckOutScmResult |
checkOut(ScmRepository repository,
ScmFileSet fileSet,
ScmVersion version)
Create a copy of the repository on your local machine
|
CheckOutScmResult |
checkOut(ScmRepository scmRepository,
ScmFileSet scmFileSet,
ScmVersion version,
boolean recursive)
Create a copy of the repository on your local machine.
|
DiffScmResult |
diff(ScmRepository scmRepository,
ScmFileSet scmFileSet,
ScmVersion startVersion,
ScmVersion endVersion)
Create a diff between two branch/tag/revision.
|
EditScmResult |
edit(ScmRepository repository,
ScmFileSet fileSet)
Make a file editable.
|
ExportScmResult |
export(ScmRepository repository,
ScmFileSet fileSet)
Create an exported copy of the repository on your local machine
|
ExportScmResult |
export(ScmRepository repository,
ScmFileSet fileSet,
ScmVersion version)
Create an exported copy of the repository on your local machine
|
ExportScmResult |
export(ScmRepository repository,
ScmFileSet fileSet,
ScmVersion version,
String outputDirectory)
Create an exported copy of the repository on your local machine
|
ExportScmResult |
export(ScmRepository repository,
ScmFileSet fileSet,
String outputDirectory)
Create an exported copy of the repository on your local machine
|
ScmProvider |
getProviderByRepository(ScmRepository repository) |
ScmProvider |
getProviderByType(String providerType)
Returns the default provider registered for this providerType or a specific implementation if the
'maven.scm.provider.providerType.implementation' system property is defined.
|
ScmProvider |
getProviderByUrl(String scmUrl) |
ListScmResult |
list(ScmRepository repository,
ScmFileSet fileSet,
boolean recursive,
ScmVersion version)
List each element (files and directories) of fileSet as they exist in the repository.
|
ScmRepository |
makeProviderScmRepository(String providerType,
File path) |
ScmRepository |
makeScmRepository(String scmUrl)
Generate a SCMRepository from a SCM url.
|
MkdirScmResult |
mkdir(ScmRepository repository,
ScmFileSet fileSet,
String message,
boolean createInLocal)
Create new directory/directories in the repository.
|
RemoveScmResult |
remove(ScmRepository repository,
ScmFileSet fileSet,
String message)
Removes the given files from the source control system
|
void |
setScmProvider(String providerType,
ScmProvider provider)
Set a provider to be used for a type of SCM.
|
void |
setScmProviderImplementation(String providerType,
String providerImplementation)
Set the provider implementation
|
StatusScmResult |
status(ScmRepository repository,
ScmFileSet fileSet)
Returns the status of the files in the source control system.
|
TagScmResult |
tag(ScmRepository repository,
ScmFileSet fileSet,
String tagName)
Tag (or label in some systems) will tag the source file with a certain tag
|
TagScmResult |
tag(ScmRepository repository,
ScmFileSet fileSet,
String tagName,
String message)
Tag (or label in some systems) will tag the source file with a certain tag
|
UnEditScmResult |
unedit(ScmRepository repository,
ScmFileSet fileSet)
Make a file no longer editable.
|
UpdateScmResult |
update(ScmRepository repository,
ScmFileSet fileSet)
Updates the copy on the local machine with the changes in the repository
|
UpdateScmResult |
update(ScmRepository repository,
ScmFileSet fileSet,
boolean runChangelog)
Updates the copy on the local machine with the changes in the repository
|
UpdateScmResult |
update(ScmRepository repository,
ScmFileSet fileSet,
Date lastUpdate)
Updates the copy on the local machine with the changes in the repository
|
UpdateScmResult |
update(ScmRepository repository,
ScmFileSet fileSet,
Date lastUpdate,
String datePattern)
Updates the copy on the local machine with the changes in the repository
|
UpdateScmResult |
update(ScmRepository repository,
ScmFileSet fileSet,
ScmVersion version)
Updates the copy on the local machine with the changes in the repository
|
UpdateScmResult |
update(ScmRepository repository,
ScmFileSet fileSet,
ScmVersion version,
boolean runChangelog)
Updates the copy on the local machine with the changes in the repository
|
UpdateScmResult |
update(ScmRepository repository,
ScmFileSet fileSet,
ScmVersion version,
Date lastUpdate)
Updates the copy on the local machine with the changes in the repository
|
UpdateScmResult |
update(ScmRepository repository,
ScmFileSet fileSet,
ScmVersion version,
Date lastUpdate,
String datePattern)
Updates the copy on the local machine with the changes in the repository
|
UpdateScmResult |
update(ScmRepository repository,
ScmFileSet fileSet,
ScmVersion version,
String datePattern)
Updates the copy on the local machine with the changes in the repository
|
UpdateScmResult |
update(ScmRepository repository,
ScmFileSet fileSet,
String datePattern)
Updates the copy on the local machine with the changes in the repository
|
List<String> |
validateScmRepository(String scmUrl)
Validate a SCM URL.
|
ScmRepository makeScmRepository(String scmUrl) throws ScmRepositoryException, NoSuchScmProviderException
scmUrl
- the scm urlScmRepositoryException
- if an error occurs in the scm repository constructionNoSuchScmProviderException
- if the provider doesn't existScmRepository makeProviderScmRepository(String providerType, File path) throws ScmRepositoryException, UnknownRepositoryStructure, NoSuchScmProviderException
List<String> validateScmRepository(String scmUrl)
scmUrl
- the SCM URL to validateList
of String
objects with the messages returned by the SCM providerScmProvider getProviderByUrl(String scmUrl) throws ScmRepositoryException, NoSuchScmProviderException
ScmProvider getProviderByType(String providerType) throws NoSuchScmProviderException
providerType
- The provider type (cvs, svn...)NoSuchScmProviderException
- if the provider doesn't existScmProvider getProviderByRepository(ScmRepository repository) throws NoSuchScmProviderException
NoSuchScmProviderException
void setScmProvider(String providerType, ScmProvider provider)
providerType
- the type of SCM, eg. svn
, cvs
provider
- the provider that will be used for that SCM typevoid setScmProviderImplementation(String providerType, String providerImplementation)
providerType
- The provider type, eg. cvs
providerImplementation
- The provider implementation (the role-hint of the provider), eg. cvs
,
cvs_native
AddScmResult add(ScmRepository repository, ScmFileSet fileSet) throws ScmException
repository
- the source control systemfileSet
- the files to be addedAddScmResult
that contains the files that have been addedScmException
AddScmResult add(ScmRepository repository, ScmFileSet fileSet, String message) throws ScmException
repository
- the source control systemfileSet
- the files to be addedmessage
- a string that is a comment on the new added fileAddScmResult
that contains the files that have been addedScmException
- if anyBranchScmResult branch(ScmRepository repository, ScmFileSet fileSet, String branchName) throws ScmException
repository
- the source control systemfileSet
- the files to branch. Implementations can also give the changes from the
ScmFileSet.getBasedir()
downwards.branchName
- the branch name to apply to the filesScmException
- if anyBranchScmResult branch(ScmRepository repository, ScmFileSet fileSet, String branchName, String message) throws ScmException
repository
- the source control systemfileSet
- the files to branch. Implementations can also give the changes from the
ScmFileSet.getBasedir()
downwards.branchName
- the branch name to apply to the filesmessage
- the commit message used for the tag creationScmException
- if any@Deprecated ChangeLogScmResult changeLog(ScmRepository repository, ScmFileSet fileSet, Date startDate, Date endDate, int numDays, ScmBranch branch) throws ScmException
changeLog(org.apache.maven.scm.command.changelog.ChangeLogScmRequest)
insteadrepository
- the source control systemfileSet
- the files to know the changes about. Implementations can also give the changes from the
ScmFileSet.getBasedir()
downwards.startDate
- the start date of the periodendDate
- the end date of the periodnumDays
- the number days before the current time if startdate and enddate are nullbranch
- the branch/tagScmException
- if any@Deprecated ChangeLogScmResult changeLog(ScmRepository repository, ScmFileSet fileSet, Date startDate, Date endDate, int numDays, ScmBranch branch, String datePattern) throws ScmException
changeLog(org.apache.maven.scm.command.changelog.ChangeLogScmRequest)
insteadrepository
- the source control systemfileSet
- the files to know the changes about. Implementations can also give the changes from the
ScmFileSet.getBasedir()
downwards.startDate
- the start date of the periodendDate
- the end date of the periodnumDays
- the number days before the current time if startdate and enddate are nullbranch
- the branch/tagdatePattern
- the date pattern use in changelog output returned by scm toolScmException
- if anyChangeLogScmResult changeLog(ChangeLogScmRequest scmRequest) throws ScmException
scmRequest
- request wrapping detailed parameters for the changelog commandScmException
- if any@Deprecated ChangeLogScmResult changeLog(ScmRepository repository, ScmFileSet fileSet, ScmVersion startVersion, ScmVersion endVersion) throws ScmException
changeLog(org.apache.maven.scm.command.changelog.ChangeLogScmRequest)
insteadrepository
- the source control systemfileSet
- the files to know the changes about. Implementations can also give the changes from the
ScmFileSet.getBasedir()
downwards.startVersion
- the start branch/tag/revisionendVersion
- the end branch/tag/revisionScmException
- if any@Deprecated ChangeLogScmResult changeLog(ScmRepository repository, ScmFileSet fileSet, ScmVersion startRevision, ScmVersion endRevision, String datePattern) throws ScmException
changeLog(org.apache.maven.scm.command.changelog.ChangeLogScmRequest)
insteadrepository
- the source control systemfileSet
- the files to know the changes about. Implementations can also give the changes from the
ScmFileSet.getBasedir()
downwards.startRevision
- the start revisionendRevision
- the end revisiondatePattern
- the date pattern use in changelog output returned by scm toolScmException
- if anyCheckInScmResult checkIn(ScmRepository repository, ScmFileSet fileSet, String message) throws ScmException
repository
- the source control systemfileSet
- the files to check in (sometimes called commit)message
- a string that is a comment on the changes that where doneScmException
- if anyCheckInScmResult checkIn(ScmRepository repository, ScmFileSet fileSet, ScmVersion revision, String message) throws ScmException
repository
- the source control systemfileSet
- the files to check in (sometimes called commit)revision
- branch/tag/revisionmessage
- a string that is a comment on the changes that where doneScmException
- if anyCheckOutScmResult checkOut(ScmRepository repository, ScmFileSet fileSet) throws ScmException
repository
- the source control systemfileSet
- the files are copied to the ScmFileSet.getBasedir()
locationScmException
- if anyCheckOutScmResult checkOut(ScmRepository repository, ScmFileSet fileSet, ScmVersion version) throws ScmException
repository
- the source control systemfileSet
- the files are copied to the ScmFileSet.getBasedir()
locationversion
- get the version defined by the revision, branch or tagScmException
- if anyCheckOutScmResult checkOut(ScmRepository scmRepository, ScmFileSet scmFileSet, boolean recursive) throws ScmException
scmRepository
- the source control systemscmFileSet
- the files are copied to the ScmFileSet.getBasedir()
locationrecursive
- whether to check out recursivelyScmException
- if anyCheckOutScmResult checkOut(ScmRepository scmRepository, ScmFileSet scmFileSet, ScmVersion version, boolean recursive) throws ScmException
scmRepository
- the source control systemscmFileSet
- the files are copied to the ScmFileSet.getBasedir()
locationversion
- get the version defined by the revision, branch or tagrecursive
- whether to check out recursivelyScmException
- if anyDiffScmResult diff(ScmRepository scmRepository, ScmFileSet scmFileSet, ScmVersion startVersion, ScmVersion endVersion) throws ScmException
scmRepository
- the source control systemscmFileSet
- the files are copied to the ScmFileSet.getBasedir()
locationstartVersion
- the start branch/tag/revisionendVersion
- the end branch/tag/revisionScmException
- if anyEditScmResult edit(ScmRepository repository, ScmFileSet fileSet) throws ScmException
repository
- the source control systemfileSet
- the files to make editableScmException
- if anyExportScmResult export(ScmRepository repository, ScmFileSet fileSet) throws ScmException
repository
- the source control systemfileSet
- the files are copied to the ScmFileSet.getBasedir()
locationScmException
- if anyExportScmResult export(ScmRepository repository, ScmFileSet fileSet, ScmVersion version) throws ScmException
repository
- the source control systemfileSet
- the files are copied to the ScmFileSet.getBasedir()
locationversion
- get the version defined by the branch/tag/revisionScmException
- if anyExportScmResult export(ScmRepository repository, ScmFileSet fileSet, String outputDirectory) throws ScmException
repository
- the source control systemfileSet
- the files are copied to the ScmFileSet.getBasedir()
locationoutputDirectory
- the directory where the export will be storedScmException
- if anyExportScmResult export(ScmRepository repository, ScmFileSet fileSet, ScmVersion version, String outputDirectory) throws ScmException
repository
- the source control systemfileSet
- the files are copied to the ScmFileSet.getBasedir()
locationversion
- get the version defined by the branch/tag/revisionoutputDirectory
- the directory where the export will be storedScmException
- if anyListScmResult list(ScmRepository repository, ScmFileSet fileSet, boolean recursive, ScmVersion version) throws ScmException
repository
- the source control systemfileSet
- the files to listrecursive
- descend recursivelyversion
- use the version defined by the branch/tag/revisionScmException
MkdirScmResult mkdir(ScmRepository repository, ScmFileSet fileSet, String message, boolean createInLocal) throws ScmException
repository
- fileSet
- message
- createInLocal
- ScmException
RemoveScmResult remove(ScmRepository repository, ScmFileSet fileSet, String message) throws ScmException
repository
- the source control systemfileSet
- the files to be removedmessage
- ScmException
- if anyStatusScmResult status(ScmRepository repository, ScmFileSet fileSet) throws ScmException
ScmFileStatus
flags.repository
- the source control systemfileSet
- the files to know the status about. Implementations can also give the changes from the
ScmFileSet.getBasedir()
downwards.ScmException
- if anyTagScmResult tag(ScmRepository repository, ScmFileSet fileSet, String tagName) throws ScmException
repository
- the source control systemfileSet
- the files to tag. Implementations can also give the changes from the
ScmFileSet.getBasedir()
downwards.tagName
- the tag name to apply to the filesScmException
- if anyTagScmResult tag(ScmRepository repository, ScmFileSet fileSet, String tagName, String message) throws ScmException
repository
- the source control systemfileSet
- the files to tag. Implementations can also give the changes from the
ScmFileSet.getBasedir()
downwards.tagName
- the tag name to apply to the filesmessage
- the commit message used for the tag creationScmException
- if anyUnEditScmResult unedit(ScmRepository repository, ScmFileSet fileSet) throws ScmException
edit(org.apache.maven.scm.repository.ScmRepository, org.apache.maven.scm.ScmFileSet)
. It makes the file
read-only again.repository
- the source control systemfileSet
- the files to make uneditableScmException
- if anyUpdateScmResult update(ScmRepository repository, ScmFileSet fileSet) throws ScmException
repository
- the source control systemfileSet
- location of your local copyScmException
- if anyUpdateScmResult update(ScmRepository repository, ScmFileSet fileSet, ScmVersion version) throws ScmException
repository
- the source control systemfileSet
- location of your local copyversion
- use the version defined by the branch/tag/revisionScmException
- if anyUpdateScmResult update(ScmRepository repository, ScmFileSet fileSet, boolean runChangelog) throws ScmException
repository
- the source control systemfileSet
- location of your local copyrunChangelog
- Run the changelog command after the updateScmException
- if anyUpdateScmResult update(ScmRepository repository, ScmFileSet fileSet, ScmVersion version, boolean runChangelog) throws ScmException
repository
- the source control systemfileSet
- location of your local copyversion
- use the version defined by the branch/tag/revisionrunChangelog
- Run the changelog command after the updateScmException
- if anyUpdateScmResult update(ScmRepository repository, ScmFileSet fileSet, String datePattern) throws ScmException
repository
- the source control systemfileSet
- location of your local copydatePattern
- the date pattern use in changelog output returned by scm toolScmException
- if anyUpdateScmResult update(ScmRepository repository, ScmFileSet fileSet, ScmVersion version, String datePattern) throws ScmException
repository
- the source control systemfileSet
- location of your local copyversion
- use the version defined by the branch/tag/revisiondatePattern
- the date pattern use in changelog output returned by scm toolScmException
- if anyUpdateScmResult update(ScmRepository repository, ScmFileSet fileSet, Date lastUpdate) throws ScmException
repository
- the source control systemfileSet
- location of your local copylastUpdate
- ScmException
- if anyUpdateScmResult update(ScmRepository repository, ScmFileSet fileSet, ScmVersion version, Date lastUpdate) throws ScmException
repository
- the source control systemfileSet
- location of your local copyversion
- use the version defined by the branch/tag/revisionlastUpdate
- ScmException
- if anyUpdateScmResult update(ScmRepository repository, ScmFileSet fileSet, Date lastUpdate, String datePattern) throws ScmException
repository
- the source control systemfileSet
- location of your local copylastUpdate
- Date of last updatedatePattern
- the date pattern use in changelog output returned by scm toolScmException
- if anyUpdateScmResult update(ScmRepository repository, ScmFileSet fileSet, ScmVersion version, Date lastUpdate, String datePattern) throws ScmException
repository
- the source control systemfileSet
- location of your local copyversion
- use the version defined by the branch/tag/revisionlastUpdate
- Date of last updatedatePattern
- the date pattern use in changelog output returned by scm toolScmException
- if anyBlameScmResult blame(ScmRepository repository, ScmFileSet fileSet, String filename) throws ScmException
repository
- the source control systemfileSet
- location of your local copyfilename
- fileScmException
- if anyBlameScmResult blame(BlameScmRequest blameScmRequest) throws ScmException
blameScmRequest
- ScmException
- if anyCopyright © 2003–2015 The Apache Software Foundation. All rights reserved.