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 );
这里的URL有两种表现形式:(此处不好理解,下一篇文章会使用具体代码做解释)
①.不是以"/"开头,相对于驱动的绑定位置,即Repository的目录
②.以"/"开头,代表repository的根,相对于Repository的Root对应的目录
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的默认实现:
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" );