使用 SharpSvn 执行 svn 操作的Demo

1. SharpSvn简介

SharpSvn.dll 是为.Net 2.0-4.0+ 应用提供的 Subversion Client API,更多详细介绍请见 https://sharpsvn.open.collab.net/。

2. 鉴权操作

SharpSvn 通过 Authentication 接口提供相关的鉴权操作,例如用户名和密码获取、证书确认等。Authentication 接口分别为这些操作定义了相关的事件句柄(Handlers)。当需要某些鉴权操作时,SharpSvn 就会去调用相对应的句柄。我们只需要将我们需要执行的鉴权操作挂载到相对应的句柄上即可。下面各提供用户名和密码获取、证书确认的例子。

2.1 用户名和密码获取

当执行某个 svn 操作需要用户权限认证时,会调用 UserNamePasswordHandlers 中的句柄来获取用户名和密码。例如,

using (SvnClient client = new SvnClient())
{
    client.Authentication.UserNamePasswordHandlers +=
        new EventHandlers<SvnUserNamePasswordEventArgs>(
            delegate (object s, SvnUserNamePasswordEventArgs e)
            {
                e.UserName = "test";
                e.Password = "password";
            });
} 

2.2 证书确认

当我们访问的 Svn 服务器使用的协议不是我们默认执行标准,svn 客户会让用户确认这个服务器是否值得信任并继续访问。此时,SharpSvn 会执行 Authentication 接口中的 SslServerTrustHandlers 中挂载的事件句柄。例如,

using (SvnClient client = new SvnClient())
{
    client.Authentication.SslServerTrustHandlers +=
        delegate (object s, SvnSslServerTrustEventHandlerArgs> e)
        {
            e.Save = true;
            //e.Cancel = true; //表示不信任该服务器,放弃访问。
        };
}

2.3 SharpSvnUI绑定

SharpSvn.UI.dll 提供了一个默认的操作界面。例如上面的用户名和密码获取界面、证书确认界面。我们只需要将下面这两行代码写入我们程序中,SharpSvn 会自动挂载相对应的事件句柄。当需要用户名和密码获取或者证书确认时就会弹出相对应的界面。

using (SvnClient client = new SvnClient())
{
    SharpSvn.UI.SvnUIBindArgs uiBindArgs = new SharpSvn.UI.SvnUIBindArgs();
    SharpSvn.UI.SvnUI.Bind(client, uiBindArgs);
}

3 SVN基本操作

3.1 更新 Update

using (SvnClient client = new SvnClient())
{
    string path = @”d:\\svn\temp";
    SvnUpdateArgs updateArgs = new SvnUpdateArgs();
    updateArgs.Depth = SvnDepth.Empty;
    client.Update(path, updateArgs);
}

3.2加入版本控制 Add

using (SvnClient client = new SvnClient())
{
    string path = @"d:\\svn\temp\new.txt";
    SvnAddArgs args = new SvnAddArgs();
    args.Depth = SvnDepth.Empty;
    client.Add(path, args);
}

3.3 提交 Commit

using (SvnClient client = new SvnClient())
{
    SvnCommitArgs commitArgs = new SvnCommitArgs();
    commitArgs.Depth = SvnDepth.Empty;
    commitArgs.LogMessage = "My Test Commit";
    SvnCommitResult commitResult = null;
    client.Commit(@"d:\\svn\temp\test.txt", commitArgs, out commitResult);
}

其他操作,例如 Delete、Lock、Unlock 等,这些基本操作的代码结构跟上面这几个操作类似,这里就不赘述了。

3.4 获取本更文件列

using (SvnClient client = new SvnClient())
{
    SvnStatusArgs args = new SvnStatusArgs();
    args.Depth = SvnDepth.Empty;
    args.RetriveRemoteStatus = false;
    Collection<SvnStatusEventArgs> list = new Collection<SvnStatusEventArgs>();
    client.GetStatus(@"d:\\svn\temp", args, out list);
    foreach (SvnStatusEventArgs eventArgs in list)
    {
        //从eventArgs中获取每个变更文件的相关信息
    }
}

4 SharpSvn 操作日志获取

通过 SvnClientReporter 可以将 SharpSvn 的操作日志信息进行重定向,可以重定向到一个 StringBuilder 或者某个文件中,下面的这两行代码SharpSvn 重定向到某个 StringBuilder 中,

using (SvnClient client = new SvnClient())
{
    StringBuilder strBuilder = new StringBuilder();
    SvnClientReporter reporter = new SvnClientReporter(client, strBuilder);
}

注:SharpSvn 可重定向到多个目标,可一个多次重定向到同一个目标。例如,如果对于同一个 StringBuilder,定义了多个 SvnClientReporter 对象,则该 StringBuilder 中的 SharpSvn 操作日志会记录多份。可以手工调用SvnClientReporter 对象的 Dispose()释放某个日志重定向。

5 取消操作

SharpSvn 的取消机制类似与线程的取消机制。SharpSvn 的操作过程中会有一些取消检测点。当操作执行到某个检测点时会判断一下用户是否设置了取消标志,如果没有,则继续操作;如果设置了取消标志,则终止当前操作。

在 SharpSvn 的操作过程中,当到达一个取消检测点时会处罚一个Cancel 事件,通过 Cancel 事件来获取用户是否设置了取消标志。当我们要取消 svn 操作时,注册一下 Cancel 事件处理方法,则改方法中设置SvnCancelEventArgs 对象的 Cancel 属性为 true 即可。例如,

using (SvnClient client = new SvnClient())
{
    //do something
    client.Cancel +=
        delegate (object s, SvnCancelEventArgs e)
        {
            e.Cancel = true;
        };
    //do svn operations
}

6 Svn 远程会话 SvnRemoteSession

通过提供的一个 Svn 控制元素路径可以即可建立一个 Svn 远程会话SvnRemoteSession,

string elementPath = @"https://10.23.34.45:6801/svn/temp/test.txt";
SvnRemoteSession remoteSession = new SvnRemoteSession(new Uri(elementPath));

调用 SvnRemoteSession 对象的 GetRepositoryRoot() 方法可以获取当前svn 配置库服务器的根目录,

Uri repoRootUri = null;
remoteSession.GetRepositoryRoot(out repoRootUri);

获取到 svn 配置库的根目录之后,我们就可以调用 Reparent() 方法将SvnRemoteSession 会话对象设置到 svn 配置库的根,

remoteSession.Reparent(repoRootUri);

将远程会话设置到 svn 配置库根目录之后,我们就可以各个配置库元素执行相关的远程操作,例如列出某个配置库目录下的所有元素、获取当前配置库的最新版本号、获取某个元素的提交记录等。下面分别给出这三个操作的例子,

6.1 列出目录下的所有元素(非递归)

string dirPath = @"https://10.23.34.45:6801/svn/temp";
string dirRelPath = remoteSession.MakeRepositoryRootRelativePath(new Uri(dirPath)); //获取相对目录相对配置库根目录的相对路径
remoteSession.List(dirRelPath,
    new EventHandler<SvnRemoteListEventArgs>(
        delegate (object s, SvnRemoteListEventArgs e)
        {
            //e.Name: 元素名
            //e.Path: 元素路径
            //e.RetrievedRevistion: 元素的版本号
        }));

6.2 获取配置库最新版本号

long latestRevision = 0;
remoetSession.GetLatestRevision(out latestRevision);

6.3 获取指定文件的提交记录

Uri fileUri = new Uri(@"https://10.23.34.45:6801/svn/temp/test.txt");
string fileRelPath = remoteSession.MakeRepositoryRootRelativePath(fileUri);
    delegate (object s, SvnRemoteLogEventArgs e)
    {
        //e.Author: 提交人
        //e.Revision: 版本号
        //e.LogMessage: 提交备注信息
    }));

7 结束语

SharpSvn 项目自身提供的 Demo 样例几乎没有,提供的文档对各个 API 介绍的少得可怜。之前因工作需要,在网上搜索也没有发现多少关于 SharpSvn 的样例介绍。上面这些只是自身因需要用到而进行验证得来的一些 demo 样例,后面就没有再更多得使用 SharpSvn,所以关于SharpSvn 的探索就这么浅薄了,也懒得再继续深入了。

时间: 2024-11-02 12:44:05

使用 SharpSvn 执行 svn 操作的Demo的相关文章

获取 SharpSvn 执行 svn 操作的实时日志

1 获取 SharpSvn 操作日志的方式 之前一篇随笔(使用 SharpSvn 执行 svn 操作)讲到可以通过声称一个绑定到一个 SvnClient 对象的 SvnClientReport 对象.为了说明方便,将对应的程序片段再次写在下面, using (SvnClient client = new SvnClient()) { StringBuilder strBuilder = new StringBuilder(); SvnClientReporter reporter = new S

svn执行update操作后出现:Error : Previous operation has not finished; run &#39;cleanup&#39; if it was interrupted.

svn执行update操作后出现: Error : Previous operation has not finished; run 'cleanup' if it was interrupted. Error : Please execute the 'Cleanup' command. 提示要去执行下Cleanup命令,于是就去执行下Cleanup命令,结果出现了: 于是,解决方法只能是清空掉svn的队列.具体操作步骤如下: 1.下载sqlite3.zip 2.找到你svn项目下的.svn,

mybatis(二)执行CRUD操作的两种方式配置和注解

一.使用MyBatis对表执行CRUD操作——基于XML的实现 1.定义sql映射xml文件 userMapper.xml文件的内容如下: <?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper

SVN操作异常解决日志

1 svn locked某个目录-无法进行更新 产生这种情况大多是因为上次svn命令执行失败且被锁定了.如果cleanup没有效果的话只好手动删除锁定文件. 在命令提示符下cd 到svn项目出现问题的文件所在目录下,然后执行如下命令 del lock /q/s 就把锁删掉了.如图所示: 2.svn remains in conflict错误解决 情形:当有人在对某文件进行修改,假设为A文件,并提交至svn服务器,如果此时你正在修改A页面,并对其进行更新.会出现一些残余文件信息.如果在未删除这些文

svn操作的坑

1,如果本地文件误删了,服务器上有,导入方法:终端输入(注意空格) svn checkout svn://192.168.1.162/zuozuo空--username=yangqinglong空--password=yangqinglong /Users/njfifthcity/Desktop/zuozuo2 2,svn上传期间,如果意外中断,被操作的文件会被自动加锁,解决方法: 最上方finder位置的导航栏,找到clean,可以自动解锁,然后继续操作. 其他的坑(度娘说的): 1.Xcod

C# Winform中执行post操作并获取返回的XML类型的数据

/// <summary> /// 返回指定日期的订单数据 /// </summary> /// <param name="StartDate">起始日期</param> /// <param name="EndDate">结束日期</param> /// <returns>DataTable</returns> public System.Data.DataTable

SVN操作手册(part3)——SVN操作

SVN操作手册 3.SVN操作 3.1 SVN服务端操作 3.1.1 创建仓库 启动VisualSVN Server Manager,如图: ① 右键Repositories,选择create new repository,如图: ②在输入框中输入产库名称,如:137(注:命名时尽量使用英文和数字,不要使用汉字与空格),点击"下一步",进入下一步 ③选择仓库初始类型: Empty repository 代表空仓库,选择single-project repository版本库中会默认建立

使用MyBatis对表执行CRUD操作

一.使用MyBatis对表执行CRUD操作——基于XML的实现 1.定义sql映射xml文件 userMapper.xml文件的内容如下: 1 <?xml version="1.0" encoding="UTF-8" ?> 2 <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-ma

运维规范:执行写入操作时,一定不要开两个分别连入不同主机的securCRT窗口

运维规范:执行写入操作时,一定不要开两个分别连入不同主机的securCRT窗口. 本文说的是写入操作,若是查询操作,能只打开一个主机的securCRT窗口,就不要打开两个主机的securCRT窗口. 由于ogg复制环境中需要单表数据重新同步的关系,我经常在生产环境的ogg源头库中expdp,在ogg目的端库中impdp 当我在生产环境的ogg源头库中expdp完成并scp dmp 文件到目的端os之后,我会立即exit退出ogg源头的securCRT窗口. 原因是我怕impdp之前的drop t