Package org.tigris.subversion.javahl

Interface SVNClientInterface

All Known Implementing Classes:
SVNClient, SVNClientSynchronized
public interface SVNClientInterface
This interface is the commom interface for all subversion operations. It is implemented by SVNClient and SVNClientSynchronized

  • Method Details

    • dispose

      void dispose()
      release the native peer (should not depend on finalize)

    • getVersion

      Version getVersion()
      Returns:
      Version information about the underlying native libraries.
      Since:
      1.0

    • getAdminDirectoryName

      String getAdminDirectoryName()
      Returns:
      The name of the working copy's administrative directory, which is usually .svn.
      Since:
      1.3
      See Also:
      Instructions on changing this as a work-around for the behavior of ASP.Net on Windows.

    • isAdminDirectory

      boolean isAdminDirectory​(String name)
      Parameters:
      name - The name of the directory to compare.
      Returns:
      Whether name is that of a working copy administrative directory.
      Since:
      1.3

    • getLastPath

      String getLastPath()
      Deprecated.
      Returns the last destination path submitted.
      Returns:
      path in Subversion format.
      Since:
      1.0

    • singleStatus

      Status singleStatus​(String path, boolean onServer) throws ClientException
      Deprecated.
      Use #status(String, int, boolean, boolean, boolean, boolean, StatusCallback) instead.
      Returns the status of a single file in the path.
      Parameters:
      path - File to gather status.
      onServer - Request status information from the server.
      Returns:
      The Subversion status of the file, or null if no status is available.
      Throws:
      ClientException
      Since:
      1.0

    • status

      Status[] status​(String path, boolean descend, boolean onServer, boolean getAll) throws ClientException
      Deprecated.
      Use #status(String, int, boolean, boolean, boolean, boolean, StatusCallback) instead.
      List a directory or file of the working copy.
      Parameters:
      path - Path to explore.
      descend - Recurse into subdirectories if they exist.
      onServer - Request status information from server.
      getAll - get status for uninteresting (unchanged) files.
      Returns:
      Array of Status entries.
      Throws:
      ClientException
      Since:
      1.0

    • status

      Status[] status​(String path, boolean descend, boolean onServer, boolean getAll, boolean noIgnore) throws ClientException
      Deprecated.
      Use #status(String, int, boolean, boolean, boolean, boolean, StatusCallback) instead.
      List a directory or file of the working copy.
      Parameters:
      path - Path to explore.
      descend - Recurse into subdirectories if they exist.
      onServer - Request status information from server.
      getAll - get status for uninteresting (unchanged) files.
      noIgnore - get status for normaly ignored files and directories.
      Returns:
      Array of Status entries.
      Throws:
      ClientException
      Since:
      1.0

    • status

      Status[] status​(String path, boolean descend, boolean onServer, boolean getAll, boolean noIgnore, boolean ignoreExternals) throws ClientException
      Deprecated.
      Use #status(String, int, boolean, boolean, boolean, boolean, StatusCallback) instead.
      List a directory or file of the working copy.
      Parameters:
      path - Path to explore.
      descend - Recurse into subdirectories if they exist.
      onServer - Request status information from server.
      getAll - get status for uninteresting (unchanged) files.
      noIgnore - get status for normaly ignored files and directories.
      ignoreExternals - if externals are ignored during status
      Returns:
      Array of Status entries.
      Throws:
      ClientException
      Since:
      1.2

    • status

      void status​(String path, int depth, boolean onServer, boolean getAll, boolean noIgnore, boolean ignoreExternals, String[] changelists, StatusCallback callback) throws ClientException
      List a directory or file of the working copy.
      Parameters:
      path - Path to explore.
      depth - How deep to recurse into subdirectories.
      onServer - Request status information from server.
      getAll - get status for uninteresting (unchanged) files.
      noIgnore - get status for normaly ignored files and directories.
      ignoreExternals - if externals are ignored during status
      changelists - changelists to filter by
      Throws:
      ClientException
      Since:
      1.5

    • list

      DirEntry[] list​(String url, Revision revision, boolean recurse) throws ClientException
      Deprecated.
      Use list(String, Revision, Revision, int, int, boolean, ListCallback) instead.
      Lists the directory entries of a url on the server.
      Parameters:
      url - the url to list
      revision - the revision to list
      recurse - recurse into subdirectories
      Returns:
      Array of DirEntry objects.
      Throws:
      ClientException
      Since:
      1.0

    • list

      DirEntry[] list​(String url, Revision revision, Revision pegRevision, boolean recurse) throws ClientException
      Deprecated.
      Use list(String, Revision, Revision, int, int, boolean, ListCallback) instead.
      Lists the directory entries of a url on the server.
      Parameters:
      url - the url to list
      revision - the revision to list
      pegRevision - the revision to interpret url
      recurse - recurse into subdirectories
      Returns:
      Array of DirEntry objects.
      Throws:
      ClientException
      Since:
      1.2

    • list

      void list​(String url, Revision revision, Revision pegRevision, int depth, int direntFields, boolean fetchLocks, ListCallback callback) throws ClientException
      Lists the directory entries of a url on the server.
      Parameters:
      url - the url to list
      revision - the revision to list
      pegRevision - the revision to interpret url
      depth - the depth to recurse into subdirectories
      direntFields - the fields to retrieve
      fetchLocks - whether to fetch lock information
      callback - the callback to receive the directory entries
      Throws:
      ClientException
      Since:
      1.5

    • username

      void username​(String username)
      Sets the username used for authentication.
      Parameters:
      username - The username, ignored if the empty string. Set to the empty string to clear it.
      Throws:
      IllegalArgumentException - If username is null.
      Since:
      1.0
      See Also:
      password(String)

    • password

      void password​(String password)
      Sets the password used for authentication.
      Parameters:
      password - The password, ignored if the empty string. Set to the empty string to clear it.
      Throws:
      IllegalArgumentException - If password is null.
      Since:
      1.0
      See Also:
      username(String)

    • setPrompt

      void setPrompt​(PromptUserPassword prompt)
      Register callback interface to supply username and password on demand. This callback can also be used to provide theequivalent of the --no-auth-cache and --non-interactive arguments accepted by the command-line client.
      Parameters:
      prompt - the callback interface
      Since:
      1.0

    • logMessages

      LogMessage[] logMessages​(String path, Revision revisionStart, Revision revisionEnd) throws ClientException
      Deprecated.
      Use logMessages(String, Revision, Revision, Revision, boolean, boolean, boolean, String[], long, LogMessageCallback) instead.
      Retrieve the log messages for an item
      Parameters:
      path - path or url to get the log message for.
      revisionStart - first revision to show
      revisionEnd - last revision to show
      Returns:
      array of LogMessages
      Throws:
      ClientException
      Since:
      1.0

    • logMessages

      LogMessage[] logMessages​(String path, Revision revisionStart, Revision revisionEnd, boolean stopOnCopy) throws ClientException
      Deprecated.
      Use logMessages(String, Revision, Revision, Revision, boolean, boolean, boolean, String[], long, LogMessageCallback) instead.
      Retrieve the log messages for an item
      Parameters:
      path - path or url to get the log message for.
      revisionStart - first revision to show
      revisionEnd - last revision to show
      stopOnCopy - do not continue on copy operations
      Returns:
      array of LogMessages
      Throws:
      ClientException
      Since:
      1.0

    • logMessages

      LogMessage[] logMessages​(String path, Revision revisionStart, Revision revisionEnd, boolean stopOnCopy, boolean discoverPath) throws ClientException
      Deprecated.
      Use logMessages(String, Revision, Revision, Revision, boolean, boolean, boolean, String[], long, LogMessageCallback) instead.
      Retrieve the log messages for an item
      Parameters:
      path - path or url to get the log message for.
      revisionStart - first revision to show
      revisionEnd - last revision to show
      stopOnCopy - do not continue on copy operations
      discoverPath - returns the paths of the changed items in the returned objects
      Returns:
      array of LogMessages
      Throws:
      ClientException
      Since:
      1.0

    • logMessages

      LogMessage[] logMessages​(String path, Revision revisionStart, Revision revisionEnd, boolean stopOnCopy, boolean discoverPath, long limit) throws ClientException
      Deprecated.
      Use logMessages(String, Revision, Revision, Revision, boolean, boolean, boolean, String[], long, LogMessageCallback) instead.
      Retrieve the log messages for an item
      Parameters:
      path - path or url to get the log message for.
      revisionStart - first revision to show
      revisionEnd - last revision to show
      stopOnCopy - do not continue on copy operations
      discoverPath - returns the paths of the changed items in the returned objects
      limit - limit the number of log messages (if 0 or less no limit)
      Returns:
      array of LogMessages
      Throws:
      ClientException
      Since:
      1.2

    • logMessages

      void logMessages​(String path, Revision pegRevision, Revision revisionStart, Revision revisionEnd, boolean stopOnCopy, boolean discoverPath, boolean includeMergedRevisions, String[] revProps, long limit, LogMessageCallback callback) throws ClientException
      Deprecated.
      Use logMessages(String, Revision, RevisionRange[], boolean, boolean, boolean, String[], long, LogMessageCallback) instead.
      Retrieve the log messages for an item.
      Parameters:
      path - path or url to get the log message for.
      pegRevision - revision to interpret path
      revisionStart - first revision to show
      revisionEnd - last revision to show
      stopOnCopy - do not continue on copy operations
      discoverPath - returns the paths of the changed items in the returned objects
      includeMergedRevisions - include log messages for revisions which were merged.
      revProps - the revprops to retrieve
      limit - limit the number of log messages (if 0 or less no limit)
      callback - the object to receive the log messages
      Throws:
      ClientException
      Since:
      1.5

    • logMessages

      void logMessages​(String path, Revision pegRevision, RevisionRange[] ranges, boolean stopOnCopy, boolean discoverPath, boolean includeMergedRevisions, String[] revProps, long limit, LogMessageCallback callback) throws ClientException
      Retrieve the log messages for an item.
      Parameters:
      path - path or url to get the log message for.
      pegRevision - revision to interpret path
      ranges - an array of revision ranges to show
      stopOnCopy - do not continue on copy operations
      discoverPath - returns the paths of the changed items in the returned objects
      includeMergedRevisions - include log messages for revisions which were merged.
      revProps - the revprops to retrieve
      limit - limit the number of log messages (if 0 or less no limit)
      callback - the object to receive the log messages
      Throws:
      ClientException
      Since:
      1.6

    • checkout

      long checkout​(String moduleName, String destPath, Revision revision, boolean recurse) throws ClientException
      Deprecated.
      Use checkout(String, String, Revision, Revision, int, boolean, boolean) instead.
      Executes a revision checkout.
      Parameters:
      moduleName - name of the module to checkout.
      destPath - destination directory for checkout.
      revision - the revision to checkout.
      recurse - whether you want it to checkout files recursively.
      Throws:
      ClientException
      Since:
      1.0

    • checkout

      long checkout​(String moduleName, String destPath, Revision revision, Revision pegRevision, boolean recurse, boolean ignoreExternals) throws ClientException
      Deprecated.
      Use checkout(String, String, Revision, Revision, int, boolean, boolean) instead.
      Executes a revision checkout.
      Parameters:
      moduleName - name of the module to checkout.
      destPath - destination directory for checkout.
      revision - the revision to checkout.
      pegRevision - the peg revision to interpret the path
      recurse - whether you want it to checkout files recursively.
      ignoreExternals - if externals are ignored during checkout
      Throws:
      ClientException
      Since:
      1.2

    • checkout

      long checkout​(String moduleName, String destPath, Revision revision, Revision pegRevision, int depth, boolean ignoreExternals, boolean allowUnverObstructions) throws ClientException
      Executes a revision checkout.
      Parameters:
      moduleName - name of the module to checkout.
      destPath - destination directory for checkout.
      revision - the revision to checkout.
      pegRevision - the peg revision to interpret the path
      depth - how deep to checkout files recursively.
      ignoreExternals - if externals are ignored during checkout
      allowUnverObstructions - allow unversioned paths that obstruct adds
      Throws:
      ClientException
      Since:
      1.5

    • notification

      void notification​(Notify notify)
      Deprecated.
      Use notification2(Notify2) instead.
      Sets the notification callback used to send processing information back to the calling program.
      Parameters:
      notify - listener that the SVN library should call on many file operations.
      Since:
      1.0

    • notification2

      void notification2​(Notify2 notify)
      Sets the notification callback used to send processing information back to the calling program.
      Parameters:
      notify - listener that the SVN library should call on many file operations.
      Since:
      1.2

    • setConflictResolver

      void setConflictResolver​(ConflictResolverCallback listener)
      Set the conflict resolution callback.
      Parameters:
      listener - The conflict resolution callback.
      Since:
      1.5

    • setProgressListener

      void setProgressListener​(ProgressListener listener)
      Set the progress callback.
      Parameters:
      listener - The progress callback.
      Since:
      1.5

    • commitMessageHandler

      void commitMessageHandler​(CommitMessage messageHandler)
      Sets the commit message handler. This allows more complex commit message with the list of the elements to be committed as input.
      Parameters:
      messageHandler - callback for entering commit messages if this is set the message parameter is ignored.
      Since:
      1.0

    • remove

      void remove​(String[] path, String message, boolean force) throws ClientException
      Deprecated.
      Use #remove(String[], String, boolean, boolean) instead.
      Sets a file for deletion.
      Parameters:
      path - path or url to be deleted
      message - if path is a url, this will be the commit message.
      force - delete even when there are local modifications.
      Throws:
      ClientException
      Since:
      1.0

    • remove

      void remove​(String[] path, String message, boolean force, boolean keepLocal, Map revpropTable) throws ClientException
      Sets a file for deletion.
      Parameters:
      path - path or url to be deleted
      message - if path is a url, this will be the commit message.
      force - delete even when there are local modifications.
      keepLocal - only remove the paths from the repository.
      revpropTable - A string-to-string mapping of revision properties to values which will be set if this operation results in a commit.
      Throws:
      ClientException
      Since:
      1.5

    • revert

      void revert​(String path, boolean recurse) throws ClientException
      Deprecated.
      Use #revert(String, int) instead.
      Reverts a file to a pristine state.
      Parameters:
      path - path of the file.
      recurse - recurse into subdirectories
      Throws:
      ClientException
      Since:
      1.0

    • revert

      void revert​(String path, int depth, String[] changelists) throws ClientException
      Reverts a file to a pristine state.
      Parameters:
      path - path of the file.
      depth - the depth to recurse into subdirectories
      changelists - changelists to filter by
      Throws:
      ClientException
      Since:
      1.5

    • add

      void add​(String path, boolean recurse) throws ClientException
      Deprecated.
      Use add(String, int, boolean, boolean, boolean) instead.
      Adds a file to the repository.
      Parameters:
      path - path to be added.
      recurse - recurse into subdirectories
      Throws:
      ClientException
      Since:
      1.0

    • add

      void add​(String path, boolean recurse, boolean force) throws ClientException
      Deprecated.
      Use add(String, int, boolean, boolean, boolean) instead.
      Adds a file to the repository.
      Parameters:
      path - path to be added.
      recurse - recurse into subdirectories
      force - if adding a directory and recurse true and path is a directory, all not already managed files are added.
      Throws:
      ClientException
      Since:
      1.2

    • add

      void add​(String path, int depth, boolean force, boolean noIgnores, boolean addParents) throws ClientException
      Adds a file to the repository.
      Parameters:
      path - path to be added.
      depth - the depth to recurse into subdirectories
      force - if adding a directory and recurse true and path is a directory, all not already managed files are added.
      noIgnores - if false, don't add files or directories matching ignore patterns
      addParents - add any intermediate parents to the working copy
      Throws:
      ClientException
      Since:
      1.5

    • update

      long update​(String path, Revision revision, boolean recurse) throws ClientException
      Deprecated.
      Use update(String, Revision, int, boolean, boolean, boolean) instead.
      Updates the directory or file from repository
      Parameters:
      path - target file.
      revision - the revision number to update. Revision.HEAD will update to the latest revision.
      recurse - recursively update.
      Throws:
      ClientException
      Since:
      1.0

    • update

      long[] update​(String[] path, Revision revision, boolean recurse, boolean ignoreExternals) throws ClientException
      Deprecated.
      Use update(String[], Revision, int, boolean, boolean, boolean) instead.
      Updates the directories or files from repository
      Parameters:
      path - array of target files.
      revision - the revision number to update. Revision.HEAD will update to the latest revision.
      recurse - recursively update.
      ignoreExternals - if externals are ignored during update
      Throws:
      ClientException
      Since:
      1.2

    • update

      long update​(String path, Revision revision, int depth, boolean depthIsSticky, boolean ignoreExternals, boolean allowUnverObstructions) throws ClientException
      Updates the directory or file from repository
      Parameters:
      path - target file.
      revision - the revision number to update. Revision.HEAD will update to the latest revision.
      depth - the depth to recursively update.
      depthIsSticky - if set, and depth is not Depth.unknown, then also set the ambient depth value to depth.
      ignoreExternals - if externals are ignored during update
      allowUnverObstructions - allow unversioned paths that obstruct adds
      Throws:
      ClientException
      Since:
      1.5

    • update

      long[] update​(String[] path, Revision revision, int depth, boolean depthIsSticky, boolean ignoreExternals, boolean allowUnverObstructions) throws ClientException
      Updates the directories or files from repository
      Parameters:
      path - array of target files.
      revision - the revision number to update. Revision.HEAD will update to the latest revision.
      depth - the depth to recursively update.
      depthIsSticky - if set, and depth is not Depth.unknown, then also set the ambient depth value to depth.
      ignoreExternals - if externals are ignored during update
      allowUnverObstructions - allow unversioned paths that obstruct adds
      Throws:
      ClientException
      Since:
      1.5

    • commit

      long commit​(String[] path, String message, boolean recurse) throws ClientException
      Deprecated.
      Use #commit(String[], String, int, boolean, boolean, String[]) instead.
      Commits changes to the repository.
      Parameters:
      path - files to commit.
      message - log message.
      recurse - whether the operation should be done recursively.
      Returns:
      The new revision number created by the commit, or Revision.SVN_INVALID_REVNUM if the revision number is invalid.
      Throws:
      ClientException

    • commit

      long commit​(String[] path, String message, boolean recurse, boolean noUnlock) throws ClientException
      Deprecated.
      Use #commit(String[], String, int, boolean, boolean, String[]) instead.
      Commits changes to the repository.
      Parameters:
      path - files to commit.
      message - log message.
      recurse - whether the operation should be done recursively.
      noUnlock - do remove any locks
      Returns:
      The new revision number created by the commit, or Revision.SVN_INVALID_REVNUM if the revision number is invalid.
      Throws:
      ClientException
      Since:
      1.2

    • commit

      long commit​(String[] path, String message, int depth, boolean noUnlock, boolean keepChangelist, String[] changelists, Map revpropTable) throws ClientException
      Commits changes to the repository.
      Parameters:
      path - files to commit.
      message - log message.
      depth - how deep to recurse in subdirectories
      noUnlock - do remove any locks
      keepChangelist - keep changelist associations after the commit.
      changelists - if non-null, filter paths using changelists
      revpropTable - A string-to-string mapping of revision properties to values which will be set if this operation results in a commit.
      Returns:
      The new revision number created by the commit, or Revision.SVN_INVALID_REVNUM if the revision number is invalid.
      Throws:
      ClientException
      Since:
      1.5

    • copy

      void copy​(CopySource[] sources, String destPath, String message, boolean copyAsChild, boolean makeParents, boolean ignoreExternals, Map revpropTable) throws ClientException
      Copy versioned paths with the history preserved.
      Parameters:
      sources - A list of CopySource objects.
      destPath - Destination path or URL.
      message - Commit message. May be null if destPath is not a URL.
      copyAsChild - Whether to copy srcPaths as children of destPath.
      makeParents - Whether to create intermediate parents
      ignoreExternals - Whether or not to process external definitions as part of this operation.
      revpropTable - A string-to-string mapping of revision properties to values which will be set if this operation results in a commit.
      Throws:
      ClientException - If the copy operation fails.
      Since:
      1.7

    • copy

      void copy​(CopySource[] sources, String destPath, String message, boolean copyAsChild, boolean makeParents, Map revpropTable) throws ClientException
      Deprecated.
      Use copy(CopySource[], String, String, boolean, boolean, boolean, Map) instead.
      Copy versioned paths with the history preserved.
      Parameters:
      sources - A list of CopySource objects.
      destPath - Destination path or URL.
      message - Commit message. May be null if destPath is not a URL.
      copyAsChild - Whether to copy srcPaths as children of destPath.
      makeParents - Whether to create intermediate parents
      revpropTable - A string-to-string mapping of revision properties to values which will be set if this operation results in a commit.
      Throws:
      ClientException - If the copy operation fails.
      Since:
      1.5

    • copy

      void copy​(String srcPath, String destPath, String message, Revision revision) throws ClientException
      Deprecated.
      Use copy(CopySource[], String, String, boolean, boolean, boolean, Map) instead.
      Copy versioned paths with the history preserved (with copyAsChild behavior).
      Parameters:
      srcPath - source path or url
      destPath - destination path or url
      message - commit message if destPath is a url
      revision - source revision
      Throws:
      ClientException

    • move

      void move​(String[] srcPaths, String destPath, String message, boolean force, boolean moveAsChild, boolean makeParents, Map revpropTable) throws ClientException
      Move or rename versioned paths.
      Parameters:
      srcPaths - Source paths or URLs.
      destPath - Destination path or URL.
      message - Commit message. May be null if destPath is not a URL.
      force - Whether to perform the move even if local modifications exist.
      moveAsChild - Whether to move srcPaths as children of destPath.
      makeParents - Whether to create intermediate parents.
      revpropTable - A string-to-string mapping of revision properties to values which will be set if this operation results in a commit.
      Throws:
      ClientException - If the move operation fails.
      Since:
      1.5

    • move

      void move​(String srcPath, String destPath, String message, Revision ignored, boolean force) throws ClientException
      Deprecated.
      Use #move(String[], String, String, boolean, boolean, boolean) instead.
      Throws:
      ClientException
      Since:
      1.2

    • move

      void move​(String srcPath, String destPath, String message, boolean force) throws ClientException
      Deprecated.
      Use #move(String[], String, String, boolean, boolean, boolean) instead.
      Move or rename versioned paths (with moveAsChild behavior).
      Parameters:
      srcPath - source path or url
      destPath - destination path or url
      message - commit message if destPath is a url
      force - even with local modifications.
      Throws:
      ClientException
      Since:
      1.2

    • mkdir

      void mkdir​(String[] path, String message, boolean makeParents, Map revpropTable) throws ClientException
      Creates a directory directly in a repository or creates a directory on disk and schedules it for addition.
      Parameters:
      path - directories to be created
      message - commit message to used if path contains urls
      makeParents - Whether to create intermediate parents
      revpropTable - A string-to-string mapping of revision properties to values which will be set if this operation results in a commit.
      Throws:
      ClientException
      Since:
      1.5

    • mkdir

      void mkdir​(String[] path, String message) throws ClientException
      Creates a directory directly in a repository or creates a directory on disk and schedules it for addition.
      Parameters:
      path - directories to be created
      message - commit message to used if path contains urls
      Throws:
      ClientException

    • cleanup

      void cleanup​(String path) throws ClientException
      Recursively cleans up a local directory, finishing any incomplete operations, removing lockfiles, etc.
      Parameters:
      path - a local directory.
      Throws:
      ClientException

    • resolve

      void resolve​(String path, int depth, int conflictResult) throws SubversionException
      Resolves the conflicted state on a WC path (or tree).
      Parameters:
      path - The path to resolve.
      depth - How deep to recurse into child paths.
      conflictResult - Which version to choose in the event of a conflict.
      Throws:
      SubversionException - If an error occurs.
      Since:
      1.5

    • resolved

      void resolved​(String path, boolean recurse) throws ClientException
      Deprecated.
      Use #resolved(String, int, int) instead.
      Removes the conflicted state on a WC path (or tree).
      Throws:
      ClientException
      See Also:
      #resolved(String, int, int)

    • doExport

      long doExport​(String srcPath, String destPath, Revision revision, boolean force) throws ClientException
      Deprecated.
      Use doExport(String, String, Revision, Revision, boolean, boolean, int, String) instead.
      Exports the contents of either a subversion repository into a 'clean' directory (meaning a directory with no administrative directories).
      Parameters:
      srcPath - the url of the repository path to be exported
      destPath - a destination path that must not already exist.
      revision - the revsion to be exported
      force - set if it is ok to overwrite local files
      Throws:
      ClientException
      Since:
      1.0

    • doExport

      long doExport​(String srcPath, String destPath, Revision revision, Revision pegRevision, boolean force, boolean ignoreExternals, boolean recurse, String nativeEOL) throws ClientException
      Deprecated.
      Use doExport(String, String, Revision, Revision, boolean, boolean, int, String) instead.
      Exports the contents of either a subversion repository into a 'clean' directory (meaning a directory with no administrative directories).
      Parameters:
      srcPath - the url of the repository path to be exported
      destPath - a destination path that must not already exist.
      revision - the revsion to be exported
      pegRevision - the revision to interpret srcPath
      force - set if it is ok to overwrite local files
      ignoreExternals - ignore external during export
      recurse - recurse to subdirectories
      nativeEOL - which EOL characters to use during export
      Throws:
      ClientException
      Since:
      1.2

    • doExport

      long doExport​(String srcPath, String destPath, Revision revision, Revision pegRevision, boolean force, boolean ignoreExternals, int depth, String nativeEOL) throws ClientException
      Exports the contents of either a subversion repository into a 'clean' directory (meaning a directory with no administrative directories).
      Parameters:
      srcPath - the url of the repository path to be exported
      destPath - a destination path that must not already exist.
      revision - the revsion to be exported
      pegRevision - the revision to interpret srcPath
      force - set if it is ok to overwrite local files
      ignoreExternals - ignore external during export
      depth - how deep to recurse in subdirectories
      nativeEOL - which EOL characters to use during export
      Throws:
      ClientException
      Since:
      1.5

    • doSwitch

      long doSwitch​(String path, String url, Revision revision, boolean recurse) throws ClientException
      Deprecated.
      Use doSwitch(String, String, Revision, boolean) instead.
      Update local copy to mirror a new url.
      Parameters:
      path - the working copy path
      url - the new url for the working copy
      revision - the new base revision of working copy
      recurse - traverse into subdirectories
      Throws:
      ClientException
      Since:
      1.0

    • doSwitch

      long doSwitch​(String path, String url, Revision revision, Revision pegRevision, int depth, boolean depthIsSticky, boolean ignoreExternals, boolean allowUnverObstructions) throws ClientException
      Update local copy to mirror a new url.
      Parameters:
      path - the working copy path
      url - the new url for the working copy
      revision - the new base revision of working copy
      pegRevision - the revision at which to interpret path
      depth - how deep to traverse into subdirectories
      depthIsSticky - if set, and depth is not Depth.unknown, then also set the ambient depth value to depth.
      ignoreExternals - whether to process externals definitions
      allowUnverObstructions - allow unversioned paths that obstruct adds
      Throws:
      ClientException
      Since:
      1.5

    • doImport

      void doImport​(String path, String url, String message, boolean recurse) throws ClientException
      Deprecated.
      Use #doImport(String, String, String, int, boolean, boolean) instead.
      Import a file or directory into a repository directory at head.
      Parameters:
      path - the local path
      url - the target url
      message - the log message.
      recurse - traverse into subdirectories
      Throws:
      ClientException
      Since:
      1.0

    • doImport

      void doImport​(String path, String url, String message, int depth, boolean noIgnore, boolean ignoreUnknownNodeTypes, Map revpropTable) throws ClientException
      Import a file or directory into a repository directory at head.
      Parameters:
      path - the local path
      url - the target url
      message - the log message.
      depth - depth to traverse into subdirectories
      noIgnore - whether to add files matched by ignore patterns
      ignoreUnknownNodeTypes - whether to ignore files which the node type is not konwn, just as pipes
      revpropTable - A string-to-string mapping of revision properties to values which will be set if this operation results in a commit.
      Throws:
      ClientException
      Since:
      1.5

    • suggestMergeSources

      String[] suggestMergeSources​(String path, Revision pegRevision) throws SubversionException
      Return an ordered list of suggested merge source URLs.
      Parameters:
      path - The merge target path for which to suggest sources.
      pegRevision - Peg revision used to interpret path.
      Returns:
      The list of URLs, empty if there are no suggestions.
      Throws:
      ClientException - If an error occurs.
      SubversionException
      Since:
      1.5

    • merge

      void merge​(String path1, Revision revision1, String path2, Revision revision2, String localPath, boolean force, boolean recurse) throws ClientException
      Deprecated.
      Use merge(String, Revision, String, Revision, String, boolean, int, boolean, boolean, boolean) instead.
      Merge changes from two paths into a new local path.
      Parameters:
      path1 - first path or url
      revision1 - first revision
      path2 - second path or url
      revision2 - second revision
      localPath - target local path
      force - overwrite local changes
      recurse - traverse into subdirectories
      Throws:
      ClientException
      Since:
      1.0

    • merge

      void merge​(String path1, Revision revision1, String path2, Revision revision2, String localPath, boolean force, boolean recurse, boolean ignoreAncestry, boolean dryRun) throws ClientException
      Deprecated.
      Use merge(String, Revision, String, Revision, String, boolean, int, boolean, boolean, boolean) instead.
      Merge changes from two paths into a new local path.
      Parameters:
      path1 - first path or url
      revision1 - first revision
      path2 - second path or url
      revision2 - second revision
      localPath - target local path
      force - overwrite local changes
      recurse - traverse into subdirectories
      ignoreAncestry - ignore if files are not related
      dryRun - do not change anything
      Throws:
      ClientException
      Since:
      1.2

    • merge

      void merge​(String path1, Revision revision1, String path2, Revision revision2, String localPath, boolean force, int depth, boolean ignoreAncestry, boolean dryRun, boolean recordOnly) throws ClientException
      Merge changes from two paths into a new local path.
      Parameters:
      path1 - first path or url
      revision1 - first revision
      path2 - second path or url
      revision2 - second revision
      localPath - target local path
      force - overwrite local changes
      depth - how deep to traverse into subdirectories
      ignoreAncestry - ignore if files are not related
      dryRun - do not change anything
      recordOnly - record mergeinfo but do not run merge
      Throws:
      ClientException
      Since:
      1.5

    • merge

      void merge​(String path, Revision pegRevision, Revision revision1, Revision revision2, String localPath, boolean force, boolean recurse, boolean ignoreAncestry, boolean dryRun) throws ClientException
      Deprecated.
      Use merge(String, Revision, RevisionRange[], String, boolean, int, boolean, boolean, boolean) instead.
      Merge changes from two paths into a new local path.
      Parameters:
      path - path or url
      pegRevision - revision to interpret path
      revision1 - first revision
      revision2 - second revision
      localPath - target local path
      force - overwrite local changes
      recurse - traverse into subdirectories
      ignoreAncestry - ignore if files are not related
      dryRun - do not change anything
      Throws:
      ClientException
      Since:
      1.2

    • merge

      void merge​(String path, Revision pegRevision, RevisionRange[] revisions, String localPath, boolean force, int depth, boolean ignoreAncestry, boolean dryRun, boolean recordOnly) throws ClientException
      Merge set of revisions into a new local path.
      Parameters:
      path - path or url
      pegRevision - revision to interpret path
      revisions - revisions to merge
      localPath - target local path
      force - overwrite local changes
      depth - how deep to traverse into subdirectories
      ignoreAncestry - ignore if files are not related
      dryRun - do not change anything
      recordOnly - record mergeinfo but do not run merge
      Throws:
      ClientException
      Since:
      1.5

    • mergeReintegrate

      void mergeReintegrate​(String path, Revision pegRevision, String localPath, boolean dryRun) throws ClientException
      Perform a reintegration merge of path into localPath. localPath must be a single-revision, infinite depth, pristine, unswitched working copy -- in other words, it must reflect a single revision tree, the "target". The mergeinfo on path must reflect that all of the target has been merged into it. Then this behaves like a merge from the target's URL to the localPath. The depth of the merge is always infinity.
      Parameters:
      path - path or url
      pegRevision - revision to interpret path
      localPath - target local path
      dryRun - do not change anything
      Throws:
      ClientException
      Since:
      1.5

    • getMergeinfo

      Mergeinfo getMergeinfo​(String path, Revision pegRevision) throws SubversionException
      Get mergeinfo for path at pegRevision.
      Parameters:
      path - WC path or URL.
      pegRevision - peg revision at which to get the merge info for path.
      Returns:
      The merge history of path.
      Throws:
      SubversionException
      Since:
      1.5

    • getMergeinfoLog

      void getMergeinfoLog​(int kind, String pathOrUrl, Revision pegRevision, String mergeSourceUrl, Revision srcPegRevision, boolean discoverChangedPaths, int depth, String[] revProps, LogMessageCallback callback) throws ClientException
      Retrieve either merged or eligible-to-be-merged revisions.
      Parameters:
      kind - kind of revisions to receive: See {@see org.apache.subversion.javahl.MergeinfoLogKind}.
      pathOrUrl - target of merge
      pegRevision - peg rev for pathOrUrl
      mergeSourceUrl - the source of the merge
      srcPegRevision - peg rev for mergeSourceUrl
      discoverChangedPaths - return paths of changed items
      depth - the depth to recurse to
      revProps - the revprops to retrieve
      callback - the object to receive the log messages
      Throws:
      ClientException
      Since:
      1.7

    • getMergeinfoLog

      void getMergeinfoLog​(int kind, String pathOrUrl, Revision pegRevision, String mergeSourceUrl, Revision srcPegRevision, boolean discoverChangedPaths, String[] revProps, LogMessageCallback callback) throws ClientException
      Deprecated.
      Use getMergeinfoLog(int, String, Revision, String, Revision, boolean, int, String[], LogMessageCallback)
      Retrieve either merged or eligible-to-be-merged revisions.
      Parameters:
      kind - kind of revisions to receive: See {@see org.apache.subversion.javahl.MergeinfoLogKind}.
      pathOrUrl - target of merge
      pegRevision - peg rev for pathOrUrl
      mergeSourceUrl - the source of the merge
      srcPegRevision - peg rev for mergeSourceUrl
      discoverChangedPaths - return paths of changed items
      revProps - the revprops to retrieve
      callback - the object to receive the log messages
      Throws:
      ClientException
      Since:
      1.5

    • diff

      void diff​(String target1, Revision revision1, String target2, Revision revision2, String outFileName, boolean recurse) throws ClientException
      Deprecated.
      Use #diff(String, Revision, String, Revision, String, String, int, boolean, boolean, boolean) instead.
      Display the differences between two paths
      Parameters:
      target1 - first path or url
      revision1 - first revision
      target2 - second path or url
      revision2 - second revision
      outFileName - file name where difference are written
      recurse - traverse into subdirectories
      Throws:
      ClientException
      Since:
      1.0

    • diff

      void diff​(String target1, Revision revision1, String target2, Revision revision2, String outFileName, boolean recurse, boolean ignoreAncestry, boolean noDiffDeleted, boolean force) throws ClientException
      Deprecated.
      Use #diff(String, Revision, String, Revision, String, String, int, boolean, boolean, boolean) instead.
      Display the differences between two paths
      Parameters:
      target1 - first path or url
      revision1 - first revision
      target2 - second path or url
      revision2 - second revision
      outFileName - file name where difference are written
      recurse - traverse into subdirectories
      ignoreAncestry - ignore if files are not related
      noDiffDeleted - no output on deleted files
      force - diff even on binary files
      Throws:
      ClientException
      Since:
      1.2

    • diff

      void diff​(String target1, Revision revision1, String target2, Revision revision2, String relativeToDir, String outFileName, int depth, String[] changelists, boolean ignoreAncestry, boolean noDiffDeleted, boolean force, boolean copiesAsAdds) throws ClientException
      Display the differences between two paths
      Parameters:
      target1 - first path or url
      revision1 - first revision
      target2 - second path or url
      revision2 - second revision
      relativeToDir - index path is relative to this path
      outFileName - file name where difference are written
      depth - how deep to traverse into subdirectories
      ignoreAncestry - ignore if files are not related
      noDiffDeleted - no output on deleted files
      force - diff even on binary files
      copiesAsAdds - if set, copied files will be shown in their entirety, not as diffs from their sources
      Throws:
      ClientException
      Since:
      1.7

    • diff

      void diff​(String target1, Revision revision1, String target2, Revision revision2, String relativeToDir, String outFileName, int depth, String[] changelists, boolean ignoreAncestry, boolean noDiffDeleted, boolean force) throws ClientException
      Deprecated.
      Use #diff(String, Revision, String, Revision, String, String, int, boolean, boolean, boolean, boolean) instead.
      Display the differences between two paths
      Parameters:
      target1 - first path or url
      revision1 - first revision
      target2 - second path or url
      revision2 - second revision
      relativeToDir - index path is relative to this path
      outFileName - file name where difference are written
      depth - how deep to traverse into subdirectories
      ignoreAncestry - ignore if files are not related
      noDiffDeleted - no output on deleted files
      force - diff even on binary files
      Throws:
      ClientException
      Since:
      1.5

    • diff

      void diff​(String target, Revision pegRevision, Revision startRevision, Revision endRevision, String outFileName, boolean recurse, boolean ignoreAncestry, boolean noDiffDeleted, boolean force) throws ClientException
      Deprecated.
      Use #diff(String, Revision, Revision, Revision, String, String, int, boolean, boolean, boolean) instead.
      Display the differences between two paths.
      Parameters:
      target - path or url
      pegRevision - revision tointerpret target
      startRevision - first Revision to compare
      endRevision - second Revision to compare
      outFileName - file name where difference are written
      recurse - traverse into subdirectories
      ignoreAncestry - ignore if files are not related
      noDiffDeleted - no output on deleted files
      force - diff even on binary files
      Throws:
      ClientException
      Since:
      1.2

    • diff

      void diff​(String target, Revision pegRevision, Revision startRevision, Revision endRevision, String relativeToDir, String outFileName, int depth, String[] changelists, boolean ignoreAncestry, boolean noDiffDeleted, boolean force, boolean copiesAsAdds) throws ClientException
      Display the differences between two paths.
      Parameters:
      target - path or url
      pegRevision - revision tointerpret target
      startRevision - first Revision to compare
      endRevision - second Revision to compare
      relativeToDir - index path is relative to this path
      outFileName - file name where difference are written
      depth - how deep to traverse into subdirectories
      changelists - if non-null, filter paths using changelists
      ignoreAncestry - ignore if files are not related
      noDiffDeleted - no output on deleted files
      force - diff even on binary files
      copiesAsAdds - if set, copied files will be shown in their entirety, not as diffs from their sources
      Throws:
      ClientException
      Since:
      1.7

    • diff

      void diff​(String target, Revision pegRevision, Revision startRevision, Revision endRevision, String relativeToDir, String outFileName, int depth, String[] changelists, boolean ignoreAncestry, boolean noDiffDeleted, boolean force) throws ClientException
      Deprecated.
      Use #diff(String, Revision, Revision, Revision, String, String, int, boolean, boolean, boolean, boolean) instead.
      Display the differences between two paths.
      Parameters:
      target - path or url
      pegRevision - revision tointerpret target
      startRevision - first Revision to compare
      endRevision - second Revision to compare
      relativeToDir - index path is relative to this path
      outFileName - file name where difference are written
      depth - how deep to traverse into subdirectories
      changelists - if non-null, filter paths using changelists
      ignoreAncestry - ignore if files are not related
      noDiffDeleted - no output on deleted files
      force - diff even on binary files
      Throws:
      ClientException
      Since:
      1.5

    • diffSummarize

      void diffSummarize​(String target1, Revision revision1, String target2, Revision revision2, int depth, String[] changelists, boolean ignoreAncestry, DiffSummaryReceiver receiver) throws ClientException
      Produce a diff summary which lists the items changed between path and revision pairs.
      Parameters:
      target1 - Path or URL.
      revision1 - Revision of target1.
      target2 - Path or URL.
      revision2 - Revision of target2.
      depth - how deep to recurse.
      changelists - if non-null, filter paths using changelists
      ignoreAncestry - Whether to ignore unrelated files during comparison. False positives may potentially be reported if this parameter false, since a file might have been modified between two revisions, but still have the same contents.
      receiver - As each is difference is found, this callback is invoked with a description of the difference.
      Throws:
      ClientException
      Since:
      1.5

    • diffSummarize

      void diffSummarize​(String target, Revision pegRevision, Revision startRevision, Revision endRevision, int depth, String[] changelists, boolean ignoreAncestry, DiffSummaryReceiver receiver) throws ClientException
      Produce a diff summary which lists the items changed between path and revision pairs.
      Parameters:
      target - Path or URL.
      pegRevision - Revision at which to interpret target. If RevisionKind.unspecified or null, behave identically to #diffSummarize(String, Revision, String, Revision, int, boolean, DiffSummaryReceiver), using path for both of that method's targets.
      startRevision - Beginning of range for comparison of target.
      endRevision - End of range for comparison of target.
      depth - how deep to recurse.
      changelists - if non-null, filter paths using changelists
      ignoreAncestry - Whether to ignore unrelated files during comparison. False positives may potentially be reported if this parameter false, since a file might have been modified between two revisions, but still have the same contents.
      receiver - As each is difference is found, this callback is invoked with a description of the difference.
      Throws:
      ClientException
      Since:
      1.5

    • properties

      PropertyData[] properties​(String path) throws ClientException
      Deprecated.
      Use #properties(String, Revision, Revision, int, ProplistCallback) instead.
      Retrieves the properties of an item
      Parameters:
      path - the path of the item
      Returns:
      array of property objects
      Throws:
      ClientException
      Since:
      1.0

    • properties

      PropertyData[] properties​(String path, Revision revision) throws ClientException
      Deprecated.
      Use #properties(String, Revision, Revision, int, ProplistCallback) instead.
      Retrieves the properties of an item
      Parameters:
      path - the path of the item
      revision - the revision of the item
      Returns:
      array of property objects
      Throws:
      ClientException
      Since:
      1.2

    • properties

      PropertyData[] properties​(String path, Revision revision, Revision pegRevision) throws ClientException
      Deprecated.
      Use #properties(String, Revision, Revision, int, ProplistCallback) instead.
      Retrieves the properties of an item
      Parameters:
      path - the path of the item
      revision - the revision of the item
      pegRevision - the revision to interpret path
      Returns:
      array of property objects
      Throws:
      ClientException
      Since:
      1.2

    • properties

      void properties​(String path, Revision revision, Revision pegRevision, int depth, String[] changelists, ProplistCallback callback) throws ClientException
      Retrieves the properties of an item
      Parameters:
      path - the path of the item
      revision - the revision of the item
      pegRevision - the revision to interpret path
      depth - the depth to recurse into subdirectories
      changelists - changelists to filter by
      callback - the callback to use to return the properties
      Throws:
      ClientException
      Since:
      1.5

    • propertySet

      void propertySet​(String path, String name, String value, boolean recurse) throws ClientException
      Deprecated.
      Use #propertySet(String, String, String, int, boolean) instead.
      Sets one property of an item with a String value
      Parameters:
      path - path of the item
      name - name of the property
      value - new value of the property
      recurse - set property also on the subdirectories
      Throws:
      ClientException
      Since:
      1.0

    • propertySet

      void propertySet​(String path, String name, String value, boolean recurse, boolean force) throws ClientException
      Deprecated.
      Use #propertySet(String, String, String, int, boolean) instead.
      Sets one property of an item with a String value
      Parameters:
      path - path of the item
      name - name of the property
      value - new value of the property
      recurse - set property also on the subdirectories
      force - do not check if the value is valid
      Throws:
      ClientException
      Since:
      1.2

    • propertySet

      void propertySet​(String path, String name, byte[] value, boolean recurse) throws ClientException
      Deprecated.
      Use #propertySet(String, String, String, int, boolean) instead.
      Sets one property of an item with a byte array value
      Parameters:
      path - path of the item
      name - name of the property
      value - new value of the property
      recurse - set property also on the subdirectories
      Throws:
      ClientException
      Since:
      1.0

    • propertySet

      void propertySet​(String path, String name, byte[] value, boolean recurse, boolean force) throws ClientException
      Deprecated.
      Use #propertySet(String, String, String, int, boolean) instead.
      Sets one property of an item with a byte array value
      Parameters:
      path - path of the item
      name - name of the property
      value - new value of the property
      recurse - set property also on the subdirectories
      force - do not check if the value is valid
      Throws:
      ClientException
      Since:
      1.2

    • propertySet

      void propertySet​(String path, String name, String value, int depth, String[] changelists, boolean force, Map revpropTable) throws ClientException
      Sets one property of an item with a String value
      Parameters:
      path - path of the item
      name - name of the property
      value - new value of the property
      depth - the depth to recurse into subdirectories
      changelists - changelists to filter by
      force - do not check if the value is valid
      revpropTable - A string-to-string mapping of revision properties to values which will be set if this operation results in a commit.
      Throws:
      ClientException
      Since:
      1.5

    • propertyRemove

      void propertyRemove​(String path, String name, boolean recurse) throws ClientException
      Deprecated.
      Use #propertyRemove(String, String, int) instead.
      Remove one property of an item.
      Parameters:
      path - path of the item
      name - name of the property
      recurse - remove the property also on subdirectories
      Throws:
      ClientException
      Since:
      1.0

    • propertyRemove

      void propertyRemove​(String path, String name, int depth, String[] changelists) throws ClientException
      Remove one property of an item.
      Parameters:
      path - path of the item
      name - name of the property
      depth - the depth to recurse into subdirectories
      changelists - changelists to filter by
      Throws:
      ClientException
      Since:
      1.5

    • propertyCreate

      void propertyCreate​(String path, String name, String value, boolean recurse) throws ClientException
      Deprecated.
      Use #propertyCreate(String, String, String, int, boolean) instead.
      Create and sets one property of an item with a String value
      Parameters:
      path - path of the item
      name - name of the property
      value - new value of the property
      recurse - set property also on the subdirectories
      Throws:
      ClientException
      Since:
      1.0

    • propertyCreate

      void propertyCreate​(String path, String name, String value, boolean recurse, boolean force) throws ClientException
      Deprecated.
      Use #propertyCreate(String, String, String, int, boolean) instead.
      Create and sets one property of an item with a String value
      Parameters:
      path - path of the item
      name - name of the property
      value - new value of the property
      recurse - set property also on the subdirectories
      force - do not check if the value is valid
      Throws:
      ClientException
      Since:
      1.2

    • propertyCreate

      void propertyCreate​(String path, String name, byte[] value, boolean recurse) throws ClientException
      Deprecated.
      Use #propertyCreate(String, String, String, int, boolean) instead.
      Create and sets one property of an item with a byte array value
      Parameters:
      path - path of the item
      name - name of the property
      value - new value of the property
      recurse - set property also on the subdirectories
      Throws:
      ClientException
      Since:
      1.0

    • propertyCreate

      void propertyCreate​(String path, String name, byte[] value, boolean recurse, boolean force) throws ClientException
      Deprecated.
      Use #propertyCreate(String, String, String, int, boolean) instead.
      Create and sets one property of an item with a byte array value
      Parameters:
      path - path of the item
      name - name of the property
      value - new value of the property
      recurse - set property also on the subdirectories
      force - do not check if the value is valid
      Throws:
      ClientException
      Since:
      1.2

    • propertyCreate

      void propertyCreate​(String path, String name, String value, int depth, String[] changelists, boolean force) throws ClientException
      Create and sets one property of an item with a byte array value
      Parameters:
      path - path of the item
      name - name of the property
      value - new value of the property
      depth - depth to set property on the subdirectories
      changelists - changelists to filter by
      force - do not check if the value is valid
      Throws:
      ClientException
      Since:
      1.5

    • revProperty

      PropertyData revProperty​(String path, String name, Revision rev) throws ClientException
      Retrieve one revsision property of one item
      Parameters:
      path - path of the item
      name - name of the property
      rev - revision to retrieve
      Returns:
      the Property
      Throws:
      ClientException
      Since:
      1.0

    • revProperties

      PropertyData[] revProperties​(String path, Revision rev) throws ClientException
      Retrieve all revsision properties of one item
      Parameters:
      path - path of the item
      rev - revision to retrieve
      Returns:
      the Properties
      Throws:
      ClientException
      Since:
      1.2

    • setRevProperty

      void setRevProperty​(String path, String name, Revision rev, String value, boolean force) throws ClientException
      set one revsision property of one item
      Parameters:
      path - path of the item
      name - name of the property
      rev - revision to retrieve
      value - value of the property
      force - use force to set
      Throws:
      ClientException
      Since:
      1.2

    • setRevProperty

      void setRevProperty​(String path, String name, Revision rev, String value, String originalValue, boolean force) throws ClientException
      set one revsision property of one item
      Parameters:
      path - path of the item
      name - name of the property
      rev - revision to retrieve
      value - value of the property
      originalValue - the original value of the property.
      force - use force to set
      Throws:
      ClientException
      Since:
      1.6

    • propertyGet

      PropertyData propertyGet​(String path, String name) throws ClientException
      Deprecated.
      Use propertyGet(String, String, Revision) instead.
      Retrieve one property of one item
      Parameters:
      path - path of the item
      name - name of property
      Returns:
      the Property
      Throws:
      ClientException
      Since:
      1.0

    • propertyGet

      PropertyData propertyGet​(String path, String name, Revision revision) throws ClientException
      Retrieve one property of one item
      Parameters:
      path - path of the item
      name - name of property
      revision - revision of the item
      Returns:
      the Property
      Throws:
      ClientException
      Since:
      1.2

    • propertyGet

      PropertyData propertyGet​(String path, String name, Revision revision, Revision pegRevision) throws ClientException
      Retrieve one property of one item
      Parameters:
      path - path of the item
      name - name of property
      revision - revision of the item
      pegRevision - the revision to interpret path
      Returns:
      the Property
      Throws:
      ClientException
      Since:
      1.2

    • fileContent

      byte[] fileContent​(String path, Revision revision) throws ClientException
      Deprecated.
      Use fileContent(String, Revision, Revision) instead.
      Retrieve the content of a file
      Parameters:
      path - the path of the file
      revision - the revision to retrieve
      Returns:
      the content as byte array
      Throws:
      ClientException
      Since:
      1.0

    • fileContent

      byte[] fileContent​(String path, Revision revision, Revision pegRevision) throws ClientException
      Retrieve the content of a file
      Parameters:
      path - the path of the file
      revision - the revision to retrieve
      pegRevision - the revision to interpret path
      Returns:
      the content as byte array
      Throws:
      ClientException
      Since:
      1.2

    • streamFileContent

      void streamFileContent​(String path, Revision revision, Revision pegRevision, int bufferSize, OutputStream stream) throws ClientException
      Write the file's content to the specified output stream. If you need an InputStream, use a PipedInputStream/PipedOutputStream combination.
      Parameters:
      path - the path of the file
      revision - the revision to retrieve
      pegRevision - the revision at which to interpret the path
      stream - the stream to write the file's content to
      Throws:
      ClientException
      Since:
      1.0
      See Also:
      PipedOutputStream, PipedInputStream

    • relocate

      void relocate​(String from, String to, String path, boolean recurse) throws ClientException
      Rewrite the url's in the working copy
      Parameters:
      from - old url
      to - new url
      path - working copy path
      recurse - recurse into subdirectories
      Throws:
      ClientException
      Since:
      1.0

    • blame

      byte[] blame​(String path, Revision revisionStart, Revision revisionEnd) throws ClientException
      Deprecated.
      Return for each line of the file, the author and the revision of the last together with the content.
      Parameters:
      path - the path
      revisionStart - the first revision to show
      revisionEnd - the last revision to show
      Returns:
      the content together with author and revision of last change
      Throws:
      ClientException
      Since:
      1.0

    • blame

      void blame​(String path, Revision revisionStart, Revision revisionEnd, BlameCallback callback) throws ClientException
      Deprecated.
      Use blame(String, Revision, Revision, Revision, boolean, boolean, BlameCallback2) instead.
      Retrieve the content together with the author, the revision and the date of the last change of each line
      Parameters:
      path - the path
      revisionStart - the first revision to show
      revisionEnd - the last revision to show
      callback - callback to receive the file content and the other information
      Throws:
      ClientException
      Since:
      1.0

    • blame

      void blame​(String path, Revision pegRevision, Revision revisionStart, Revision revisionEnd, BlameCallback callback) throws ClientException
      Deprecated.
      Use blame(String, Revision, Revision, Revision, boolean, boolean, BlameCallback2) instead.
      Retrieve the content together with the author, the revision and the date of the last change of each line
      Parameters:
      path - the path
      pegRevision - the revision to interpret the path
      revisionStart - the first revision to show
      revisionEnd - the last revision to show
      callback - callback to receive the file content and the other information
      Throws:
      ClientException
      Since:
      1.2

    • blame

      void blame​(String path, Revision pegRevision, Revision revisionStart, Revision revisionEnd, boolean ignoreMimeType, boolean includeMergedRevisions, BlameCallback2 callback) throws ClientException
      Deprecated.
      Use blame(String, Revision, Revision, Revision, boolean, boolean, BlameCallback3) instead.
      Retrieve the content together with the author, the revision and the date of the last change of each line
      Parameters:
      path - the path
      pegRevision - the revision to interpret the path
      revisionStart - the first revision to show
      revisionEnd - the last revision to show
      ignoreMimeType - whether or not to ignore the mime-type
      includeMergedRevisions - whether or not to include extra merge information
      callback - callback to receive the file content and the other information
      Throws:
      ClientException
      Since:
      1.5

    • blame

      void blame​(String path, Revision pegRevision, Revision revisionStart, Revision revisionEnd, boolean ignoreMimeType, boolean includeMergedRevisions, BlameCallback3 callback) throws ClientException
      Retrieve the content together with the author, the revision and the date of the last change of each line
      Parameters:
      path - the path
      pegRevision - the revision to interpret the path
      revisionStart - the first revision to show
      revisionEnd - the last revision to show
      ignoreMimeType - whether or not to ignore the mime-type
      includeMergedRevisions - whether or not to include extra merge information
      callback - callback to receive the file content and the other information
      Throws:
      ClientException
      Since:
      1.7

    • setConfigDirectory

      void setConfigDirectory​(String configDir) throws ClientException
      Set directory for the configuration information, taking the usual steps to ensure that Subversion's config file templates exist in the specified location.. On Windows, setting a non-null value will override lookup of configuration in the registry.
      Parameters:
      configDir - Path of the directory, or null for the platform's default.
      Throws:
      ClientException
      Since:
      1.0

    • getConfigDirectory

      String getConfigDirectory() throws ClientException
      Get the configuration directory
      Returns:
      the directory
      Throws:
      ClientException
      Since:
      1.0

    • cancelOperation

      void cancelOperation() throws ClientException
      cancel the active operation
      Throws:
      ClientException
      Since:
      1.0

    • info

      Info info​(String path) throws ClientException
      Deprecated.
      Use #info2(String, Revision, Revision, int, InfoCallback) instead.
      Retrieves the working copy information for an item
      Parameters:
      path - path of the item
      Returns:
      the information object
      Throws:
      ClientException
      Since:
      1.0

    • addToChangelist

      void addToChangelist​(String[] paths, String changelist, int depth, String[] changelists) throws ClientException
      Add paths to a changelist
      Parameters:
      paths - paths to add to the changelist
      changelist - changelist name
      depth - the depth to recurse
      changelists - changelists to filter by
      Throws:
      ClientException
      Since:
      1.5

    • removeFromChangelists

      void removeFromChangelists​(String[] paths, int depth, String[] changelists) throws ClientException
      Remove paths from a changelist
      Parameters:
      paths - paths to remove from the changelist
      depth - the depth to recurse
      changelists - changelists to filter by
      Throws:
      ClientException
      Since:
      1.5

    • getChangelists

      void getChangelists​(String rootPath, String[] changelists, int depth, ChangelistCallback callback) throws ClientException
      Recursively get the paths which belong to a changelist
      Parameters:
      rootPath - the wc path under which to check
      changelists - the changelists to look under
      depth - the depth to recurse
      callback - the callback to return the changelists through
      Throws:
      ClientException
      Since:
      1.5

    • lock

      void lock​(String[] path, String comment, boolean force) throws ClientException
      Lock a working copy item
      Parameters:
      path - path of the item
      comment -
      force - break an existing lock
      Throws:
      ClientException
      Since:
      1.2

    • unlock

      void unlock​(String[] path, boolean force) throws ClientException
      Unlock a working copy item
      Parameters:
      path - path of the item
      force - break an existing lock
      Throws:
      ClientException
      Since:
      1.2

    • info2

      Info2[] info2​(String pathOrUrl, Revision revision, Revision pegRevision, boolean recurse) throws ClientException
      Deprecated.
      Use #info2(String, Revision, Revision, int, InfoCallback) instead.
      Retrieve information about repository or working copy items.
      Parameters:
      pathOrUrl - the path or the url of the item
      revision - the revision of the item to return
      pegRevision - the revision to interpret pathOrUrl
      recurse - flag if to recurse, if the item is a directory
      Returns:
      the information objects
      Throws:
      ClientException
      Since:
      1.2

    • info2

      void info2​(String pathOrUrl, Revision revision, Revision pegRevision, int depth, String[] changelists, InfoCallback callback) throws ClientException
      Retrieve information about repository or working copy items.
      Parameters:
      pathOrUrl - the path or the url of the item
      revision - the revision of the item to return
      pegRevision - the revision to interpret pathOrUrl
      depth - the depth to recurse
      changelists - if non-null, filter paths using changelists
      callback - a callback to receive the infos retrieved
      Throws:
      ClientException
      Since:
      1.5

    • getVersionInfo

      String getVersionInfo​(String path, String trailUrl, boolean lastChanged) throws ClientException
      Produce a compact "version number" for a working copy
      Parameters:
      path - path of the working copy
      trailUrl - to detect switches of the whole working copy
      lastChanged - last changed rather than current revisions
      Returns:
      the compact "version number"
      Throws:
      ClientException
      Since:
      1.2

    • upgrade

      void upgrade​(String path) throws ClientException
      Recursively upgrade a working copy to a new metadata storage format.
      Parameters:
      path - path of the working copy
      Throws:
      ClientException
      Since:
      1.7