• 使用 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	emp";
        SvnUpdateArgs updateArgs = new SvnUpdateArgs();
        updateArgs.Depth = SvnDepth.Empty;
        client.Update(path, updateArgs);
    }

    3.2加入版本控制 Add

    using (SvnClient client = new SvnClient())
    {
        string path = @"d:\svn	emp
    ew.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	emp	est.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	emp", 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 的探索就这么浅薄了,也懒得再继续深入了。

  • 相关阅读:
    【深度强化学习】Curriculum-guided Hindsight Experience Replay读后感
    【深度学习】perceptron(感知机)
    【深度学习】基础--NumPy
    【RMAN】一些参数温故知新
    初识Kotlin之函数
    初识Kotlin之变量
    编程和英语一起学,每日一词
    SpringBoot注册Windows服务和启动报错的原因
    从Docker 到Jenkins 到Ansible的部署经验
    IDEA 常用配置
  • 原文地址:https://www.cnblogs.com/lienhua34/p/3917787.html
Copyright © 2020-2023  润新知