svn纯java客户端SVNKit 学习整理（4）

SVNKit入门

SVNKit中怎样使用不同的仓库访问协议？

 

当你下载了最新版的SVNKit二进制文件并且准备使用它时，一个问题出现了，要创建一个库需要做哪些初始化的步骤？直接与Subversion仓库交互已经在低级层API中实现，主要的仓库访问驱动的接口就是SVNRepository抽象类。这个驱动实现了一些协议，一个协议一个实现。每个驱动由一个抽象工厂类-SVNRepositoryFactory 创建，抽象工厂类也有每一种协议的实现。下面的表格将一种协议和工厂类的实现类一一对应：

 

protocol	SVNRepositoryFactory realization
svn://	SVNRepositoryFactoryImpl
http://	DAVRepositoryFactory
file:///	FSRepositoryFactory

 

SVNKit初始化的操作

在使用SVNKit库前，你必须为某一特定的协议创建一个合适的SVNRepositryFactory对象。例如，如果你想使用 svn:// 协议来和仓库交互，你必须注册一下SVNRepositoryFactoryImpl工厂：

try {

    SVNRepositoryFactoryImpl.setup();

    ...

} catch (SVNException e) {

    //handle exception

}

 

这一步之后，由于SVNKit包含了注册的工厂对象，SVNRepositoryFactory知道了怎样给svn:// 协议创建SVNRepository驱动。接下来你就可以为它创建一个驱动了：

 

try {

    ...

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

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

    ...

    } catch ( SVNException e ) {

    //handle exception

}

 

在SVNKit中，所有的仓库url由SVNURL类来表示，如果一个路径字符串不是UTF-8编码的，可以使用SVNURL的 parseURIDecoded()方法来创建一个新的url（如果需要编码，它会重新编码）。然后你可以通过这个url来在SVNRepositoryFactory中创建一个新的SVNRepository驱动。这样，你可以绑定驱动到任何一个你想访问的仓库地址。

 

 

 

上图说明了不同的仓库路径所创建的不同的驱动；一个是仓库跟目录(svn://host/path_to_root)，一个是仓库中的一个文件夹(svn://host/path_to_root/dirA)，另一个是仓库中的一个文件(svn://host/path_to_root/dirB/fileB1)。SVNRepository驱动能执行的大多数操作接受一下两个类型的仓库路径：

1、  不以’/’开始的路径 – 总是相对驱动绑定的路径

2、   以’/’开始的路径 – 总是相对于仓库跟目录的绝对路径

 

使用高级层API

当你使用SVNKit管理工作拷贝时，由于高级层API使用低级层API来与仓库交互，你也需要创建合适的工厂类，如果你遗漏了这一初始化步骤，可能会抛出一个SVNKit不能给提供的url创建SVNRepository对象的异常。

 

SVN*Client 类

全部高级层管理工作拷贝的操作都逻辑的份分配到SVN*Client类中：每一个SVN*Client类将一类操作集中起来（例如，SVNUpdateClient提供update操作的API，如：check out，update，switch，export）。有两种方法使用这些类：

1、  仅创建需要使用的SVN*Client对象

2、  创建一个SVNClientManager对象，它能提供所有需要使用的类型的SVN*Client的对象。

 

 

往前的文章在我的博客中可以找到，持续更新中……by xiangxji@gmail.com