private static string GenerateArgumentString(LoggingSite site, bool includeContext)
{
var contextArgument = includeContext
? site.LoggingContextParameterName + (site.Payload.Any() ? ", " : string.Empty)
: string.Empty;
return(contextArgument + string.Join(", ", site.Payload.Select(
parameter =>
{
var modifier = parameter.RefKind == RefKind.Ref ? "ref" : string.Empty;
return $"{modifier} {parameter.Name}";
})
));
}
private static string GenerateParameterString(LoggingSite site, bool includeContext)
{
var contextParameter = includeContext
? $"{GlobalInstrumentationNamespace}.LoggingContext {site.LoggingContextParameterName}" + (site.Payload.Any() ? ", " : string.Empty)
: string.Empty;
return(contextParameter + string.Join(", ", site.Payload.Select(
parameter =>
{
var modifier = parameter.RefKind == RefKind.Ref ? "ref" : string.Empty;
var typeValue = parameter.Type.ToDisplayString();
var defaultValue = parameter.HasExplicitDefaultValue
? " = " + (parameter.ExplicitDefaultValue == null ? "null" : parameter.ExplicitDefaultValue.ToString())
: string.Empty;
return $"{modifier}{typeValue} {parameter.Name}{defaultValue}";
})
));
}
/// <summary>
/// Parses an validates the logging attributes and message in a logging method.
/// </summary>
public static bool ParseAndValidateLogSite(IMethodSymbol method, AttributeData attributeData, IReadOnlyDictionary <string, string> aliases, ErrorReport errorReport, out LoggingSite loggingSite)
{
loggingSite = new LoggingSite();
loggingSite.Aliases = aliases;
loggingSite.Method = method;
if (!loggingSite.SetPayload(errorReport, method.Parameters.Skip(1)))
{
return(false);
}
// Pull the data out of the GeneratedEventAttribute
foreach (var argument in attributeData.NamedArguments)
{
if (argument.Value.IsNull)
{
System.Diagnostics.Debugger.Launch();
errorReport.ReportError(method, $"Argument.Value is null. Key={argument.Key}");
continue;
}
Contract.Assert(argument.Value.Value is not null);
switch (argument.Key)
{
case nameof(GeneratedEventAttribute.EventLevel):
if (argument.Value.Value.GetType() != typeof(int))
{
errorReport.ReportError(method, $"Unsupported {nameof(GeneratedEventAttribute.EventLevel)} value '{argument.Value.Value.ToString()}'");
return(false);
}
int value = (int)argument.Value.Value;
switch (value)
{
case 0:
loggingSite.Level = Level.LogAlways;
break;
case 1:
loggingSite.Level = Level.Critical;
break;
case 2:
loggingSite.Level = Level.Error;
break;
case 3:
loggingSite.Level = Level.Warning;
break;
case 4:
loggingSite.Level = Level.Informational;
break;
case 5:
loggingSite.Level = Level.Verbose;
break;
default:
errorReport.ReportError(method, $"Unsupported {nameof(GeneratedEventAttribute.EventLevel)} value '{value}'");
break;
}
break;
case nameof(GeneratedEventAttribute.EventGenerators):
loggingSite.EventGenerators = (EventGenerators)argument.Value.Value;
break;
case nameof(GeneratedEventAttribute.Message):
loggingSite.SpecifiedMessageFormat = EscapeMessageString((string)argument.Value.Value);
break;
case nameof(GeneratedEventAttribute.EventOpcode):
loggingSite.EventOpcode = (byte)argument.Value.Value;
break;
case nameof(GeneratedEventAttribute.Keywords):
loggingSite.EventKeywords = (int)argument.Value.Value;
break;
case nameof(GeneratedEventAttribute.EventTask):
loggingSite.EventTask = (ushort)argument.Value.Value;
break;
}
}
if (string.IsNullOrWhiteSpace(loggingSite.SpecifiedMessageFormat))
{
errorReport.ReportError(method, $"{nameof(GeneratedEventAttribute.Message)} is required");
return(false);
}
if (loggingSite.SpecifiedMessageFormat.StartsWith(EventConstants.LabeledProvenancePrefix, StringComparison.Ordinal) && method.Parameters.Length >= 2 && method.Parameters[1].Name != "location")
{
errorReport.ReportError(method, $"{nameof(GeneratedEventAttribute.Message)} is using provenance prefix information to indicate line information. Therefore the location must be the first parameter after the {nameof(LoggingContext)}. This method declares '{method.Parameters[1].Name}' as that parameter");
return(false);
}
// Verify the message format
string normalizedMessageFormat = loggingSite.GetNormalizedMessageFormat();
normalizedMessageFormat = normalizedMessageFormat.Replace("{{", string.Empty).Replace("}}", string.Empty);
int openBracketPos = -1;
int curlyBracketPos = normalizedMessageFormat.IndexOfAny(new char[] { '{', '}' });
while (curlyBracketPos >= 0)
{
if (openBracketPos < 0)
{
if (normalizedMessageFormat[curlyBracketPos] == '}')
{
errorReport.ReportError(method, $"{nameof(GeneratedEventAttribute.Message)} format error: Found '}}' without matching '{{'");
return(false);
}
openBracketPos = curlyBracketPos;
}
else
{
if (normalizedMessageFormat[curlyBracketPos] == '{')
{
errorReport.ReportError(method, $"{nameof(GeneratedEventAttribute.Message)} format error: Found too many nested '{{'");
return(false);
}
string format = normalizedMessageFormat.Substring(openBracketPos + 1, curlyBracketPos - openBracketPos - 1);
int idx;
if (!int.TryParse(format.Split(':')[0], out idx))
{
errorReport.ReportError(method, $"{nameof(GeneratedEventAttribute.Message)} format error: Unknown parameter: {{{format}}}");
return(false);
}
if (idx < 0 || idx >= loggingSite.FlattenedPayload.Count)
{
errorReport.ReportError(method, $"{nameof(GeneratedEventAttribute.Message)} format error: Index out of range: {{{format}}}");
return(false);
}
openBracketPos = -1;
}
curlyBracketPos = normalizedMessageFormat.IndexOfAny(new char[] { '{', '}' }, curlyBracketPos + 1);
}
if (openBracketPos >= 0)
{
errorReport.ReportError(method, $"{nameof(GeneratedEventAttribute.Message)} format error: Found '{{' without matching '}}'");
return(false);
}
// Only perform this check if telemetry is turned on. Otherwise events that only send to telemetry will
// trigger the error
if (loggingSite.EventGenerators == EventGenerators.None)
{
errorReport.ReportError(method, $"{nameof(GeneratedEventAttribute.EventGenerators)} not specified");
return(false);
}
if (attributeData.ConstructorArguments.Length > 0 && attributeData.ConstructorArguments[0].Value.GetType() == typeof(ushort))
{
loggingSite.Id = (ushort)attributeData.ConstructorArguments[0].Value;
}
else
{
errorReport.ReportError(method, "First constructor argument should be an ushort");
return(false);
}
if (method.Parameters.Length > 0 && method.Parameters[0].Type.Name == "LoggingContext")
{
loggingSite.LoggingContextParameterName = method.Parameters[0].Name;
}
else
{
errorReport.ReportError(method, $"First method argument must be a {nameof(LoggingContext)}");
return(false);
}
foreach (AttributeData attribute in method.ContainingType.GetAttributes())
{
switch (attribute.AttributeClass.Name)
{
case nameof(EventKeywordsTypeAttribute):
loggingSite.KeywordsType = (INamedTypeSymbol)attribute.ConstructorArguments[0].Value;
break;
case nameof(EventTasksTypeAttribute):
loggingSite.TasksType = (INamedTypeSymbol)attribute.ConstructorArguments[0].Value;
break;
}
}
return(true);
}
/// <summary> /// Writes to the body of the log method. This will be called for each <see cref="LoggingSite"/> /// </summary> public abstract void GenerateLogMethodBody(LoggingSite site, Func <string> getMessageExpression);