docs: 更新示例项目

This commit is contained in:
Fu Diwei
2025-06-04 23:53:34 +08:00
parent ac925f87cf
commit 56ed274c40
45 changed files with 800 additions and 492 deletions

View File

@@ -30,7 +30,8 @@ namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Sample.Services.BackgroundService
{
// NOTICE:
// 2024-10-01 后微信支付新增了基于微信支付公钥的验证身份方式,
// 如果你已切换至使用平台公钥,则不再需要下载平台证书,可忽略此定时任务。
// 如果你已切换至使用平台公钥,则不再需要下载平台证书,可删除此定时任务。
while (!stoppingToken.IsCancellationRequested)
{
foreach (var tenpayMerchantOptions in _tenpayOptions.Merchants)

View File

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

View File

@@ -5,20 +5,25 @@ using Microsoft.Extensions.Options;
namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Sample.Services.HttpClients.Implements
{
using SKIT.FlurlHttpClient.Wechat.TenpayV3.Settings;
internal partial class WechatTenpayClientFactory : IWechatTenpayClientFactory
{
private readonly IHttpClientFactory _httpClientFactory;
private readonly Options.TenpayOptions _tenpayOptions;
private readonly IWechatTenpayCertificateManagerFactory _tenpayCertificateManagerFactory;
private readonly IWechatTenpayPublicKeyManagerFactory _tenpayPublicKeyManagerFactory;
public WechatTenpayClientFactory(
IHttpClientFactory httpClientFactory,
IOptions<Options.TenpayOptions> tenpayOptions,
IWechatTenpayCertificateManagerFactory tenpayCertificateManagerFactory)
IWechatTenpayCertificateManagerFactory tenpayCertificateManagerFactory,
IWechatTenpayPublicKeyManagerFactory tenpayPublicKeyManagerFactory)
{
_httpClientFactory = httpClientFactory;
_tenpayOptions = tenpayOptions.Value;
_tenpayCertificateManagerFactory = tenpayCertificateManagerFactory;
_tenpayPublicKeyManagerFactory = tenpayPublicKeyManagerFactory;
}
public WechatTenpayClient Create(string merchantId)
@@ -27,19 +32,26 @@ namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Sample.Services.HttpClients.Imple
// 这里的工厂方法是为了演示多租户而存在的,可根据商户号生成不同的 API 客户端。
// 如果你的项目只存在唯一一个租户,那么直接注入 `WechatTenpayClient` 即可。
var tenpayMerchantConfig = _tenpayOptions.Merchants?.FirstOrDefault(e => string.Equals(merchantId, e.MerchantId));
if (tenpayMerchantConfig == null)
var tenpayMerchantOptions = _tenpayOptions.Merchants?.FirstOrDefault(e => string.Equals(merchantId, e.MerchantId));
if (tenpayMerchantOptions == null)
throw new Exception("未在配置项中找到该 MerchantId 对应的微信商户号。");
var wechatTenpayClientOptions = new WechatTenpayClientOptions()
{
MerchantId = tenpayMerchantConfig.MerchantId,
MerchantV3Secret = tenpayMerchantConfig.SecretV3,
MerchantCertificateSerialNumber = tenpayMerchantConfig.CertificateSerialNumber,
MerchantCertificatePrivateKey = tenpayMerchantConfig.CertificatePrivateKey,
PlatformCertificateManager = _tenpayCertificateManagerFactory.Create(tenpayMerchantConfig.MerchantId),
MerchantId = tenpayMerchantOptions.MerchantId,
MerchantV3Secret = tenpayMerchantOptions.SecretV3,
MerchantCertificateSerialNumber = tenpayMerchantOptions.CertificateSerialNumber,
MerchantCertificatePrivateKey = tenpayMerchantOptions.CertificatePrivateKey,
AutoEncryptRequestSensitiveProperty = false,
AutoDecryptResponseSensitiveProperty = false
AutoDecryptResponseSensitiveProperty = false,
// 基于平台证书的认证方式还需设置以下参数:
PlatformAuthScheme = PlatformAuthScheme.Certificate,
PlatformCertificateManager = _tenpayCertificateManagerFactory.Create(tenpayMerchantOptions.MerchantId),
// 基于平台公钥的认证方式还需设置以下参数:
//PlatformAuthScheme = PlatformAuthScheme.PublicKey,
//PlatformPublicKeyManager = _tenpayPublicKeyManagerFactory.Create(tenpayMerchantOptions.MerchantId)
};
var wechatTenpayClient = WechatTenpayClientBuilder.Create(wechatTenpayClientOptions)
.UseHttpClient(_httpClientFactory.CreateClient(), disposeClient: false)

View File

@@ -0,0 +1,41 @@
using System;
using System.Collections.Concurrent;
using System.Linq;
using System.Net.Http;
using Microsoft.Extensions.Options;
namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Sample.Services.HttpClients.Implements
{
using SKIT.FlurlHttpClient.Wechat.TenpayV3.Settings;
internal partial class WechatTenpayPublicKeyManagerFactory : IWechatTenpayPublicKeyManagerFactory
{
private readonly ConcurrentDictionary<string, IPublicKeyManager> _dict;
private readonly Options.TenpayOptions _tenpayOptions;
public WechatTenpayPublicKeyManagerFactory(
IOptions<Options.TenpayOptions> tenpayOptions)
{
_dict = new ConcurrentDictionary<string, IPublicKeyManager>();
_tenpayOptions = tenpayOptions.Value;
}
public IPublicKeyManager Create(string merchantId)
{
// NOTICE:
// 这里的工厂方法是为了演示多租户而存在的,可根据商户号生成不同的公钥管理器。
// 如果你的项目只存在唯一一个租户,那么直接注入 `PublicKeyManager` 即可。
var tenpayMerchantOptions = _tenpayOptions.Merchants?.FirstOrDefault(e => string.Equals(merchantId, e.MerchantId));
if (tenpayMerchantOptions == null)
throw new Exception("未在配置项中找到该 MerchantId 对应的微信商户号。");
return _dict.GetOrAdd(merchantId, (_) =>
{
var manager = new InMemoryPublicKeyManager();
manager.AddEntry(new PublicKeyEntry(PublicKeyEntry.ALGORITHM_TYPE_RSA, tenpayMerchantOptions.PlatformPublicKeyId!, tenpayMerchantOptions.PlatformPublicKey!));
return manager;
});
}
}
}