码迷,mamicode.com
首页 > Web开发 > 详细

[dotnet] 封装一个同时支持密码/安全密钥认证的SFTP下载器,简单易用。

时间:2019-04-28 09:55:32      阅读:190      评论:0      收藏:0      [点我收藏+]

标签:工具   cancel   客户   word   疑问   pack   基本   配置文件   readonly   

前言

最近在开发订单对账系统,先从各种支付平台获取订单销售数据,然后与公司商城订单数据进行对账兜底。总体上,各个支付平台提供数据的方式分为两类,一般以接口的方式提供实时数据,比如:webservice、NVP、restfull api,以文件服务的方式提供周期性数据,比如:SFTP。接口的方式比较简单,随便一个HTTP客户端库都能搞定,而SFTP文件下载服务就不一样了,至少需要满足三个条件,不然对接起来就相当麻烦。

  1. 支持密码认证
  2. 支持安全密钥认证
  3. 支持根据按文件命名策略检索文件,即支持正则检索文件

经过调研发现了一个非常好用,且文档全面的SFTP客户端库:

  1. GitHub
  2. 官方文档

这个库由componentpro出品,此公司还提供了其它的工具库,功能非常强大,如下:

技术图片

从上面可以看出,不仅提供FTP client/server、SFTP client/server的库,还提供了Mail、Excel、SAML、PDF的库,真的是太强大了,经过实验也发现它的SFTP封装的真的好用。

如何封装

作者已经使用SFTP Library封装并实现了以上三点需求,代码结构如下:

技术图片

这里就不赘述代码设计了,感兴趣请自行查看源码。

地址:https://github.com/justmine66/Samples/tree/master/SFTP/SFtpDownloader

如何使用

请先安装包:Install-Package SFTP.Downloader -Version 1.0.0

1. 实现文件命名策略接口

public class FileNamingStrategy : IFileNamingStrategy
{
    public string GetFileRegexName()
    {
        return $"test.csv";
    }
}

2. 配置文件下载器

new ServiceCollection()
.AddSFtpServices(builder =>
{
    // 1. 注册命名服务,用于按需检索文件。
    builder.AddNamingStrategy<FileNamingStrategy>();
    // 2. 认证方案(任选其一)
    // 2.1 密码
    builder.UsePwdAuthTScheme("sftp-host", "userName", "pwd", "/upload/");
    // 2.2 安全密钥
    builder.UseSecurityKeyAuthTScheme("sftp-host", "userName", "SFtpDownloader.test.ppk", "/upload/");
});

备注:当使用安全密钥认证方案时,请将私钥设置为嵌入式资源。

3. 使用文件下载器

private readonly ILogger _logger;
private readonly IFilesDownloader _downloader;

public Engine(ILogger<Engine> logger, IFilesDownloader downloader)
{
    _logger = logger;
    _downloader = downloader;
}

public async Task StartAsync(CancellationToken cancellationToken)
{
    var files = await _downloader.DownloadAsync(1);
    _logger.LogInformation($"The files downloaded: {files.Aggregate((x, y) => $"{x},{y}")}.");
}

当需要在运行时才能注入配置时,还可以传入参数options,比如:

var files = await _downloader.DownloadAsync(1, options: new SFtpOptions(){
    Host = "sftp-host",UserName="userName",Password="pwd",RemoteDirectory="/upload"
});

示例github项目地址:https://github.com/justmine66/Samples/tree/master/SFTP/SFtpDownloader.Test

技术图片

使用起来就是这么简单!!!

技术图片

总结

本篇首先介绍了实现一个SFTP文件下载器,需要满足的基本需求,然后使用SFTP Library封装了一个既简单又好用的SFTP文件下载器,最后演示了如何使用此库。

最后

如果有什么疑问和见解,欢迎评论区交流。
如果你觉得本篇文章对您有帮助的话,感谢您的【推荐】。
如果你对dotnet感兴趣的话可以关注我,我会定期的在博客分享我的学习心得。
未经允许不得转载,转载请在明显位置给出出处及链接

[dotnet] 封装一个同时支持密码/安全密钥认证的SFTP下载器,简单易用。

标签:工具   cancel   客户   word   疑问   pack   基本   配置文件   readonly   

原文地址:https://www.cnblogs.com/justmine/p/10778459.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!