Logging :: Documentation :: Pure Java Subversion (SVN) Client Library

Home :: Documentation :: Logging

Logging JavaSVN operations

If you experience problems that you think are JavaSVN related, it is always a good idea to post a bug report into JavaSVN Issue Tracker. To provide more information with the bug report, please consider attaching JavaSVN log file to it. Below you will find detailed instructions on how to get JavaSVN log file.

JavaSVN is used as Eclipse plugin (works for Subclipse Extension as well)

When used within Eclipse JavaSVN logs its operation using Eclipse built-in logging facilities. Logging is turned off by default. To enable JavaSVN logging please do the following:

Copy plugins/org.tmatesoft.javasvn_version/.options file to ECLIPSE_HOME directory
Start Eclipse with -debug command line argument:
$eclipse -debug
In Eclipse, open standard 'Error Log' view - it will contain detailed log of JavaSVN operations that you may export to a file.

JavaSVN is used as library in standalone application

By default JavaSVN uses standard JDK logging API. You may find JavaSVN log file at USER_HOME/.javasvn/.javasvn.0.0.log

Following system properties may be used to control JavaSVN logging output:

javasvn.log.console=true|false [false] - log to System.out
javasvn.log.file=true|false    [true] - log to file
javasvn.log.path=path/to/log/file      - use specified log file instead of default one
javasvn.log.svn=true|false     [false] - log svn protocol messages
javasvn.log.http=true|false    [false] - log DAV protocol requests

Setting up your own logger

When you're using JavaSVN in your application it is not always an option to let JavaSVN use JDK logging API. Instead you may like to have a fine-grained control over the way JavaSVN logs its operations. The solution is to provide JavaSVN with custom logger class that should extend DebugLoggerAdapter class. The code below demonstrates how it could be done.

....
import org.tmatesoft.svn.util.DebugLog;
import org.tmatesoft.svn.util.DebugLoggerAdapter;
....
    public static void initJavaSVNLogger() {
        DebugLog.setLogger(new CustomJavaSVNLogger();
    }

    private static class CustomJavaSVNLogger 
                                   extends DebugLoggerAdapter {
    	// Override superclass methods to redirect logging
    	// as you wish. Superclass implementaion is empty, i.e.
    	// all log messages are swallowed.
    }
....

Note: One have to set up the custom logger before any other calls are made to JavaSVN, otherwise default logging will be used.

If you have any questions regarding JavaSVN, would like to report a bug or contribute a patch, please write to support@tmatesoft.com