com.atlassian.stash.scm.Scm3 |
This interface is deprecated.
in 3.7 for removal in 4.0. In 4.0 this interface's methods will be folded into Scm
and become
a mandatory part of the SCM contract.
Overrides the standard Scm
methods to require the new transitional interfaces introduced for migrating
from "changeset" to "commit". This interface overrides:
getCommandFactory()
to return PluginCommandFactory2
getCompareCommandFactory()
to return PluginCompareCommandFactory2
getPullRequestCommandFactory()
to return PluginPullRequestCommandFactory2
This is a transitional interface to retain API compatibility for Scm
. Its methods will be folded
into Scm
in the 4.0 major release.
Note: PluginCommandFactory
includes methods which, due to the way erasure works for Java generics, cannot
be updated to replace "changeset" with "commit" in a backwards-compatible way. As a result, the SCM changes made
in 4.0 will be backwards-incompatible with no possible way to make an SCM compatible with both 3.x and 4.x.
Those methods are:
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Retrieves a
PluginCommandFactory , used to create Command commands for performing standard SCM
operations such as retrieving commits and viewing diffs. | |||||||||||
Retrieves a
PluginCompareCommandFactory , used to create Command commands tailored for comparing
refs. | |||||||||||
Retrieves a
PluginPullRequestCommandFactory , used to create Command commands tailored for use
supporting pull requests. |
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From interface
com.atlassian.stash.scm.Scm
| |||||||||||
From interface
com.atlassian.stash.scm.Scm2
|
Retrieves a PluginCommandFactory
, used to create Command commands for performing standard SCM
operations such as retrieving commits and viewing diffs. The commands created by the returned factory are used
to support normal system functionality; as a result, SCMs are required to provide an implementation.
Implementation Note: This method is required and may not return null
.
Retrieves a PluginCompareCommandFactory
, used to create Command commands tailored for comparing
refs.
Implementation Note: This method is optional. SCMs which do not support comparing refs may return
null
.
null
if the SCM does not support itRetrieves a PluginPullRequestCommandFactory
, used to create Command commands tailored for use
supporting pull requests. Repositories
using an SCM which implements this method will have
the ability to create, view and merge pull requests.
Implementation Note: This method is optional. SCMs which do not support pull requests may return
null
. Repositories
using such SCMs will not be able to create pull requests.
null
if the SCM does not support pull requests