系统集成SVN（SVNKit操作SVN）

网址：https://svnkit.com/documentation.html

文档：https://svnkit.com/javadoc/index.html

依赖以及介绍

JavaHLL API：本机Subversion包括可通过JavaHL接口-SVNClientInterface使用的JNI绑定。SVNKit使用SVNClientImpl类实现它，这样您就可以在运行时在JavaHL和SVNKit之间切换。

1、maven依赖：

<!-- https://mvnrepository.com/artifact/org.tmatesoft.svnkit/svnkit -->

<!-- 目前最新版本1.10.8，可使用1.10.X版本-->

<dependency>

    <groupId>org.tmatesoft.svnkit</groupId>

    <artifactId>svnkit</artifactId>

    <version>1.10.8</version>

</dependency>

2、API介绍

　High-Level API：主要使用SVNClientManager类来创建一些了的SVN*Client实现一系列对Working Copy的操作，比如创建一个SVNUpdateClient，可以执行checkout、update、switch、export等。

　Low-Level API：主要使用SVNRepository类与Repository仓库进行交互，支持的协议都是基于SVNRepositoryFactory抽象类的具体实现，协议和实现类的关系：（通过不同的类创建不同的上传协议）

protocol    SVNRepositoryFactory realization

svn://      SVNRepositoryFactoryImpl

http://     DAVRepositoryFactory

file:///    FSRepositoryFactory

开始使用SVNKit

使用High-Level API的操作步骤：

1、根据不同协议，初始化不同的仓库工厂。(工厂实现基于SVNRepositoryFactory抽象类)**

备注：一般性使用static void 方法进行初始化

//svn://,  svn+xxx:// (svn+ssh:// in particular)

SVNRepositoryFactoryImpl.setup();

//http://  and https://

DAVRepositoryFactory.setup();

//file:///

FSRepositoryFactory.setup();

2、创建一个驱动。（基于工厂），svnkit中repository所有的URL都基于SVNURL类生成，编码不是UTF-8的话，可以调用SVNURL的parseURIEncoded()方法。url可以是项目根目录、目录或文件。

SVNURL url = SVNURL.parseURIDecoded( "svn://host/path_to_repository_root/inner_path" );

SVNRepository repository = SVNRepositoryFactory.create( url, null );

这里的URL有两种表现形式：

①.不是以"/"开头，相对于驱动的绑定位置，即Repository的目录

②.以"/"开头，代表repository的根，相对于Repository的Root对应的目录

3、创建一个权限验证对象

SVN大多数操作都是具有权限访问控制的，大多数情况不支持匿名访问。

SVNKit使用ISVNAuthenticationManager接口来实现权限的控制。

SVNRepository repository=SVNRepositoryFactory.create(url);

ISVNAuthenticationManager authManager = SVNWCUtil.createDefaultAuthenticationManager(username, password);

repository.setAuthenticationManager(authManager);

DefaultSVNOptions options = SVNWCUtil.createDefaultOptions(true);

return SVNClientManager.newInstance(options, authManager);

代码实例

package com.xxx.patchgen.svn;

import java.io.ByteArrayOutputStream;

import java.io.File;

import java.io.FileOutputStream;

import java.io.OutputStream;

import java.util.ArrayList;

import java.util.List;

import org.tmatesoft.svn.core.SVNDepth;

import org.tmatesoft.svn.core.SVNException;

import org.tmatesoft.svn.core.SVNNodeKind;

import org.tmatesoft.svn.core.SVNURL;

import org.tmatesoft.svn.core.auth.ISVNAuthenticationManager;

import org.tmatesoft.svn.core.internal.io.dav.DAVRepositoryFactory;

import org.tmatesoft.svn.core.internal.io.fs.FSRepositoryFactory;

import org.tmatesoft.svn.core.internal.io.svn.SVNRepositoryFactoryImpl;

import org.tmatesoft.svn.core.internal.wc.DefaultSVNOptions;

import org.tmatesoft.svn.core.io.SVNRepository;

import org.tmatesoft.svn.core.io.SVNRepositoryFactory;

import org.tmatesoft.svn.core.wc.ISVNDiffStatusHandler;

import org.tmatesoft.svn.core.wc.ISVNOptions;

import org.tmatesoft.svn.core.wc.SVNClientManager;

import org.tmatesoft.svn.core.wc.SVNDiffClient;

import org.tmatesoft.svn.core.wc.SVNDiffStatus;

import org.tmatesoft.svn.core.wc.SVNRevision;

import org.tmatesoft.svn.core.wc.SVNStatusType;

import org.tmatesoft.svn.core.wc.SVNUpdateClient;

import org.tmatesoft.svn.core.wc.SVNWCClient;

import org.tmatesoft.svn.core.wc.SVNWCUtil;

public class SVNOperator {

	private String userName;

	private String passwd;

	private SVNClientManager ourClientManager;

	private SVNWCClient wcClient;

	private SVNDiffClient diffClient;

	private SVNUpdateClient updateClient;

	private List<SVNDiffStatus> changedFilePathsList = new ArrayList<SVNDiffStatus>();

	public SVNOperator(String userName, String passwd) {

		//setup

		DAVRepositoryFactory.setup();

		SVNRepositoryFactoryImpl.setup();

		FSRepositoryFactory.setup();

		//create clientManager

		ISVNOptions options = SVNWCUtil.createDefaultOptions(true);

		ourClientManager = SVNClientManager.newInstance((DefaultSVNOptions) options, userName, passwd);

		this.userName = userName;

		this.passwd = passwd;

		//generate client

		wcClient = ourClientManager.getWCClient();

		diffClient = ourClientManager.getDiffClient();

		updateClient = ourClientManager.getUpdateClient();

	}

	/**

	 * 获取指定版本的文件并转换为字符串

	 */

	public String getRevisionFileContent(String url,SVNRevision revision) throws Exception {

		SVNURL repositoryUrl = SVNURL.parseURIEncoded(url);

		OutputStream contentStream = new ByteArrayOutputStream();

		wcClient.doGetFileContents(repositoryUrl, SVNRevision.HEAD, revision, false, contentStream);

		return contentStream.toString();

	}

	/**

	 * 获取指定版本的文件

	 */

	public File getRevisionFile(String url,String version) throws Exception {

		SVNRevision revision = SVNRevision.create(Long.parseLong(version));

		File file = File.createTempFile("patch-", ".tmp");

		SVNURL repositoryUrl = SVNURL.parseURIEncoded(url);

		OutputStream contentStream = new FileOutputStream(file);

		wcClient.doGetFileContents(repositoryUrl, SVNRevision.HEAD, revision, false, contentStream);

		return file;

	}

	/**

	 * 获取版本间差异文件

	 */

	public void getDiffFiles(String url,String startVersion,String endVersion) throws Exception{

		changedFilePathsList.clear();

		SVNURL repositoryUrl = SVNURL.parseURIEncoded(url);

//		authentication(repositoryUrl);

		SVNRevision start = SVNRevision.create(Long.parseLong(startVersion));

		SVNRevision end = SVNRevision.create(Long.parseLong(endVersion));

		diffClient.doDiffStatus(repositoryUrl,start,repositoryUrl,end,SVNDepth.INFINITY,false,new ISVNDiffStatusHandler() {

			public void handleDiffStatus(SVNDiffStatus status) throws SVNException {

				if(status.getKind() == SVNNodeKind.FILE

						&& (status.getModificationType() == SVNStatusType.STATUS_ADDED

								|| status.getModificationType() == SVNStatusType.STATUS_MODIFIED)){

					changedFilePathsList.add(status);

					System.out.println(status.getPath());

				}

			}

		});

	}

	/**

	 * 导出指定版本间差异文件

	 */

	public void doExport(String endVersion,String exportDir) throws Exception{

		SVNRevision end = SVNRevision.create(Long.parseLong(endVersion));

		for(SVNDiffStatus status: changedFilePathsList){

			File destination = new File(exportDir + "/" +status.getPath());

			updateClient.doExport(status.getURL(), destination, end, end, null, true, SVNDepth.getInfinityOrEmptyDepth(true));

		}

	}

	/**

	 * 导出最新版本文件

	 */

	public void doExportHead(String url,String exportDir) throws Exception{

		SVNURL repositoryUrl = SVNURL.parseURIEncoded(url);

		updateClient.doExport(repositoryUrl, new File(exportDir), SVNRevision.HEAD, SVNRevision.HEAD, null, true, SVNDepth.getInfinityOrEmptyDepth(true));

	}

	/**

	 * 认证

	 */

	public void authentication(SVNURL url) throws Exception{

		ISVNAuthenticationManager authManager = SVNWCUtil.createDefaultAuthenticationManager(userName, passwd);

		SVNRepository repository = SVNRepositoryFactory.create(url);

		repository.setAuthenticationManager(authManager);

	}

}

备注：具体代码实例操作可查看官网。

High Level API：https://wiki.svnkit.com/Managing_A_Working_Copy

Low Level API：https://wiki.svnkit.com/Managing_Repository_With_SVNKit

巴特西

SVNKit操作SVN