| java.lang.Object
 org.tmatesoft.svn.core.wc.SVNBasicClient
org.tmatesoft.svn.core.wc.SVNCopyClient
| SVNCopyClient | | public class SVNCopyClient extends SVNBasicClient (Code) | | The SVNCopyClient provides methods to perform any kinds of copying and moving that SVN
supports - operating on both Working Copies (WC) and URLs.
Copy operations allow a user to copy versioned files and directories with all their
previous history in several ways.
Supported copy operations are:
- Working Copy to Working Copy (WC-to-WC) copying - this operation copies the source
Working Copy item to the destination one and schedules the source copy for addition with history.
- Working Copy to URL (WC-to-URL) copying - this operation commits to the repository (exactly
to that repository location that is specified by URL) a copy of the Working Copy item.
- URL to Working Copy (URL-to-WC) copying - this operation will copy the source item from
the repository to the Working Copy item and schedule the source copy for addition with history.
- URL to URL (URL-to-URL) copying - this is a fully repository-side operation, it commits
a copy of the source item to a specified repository location (within the same repository, of
course).
Besides just copying SVNCopyClient also is able to move a versioned item - that is
first making a copy of the source item and then scheduling the source item for deletion
when operating on a Working Copy, or right committing the deletion of the source item when
operating immediately on the repository.
Supported move operations are:
- Working Copy to Working Copy (WC-to-WC) moving - this operation copies the source
Working Copy item to the destination one and schedules the source item for deletion.
- URL to URL (URL-to-URL) moving - this is a fully repository-side operation, it commits
a copy of the source item to a specified repository location and deletes the source item.
Overloaded doCopy() methods of SVNCopyClient are similar to
'svn copy' and 'svn move' commands of the SVN command line client.
version:
1.1.1
author:
TMate Software Ltd.
See Also: Examples |
| Constructor Summary | |
| public | SVNCopyClient(ISVNAuthenticationManager authManager, ISVNOptions options)
Constructs and initializes an SVNCopyClient object
with the specified run-time configuration and authentication
drivers.
If options is null,
then this SVNCopyClient will be using a default run-time
configuration driver which takes client-side settings from the
default SVN's run-time configuration area but is not able to
change those settings (read more on
ISVNOptions and
SVNWCUtil ). | | public | SVNCopyClient(ISVNRepositoryPool repositoryPool, ISVNOptions options)
|
| Method Summary | |
| public SVNCommitInfo | doCopy(SVNURL srcURL, SVNRevision srcRevision, SVNURL dstURL, boolean isMove, String commitMessage)
Copies/moves a source URL to a destination one immediately committing changes
to a repository. | | public SVNCommitInfo | doCopy(SVNURL srcURL, SVNRevision srcRevision, SVNURL dstURL, boolean isMove, boolean failWhenDstExists, String commitMessage)
Copies/moves a source URL to a destination one immediately committing changes
to a repository. | | public SVNCommitInfo | doCopy(File srcPath, SVNRevision srcRevision, SVNURL dstURL, String commitMessage)
Copies a source Working Copy path (or its repository location URL) to a destination
URL immediately committing changes to a repository.
Equivalent to doCopy(srcPath, srcRevision, dstURL, false, commitMessage). | | public SVNCommitInfo | doCopy(File srcPath, SVNRevision srcRevision, SVNURL dstURL, boolean failWhenDstExists, String commitMessage)
Copies a source Working Copy path (or its repository location URL) to a destination
URL immediately committing changes to a repository.
If srcRevision is not
SVNRevision.WORKING then the repository
location URL of srcPath is copied to dstURL. | | public long | doCopy(SVNURL srcURL, SVNRevision srcRevision, File dstPath)
Copies a source URL to a destination Working Copy path. | | public void | doCopy(File srcPath, SVNRevision srcRevision, File dstPath, boolean force, boolean isMove)
Copies/moves a source Working Copy path to a destination Working Copy path.
If srcRevision is not
SVNRevision.WORKING and
isMove = false, then the repository
location URL of srcPath is copied to dstPath. | | public ISVNCommitHandler | getCommitHandler()
Returns the specified commit handler (if set) being in use or a default one
(DefaultSVNCommitHandler) if no special
implementations of ISVNCommitHandler were
previousely provided. | | public ISVNCommitParameters | getCommitParameters()
Returns commit parameters. | | static void | postCopyCleanup(SVNAdminArea dir)
| | public void | setCommitHandler(ISVNCommitHandler handler)
Sets an implementation of ISVNCommitHandler to
the commit handler that will be used during commit operations to handle
commit log messages. | | public void | setCommitParameters(ISVNCommitParameters parameters)
Sets commit parameters to use.
When no parameters are set
DefaultSVNCommitParameters default
ones are used. |
| SVNCopyClient | | public SVNCopyClient(ISVNAuthenticationManager authManager, ISVNOptions options)(Code) | | Constructs and initializes an SVNCopyClient object
with the specified run-time configuration and authentication
drivers.
If options is null,
then this SVNCopyClient will be using a default run-time
configuration driver which takes client-side settings from the
default SVN's run-time configuration area but is not able to
change those settings (read more on
ISVNOptions and
SVNWCUtil ).
If authManager is null,
then this SVNCopyClient will be using a default authentication
and network layers driver (see
SVNWCUtil.createDefaultAuthenticationManager )
which uses server-side settings and auth storage from the
default SVN's run-time configuration area (or system properties
if that area is not found).
Parameters:
authManager - an authentication and network layers driver
Parameters:
options - a run-time configuration options driver |
| doCopy | | public SVNCommitInfo doCopy(SVNURL srcURL, SVNRevision srcRevision, SVNURL dstURL, boolean isMove, String commitMessage) throws SVNException(Code) | | Copies/moves a source URL to a destination one immediately committing changes
to a repository. Equivalent to doCopy(srcURL, srcRevision, dstURL, isMove, false, commitMessage).
Parameters:
srcURL - a source repository location URL
Parameters:
srcRevision - a revision of srcURL
Parameters:
dstURL - a target URL where srcURL is to becopied/moved
Parameters:
isMove - true to move the sourceto the target (only URL-to-URL), false to copy
Parameters:
commitMessage - a commit log message information on the committed revision
throws:
SVNException -
See Also: SVNCopyClient.doCopy(SVNURL,SVNRevision,SVNURL,boolean,boolean,String)
See Also: |
| doCopy | | public SVNCommitInfo doCopy(SVNURL srcURL, SVNRevision srcRevision, SVNURL dstURL, boolean isMove, boolean failWhenDstExists, String commitMessage) throws SVNException(Code) | | Copies/moves a source URL to a destination one immediately committing changes
to a repository.
If dstURL and srcURL are the same,
failWhenDstExists is false and
srcURL is a directory then this directory will be copied into itself.
If dstURL is a directory, dstURL and srcURL are not the same,
failWhenDstExists is false, dstURL
has not the last path element entry of srcURL then that entry will be copied into
dstURL.
Parameters:
srcURL - a source repository location URL
Parameters:
srcRevision - a revision of srcURL
Parameters:
dstURL - a target URL where srcURL is to becopied/moved
Parameters:
isMove - true to move the sourceto the target (only URL-to-URL), false to copy
Parameters:
failWhenDstExists - true to force a failure if the destination exists
Parameters:
commitMessage - a commit log message information on the committed revision
throws:
SVNException - if one of the following is true: srcURL and dstURL are not in thesame repository srcURL was not found in srcRevisiondstURL and srcURL are the same and failWhenDstExists is truedstURL already exists and failWhenDstExists is truedstURL already exists, failWhenDstExists is false, but dstURL already contains the top path element name of srcURL isMove = true and dstURL = srcURL
|
| doCopy | | public SVNCommitInfo doCopy(File srcPath, SVNRevision srcRevision, SVNURL dstURL, String commitMessage) throws SVNException(Code) | | Copies a source Working Copy path (or its repository location URL) to a destination
URL immediately committing changes to a repository.
Equivalent to doCopy(srcPath, srcRevision, dstURL, false, commitMessage).
Parameters:
srcPath - a source Working Copy path
Parameters:
srcRevision - a revision of srcPath
Parameters:
dstURL - a target URL where srcPath is to becopied
Parameters:
commitMessage - a commit log message information on the committed revision
throws:
SVNException - if one of the following is true: srcPath is not under version controlsrcPath has no URL- the repository location of
srcPath was not found in srcRevision dstURL already exists
See Also: SVNCopyClient.doCopy(File,SVNRevision,SVNURL,boolean,String) |
| doCopy | | public SVNCommitInfo doCopy(File srcPath, SVNRevision srcRevision, SVNURL dstURL, boolean failWhenDstExists, String commitMessage) throws SVNException(Code) | | Copies a source Working Copy path (or its repository location URL) to a destination
URL immediately committing changes to a repository.
If srcRevision is not
SVNRevision.WORKING then the repository
location URL of srcPath is copied to dstURL. Otherwise
srcPath itself.
failWhenDstExists behaves
like in
SVNCopyClient.doCopy(SVNURL,SVNRevision,SVNURL,boolean,boolean,String) .
Parameters:
srcPath - a source Working Copy path
Parameters:
srcRevision - a revision of srcPath
Parameters:
dstURL - a target URL where srcPath is to becopied
Parameters:
failWhenDstExists - true to force a failure if the destination exists
Parameters:
commitMessage - a commit log message information on the committed revision
throws:
SVNException - if one of the following is true: srcPath is not under version controlsrcPath has no URL- the repository location of
srcPath was not found in srcRevision dstURL already exists and failWhenDstExists is true
|
| doCopy | | public long doCopy(SVNURL srcURL, SVNRevision srcRevision, File dstPath) throws SVNException(Code) | | Copies a source URL to a destination Working Copy path.
dstPath will be automatically scheduled for addition with history.
Parameters:
srcURL - a source URL
Parameters:
srcRevision - a revision of srcURL
Parameters:
dstPath - a destination WC path the revision number of a source
throws:
SVNException - if one of the following is true: srcURL was not found in srcRevisiondstPath already existsdstPath appears in srcURLdstPath and srcURL are fromdifferent repositoriesdstPath is under version control but missing
|
| doCopy | | public void doCopy(File srcPath, SVNRevision srcRevision, File dstPath, boolean force, boolean isMove) throws SVNException(Code) | | Copies/moves a source Working Copy path to a destination Working Copy path.
If srcRevision is not
SVNRevision.WORKING and
isMove = false, then the repository
location URL of srcPath is copied to dstPath. Otherwise
srcPath itself.
dstPath will be automatically scheduled for addition with history.
Parameters:
srcPath - a source WC path
Parameters:
srcRevision - a revision of srcPath
Parameters:
dstPath - a destination WC path
Parameters:
force - true to force the operationto run
Parameters:
isMove - true to move the sourceto the target (only WC-to-WC), false to copy
throws:
SVNException - if one of the following is true: dstPath already exists and is in the waycontaining an item with the same name as the sourcesrcPath is not under version controlsrcPath does not existsrcPath has no URLdstPath is a child of srcPathdstPath is scheduled for deletionisMove = true and dstURL = srcURL
|
| setCommitHandler | | public void setCommitHandler(ISVNCommitHandler handler)(Code) | | Sets an implementation of ISVNCommitHandler to
the commit handler that will be used during commit operations to handle
commit log messages. The handler will receive a clien's log message and items
(represented as SVNCommitItem objects) that will be
committed. Depending on implementor's aims the initial log message can
be modified (or something else) and returned back.
If using SVNCopyClient without specifying any
commit handler then a default one will be used -
DefaultSVNCommitHandler .
Parameters:
handler - an implementor's handler that will be used to handle commit log messages
See Also: SVNCopyClient.getCommitHandler()
See Also: SVNCommitItem |
| Methods inherited from org.tmatesoft.svn.core.wc.SVNBasicClient | public void checkCancelled() throws SVNCancelException(Code)(Java Doc)
protected SVNRepository createRepository(SVNURL url, boolean mayReuse) throws SVNException(Code)(Java Doc)
protected SVNRepository createRepository(SVNURL url, File path, SVNRevision pegRevision, SVNRevision revision) throws SVNException(Code)(Java Doc)
protected SVNRepository createRepository(SVNURL url, File path, SVNRevision pegRevision, SVNRevision revision, long[] pegRev) throws SVNException(Code)(Java Doc)
protected SVNWCAccess createWCAccess()(Code)(Java Doc)
protected SVNWCAccess createWCAccess(String pathPrefix)(Code)(Java Doc)
protected void dispatchEvent(SVNEvent event) throws SVNException(Code)(Java Doc)
protected void dispatchEvent(SVNEvent event, double progress) throws SVNException(Code)(Java Doc)
public ISVNDebugLog getDebugLog()(Code)(Java Doc)
protected ISVNEventHandler getEventDispatcher()(Code)(Java Doc)
protected SVNRepositoryLocation[] getLocations(SVNURL url, File path, SVNRepository repository, SVNRevision revision, SVNRevision start, SVNRevision end) throws SVNException(Code)(Java Doc)
public ISVNOptions getOptions()(Code)(Java Doc)
protected ISVNRepositoryPool getRepositoryPool()(Code)(Java Doc)
protected long getRevisionNumber(SVNRevision revision, SVNRepository repository, File path) throws SVNException(Code)(Java Doc)
protected SVNURL getURL(File path) throws SVNException(Code)(Java Doc)
public void handleEvent(SVNEvent event, double progress) throws SVNException(Code)(Java Doc)
public boolean isIgnoreExternals()(Code)(Java Doc)
public boolean isLeaveConflictsUnresolved()(Code)(Java Doc)
public void setDebugLog(ISVNDebugLog log)(Code)(Java Doc)
public void setEventHandler(ISVNEventHandler dispatcher)(Code)(Java Doc)
public void setEventPathPrefix(String prefix)(Code)(Java Doc)
public void setIgnoreExternals(boolean ignore)(Code)(Java Doc)
public void setLeaveConflictsUnresolved(boolean leave)(Code)(Java Doc)
public void setOptions(ISVNOptions options)(Code)(Java Doc)
protected void sleepForTimeStamp()(Code)(Java Doc)
|
|
|