Class SVNChangelistClient16
java.lang.Object
org.tmatesoft.svn.core.internal.wc16.SVNBasicDelegate
org.tmatesoft.svn.core.internal.wc16.SVNChangelistClient16
- All Implemented Interfaces:
ISVNCanceller
,ISVNEventHandler
The SVNChangelistClient provides API for managing changelists.
Here's a list of the SVNChangelistClient's methods matched against corresponing commands of the SVN command line client:
SVNKit | Subversion |
doAddToChangelist() | 'svn changelist CLNAME TARGET' |
doRemoveFromChangelist() | 'svn changelist --remove TARGET' |
- Since:
- 1.2
- Version:
- 1.3
-
Nested Class Summary
Nested ClassesNested classes/interfaces inherited from class org.tmatesoft.svn.core.internal.wc16.SVNBasicDelegate
SVNBasicDelegate.RepositoryReference, SVNBasicDelegate.SVNRepositoryLocation
-
Field Summary
Fields inherited from interface org.tmatesoft.svn.core.ISVNCanceller
NULL
Fields inherited from interface org.tmatesoft.svn.core.wc.ISVNEventHandler
UNKNOWN
-
Constructor Summary
ConstructorsConstructorDescriptionSVNChangelistClient16
(ISVNAuthenticationManager authManager, ISVNOptions options) Constructs and initializes an SVNChangelistClient object with the specified run-time configuration and authentication drivers.SVNChangelistClient16
(ISVNRepositoryPool repositoryPool, ISVNOptions options) Constructs and initializes an SVNChangelistClient object with the specified run-time configuration and repository pool object. -
Method Summary
Modifier and TypeMethodDescriptionvoid
addToChangelist
(File[] paths, SVNDepth depth, String changelist, String[] changelists) Deprecated.void
doAddToChangelist
(File[] paths, SVNDepth depth, String changelist, String[] changelists) Adds each path inpaths
(recursing todepth
as necessary) tochangelist
.void
doGetChangeListPaths
(Collection changeLists, Collection targets, SVNDepth depth, ISVNChangelistHandler handler) Gets paths belonging to the specified changelists discovered under the specified targets.void
doGetChangeLists
(File path, Collection changeLists, SVNDepth depth, ISVNChangelistHandler handler) Gets paths belonging to the specified changelists discovered under the specified path.void
doRemoveFromChangelist
(File[] paths, SVNDepth depth, String[] changelists) Removes each path inpaths
(recursing todepth
as necessary) from changelists to which they are currently assigned.void
getChangeListPaths
(Collection changeLists, Collection targets, SVNDepth depth, ISVNChangelistHandler handler) Deprecated.void
getChangeLists
(File path, Collection changeLists, SVNDepth depth, ISVNChangelistHandler handler) Deprecated.void
removeFromChangelist
(File[] paths, SVNDepth depth, String[] changelists) Deprecated.usedoRemoveFromChangelist(File[],SVNDepth,String[])
insteadprivate void
setChangelist
(File[] paths, String changelistName, String[] changelists, SVNDepth depth) Methods inherited from class org.tmatesoft.svn.core.internal.wc16.SVNBasicDelegate
checkCancelled, createRepository, createRepository, createRepository, createWCAccess, createWCAccess, deriveLocation, dispatchEvent, dispatchEvent, elideMergeInfo, ensureSessionURL, getDebugLog, getEntryLocation, getEventDispatcher, getLevelsToLockFromDepth, getLocations, getOptions, getPathLastChangeRevision, getPathRelativeToRoot, getPathRelativeToSession, getRepositoryPool, getReposMergeInfo, getReposRoot, getRevisionNumber, getRevisionNumber, getURL, getWCMergeInfo, getWCOrRepositoryMergeInfo, handleEvent, handlePathListItem, isIgnoreExternals, isLeaveConflictsUnresolved, resolveRevisions, setCommitItemAccess, setCommitItemFlags, setCommitItemProperty, setDebugLog, setEventHandler, setEventPathPrefix, setIgnoreExternals, setLeaveConflictsUnresolved, setOptions, setPathListHandler, sleepForTimeStamp
-
Constructor Details
-
SVNChangelistClient16
Constructs and initializes an SVNChangelistClient object with the specified run-time configuration and authentication drivers. Ifoptions
is null, then this SVNChangelistClient 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 onISVNOptions
andSVNWCUtil
). IfauthManager
is null, then this SVNChangelistClient will be using a default authentication and network layers driver (seeSVNWCUtil.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 driveroptions
- a run-time configuration options driver
-
SVNChangelistClient16
Constructs and initializes an SVNChangelistClient object with the specified run-time configuration and repository pool object. Ifoptions
is null, then this SVNChangelistClient 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 onISVNOptions
andSVNWCUtil
). IfrepositoryPool
is null, thenSVNRepositoryFactory
will be used to createrepository access objects
.- Parameters:
repositoryPool
- a repository pool objectoptions
- a run-time configuration options driver
-
-
Method Details
-
getChangeLists
public void getChangeLists(File path, Collection changeLists, SVNDepth depth, ISVNChangelistHandler handler) throws SVNException Deprecated.- Parameters:
path
-changeLists
-depth
-handler
-- Throws:
SVNException
-
getChangeListPaths
public void getChangeListPaths(Collection changeLists, Collection targets, SVNDepth depth, ISVNChangelistHandler handler) throws SVNException Deprecated.- Parameters:
changeLists
-targets
-depth
-handler
-- Throws:
SVNException
-
addToChangelist
public void addToChangelist(File[] paths, SVNDepth depth, String changelist, String[] changelists) throws SVNException Deprecated.- Parameters:
paths
-depth
-changelist
-changelists
-- Throws:
SVNException
-
removeFromChangelist
public void removeFromChangelist(File[] paths, SVNDepth depth, String[] changelists) throws SVNException Deprecated.usedoRemoveFromChangelist(File[],SVNDepth,String[])
instead- Parameters:
paths
-depth
-changelists
-- Throws:
SVNException
-
doAddToChangelist
public void doAddToChangelist(File[] paths, SVNDepth depth, String changelist, String[] changelists) throws SVNException Adds each path inpaths
(recursing todepth
as necessary) tochangelist
. If a path is already a member of another changelist, then removes it from the other changelist and adds it tochangelist
. (For now, a path cannot belong to two changelists at once.)changelists
is an array ofString
changelist names, used as a restrictive filter on items whose changelist assignments are adjusted; that is, doesn't tweak the changeset of any item unless it's currently a member of one of those changelists. Ifchangelists
is empty (or null), no changelist filtering occurs. Note: this metadata is purely a client-side "bookkeeping" convenience, and is entirely managed by the working copy. Note: this method does not require repository access.- Parameters:
paths
- working copy paths to add tochangelist
depth
- tree depth to processchangelist
- name of the changelist to add new paths tochangelists
- collection of changelist names as a filter- Throws:
SVNException
- Since:
- 1.2.0, New in SVN 1.5.0
-
doRemoveFromChangelist
public void doRemoveFromChangelist(File[] paths, SVNDepth depth, String[] changelists) throws SVNException Removes each path inpaths
(recursing todepth
as necessary) from changelists to which they are currently assigned.changelists
is an array ofString
changelist names, used as a restrictive filter on items whose changelist assignments are removed; that is, doesn't remove from a changeset any item unless it's currently a member of one of those changelists. Ifchangelists
is empty (or null), all changelist assignments in and under each path inpaths
(todepth
) will be removed. Note: this metadata is purely a client-side "bookkeeping" convenience, and is entirely managed by the working copy. Note: this method does not require repository access.- Parameters:
paths
- paths to remove from any changelistsdepth
- tree depth to processchangelists
- collection of changelist names as a filter- Throws:
SVNException
- Since:
- 1.2.0, New in SVN 1.5.0
-
doGetChangeListPaths
public void doGetChangeListPaths(Collection changeLists, Collection targets, SVNDepth depth, ISVNChangelistHandler handler) throws SVNException Gets paths belonging to the specified changelists discovered under the specified targets. This method is just likedoGetChangeLists(File,Collection,SVNDepth,ISVNChangelistHandler)
except for it operates on multiple targets instead of a single one. Note: this method does not require repository access.- Parameters:
changeLists
- collection of changelist namestargets
- working copy paths to operate ondepth
- tree depth to processhandler
- caller's handler to receive path-to-changelist information- Throws:
SVNException
-
doGetChangeLists
public void doGetChangeLists(File path, Collection changeLists, SVNDepth depth, ISVNChangelistHandler handler) throws SVNException Gets paths belonging to the specified changelists discovered under the specified path. Beginning atpath
, crawls todepth
to discover every path in or underpath
which belongs to one of the changelists in
changeLists
(a collection ofString
changelist names). IfchangeLists
is null, discovers paths with any changelist. Callshandler
each time a changelist-having path is discovered. If there was an event handler provided viaSVNBasicDelegate.setEventHandler(ISVNEventHandler)
, then itsISVNCanceller.checkCancelled()
will be invoked during the recursive walk. Note: this method does not require repository access.- Parameters:
path
- target working copy pathchangeLists
- collection of changelist namesdepth
- tree depth to processhandler
- caller's handler to receive path-to-changelist information- Throws:
SVNException
- Since:
- 1.2.0, New in SVN 1.5.0
-
setChangelist
private void setChangelist(File[] paths, String changelistName, String[] changelists, SVNDepth depth) throws SVNException - Throws:
SVNException
-
doAddToChangelist(File[],SVNDepth,String,String[])
instead