mirror of
https://gitee.com/ThingsGateway/ThingsGateway.git
synced 2025-10-24 12:20:28 +08:00
126 lines
4.5 KiB
C#
126 lines
4.5 KiB
C#
// ------------------------------------------------------------------------
|
||
// 版权信息
|
||
// 版权归百小僧及百签科技（广东）有限公司所有。
|
||
// 所有权利保留。
|
||
// 官方网站：https://baiqian.com
|
||
//
|
||
// 许可证信息
|
||
// 项目主要遵循 MIT 许可证和 Apache 许可证（版本 2.0）进行分发和使用。
|
||
// 许可证的完整文本可以在源代码树根目录中的 LICENSE-APACHE 和 LICENSE-MIT 文件中找到。
|
||
// ------------------------------------------------------------------------
|
||
|
||
using System.Diagnostics.CodeAnalysis;
|
||
using System.Reflection;
|
||
|
||
using ThingsGateway.Extensions;
|
||
|
||
namespace ThingsGateway.HttpRemote;
|
||
|
||
/// <summary>
|
||
/// HTTP 声明式提取器上下文
|
||
/// </summary>
|
||
public sealed class HttpDeclarativeExtractorContext
|
||
{
|
||
/// <summary>
|
||
/// 冻结参数类型集合
|
||
/// </summary>
|
||
/// <remarks>此类参数类型不应作为外部提取对象。</remarks>
|
||
internal static readonly Type[] _frozenParameterTypes =
|
||
[
|
||
typeof(Action<HttpRequestBuilder>), typeof(Action<HttpMultipartFormDataBuilder>), typeof(HttpCompletionOption),
|
||
typeof(CancellationToken)
|
||
];
|
||
|
||
/// <summary>
|
||
/// <inheritdoc cref="HttpDeclarativeExtractorContext" />
|
||
/// </summary>
|
||
/// <param name="method">被调用方法</param>
|
||
/// <param name="args">被调用方法的参数值数组</param>
|
||
internal HttpDeclarativeExtractorContext(MethodInfo method, object?[] args)
|
||
{
|
||
// 空检查
|
||
ArgumentNullException.ThrowIfNull(method);
|
||
ArgumentNullException.ThrowIfNull(args);
|
||
|
||
Method = method;
|
||
Args = args;
|
||
|
||
// 初始化被调用方法的参数键值字典
|
||
Parameters = method.GetParameters().Select((p, i) => new { Parameter = p, Value = args[i] })
|
||
.ToDictionary(u => u.Parameter, u => u.Value).AsReadOnly();
|
||
|
||
// 初始化被调用方法的非冻结类型参数键值字典
|
||
UnFrozenParameters = Parameters.Where(u => !IsFrozenParameter(u.Key)).ToDictionary(u => u.Key, u => u.Value)
|
||
.AsReadOnly();
|
||
}
|
||
|
||
/// <summary>
|
||
/// 被调用方法
|
||
/// </summary>
|
||
public MethodInfo Method { get; }
|
||
|
||
/// <summary>
|
||
/// 被调用方法的参数值数组
|
||
/// </summary>
|
||
public object?[] Args { get; }
|
||
|
||
/// <summary>
|
||
/// 被调用方法的参数键值字典
|
||
/// </summary>
|
||
public IReadOnlyDictionary<ParameterInfo, object?> Parameters { get; }
|
||
|
||
/// <summary>
|
||
/// 被调用方法的非冻结类型参数键值字典
|
||
/// </summary>
|
||
public IReadOnlyDictionary<ParameterInfo, object?> UnFrozenParameters { get; }
|
||
|
||
/// <summary>
|
||
/// 判断参数是否为冻结参数
|
||
/// </summary>
|
||
/// <remarks>此类参数不应作为外部提取对象。</remarks>
|
||
/// <param name="parameter">
|
||
/// <see cref="ParameterInfo" />
|
||
/// </param>
|
||
/// <returns>
|
||
/// <see cref="bool" />
|
||
/// </returns>
|
||
public static bool IsFrozenParameter(ParameterInfo parameter)
|
||
{
|
||
// 空检查
|
||
ArgumentNullException.ThrowIfNull(parameter);
|
||
|
||
return _frozenParameterTypes.Contains(parameter.ParameterType);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 检查被调用方法是否定义了指定特性
|
||
/// </summary>
|
||
/// <param name="attribute">
|
||
/// <typeparamref name="TAttribute" />
|
||
/// </param>
|
||
/// <param name="inherit">是否在基类中搜索</param>
|
||
/// <typeparam name="TAttribute">
|
||
/// <see cref="Attribute" />
|
||
/// </typeparam>
|
||
/// <returns>
|
||
/// <see cref="bool" />
|
||
/// </returns>
|
||
public bool IsMethodDefined<TAttribute>([NotNullWhen(true)] out TAttribute? attribute, bool inherit = false)
|
||
where TAttribute : Attribute =>
|
||
Method.IsDefined(out attribute, inherit);
|
||
|
||
/// <summary>
|
||
/// 获取被调用方法指定特性的所有实例
|
||
/// </summary>
|
||
/// <param name="inherit">是否在基类中搜索</param>
|
||
/// <param name="methodScanFirst">是否优先查找 <see cref="MethodInfo" /> 的特性。默认值为：<c>true</c>。</param>
|
||
/// <typeparam name="TAttribute">
|
||
/// <see cref="Attribute" />
|
||
/// </typeparam>
|
||
/// <returns>
|
||
/// <typeparamref name="TAttribute" /><c>[]</c>
|
||
/// </returns>
|
||
public TAttribute[]? GetMethodDefinedCustomAttributes<TAttribute>(bool inherit = false, bool methodScanFirst = true)
|
||
where TAttribute : Attribute =>
|
||
Method.GetDefinedCustomAttributes<TAttribute>(inherit, methodScanFirst);
|
||
} |