Interface SVNClientInterface

  • All Known Implementing Classes:
    SVNClient, SVNClientImpl, SVNClientSynchronized

    public interface SVNClientInterface
    This interface is the commom interface for all subversion operations. It is implemented by SVNClient and SVNClientSynchronized
    • Method Summary

      All Methods Instance Methods Abstract Methods Deprecated Methods 
      Modifier and Type Method Description
      void add​(java.lang.String path, boolean recurse)
      void add​(java.lang.String path, boolean recurse, boolean force)
      void add​(java.lang.String path, int depth, boolean force, boolean noIgnores, boolean addParents)
      Adds a file to the repository.
      void addToChangelist​(java.lang.String[] paths, java.lang.String changelist, int depth, java.lang.String[] changelists)
      Add paths to a changelist
      byte[] blame​(java.lang.String path, Revision revisionStart, Revision revisionEnd)
      Deprecated. 
      void blame​(java.lang.String path, Revision revisionStart, Revision revisionEnd, BlameCallback callback)
      void blame​(java.lang.String path, Revision pegRevision, Revision revisionStart, Revision revisionEnd, boolean ignoreMimeType, boolean includeMergedRevisions, BlameCallback2 callback)
      void blame​(java.lang.String path, Revision pegRevision, Revision revisionStart, Revision revisionEnd, boolean ignoreMimeType, boolean includeMergedRevisions, BlameCallback3 callback)
      Retrieve the content together with the author, the revision and the date of the last change of each line
      void blame​(java.lang.String path, Revision pegRevision, Revision revisionStart, Revision revisionEnd, BlameCallback callback)
      void cancelOperation()
      cancel the active operation
      long checkout​(java.lang.String moduleName, java.lang.String destPath, Revision revision, boolean recurse)
      long checkout​(java.lang.String moduleName, java.lang.String destPath, Revision revision, Revision pegRevision, boolean recurse, boolean ignoreExternals)
      long checkout​(java.lang.String moduleName, java.lang.String destPath, Revision revision, Revision pegRevision, int depth, boolean ignoreExternals, boolean allowUnverObstructions)
      Executes a revision checkout.
      void cleanup​(java.lang.String path)
      Recursively cleans up a local directory, finishing any incomplete operations, removing lockfiles, etc.
      long commit​(java.lang.String[] path, java.lang.String message, boolean recurse)
      Deprecated.
      Use #commit(String[], String, int, boolean, boolean, String[]) instead.
      long commit​(java.lang.String[] path, java.lang.String message, boolean recurse, boolean noUnlock)
      Deprecated.
      Use #commit(String[], String, int, boolean, boolean, String[]) instead.
      long commit​(java.lang.String[] path, java.lang.String message, int depth, boolean noUnlock, boolean keepChangelist, java.lang.String[] changelists, java.util.Map revpropTable)
      Commits changes to the repository.
      void commitMessageHandler​(CommitMessage messageHandler)
      Sets the commit message handler.
      void copy​(java.lang.String srcPath, java.lang.String destPath, java.lang.String message, Revision revision)
      void copy​(CopySource[] sources, java.lang.String destPath, java.lang.String message, boolean copyAsChild, boolean makeParents, boolean ignoreExternals, java.util.Map revpropTable)
      Copy versioned paths with the history preserved.
      void copy​(CopySource[] sources, java.lang.String destPath, java.lang.String message, boolean copyAsChild, boolean makeParents, java.util.Map revpropTable)
      void diff​(java.lang.String target1, Revision revision1, java.lang.String target2, Revision revision2, java.lang.String outFileName, boolean recurse)
      Deprecated.
      Use #diff(String, Revision, String, Revision, String, String, int, boolean, boolean, boolean) instead.
      void diff​(java.lang.String target1, Revision revision1, java.lang.String target2, Revision revision2, java.lang.String outFileName, boolean recurse, boolean ignoreAncestry, boolean noDiffDeleted, boolean force)
      Deprecated.
      Use #diff(String, Revision, String, Revision, String, String, int, boolean, boolean, boolean) instead.
      void diff​(java.lang.String target1, Revision revision1, java.lang.String target2, Revision revision2, java.lang.String relativeToDir, java.lang.String outFileName, int depth, java.lang.String[] changelists, boolean ignoreAncestry, boolean noDiffDeleted, boolean force)
      Deprecated.
      Use #diff(String, Revision, String, Revision, String, String, int, boolean, boolean, boolean, boolean) instead.
      void diff​(java.lang.String target1, Revision revision1, java.lang.String target2, Revision revision2, java.lang.String relativeToDir, java.lang.String outFileName, int depth, java.lang.String[] changelists, boolean ignoreAncestry, boolean noDiffDeleted, boolean force, boolean copiesAsAdds)
      Display the differences between two paths
      void diff​(java.lang.String target, Revision pegRevision, Revision startRevision, Revision endRevision, java.lang.String outFileName, boolean recurse, boolean ignoreAncestry, boolean noDiffDeleted, boolean force)
      Deprecated.
      Use #diff(String, Revision, Revision, Revision, String, String, int, boolean, boolean, boolean) instead.
      void diff​(java.lang.String target, Revision pegRevision, Revision startRevision, Revision endRevision, java.lang.String relativeToDir, java.lang.String outFileName, int depth, java.lang.String[] changelists, boolean ignoreAncestry, boolean noDiffDeleted, boolean force)
      Deprecated.
      Use #diff(String, Revision, Revision, Revision, String, String, int, boolean, boolean, boolean, boolean) instead.
      void diff​(java.lang.String target, Revision pegRevision, Revision startRevision, Revision endRevision, java.lang.String relativeToDir, java.lang.String outFileName, int depth, java.lang.String[] changelists, boolean ignoreAncestry, boolean noDiffDeleted, boolean force, boolean copiesAsAdds)
      Display the differences between two paths.
      void diffSummarize​(java.lang.String target1, Revision revision1, java.lang.String target2, Revision revision2, int depth, java.lang.String[] changelists, boolean ignoreAncestry, DiffSummaryReceiver receiver)
      Produce a diff summary which lists the items changed between path and revision pairs.
      void diffSummarize​(java.lang.String target, Revision pegRevision, Revision startRevision, Revision endRevision, int depth, java.lang.String[] changelists, boolean ignoreAncestry, DiffSummaryReceiver receiver)
      Produce a diff summary which lists the items changed between path and revision pairs.
      void dispose()
      release the native peer (should not depend on finalize)
      long doExport​(java.lang.String srcPath, java.lang.String destPath, Revision revision, boolean force)
      long doExport​(java.lang.String srcPath, java.lang.String destPath, Revision revision, Revision pegRevision, boolean force, boolean ignoreExternals, boolean recurse, java.lang.String nativeEOL)
      long doExport​(java.lang.String srcPath, java.lang.String destPath, Revision revision, Revision pegRevision, boolean force, boolean ignoreExternals, int depth, java.lang.String nativeEOL)
      Exports the contents of either a subversion repository into a 'clean' directory (meaning a directory with no administrative directories).
      void doImport​(java.lang.String path, java.lang.String url, java.lang.String message, boolean recurse)
      Deprecated.
      Use #doImport(String, String, String, int, boolean, boolean) instead.
      void doImport​(java.lang.String path, java.lang.String url, java.lang.String message, int depth, boolean noIgnore, boolean ignoreUnknownNodeTypes, java.util.Map revpropTable)
      Import a file or directory into a repository directory at head.
      long doSwitch​(java.lang.String path, java.lang.String url, Revision revision, boolean recurse)
      long doSwitch​(java.lang.String path, java.lang.String url, Revision revision, Revision pegRevision, int depth, boolean depthIsSticky, boolean ignoreExternals, boolean allowUnverObstructions)
      Update local copy to mirror a new url.
      byte[] fileContent​(java.lang.String path, Revision revision)
      Deprecated.
      byte[] fileContent​(java.lang.String path, Revision revision, Revision pegRevision)
      Retrieve the content of a file
      java.lang.String getAdminDirectoryName()  
      void getChangelists​(java.lang.String rootPath, java.lang.String[] changelists, int depth, ChangelistCallback callback)
      Recursively get the paths which belong to a changelist
      java.lang.String getConfigDirectory()
      Get the configuration directory
      java.lang.String getLastPath()
      Deprecated. 
      Mergeinfo getMergeinfo​(java.lang.String path, Revision pegRevision)
      Get mergeinfo for path at pegRevision.
      void getMergeinfoLog​(int kind, java.lang.String pathOrUrl, Revision pegRevision, java.lang.String mergeSourceUrl, Revision srcPegRevision, boolean discoverChangedPaths, int depth, java.lang.String[] revProps, LogMessageCallback callback)
      Retrieve either merged or eligible-to-be-merged revisions.
      void getMergeinfoLog​(int kind, java.lang.String pathOrUrl, Revision pegRevision, java.lang.String mergeSourceUrl, Revision srcPegRevision, boolean discoverChangedPaths, java.lang.String[] revProps, LogMessageCallback callback)
      Version getVersion()  
      java.lang.String getVersionInfo​(java.lang.String path, java.lang.String trailUrl, boolean lastChanged)
      Produce a compact "version number" for a working copy
      Info info​(java.lang.String path)
      Deprecated.
      Use #info2(String, Revision, Revision, int, InfoCallback) instead.
      Info2[] info2​(java.lang.String pathOrUrl, Revision revision, Revision pegRevision, boolean recurse)
      Deprecated.
      Use #info2(String, Revision, Revision, int, InfoCallback) instead.
      void info2​(java.lang.String pathOrUrl, Revision revision, Revision pegRevision, int depth, java.lang.String[] changelists, InfoCallback callback)
      Retrieve information about repository or working copy items.
      boolean isAdminDirectory​(java.lang.String name)  
      DirEntry[] list​(java.lang.String url, Revision revision, boolean recurse)
      DirEntry[] list​(java.lang.String url, Revision revision, Revision pegRevision, boolean recurse)
      void list​(java.lang.String url, Revision revision, Revision pegRevision, int depth, int direntFields, boolean fetchLocks, ListCallback callback)
      Lists the directory entries of a url on the server.
      void lock​(java.lang.String[] path, java.lang.String comment, boolean force)
      Lock a working copy item
      LogMessage[] logMessages​(java.lang.String path, Revision revisionStart, Revision revisionEnd)
      LogMessage[] logMessages​(java.lang.String path, Revision revisionStart, Revision revisionEnd, boolean stopOnCopy)
      LogMessage[] logMessages​(java.lang.String path, Revision revisionStart, Revision revisionEnd, boolean stopOnCopy, boolean discoverPath)
      LogMessage[] logMessages​(java.lang.String path, Revision revisionStart, Revision revisionEnd, boolean stopOnCopy, boolean discoverPath, long limit)
      void logMessages​(java.lang.String path, Revision pegRevision, RevisionRange[] ranges, boolean stopOnCopy, boolean discoverPath, boolean includeMergedRevisions, java.lang.String[] revProps, long limit, LogMessageCallback callback)
      Retrieve the log messages for an item.
      void logMessages​(java.lang.String path, Revision pegRevision, Revision revisionStart, Revision revisionEnd, boolean stopOnCopy, boolean discoverPath, boolean includeMergedRevisions, java.lang.String[] revProps, long limit, LogMessageCallback callback)
      void merge​(java.lang.String path1, Revision revision1, java.lang.String path2, Revision revision2, java.lang.String localPath, boolean force, boolean recurse)
      void merge​(java.lang.String path1, Revision revision1, java.lang.String path2, Revision revision2, java.lang.String localPath, boolean force, boolean recurse, boolean ignoreAncestry, boolean dryRun)
      void merge​(java.lang.String path1, Revision revision1, java.lang.String path2, Revision revision2, java.lang.String localPath, boolean force, int depth, boolean ignoreAncestry, boolean dryRun, boolean recordOnly)
      Merge changes from two paths into a new local path.
      void merge​(java.lang.String path, Revision pegRevision, RevisionRange[] revisions, java.lang.String localPath, boolean force, int depth, boolean ignoreAncestry, boolean dryRun, boolean recordOnly)
      Merge set of revisions into a new local path.
      void merge​(java.lang.String path, Revision pegRevision, Revision revision1, Revision revision2, java.lang.String localPath, boolean force, boolean recurse, boolean ignoreAncestry, boolean dryRun)
      void mergeReintegrate​(java.lang.String path, Revision pegRevision, java.lang.String localPath, boolean dryRun)
      Perform a reintegration merge of path into localPath.
      void mkdir​(java.lang.String[] path, java.lang.String message)
      Creates a directory directly in a repository or creates a directory on disk and schedules it for addition.
      void mkdir​(java.lang.String[] path, java.lang.String message, boolean makeParents, java.util.Map revpropTable)
      Creates a directory directly in a repository or creates a directory on disk and schedules it for addition.
      void move​(java.lang.String[] srcPaths, java.lang.String destPath, java.lang.String message, boolean force, boolean moveAsChild, boolean makeParents, java.util.Map revpropTable)
      Move or rename versioned paths.
      void move​(java.lang.String srcPath, java.lang.String destPath, java.lang.String message, boolean force)
      Deprecated.
      Use #move(String[], String, String, boolean, boolean, boolean) instead.
      void move​(java.lang.String srcPath, java.lang.String destPath, java.lang.String message, Revision ignored, boolean force)
      Deprecated.
      Use #move(String[], String, String, boolean, boolean, boolean) instead.
      void notification​(Notify notify)
      Deprecated.
      void notification2​(Notify2 notify)
      Sets the notification callback used to send processing information back to the calling program.
      void password​(java.lang.String password)
      Sets the password used for authentication.
      PropertyData[] properties​(java.lang.String path)
      Deprecated.
      Use #properties(String, Revision, Revision, int, ProplistCallback) instead.
      PropertyData[] properties​(java.lang.String path, Revision revision)
      Deprecated.
      Use #properties(String, Revision, Revision, int, ProplistCallback) instead.
      PropertyData[] properties​(java.lang.String path, Revision revision, Revision pegRevision)
      Deprecated.
      Use #properties(String, Revision, Revision, int, ProplistCallback) instead.
      void properties​(java.lang.String path, Revision revision, Revision pegRevision, int depth, java.lang.String[] changelists, ProplistCallback callback)
      Retrieves the properties of an item
      void propertyCreate​(java.lang.String path, java.lang.String name, byte[] value, boolean recurse)
      Deprecated.
      Use #propertyCreate(String, String, String, int, boolean) instead.
      void propertyCreate​(java.lang.String path, java.lang.String name, byte[] value, boolean recurse, boolean force)
      Deprecated.
      Use #propertyCreate(String, String, String, int, boolean) instead.
      void propertyCreate​(java.lang.String path, java.lang.String name, java.lang.String value, boolean recurse)
      Deprecated.
      Use #propertyCreate(String, String, String, int, boolean) instead.
      void propertyCreate​(java.lang.String path, java.lang.String name, java.lang.String value, boolean recurse, boolean force)
      Deprecated.
      Use #propertyCreate(String, String, String, int, boolean) instead.
      void propertyCreate​(java.lang.String path, java.lang.String name, java.lang.String value, int depth, java.lang.String[] changelists, boolean force)
      Create and sets one property of an item with a byte array value
      PropertyData propertyGet​(java.lang.String path, java.lang.String name)
      Deprecated.
      PropertyData propertyGet​(java.lang.String path, java.lang.String name, Revision revision)
      Retrieve one property of one item
      PropertyData propertyGet​(java.lang.String path, java.lang.String name, Revision revision, Revision pegRevision)
      Retrieve one property of one item
      void propertyRemove​(java.lang.String path, java.lang.String name, boolean recurse)
      Deprecated.
      Use #propertyRemove(String, String, int) instead.
      void propertyRemove​(java.lang.String path, java.lang.String name, int depth, java.lang.String[] changelists)
      Remove one property of an item.
      void propertySet​(java.lang.String path, java.lang.String name, byte[] value, boolean recurse)
      Deprecated.
      Use #propertySet(String, String, String, int, boolean) instead.
      void propertySet​(java.lang.String path, java.lang.String name, byte[] value, boolean recurse, boolean force)
      Deprecated.
      Use #propertySet(String, String, String, int, boolean) instead.
      void propertySet​(java.lang.String path, java.lang.String name, java.lang.String value, boolean recurse)
      Deprecated.
      Use #propertySet(String, String, String, int, boolean) instead.
      void propertySet​(java.lang.String path, java.lang.String name, java.lang.String value, boolean recurse, boolean force)
      Deprecated.
      Use #propertySet(String, String, String, int, boolean) instead.
      void propertySet​(java.lang.String path, java.lang.String name, java.lang.String value, int depth, java.lang.String[] changelists, boolean force, java.util.Map revpropTable)
      Sets one property of an item with a String value
      void relocate​(java.lang.String from, java.lang.String to, java.lang.String path, boolean recurse)
      Rewrite the url's in the working copy
      void remove​(java.lang.String[] path, java.lang.String message, boolean force)
      Deprecated.
      Use #remove(String[], String, boolean, boolean) instead.
      void remove​(java.lang.String[] path, java.lang.String message, boolean force, boolean keepLocal, java.util.Map revpropTable)
      Sets a file for deletion.
      void removeFromChangelists​(java.lang.String[] paths, int depth, java.lang.String[] changelists)
      Remove paths from a changelist
      void resolve​(java.lang.String path, int depth, int conflictResult)
      Resolves the conflicted state on a WC path (or tree).
      void resolved​(java.lang.String path, boolean recurse)
      Deprecated.
      Use #resolved(String, int, int) instead.
      void revert​(java.lang.String path, boolean recurse)
      Deprecated.
      Use #revert(String, int) instead.
      void revert​(java.lang.String path, int depth, java.lang.String[] changelists)
      Reverts a file to a pristine state.
      PropertyData[] revProperties​(java.lang.String path, Revision rev)
      Retrieve all revsision properties of one item
      PropertyData revProperty​(java.lang.String path, java.lang.String name, Revision rev)
      Retrieve one revsision property of one item
      void setConfigDirectory​(java.lang.String configDir)
      Set directory for the configuration information, taking the usual steps to ensure that Subversion's config file templates exist in the specified location..
      void setConflictResolver​(ConflictResolverCallback listener)
      Set the conflict resolution callback.
      void setProgressListener​(ProgressListener listener)
      Set the progress callback.
      void setPrompt​(PromptUserPassword prompt)
      Register callback interface to supply username and password on demand.
      void setRevProperty​(java.lang.String path, java.lang.String name, Revision rev, java.lang.String value, boolean force)
      set one revsision property of one item
      void setRevProperty​(java.lang.String path, java.lang.String name, Revision rev, java.lang.String value, java.lang.String originalValue, boolean force)
      set one revsision property of one item
      Status singleStatus​(java.lang.String path, boolean onServer)
      Deprecated.
      Use #status(String, int, boolean, boolean, boolean, boolean, StatusCallback) instead.
      Status[] status​(java.lang.String path, boolean descend, boolean onServer, boolean getAll)
      Deprecated.
      Use #status(String, int, boolean, boolean, boolean, boolean, StatusCallback) instead.
      Status[] status​(java.lang.String path, boolean descend, boolean onServer, boolean getAll, boolean noIgnore)
      Deprecated.
      Use #status(String, int, boolean, boolean, boolean, boolean, StatusCallback) instead.
      Status[] status​(java.lang.String path, boolean descend, boolean onServer, boolean getAll, boolean noIgnore, boolean ignoreExternals)
      Deprecated.
      Use #status(String, int, boolean, boolean, boolean, boolean, StatusCallback) instead.
      void status​(java.lang.String path, int depth, boolean onServer, boolean getAll, boolean noIgnore, boolean ignoreExternals, java.lang.String[] changelists, StatusCallback callback)
      List a directory or file of the working copy.
      void streamFileContent​(java.lang.String path, Revision revision, Revision pegRevision, int bufferSize, java.io.OutputStream stream)
      Write the file's content to the specified output stream.
      java.lang.String[] suggestMergeSources​(java.lang.String path, Revision pegRevision)
      Return an ordered list of suggested merge source URLs.
      void unlock​(java.lang.String[] path, boolean force)
      Unlock a working copy item
      long[] update​(java.lang.String[] path, Revision revision, boolean recurse, boolean ignoreExternals)
      long[] update​(java.lang.String[] path, Revision revision, int depth, boolean depthIsSticky, boolean ignoreExternals, boolean allowUnverObstructions)
      Updates the directories or files from repository
      long update​(java.lang.String path, Revision revision, boolean recurse)
      long update​(java.lang.String path, Revision revision, int depth, boolean depthIsSticky, boolean ignoreExternals, boolean allowUnverObstructions)
      Updates the directory or file from repository
      void upgrade​(java.lang.String path)
      Recursively upgrade a working copy to a new metadata storage format.
      void username​(java.lang.String username)
      Sets the username used for authentication.
    • Method Detail

      • 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
      • isAdminDirectory

        boolean isAdminDirectory​(java.lang.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

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

        Status singleStatus​(java.lang.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​(java.lang.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​(java.lang.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​(java.lang.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​(java.lang.String path,
                    int depth,
                    boolean onServer,
                    boolean getAll,
                    boolean noIgnore,
                    boolean ignoreExternals,
                    java.lang.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

        void list​(java.lang.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​(java.lang.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:
        java.lang.IllegalArgumentException - If username is null.
        Since:
        1.0
        See Also:
        password(String)
      • password

        void password​(java.lang.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:
        java.lang.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

        void logMessages​(java.lang.String path,
                         Revision pegRevision,
                         Revision revisionStart,
                         Revision revisionEnd,
                         boolean stopOnCopy,
                         boolean discoverPath,
                         boolean includeMergedRevisions,
                         java.lang.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
        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​(java.lang.String path,
                         Revision pegRevision,
                         RevisionRange[] ranges,
                         boolean stopOnCopy,
                         boolean discoverPath,
                         boolean includeMergedRevisions,
                         java.lang.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​(java.lang.String moduleName,
                      java.lang.String destPath,
                      Revision revision,
                      Revision pegRevision,
                      boolean recurse,
                      boolean ignoreExternals)
               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
        recurse - whether you want it to checkout files recursively.
        ignoreExternals - if externals are ignored during checkout
        Throws:
        ClientException
        Since:
        1.2
      • checkout

        long checkout​(java.lang.String moduleName,
                      java.lang.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.
        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​(java.lang.String[] path,
                    java.lang.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​(java.lang.String[] path,
                    java.lang.String message,
                    boolean force,
                    boolean keepLocal,
                    java.util.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​(java.lang.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​(java.lang.String path,
                    int depth,
                    java.lang.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​(java.lang.String path,
                 boolean recurse,
                 boolean force)
          throws ClientException
        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​(java.lang.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​(java.lang.String[] path,
                      Revision revision,
                      boolean recurse,
                      boolean ignoreExternals)
               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.
        recurse - recursively update.
        ignoreExternals - if externals are ignored during update
        Throws:
        ClientException
        Since:
        1.2
      • update

        long update​(java.lang.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​(java.lang.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​(java.lang.String[] path,
                    java.lang.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​(java.lang.String[] path,
                    java.lang.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​(java.lang.String[] path,
                    java.lang.String message,
                    int depth,
                    boolean noUnlock,
                    boolean keepChangelist,
                    java.lang.String[] changelists,
                    java.util.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,
                  java.lang.String destPath,
                  java.lang.String message,
                  boolean copyAsChild,
                  boolean makeParents,
                  boolean ignoreExternals,
                  java.util.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,
                  java.lang.String destPath,
                  java.lang.String message,
                  boolean copyAsChild,
                  boolean makeParents,
                  java.util.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
        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
      • move

        void move​(java.lang.String[] srcPaths,
                  java.lang.String destPath,
                  java.lang.String message,
                  boolean force,
                  boolean moveAsChild,
                  boolean makeParents,
                  java.util.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​(java.lang.String srcPath,
                  java.lang.String destPath,
                  java.lang.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​(java.lang.String srcPath,
                  java.lang.String destPath,
                  java.lang.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​(java.lang.String[] path,
                   java.lang.String message,
                   boolean makeParents,
                   java.util.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​(java.lang.String[] path,
                   java.lang.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​(java.lang.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​(java.lang.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​(java.lang.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​(java.lang.String srcPath,
                      java.lang.String destPath,
                      Revision revision,
                      boolean force)
               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
        force - set if it is ok to overwrite local files
        Throws:
        ClientException
        Since:
        1.0
      • doExport

        long doExport​(java.lang.String srcPath,
                      java.lang.String destPath,
                      Revision revision,
                      Revision pegRevision,
                      boolean force,
                      boolean ignoreExternals,
                      boolean recurse,
                      java.lang.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
        recurse - recurse to subdirectories
        nativeEOL - which EOL characters to use during export
        Throws:
        ClientException
        Since:
        1.2
      • doExport

        long doExport​(java.lang.String srcPath,
                      java.lang.String destPath,
                      Revision revision,
                      Revision pegRevision,
                      boolean force,
                      boolean ignoreExternals,
                      int depth,
                      java.lang.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​(java.lang.String path,
                      java.lang.String url,
                      Revision revision,
                      boolean recurse)
               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
        recurse - traverse into subdirectories
        Throws:
        ClientException
        Since:
        1.0
      • doSwitch

        long doSwitch​(java.lang.String path,
                      java.lang.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​(java.lang.String path,
                      java.lang.String url,
                      java.lang.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​(java.lang.String path,
                      java.lang.String url,
                      java.lang.String message,
                      int depth,
                      boolean noIgnore,
                      boolean ignoreUnknownNodeTypes,
                      java.util.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

        java.lang.String[] suggestMergeSources​(java.lang.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​(java.lang.String path1,
                   Revision revision1,
                   java.lang.String path2,
                   Revision revision2,
                   java.lang.String localPath,
                   boolean force,
                   boolean recurse,
                   boolean ignoreAncestry,
                   boolean dryRun)
            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
        recurse - traverse into subdirectories
        ignoreAncestry - ignore if files are not related
        dryRun - do not change anything
        Throws:
        ClientException
        Since:
        1.2
      • merge

        void merge​(java.lang.String path1,
                   Revision revision1,
                   java.lang.String path2,
                   Revision revision2,
                   java.lang.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​(java.lang.String path,
                   Revision pegRevision,
                   Revision revision1,
                   Revision revision2,
                   java.lang.String localPath,
                   boolean force,
                   boolean recurse,
                   boolean ignoreAncestry,
                   boolean dryRun)
            throws ClientException
        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​(java.lang.String path,
                   Revision pegRevision,
                   RevisionRange[] revisions,
                   java.lang.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​(java.lang.String path,
                              Revision pegRevision,
                              java.lang.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​(java.lang.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,
                             java.lang.String pathOrUrl,
                             Revision pegRevision,
                             java.lang.String mergeSourceUrl,
                             Revision srcPegRevision,
                             boolean discoverChangedPaths,
                             int depth,
                             java.lang.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,
                             java.lang.String pathOrUrl,
                             Revision pegRevision,
                             java.lang.String mergeSourceUrl,
                             Revision srcPegRevision,
                             boolean discoverChangedPaths,
                             java.lang.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
        revProps - the revprops to retrieve
        callback - the object to receive the log messages
        Throws:
        ClientException
        Since:
        1.5
      • diff

        void diff​(java.lang.String target1,
                  Revision revision1,
                  java.lang.String target2,
                  Revision revision2,
                  java.lang.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​(java.lang.String target1,
                  Revision revision1,
                  java.lang.String target2,
                  Revision revision2,
                  java.lang.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​(java.lang.String target1,
                  Revision revision1,
                  java.lang.String target2,
                  Revision revision2,
                  java.lang.String relativeToDir,
                  java.lang.String outFileName,
                  int depth,
                  java.lang.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​(java.lang.String target1,
                  Revision revision1,
                  java.lang.String target2,
                  Revision revision2,
                  java.lang.String relativeToDir,
                  java.lang.String outFileName,
                  int depth,
                  java.lang.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​(java.lang.String target,
                  Revision pegRevision,
                  Revision startRevision,
                  Revision endRevision,
                  java.lang.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​(java.lang.String target,
                  Revision pegRevision,
                  Revision startRevision,
                  Revision endRevision,
                  java.lang.String relativeToDir,
                  java.lang.String outFileName,
                  int depth,
                  java.lang.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​(java.lang.String target,
                  Revision pegRevision,
                  Revision startRevision,
                  Revision endRevision,
                  java.lang.String relativeToDir,
                  java.lang.String outFileName,
                  int depth,
                  java.lang.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​(java.lang.String target1,
                           Revision revision1,
                           java.lang.String target2,
                           Revision revision2,
                           int depth,
                           java.lang.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​(java.lang.String target,
                           Revision pegRevision,
                           Revision startRevision,
                           Revision endRevision,
                           int depth,
                           java.lang.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 comparsion of target.
        endRevision - End of range for comparsion 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​(java.lang.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​(java.lang.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​(java.lang.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​(java.lang.String path,
                        Revision revision,
                        Revision pegRevision,
                        int depth,
                        java.lang.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​(java.lang.String path,
                         java.lang.String name,
                         java.lang.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​(java.lang.String path,
                         java.lang.String name,
                         java.lang.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​(java.lang.String path,
                         java.lang.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​(java.lang.String path,
                         java.lang.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​(java.lang.String path,
                         java.lang.String name,
                         java.lang.String value,
                         int depth,
                         java.lang.String[] changelists,
                         boolean force,
                         java.util.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​(java.lang.String path,
                            java.lang.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​(java.lang.String path,
                            java.lang.String name,
                            int depth,
                            java.lang.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​(java.lang.String path,
                            java.lang.String name,
                            java.lang.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​(java.lang.String path,
                            java.lang.String name,
                            java.lang.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​(java.lang.String path,
                            java.lang.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​(java.lang.String path,
                            java.lang.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​(java.lang.String path,
                            java.lang.String name,
                            java.lang.String value,
                            int depth,
                            java.lang.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​(java.lang.String path,
                                 java.lang.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​(java.lang.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​(java.lang.String path,
                            java.lang.String name,
                            Revision rev,
                            java.lang.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​(java.lang.String path,
                            java.lang.String name,
                            Revision rev,
                            java.lang.String value,
                            java.lang.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​(java.lang.String path,
                                 java.lang.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​(java.lang.String path,
                                 java.lang.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​(java.lang.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​(java.lang.String path,
                               Revision revision,
                               Revision pegRevision,
                               int bufferSize,
                               java.io.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​(java.lang.String from,
                      java.lang.String to,
                      java.lang.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​(java.lang.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​(java.lang.String path,
                   Revision pegRevision,
                   Revision revisionStart,
                   Revision revisionEnd,
                   boolean ignoreMimeType,
                   boolean includeMergedRevisions,
                   BlameCallback2 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.5
      • blame

        void blame​(java.lang.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​(java.lang.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

        java.lang.String getConfigDirectory()
                                     throws ClientException
        Get the configuration directory
        Returns:
        the directory
        Throws:
        ClientException
        Since:
        1.0
      • info

        Info info​(java.lang.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​(java.lang.String[] paths,
                             java.lang.String changelist,
                             int depth,
                             java.lang.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​(java.lang.String[] paths,
                                   int depth,
                                   java.lang.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​(java.lang.String rootPath,
                            java.lang.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​(java.lang.String[] path,
                  java.lang.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​(java.lang.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​(java.lang.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​(java.lang.String pathOrUrl,
                   Revision revision,
                   Revision pegRevision,
                   int depth,
                   java.lang.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

        java.lang.String getVersionInfo​(java.lang.String path,
                                        java.lang.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​(java.lang.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