org.tigris.subversion.javahl
public class SVNClient extends Object implements SVNClientInterface
Nested Class Summary | |
---|---|
static class | SVNClient.LogLevel
class for the constants of the logging levels.
|
Field Summary | |
---|---|
protected long | cppAddr
slot for the adress of the native peer. |
Constructor Summary | |
---|---|
SVNClient()
Standard empty contructor, builds just the native peer. |
Method Summary | |
---|---|
void | add(String path, boolean recurse)
Adds a file to the repository. |
void | add(String path, boolean recurse, boolean force)
Adds a file to the repository. |
byte[] | blame(String path, Revision revisionStart, Revision revisionEnd)
Return for each line of the file, the author and the revision of the
last together with the content. |
void | blame(String path, Revision revisionStart, Revision revisionEnd, BlameCallback callback)
Retrieve the content together with the author, the revision and the date
of the last change of each line |
void | blame(String path, Revision pegRevision, Revision revisionStart, Revision revisionEnd, BlameCallback callback)
Retrieve the content together with the author, the revision and the date
of the last change of each line |
void | cancelOperation()
cancel the active operation |
long | checkout(String moduleName, String destPath, Revision revision, Revision pegRevision, boolean recurse, boolean ignoreExternals)
Executes a revision checkout. |
long | checkout(String moduleName, String destPath, Revision revision, boolean recurse)
Executes a revision checkout. |
void | cleanup(String path)
Recursively cleans up a local directory, finishing any
incomplete operations, removing lockfiles, etc. |
long | commit(String[] path, String message, boolean recurse)
Commits changes to the repository. |
long | commit(String[] path, String message, boolean recurse, boolean noUnlock)
Commits changes to the repository.
|
void | commitMessageHandler(CommitMessage messageHandler)
Sets the commit message handler. |
void | copy(String srcPath, String destPath, String message, Revision revision)
Copies a versioned file with the history preserved. |
protected String | determineInitialConfigDir()
Attempt to determine an initial configuration directory,
%APPDATA%\Subversion on Windows and
~/.subversion on other operating systems.
|
void | diff(String target1, Revision revision1, String target2, Revision revision2, String outFileName, boolean recurse)
Display the differences between two paths |
void | diff(String target1, Revision revision1, String target2, Revision revision2, String outFileName, boolean recurse, boolean ignoreAncestry, boolean noDiffDeleted, boolean force)
Display the differences between two paths
|
void | diff(String target, Revision pegRevision, Revision startRevision, Revision endRevision, String outFileName, boolean recurse, boolean ignoreAncestry, boolean noDiffDeleted, boolean force)
Display the differences between two paths
|
void | dispose()
release the native peer (should not depend on finalize) |
long | doExport(String srcPath, String destPath, Revision revision, boolean force)
Exports the contents of either a subversion repository into a
'clean' directory (meaning a directory with no administrative
directories). |
long | doExport(String srcPath, String destPath, Revision revision, Revision pegRevision, boolean force, boolean ignoreExternals, boolean recurse, String nativeEOL)
Exports the contents of either a subversion repository into a
'clean' directory (meaning a directory with no administrative
directories).
|
void | doImport(String path, String url, String message, boolean recurse)
Import a file or directory into a repository directory at
head. |
long | doSwitch(String path, String url, Revision revision, boolean recurse)
Update local copy to mirror a new url. |
static void | enableLogging(int logLevel, String logFilePath)
Enable logging in the JNI-code |
byte[] | fileContent(String path, Revision revision)
Retrieve the content of a file |
byte[] | fileContent(String path, Revision revision, Revision pegRevision)
Retrieve the content of a file
|
protected void | finalize()
release the native peer (should use dispose instead) |
String | getAdminDirectoryName() |
String | getConfigDirectory()
Get the configuration directory |
String | getLastPath()
Returns the last destination path submitted. |
Version | getVersion() |
String | getVersionInfo(String path, String trailUrl, boolean lastChanged)
Produce a compact "version number" for a working copy |
Info | info(String path)
Retrieves the working copy information for an item |
Info2[] | info2(String pathOrUrl, Revision revision, Revision pegRevision, boolean recurse)
Retrieve information about repository or working copy items.
|
boolean | isAdminDirectory(String name) |
DirEntry[] | list(String url, Revision revision, boolean recurse)
Lists the directory entries of an url on the server. |
DirEntry[] | list(String url, Revision revision, Revision pegRevision, boolean recurse)
Lists the directory entries of an url on the server.
|
void | lock(String[] path, String comment, boolean force)
Lock a working copy item
|
LogMessage[] | logMessages(String path, Revision revisionStart, Revision revisionEnd)
Retrieve the log messages for an item |
LogMessage[] | logMessages(String path, Revision revisionStart, Revision revisionEnd, boolean stopOnCopy)
Retrieve the log messages for an item |
LogMessage[] | logMessages(String path, Revision revisionStart, Revision revisionEnd, boolean stopOnCopy, boolean discoverPath)
Retrieve the log messages for an item |
LogMessage[] | logMessages(String path, Revision revisionStart, Revision revisionEnd, boolean stopOnCopy, boolean discoverPath, long limit)
Retrieve the log messages for an item |
void | merge(String path1, Revision revision1, String path2, Revision revision2, String localPath, boolean force, boolean recurse)
Merge changes from two paths into a new local path. |
void | merge(String path1, Revision revision1, String path2, Revision revision2, String localPath, boolean force, boolean recurse, boolean ignoreAncestry, boolean dryRun)
Merge changes from two paths into a new local path.
|
void | merge(String path, Revision pegRevision, Revision revision1, Revision revision2, String localPath, boolean force, boolean recurse, boolean ignoreAncestry, boolean dryRun)
Merge changes from two paths into a new local path.
|
void | mkdir(String[] path, String message)
Creates a directory directly in a repository or creates a
directory on disk and schedules it for addition. |
void | move(String srcPath, String destPath, String message, Revision revision, boolean force)
Moves or renames a file. |
void | move(String srcPath, String destPath, String message, boolean force)
Moves or renames a file.
|
void | notification(Notify notify)
Sets the notification callback used to send processing information back
to the calling program. |
void | notification2(Notify2 notify)
Sets the notification callback used to send processing information back
to the calling program.
|
void | password(String password)
Sets the password used for authification. |
PropertyData[] | properties(String path)
Retrieves the properties of an item |
PropertyData[] | properties(String path, Revision revision)
Retrieves the properties of an item
|
PropertyData[] | properties(String path, Revision revision, Revision pegRevision)
Retrieves the properties of an item
|
void | propertyCreate(String path, String name, String value, boolean recurse)
Create and sets one property of an item with a String value |
void | propertyCreate(String path, String name, String value, boolean recurse, boolean force)
Create and sets one property of an item with a String value
|
void | propertyCreate(String path, String name, byte[] value, boolean recurse)
Create and sets one property of an item with a byte array value |
void | propertyCreate(String path, String name, byte[] value, boolean recurse, boolean force)
Create and sets one property of an item with a byte array value
|
PropertyData | propertyGet(String path, String name)
Retrieve one property of one iten |
PropertyData | propertyGet(String path, String name, Revision revision)
Retrieve one property of one iten
|
PropertyData | propertyGet(String path, String name, Revision revision, Revision pegRevision)
Retrieve one property of one iten
|
void | propertyRemove(String path, String name, boolean recurse)
Remove one property of an item. |
void | propertySet(String path, String name, String value, boolean recurse)
Sets one property of an item with a String value |
void | propertySet(String path, String name, String value, boolean recurse, boolean force)
Sets one property of an item with a String value
|
void | propertySet(String path, String name, byte[] value, boolean recurse)
Sets one property of an item with a byte array value |
void | propertySet(String path, String name, byte[] value, boolean recurse, boolean force)
Sets one property of an item with a byte array value
|
void | relocate(String from, String to, String path, boolean recurse)
Rewrite the url's in the working copy |
void | remove(String[] path, String message, boolean force)
Sets a file for deletion. |
void | resolved(String path, boolean recurse)
Removes the 'conflicted' state on a file. |
void | revert(String path, boolean recurse)
Reverts a file to a pristine state. |
PropertyData[] | revProperties(String path, Revision rev)
Retrieve all revsision properties of one item |
PropertyData | revProperty(String path, String name, Revision rev)
Retrieve one revsision property of one item |
void | setConfigDirectory(String configDir)
Set directory for the configuration information |
void | setPrompt(PromptUserPassword prompt)
Register callback interface to supply user name and password on
demand. |
void | setRevProperty(String path, String name, Revision rev, String value, boolean force)
set one revsision property of one item |
Status | singleStatus(String path, boolean onServer)
Returns the status of a single file in the path.
|
Status[] | status(String path, boolean descend, boolean onServer, boolean getAll)
List a directory or file of the working copy.
|
Status[] | status(String path, boolean descend, boolean onServer, boolean getAll, boolean noIgnore)
List a directory or file of the working copy.
|
Status[] | status(String path, boolean descend, boolean onServer, boolean getAll, boolean noIgnore, boolean ignoreExternals)
List a directory or file of the working copy.
|
void | streamFileContent(String path, Revision revision, Revision pegRevision, int bufferSize, OutputStream stream)
Write the file's content to the specified output stream. |
void | unlock(String[] path, boolean force)
Unlock a working copy item
|
long | update(String path, Revision revision, boolean recurse)
Updates the directory or file from repository |
long[] | update(String[] path, Revision revision, boolean recurse, boolean ignoreExternals)
Updates the directories or files from repository |
void | username(String username)
Sets the user name used for authentification. |
static String | version()
Returns version information of subversion and the javahl binding |
static int | versionMajor()
Returns the major version of the javahl binding. |
static int | versionMicro()
Returns the micro (patch) version of the javahl binding. |
static int | versionMinor()
Returns the minor version of the javahl binding. |
Parameters: path path to be added. recurse recurse into subdirectories
Throws: ClientException
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
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
Parameters: path the path revisionStart the first revision to show revisionEnd the last revision to show callback callback to receive the file content and the other information
Throws: ClientException
Parameters: path the path pegRevision the revision to interpret the path revisionStart the first revision to show revisionEnd the last revision to show callback callback to receive the file content and the other information
Throws: ClientException
Since: 1.2
Throws: ClientException
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
Parameters: moduleName name of the module to checkout. destPath destination directory for checkout. revision the revision to checkout. recurse whether you want it to checkout files recursively.
Throws: ClientException
Parameters: path a local directory.
Throws: ClientException
Parameters: path files to commit. message log message. recurse whether the operation should be done recursively.
Returns: Returns a long representing the revision. It returns a -1 if the revision number is invalid.
Throws: ClientException
Parameters: path files to commit. message log message. recurse whether the operation should be done recursively. noUnlock do remove any locks
Returns: Returns a long representing the revision. It returns a -1 if the revision number is invalid.
Throws: ClientException
Since: 1.2
Parameters: messageHandler callback for entering commit messages if this is set the message parameter is ignored.
Parameters: srcPath source path or url destPath destination path or url message commit message if destPath is an url revision source revision
Throws: ClientException
%APPDATA%\Subversion
on Windows and
~/.subversion
on other operating systems.
Returns: The initial configuration directory, or
null
to use the library default. Note that native
library versions older than 1.4 may segfault if we return
null
.
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
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
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
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
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
Parameters: path the local path url the target url message the log message. recurse traverse into subdirectories
Throws: ClientException
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
Parameters: logLevel the level of information to log (See SVNClientLogLevel) logFilePath path of the log file
Parameters: path the path of the file revision the revision to retrieve
Returns: the content as byte array
Throws: ClientException
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
Returns: The name of the working copy's administrative
directory, which is usually .svn
.
Since: 1.3
UNKNOWN: Instructions on changing this as a work-around for the behavior of ASP.Net on Windows.
Returns: the directory
Throws: ClientException
Deprecated:
Returns the last destination path submitted.Returns: path in Subversion format.
Returns: Version information about the underlying native libraries.
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
Parameters: path path of the item
Returns: the information object
Throws: ClientException
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
Since: 1.2
Parameters: name The name of the directory to compare.
Returns: Whether name
is that of a working copy
administrative directory.
Since: 1.3
Parameters: url the url to list revision the revision to list recurse recurse into subdirectories
Returns: Array of DirEntry objects.
Parameters: url the url to list revision the revision to list pegRevision the revision to interpret url recurse recurse into subdirectories
Returns: Array of DirEntry objects.
Since: 1.2
Parameters: path path of the item comment force break an existing lock
Throws: ClientException
Since: 1.2
Parameters: path path or url to get the log message for. revisionStart first revision to show revisionEnd last revision to show
Returns: array of LogMessages
Parameters: path path or url to get the log message for. revisionStart first revision to show revisionEnd last revision to show stopOnCopy do not continue on copy operations
Returns: array of LogMessages
Parameters: path path or url to get the log message for. revisionStart first revision to show revisionEnd last revision to show stopOnCopy do not continue on copy operations discoverPath
Returns: array of LogMessages
Parameters: path path or url to get the log message for. revisionStart first revision to show revisionEnd last revision to show stopOnCopy do not continue on copy operations discoverPath returns the paths of the changed items in the returned objects limit limit the number of log messages (if 0 or less no limit)
Returns: array of LogMessages
Since: 1.2
Parameters: path1 first path or url revision1 first revision path2 second path or url revision2 second revision localPath target local path force overwrite local changes recurse traverse into subdirectories
Throws: ClientException
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
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
Parameters: path directories to be created message commit message to used if path contains urls
Throws: ClientException
Parameters: srcPath source path or url destPath destination path or url message commit message if destPath is an url revision source revision force even with local modifications.
Throws: ClientException
Parameters: srcPath source path or url destPath destination path or url message commit message if destPath is an url force even with local modifications.
Throws: ClientException
Since: 1.2
Deprecated: use notification2 instead
Sets the notification callback used to send processing information back to the calling program.Parameters: notify listener that the SVN library should call on many file operations.
Parameters: notify listener that the SVN library should call on many file operations.
Since: 1.2
Parameters: password the password
Parameters: path the path of the item
Returns: array of property objects
Parameters: path the path of the item revision the revision of the item
Returns: array of property objects
Since: 1.2
Parameters: path the path of the item revision the revision of the item pegRevision the revision to interpret path
Returns: array of property objects
Since: 1.2
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
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
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
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
Parameters: path path of the item name name of property
Returns: the Property
Throws: ClientException
Parameters: path path of the item name name of property revision revision of the item
Returns: the Property
Throws: ClientException
Since: 1.2
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
Parameters: path path of the item name name of the property recurse remove the property also on subdirectories
Throws: ClientException
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
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
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
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
Parameters: from old url to new url path working copy path recurse recurse into subdirectories
Throws: ClientException
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
Parameters: path path to cleanup recurse recurce into subdirectories
Throws: ClientException
Parameters: path path of the file. recurse recurse into subdirectories
Throws: ClientException
Parameters: path path of the item rev revision to retrieve
Returns: the Properties
Throws: ClientException
Since: 1.2
Parameters: path path of the item name name of the property rev revision to retrieve
Returns: the Property
Throws: ClientException
Parameters: configDir path of the directory
Throws: ClientException
--no-auth-cache
and
--non-interactive
arguments accepted by the
command-line client.
Parameters: prompt the callback interface
Parameters: path path of the item name name of the property rev revision to retrieve value value of the property force
Throws: ClientException
Since: 1.2
Parameters: path File to gather status. onServer Request status information from the server.
Returns: the subversion status of the file.
Parameters: path Path to explore. descend Recurse into subdirectories if they exist. onServer Request status information from server. getAll get status for uninteristing files (unchanged).
Returns: Array of Status entries.
Parameters: path Path to explore. descend Recurse into subdirectories they exist. onServer Request status information from server. getAll get status for uninteristing files (unchanged). noIgnore get status for normaly ignored files and directories.
Returns: Array of Status entries.
Parameters: path Path to explore. descend Recurse into subdirectories if they exist. onServer Request status information from server. getAll get status for uninteristing files (unchanged). noIgnore get status for normaly ignored files and * directories. ignoreExternals if externals are ignored during status
Returns: Array of Status entries.
Since: 1.2
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
See Also: PipedOutputStream
PipedInputStream
Parameters: path path of the item force break an existing lock
Throws: ClientException
Since: 1.2
Parameters: path target file. revision the revision number to update. Revision.HEAD will update to the latest revision. recurse recursively update.
Throws: ClientException
Parameters: path array of target files. revision the revision number to update. Revision.HEAD will update to the latest revision. recurse recursively update. ignoreExternals externals will be ignore during update
Throws: ClientException
Since: 1.2
Parameters: username The user name.
Returns: version information
Returns: major version number
Returns: micro version number
Returns: minor version number