SVNKit学习——使用低级别的API(ISVNEditor接口)直接操作Repository的目录和文件(五)
本文是参考官方文档的实现,官方wiki:https://wiki.svnkit.com/Committing_To_A_Repository
本文核心使用的是ISVNEditor这个接口直接对Repository进行各种AM操作~
以下两张示例图分别代表我们操作前、操作后仓库的结构:
具体实现:
package com.demo; import com.google.gson.Gson; import org.tmatesoft.svn.core.*; import org.tmatesoft.svn.core.auth.ISVNAuthenticationManager; import org.tmatesoft.svn.core.internal.io.dav.DAVRepositoryFactory; import org.tmatesoft.svn.core.io.ISVNEditor; import org.tmatesoft.svn.core.io.SVNRepository; import org.tmatesoft.svn.core.io.SVNRepositoryFactory; import org.tmatesoft.svn.core.io.diff.SVNDeltaGenerator; import org.tmatesoft.svn.core.wc.SVNWCUtil; import java.io.ByteArrayInputStream; import java.io.UnsupportedEncodingException; /** * 提交到仓库 * 这块看官方demno的意思如果不用权限认证,会使用a session user name作为提交的author,但是我试了会报错401,author required~ * 本例是基于初始仓库图A转换为目标仓库图B的过程,我们需要执行的操作有: * 1.删除nodeB/itemB1 * 2.编辑nodeC/itemC1 * 3.新增nodeC/itemC2,并设置itemC2的文件属性 * 4.新增nodeB子节点nodeD */ public class CommitToRepository { public static void main(String[] args) throws Exception{ //1.根据访问协议初始化工厂 DAVRepositoryFactory.setup();; //2.初始化仓库,由于我们所有的操作都是基于nodeB节点以下的,所以我们将nodeB作为本次操作的root节点 String url = "https://wlyfree-PC:8443/svn/svnkitRepository2/trunk/nodeB"; SVNRepository svnRepository = SVNRepositoryFactory.create(SVNURL.parseURIEncoded(url)); //3.初始化权限 String username = "wly"; String password = "wly"; char[] pwd = password.toCharArray(); ISVNAuthenticationManager isvnAuthenticationManager = SVNWCUtil.createDefaultAuthenticationManager(username,pwd); svnRepository.setAuthenticationManager(isvnAuthenticationManager); //====================================DEMO START========================================= ISVNEditor editor = null; long revisionNo = -1; //指定版本号为最新版本 //4.1.删除nodeB/itemB1 try{ //获取编辑器 editor = svnRepository.getCommitEditor("delete file",null,true,null); String itemB1Path = "itemB1";//要删除的文件路径 SVNCommitInfo svnCommitInfo = deleteFile(editor,revisionNo);//执行删除并返回执行结果 System.out.println("执行删除操作的返回结果:" + svnCommitInfo); }catch (SVNException e){ //发生异常需要终止操作 editor.abortEdit(); e.printStackTrace();; } //4.2.编辑nodeC/itemC1 try{ //获取编辑器 editor = svnRepository.getCommitEditor("modify file",null,true,null); SVNCommitInfo svnCommitInfo = modifyFile(editor,revisionNo); System.out.println("执行编辑操作的返回结果:" + svnCommitInfo); }catch(SVNException e){ //发生异常需要终止操作 editor.abortEdit(); e.printStackTrace();; } //4.3.新增nodeC/itemC2,并设置itemC2的文件属性 try{ editor = svnRepository.getCommitEditor("add file",null,true,null); SVNCommitInfo svnCommitInfo = addFile(editor,revisionNo); System.out.println("执行新增文件操作的返回结果:" + svnCommitInfo); //校验nodeC/itemC2的属性是否成功设置进去 SVNProperties s = new SVNProperties(); svnRepository.getFile("nodeC/itemC2",-1,s,null); Gson gson = new Gson(); System.err.println(gson.toJson(s)); }catch (SVNException e){ editor.abortEdit(); e.printStackTrace(); } //4.4.新增nodeB子节点nodeD try{ editor = svnRepository.getCommitEditor("add dir",null,true,null); SVNCommitInfo svnCommitInfo = addDir(editor,revisionNo); System.out.println("执行新增目录操作的返回结果:" + svnCommitInfo); }catch (SVNException e){ editor.abortEdit(); e.printStackTrace(); } } /** * 删除文件 * @param editor 编辑器 * @param revisionNo 修订版版本号 * @return SVNCommitInfo 提交结果信息 * @throws SVNException */ private static SVNCommitInfo deleteFile(ISVNEditor editor,long revisionNo) throws SVNException{ // 进入Root节点,即nodeB editor.openRoot(revisionNo); //4.3.删除文件 editor.deleteEntry("itemB1",revisionNo); //操作完成要关闭编辑器,并返回操作结果 return editor.closeEdit(); } /** * 编辑文件 * @param editor 编辑器 * @param revisionNo 修订版版本号 * @return SVNCommitInfo 提交结果信息 * @throws SVNException */ private static SVNCommitInfo modifyFile(ISVNEditor editor,long revisionNo) throws SVNException{ // 进入Root节点,即nodeB editor.openRoot(revisionNo); //.进入nodeC节点 editor.openDir("nodeC",revisionNo); // 编辑nodeC/itemC1的内容 String itemC1Path = "nodeC/itemC1";//路径都是相对于root的 editor.openFile(itemC1Path,revisionNo); //确保客户端这个文件的内容和服务端的是一样的,如果不一致的话是不允许提交的。底层实现使用MD5 String baseChecksum = null; editor.applyTextDelta(itemC1Path,baseChecksum); //提交文件变更的数据,windows默认是100kb大小 byte[] oldData = new byte[]{}; byte[] newData = null; try { newData = "我来测试一下编辑2".getBytes("utf-8"); } catch (UnsupportedEncodingException e) { e.printStackTrace(); } ByteArrayInputStream baseData = new ByteArrayInputStream(oldData); ByteArrayInputStream workingData = new ByteArrayInputStream(newData); SVNDeltaGenerator svnDeltaGenerator = new SVNDeltaGenerator();//100KB-windows generator String checksum = svnDeltaGenerator.sendDelta(itemC1Path,baseData,0,workingData,editor,true); // 关闭文件 editor.closeFile(itemC1Path,checksum); // 关闭目录nodeC editor.closeDir(); // 关闭根目录nodeB editor.closeDir(); // 关闭编辑器,并返回执行结果 return editor.closeEdit(); } /** * 新增文件 * @param editor * @param revisionNo * @return * @throws SVNException */ private static SVNCommitInfo addFile(ISVNEditor editor,long revisionNo) throws SVNException{ // 进入Root节点,即nodeB editor.openRoot(revisionNo); //.进入nodeC节点 editor.openDir("nodeC",revisionNo); // 新增itemC2文件 editor.addFile("nodeC/itemC2",null,revisionNo); //确保客户端这个文件的内容和服务端的是一样的,如果不一致的话是不允许提交的。底层实现使用MD5 String itemC2Path = "nodeC/itemC2"; String baseChecksum = null; editor.applyTextDelta(itemC2Path,baseChecksum); //提交文件变更的数据,windows默认是100kb大小 byte[] oldData = new byte[]{};//旧数据 byte[] newData = null;//新数据 try { newData = "我来测试一下 - addFile".getBytes("utf-8"); } catch (UnsupportedEncodingException e) { e.printStackTrace(); } ByteArrayInputStream baseData = new ByteArrayInputStream(oldData); ByteArrayInputStream workingData = new ByteArrayInputStream(newData); SVNDeltaGenerator svnDeltaGenerator = new SVNDeltaGenerator();//100KB-windows generator String checksum = svnDeltaGenerator.sendDelta(itemC2Path,baseData,0,workingData,editor,true); //设置文件的属性,key是字符串,值被包装成SVNProperyValue了 editor.changeFileProperty("nodeC/itemC2","properName1",SVNPropertyValue.create("properValue1")); editor.changeFileProperty("nodeC/itemC2","properName2",SVNPropertyValue.create("properValue2")); System.out.println("checksum:" + checksum ); //关闭文件 editor.closeFile("nodeC/itemC2",checksum); //关闭目录nodeC editor.closeDir(); //关闭root editor.closeDir(); return editor.closeEdit(); } /** * 新增目录 * @param editor 编辑器 * @param revisionNo 修订版本号 * @return SVNCommitInfo 提交结果信息 * @throws SVNException */ private static SVNCommitInfo addDir(ISVNEditor editor,long revisionNo) throws SVNException{ // 进入Root节点,即nodeB editor.openRoot(revisionNo); //新增目录 editor.addDir("nodeD",null,revisionNo); editor.closeDir();//nodeD editor.closeDir();//nodeB return editor.closeEdit(); } }
运行效果:
执行删除操作的返回结果:r51 by 'wly' at Wed Dec 07 13:48:15 CST 2016 执行编辑操作的返回结果:r52 by 'wly' at Wed Dec 07 13:48:15 CST 2016 checksum:a107fb58070bfbaf11513c8750f87466 执行新增文件操作的返回结果:r53 by 'wly' at Wed Dec 07 13:48:15 CST 2016 {"myProperties":{"svn:entry:uuid":{"myValue":"e5dd1e38-0390-574a-b68d-e269ce50c382"},"svn:entry:revision":{"myValue":"53"},"properName1":{"myData":[112,114,111,112,101,114,86,97,108,117,101,49]},"svn:entry:committed-date":{"myValue":"2016-12-07T05:48:15.464756Z"},"properName2":{"myData":[112,114,111,112,101,114,86,97,108,117,101,50]},"svn:wc:ra_dav:version-url":{"myValue":"/svn/svnkitRepository2/!svn/ver/53/trunk/nodeB/nodeC/itemC2"},"svn:entry:checksum":{"myValue":"a107fb58070bfbaf11513c8750f87466"},"svn:entry:committed-rev":{"myValue":"53"},"svn:entry:last-author":{"myValue":"wly"}}} 执行新增目录操作的返回结果:r54 by 'wly' at Wed Dec 07 13:48:15 CST 2016
总结:
其实走读一遍代码就知道,无论进行什么操作都是有一定规律性的。
无论是操作目录还是文件,大的框架可以大体总结为以下几步:
//1.根据访问协议初始化工厂 //2.初始化仓库,由于我们所有的操作都是基于nodeB节点以下的,所以我们将nodeB作为本次操作的root节点 //3.初始化权限 //4.获取编辑器对象 //5.进入目录/文件 //6.执行操作 //7.关闭目录/文件 //8.关闭编辑器
实际工作中,感觉这种方式不是特别灵活,不一定适用于普通的应用场景,相对来讲,High-Level API更倾向于用户和SVN的交互。