chore(tenpayv3): 新增基于 .NET Framework 4.7 的示例项目

samples/SKIT.FlurlHttpClient.Wechat.TenpayV3.Sample_NetFramework47/Services/BackgroundJobs/TenpayCertificateRefreshingBackgroundJob.cs

@@ -0,0 +1,57 @@
+using System;
+using System.Diagnostics;
+using System.Threading.Tasks;
+
+namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Sample.Services.BackgroundJobs
+{
+    using SKIT.FlurlHttpClient.Wechat.TenpayV3.Models;
+    using SKIT.FlurlHttpClient.Wechat.TenpayV3.Settings;
+
+    class TenpayCertificateRefreshingBackgroundJob
+    {
+        private readonly HttpClients.IWechatTenpayHttpClientFactory _tenpayHttpClientFactory;
+
+        public TenpayCertificateRefreshingBackgroundJob(
+            HttpClients.IWechatTenpayHttpClientFactory tenpayHttpClientFactory)
+        {
+            _tenpayHttpClientFactory = tenpayHttpClientFactory;
+        }
+
+        public async Task ExecuteAsync()
+        {
+            foreach (var tenpayMerchantOptions in Options.TenpayOptions.Instance.Value.Merchants)
+            {
+                try
+                {
+                    var client = _tenpayHttpClientFactory.Create(tenpayMerchantOptions.MerchantId);
+                    var request = new QueryCertificatesRequest();
+                    var response = await client.ExecuteQueryCertificatesAsync(request);
+                    if (response.IsSuccessful())
+                    {
+                        // NOTICE:
+                        //   如果启用了 `AutoDecryptResponseSensitiveProperty` 配置项，则无需再手动执行下面被注释的解密方法：
+                        //   response = client.DecryptResponseSensitiveProperty(response);
+
+                        foreach (var certificateModel in response.CertificateList)
+                        {
+                            client.CertificateManager.AddEntry(new CertificateEntry(certificateModel));
+                        }
+
+                        Debug.WriteLine("刷新微信商户平台证书成功。");
+                    }
+                    else
+                    {
+                        Debug.WriteLine(
+                            "刷新微信商户平台证书失败（状态码：{0}，错误代码：{1}，错误描述：{2}）。",
+                            response.RawStatus, response.ErrorCode, response.ErrorMessage
+                        );
+                    }
+                }
+                catch (Exception ex)
+                {
+                    Debug.WriteLine("刷新微信商户平台证书遇到异常。\r\n{0}", ex);
+                }
+            }
+        }
+    }
+}

samples/SKIT.FlurlHttpClient.Wechat.TenpayV3.Sample_NetFramework47/Services/HttpClients/IWechatTenpayCertificateManagerFactory.cs

@@ -0,0 +1,9 @@
+namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Sample.Services.HttpClients
+{
+    using SKIT.FlurlHttpClient.Wechat.TenpayV3.Settings;
+
+    public interface IWechatTenpayCertificateManagerFactory
+    {
+        CertificateManager Create(string merchantId);
+    }
+}

samples/SKIT.FlurlHttpClient.Wechat.TenpayV3.Sample_NetFramework47/Services/HttpClients/IWechatTenpayHttpClientFactory.cs

@@ -0,0 +1,7 @@
+namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Sample.Services.HttpClients
+{
+    public interface IWechatTenpayHttpClientFactory
+    {
+        WechatTenpayClient Create(string merchantId);
+    }
+}

samples/SKIT.FlurlHttpClient.Wechat.TenpayV3.Sample_NetFramework47/Services/HttpClients/Implements/WechatTenpayCertificateManagerFactory.cs

@@ -0,0 +1,25 @@
+using System.Collections.Concurrent;
+
+namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Sample.Services.HttpClients.Implements
+{
+    using SKIT.FlurlHttpClient.Wechat.TenpayV3.Settings;
+
+    partial class WechatTenpayCertificateManagerFactory : IWechatTenpayCertificateManagerFactory
+    {
+        private readonly ConcurrentDictionary<string, CertificateManager> _dict;
+
+        public WechatTenpayCertificateManagerFactory()
+        {
+            _dict = new ConcurrentDictionary<string, CertificateManager>();
+        }
+
+        public CertificateManager Create(string merchantId)
+        {
+            // NOTICE:
+            //   这里的工厂方法是为了演示多租户而存在的，可根据商户号生成不同的证书管理器。
+            //   如果你的项目只存在唯一一个租户，那么直接注入 `CertificateManager` 即可。
+
+            return _dict.GetOrAdd(merchantId, new InMemoryCertificateManager());
+        }
+    }
+}

samples/SKIT.FlurlHttpClient.Wechat.TenpayV3.Sample_NetFramework47/Services/HttpClients/Implements/WechatTenpayHttpClientFactory.cs

@@ -0,0 +1,38 @@
+using System;
+using System.Linq;
+
+namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Sample.Services.HttpClients.Implements
+{
+    partial class WechatTenpayHttpClientFactory : IWechatTenpayHttpClientFactory
+    {
+        private readonly IWechatTenpayCertificateManagerFactory _tenpayCertificateManagerFactory;
+
+        public WechatTenpayHttpClientFactory(
+            IWechatTenpayCertificateManagerFactory tenpayCertificateManagerFactory)
+        {
+            _tenpayCertificateManagerFactory = tenpayCertificateManagerFactory;
+        }
+
+        public WechatTenpayClient Create(string merchantId)
+        {
+            // NOTICE:
+            //   这里的工厂方法是为了演示多租户而存在的，可根据商户号生成不同的 API 客户端。
+            //   如果你的项目只存在唯一一个租户，那么直接注入 `WechatTenpayClient` 即可。
+            
+            var tenpayMerchantOptions = Options.TenpayOptions.Instance.Value.Merchants?.FirstOrDefault(e => string.Equals(merchantId, e.MerchantId));
+            if (tenpayMerchantOptions == null)
+                throw new Exception("未在配置项中找到该 MerchantId 对应的微信商户号。");
+
+            return new WechatTenpayClient(new WechatTenpayClientOptions()
+            {
+                MerchantId = tenpayMerchantOptions.MerchantId,
+                MerchantV3Secret = tenpayMerchantOptions.SecretV3,
+                MerchantCertSerialNumber = tenpayMerchantOptions.CertSerialNumber,
+                MerchantCertPrivateKey = tenpayMerchantOptions.CertPrivateKey,
+                CertificateManager = _tenpayCertificateManagerFactory.Create(tenpayMerchantOptions.MerchantId),
+                AutoEncryptRequestSensitiveProperty = true,
+                AutoDecryptResponseSensitiveProperty = true
+            });
+        }
+    }
+}