首页 > 代码库 > SVNKit学习——wiki+简介（一）
SVNKit学习——wiki+简介（一）
这篇文章是参考SVNKit官网在wiki的文档，做了个人的理解~
首先抛出一个疑问，Subversion是做什么的，SVNKit又是用来干什么的？
相信一般工作过的同学都用过或了解过svn，不了解的同学可以到官网看下，这里不作为本文重点。
需要理解的概念：
仓库（Repository）：是一个特殊的结构，记录文件版本管理的状态。
工作副本（Working Copy）：本地从仓库检出的文件。
修订版（Revision）：用于记录仓库数据的变更状态，初始化版本为0，每执行一次操作版本号+1，每执行一次都会生成一个快照。
SVN目录结构：
每次进行提交等操作，svn并非记录所有文件的内容，而是比较智能的只记录和上一个版本不同的文件、目录。
所以，如果你删除了某一个文件，并非完整的删除掉了，因为你在历史的修订版本中还是可以看到的。
使用方式：
1.利用一个svn客户端程序，比如命令行、TortoiseSVN、VisualSVN Server、各种IDE插件(Eclipse的Subclipse、Intellij IDEA的TMATE)
2.利用特殊的客户端类库，比如SVNKit就是一个纯java操作SVN的程序
集中管理不同的应用大约可以分为以下两种模式：
1.适用于使用Working Copy管理的程序，程序通常以文件、目录等方式存在。
2.不适用于Working Copy管理的程序，这里比较抽象一些，区别于文件、目录。但是这类文件的版本控制也是非常重要的。这种类型的程序使用Subversion Repository管理，保持其抽象的模型层次。
建立一个Subversion仓库
参考我的另一篇博客：http://www.cnblogs.com/douJiangYouTiao888/p/6116121.html
SVNKit的结构是什么样子的？
通过上图我们可以比较明显的看出，主要包含两种操作方式：
①.High-Level API：针对Working Copy的一系列操作，底层实现实际调用Low-Level API。封装了多个SVN*Client，不同的操作基于不同的SVN*Client，操作方法和参数与SVN客户端命令行比较相似。
②.Low-Level API：针对Subversion Repository的操作，相当于操作Repository的中间驱动，它知道如何与底层协议进行交互（实际上这层API实现了底层协议）。这一层对数据结构进行了分层，表现为一个包含版本控制的、抽象复杂的树结构。
SVNKit访问Repository所支持的协议：
远程协议：
①.svn://协议（或svn+xxx，最常用的是svn+ssh）
②.http://协议（或https://协议）
本地协议：
①.file:///协议，只支持FSFS类型的Repository
开始使用SVNKit
从官网下载好SVNKit的二进制安装包后，第一步应该做什么？
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
使用High-Level API的操作步骤：
1.根据不同协议，初始化不同的仓库工厂。(工厂实现基于SVNRepositoryFactory抽象类)
//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 );
在linux一系列系统中，URL有两种表现形式：
①.不是以"/"开头，相对于驱动的绑定位置，即相对路径
②.以"/"开头，代表repository的根，从repository库的顶部开始
3.创建一个权限验证对象
SVN大多数操作都是具有权限访问控制的，大多数情况不支持匿名访问。
SVNKit使用ISVNAuthenticationManager接口来实现权限的控制。
ISVNAuthenticationManager authManager; ... SVNURL url = SVNURL.parseURIEncoded( "svn://host/path_to_repository_root/inner_path" ); SVNRepository repository = SVNRepositoryFactory.create( url , null ); //set an auth manager which will provide user credentials repository.setAuthenticationManager(basicAuthManager); ...
权限管理基于以下四个逻辑块：
不同类型的身份验证凭据：(要依据实际类型创建)
Kind Class representation Field of usage PASSWORD SVNPasswordAuthentication login:password authentication (svn://, http://) SSH SVNSSHAuthentication In svn+ssh:// tunneled connections SSL SVNSSLAuthentication In secure https:// connections USERNAME SVNUserNameAuthentication With file:/// protocol, on local machines
身份验证交互示意图（图1首次、图2非首次）：身份验证首次需要用户输入，后续则无需重复输入：
图1：
图2:
代理：如果authentication manager提供了一个非空的proxy manager，SVNKit将通过代理服务器代理管理目标服务器。
SSL：支持SSL管理
ISVNAuthenticationManager的默认实现：
①.BasicAuthenticationManager：
1.无需磁盘授权存储。
2.无需提供SSL provider
3.无需服务器或者文件配置。
4.使用proxy、ssh setting、user credentials provoded到类的构造器中，无需身份验证提供者。
5.不缓存credentials 。
②.DefaultSVNAuthenticationManager：
1.可以使用磁盘一个授权存储于默认Subversion运行的配置或者指定的目录。可以在目录中缓存credentials。
2.使用运行时的内存存储credentials。
3.可以使用用户提供的username/password认证用户。
4.使用SSL、SSH、Proxy setting、服务器配置文件运行Subvesion。
强制认证方案：
尽管Subversion的优势是你不需要重复验证直到服务器要求验证。有时它可能是有效有能力让svnkit立即验证用户不浪费时间。ISVNAuthenticationManager接口提供了这个能力，它在SVNKit使用一个行为控制时返回一个标识。
HTTP认证的方案：
①.Basic
②.Digest
③.NTLM
Basic、Digest两种方案，你需要提供一个用户名和密码：
ISVNAuthenticationManager authManager = new BasicAuthenticationManager( "login" , "password" );
NTLM方案，你需要提供一个主域名：
ISVNAuthenticationManager authManager = new BasicAuthenticationManager( "DOMAIN\\login" , "password" );
SVNKit学习——wiki+简介（一）