几个Caller-特性的妙用

火币app官网下载 2022年10月21日 11:02 49 Connor

System.Runtime.CompilerServices命名空间下有4个以“Caller”为前缀命名的Attribute，我们可以将它标注到方法参数上自动获取当前调用上下文的信息，比如当前的方法名、某个参数的表达式、当前源文件的路径，以及当前代码在源文件中的行号。

一、CallerMemberNameAttribute

顾名思义，如果当我们将CallerMemberNameAttribute特性标注到“可缺省参数”上，调用方无需显式指定参数值就可以将表示当前调用方法名赋值给该参数。如下面的代码片段所示，我们为ActivitySource定义了一个名为StartNewActivity的扩展方法，表示Activity名称的name参数是一个“可缺省参数”。我们在该参数上标准了CallerMemberNameAttribute特性，意味着当前调用的方法名将自动作为参数值。

publicstaticclassExtensions

publicstaticActivity? StartNewActivity(

thisActivitySource activitySource,

ActivityKind kind = ActivityKind.Internal,

[ CallerMemberName] stringname = "")

=> activitySource.StartActivity(name: name, kind: kind);

以Activity/ActivitySource/ActivityListener为核心的模型实际上是对OpenTelemetry的实现，所以我们可以利用上面定义的这个StartNewActivity创建一个代码跟踪操作的Activity（对应OpenTelemetry下的Span）。针对StartNewActivity方法调用体现在如下这个Invoker类型中，它的构造函数中注入了ActivitySource 对象。InvokeAsync方法内部调用了私有方法FooAsync、后者又调用了BarAsync方法，调用链InvokeAsync->FooAsync->BarAsync的跟踪通过调用ActivitySource的StartNewActivity扩展方法被记录下来，我们在调用此方法时并没有指定参数。

publicclassInvoker

privatereadonlyActivitySource _activitySource;

publicInvoker( ActivitySource activitySource)

展开全文

=> _activitySource = activitySource;

publicasyncTask InvokeAsync( )

using(_activitySource.StartNewActivity)

awaitTask.Delay( 100);

awaitFooAsync;

privateasyncTask FooAsync( )

using(_activitySource.StartNewActivity)

awaitTask.Delay( 100);

awaitBarAsync;

privateTask BarAsync( )

using(_activitySource.StartNewActivity)

returnTask.Delay( 100);

我们利用如下的代码利用依赖注入框架将Invoker对象创建出来，并调用其Invoke方法。

ActivitySource.AddActivityListener( newActivityListener

ShouldListenTo = _ => true,

Sample = ( refActivityCreationOptions<ActivityContext> options)

=> ActivitySamplingResult.AllData,

ActivityStopped = activity => {

Console.WriteLine(activity.DisplayName);

Console.WriteLine( $"\tTraceId: {activity.TraceId}" );

Console.WriteLine( $"\tSpanId: {activity.SpanId}" );

Console.WriteLine( $"\tDuration: {activity.Duration}" );

foreach( varkv inactivity.TagObjects)

Console.WriteLine( $"\t {kv.Key}: {kv.Value}" );

Console.WriteLine;

awaitnewServiceCollection

.AddSingleton( newActivitySource( "App"))

.AddSingleton<Invoker>

.BuildServiceProvider

.GetRequiredService<Invoker>

.InvokeAsync;

我们利用注册的ActivityListener在Activity终止时将Activity相关跟踪信息（操作名称、SpanId、ParentId、执行时间和Tag）打印在控制台上，具体输出如下所示。

二、CallerArgumentExpressionAttribute

CallerArgumentExpressionAttribute特性里利用目标参数将当前方法调用的某个参数（构造函数的参数表示该参数的名称）的表达式保存下来。如果指定的是一个变量（或者参数），捕获到的就是变量名。比如我们定义了如下这个用来验证参数并确保它不能为Null的ArgumentNotNull<T>。除了第一个表示参数值的argumentValue参数，它还具有一个表示参数名的argumentName参数，抛出的ArgumentNullException异常的参数名就来源于此。

publicstaticclassGuard

publicstaticT ArgumentNotNull<T>(

T argumentValue,

[ CallerArgumentExpression( "argumentValue") ]

stringargumentName = "") whereT: class

if(argumentValue isnull)

thrownewArgumentNullException(argumentName);

returnargumentValue;

我们修改了Invoker的构造函数，并按照如下的方式添加了针对输出参数（ActivitySource对象）的验证，以避免后续抛出NullReferenceException异常。可以看出，我们调用ArgumentNotNull方法时并没有执行表示参数名称的第二个参数。

varinvoker = newInvoker( null);

publicclassInvoker

privatereadonlyActivitySource _activitySource;

publicInvoker( ActivitySource activitySource)

=> _activitySource = Guard.ArgumentNotNull(activitySource);

如果我们按照如上的方式调用Invoker的构造函数，并将Null作为参数，此时会抛出如下的异常，可以看到抛出的ArgumentNullException异常被赋予了正确的参数名。

三、CallerFilePathAttribute &CallerLineNumberAttribute

CallerFilePathAttribute 和CallerLineNumberAttribute特性会将源代码的两个属性赋值给目标参数。具体来说，前者会将当前源文件的路径绑定到目标参数，后者绑定的则是当前执行代码在源文件中的行数。下面的代码为StartNewActivity扩展方法额外添加了两个参数，并标注了如上两个特性，我们将对应的参数值作为Tag添加到创建的Activity中。

publicstaticclassExtensions

publicstaticActivity? StartNewActivity(

thisActivitySource activitySource,

ActivityKind kind = ActivityKind.Internal,

[ CallerMemberName] stringname = "",

[ CallerFilePath] string? filePath = default,

[ CallerLineNumber] intlineNumber = default)

=> activitySource

.StartActivity(name: name, kind: kind)

?.AddTag( "CallerFilePath", filePath)

?.AddTag( "CallerLineNumber", lineNumber);

再次执行我们的程序，控制台上就会输出添加的两个Tag。