#region Apache License
//
// Licensed to the Apache Software Foundation (ASF) under one or more
// contributor license agreements. See the NOTICE file distributed with
// this work for additional information regarding copyright ownership.
// The ASF licenses this file to you under the Apache License, Version 2.0
// (the "License"); you may not use this file except in compliance with
// the License. You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//
#endregion
#if !NETCF && (NET_2_0 || NETSTANDARD2_0)
using System;
using System.IO;
using log4net.Util;
using log4net.Core;
namespace log4net.Layout.Pattern
{
///
/// Write the caller stack frames to the output
///
///
///
/// Writes the to the output writer, using format:
/// type3.MethodCall3 > type2.MethodCall2 > type1.MethodCall1
///
///
/// Michael Cromwell
internal class StackTracePatternConverter : PatternLayoutConverter, IOptionHandler
{
private int m_stackFrameLevel = 1;
///
/// Initialize the converter
///
///
///
/// This is part of the delayed object
/// activation scheme. The method must
/// be called on this object after the configuration properties have
/// been set. Until is called this
/// object is in an undefined state and must not be used.
///
///
/// If any of the configuration properties are modified then
/// must be called again.
///
///
public void ActivateOptions()
{
if (Option == null)
return;
string optStr = Option.Trim();
if (optStr.Length != 0)
{
int stackLevelVal;
if (SystemInfo.TryParse(optStr, out stackLevelVal))
{
if (stackLevelVal <= 0)
{
LogLog.Error(declaringType, "StackTracePatternConverter: StackeFrameLevel option (" + optStr + ") isn't a positive integer.");
}
else
{
m_stackFrameLevel = stackLevelVal;
}
}
else
{
LogLog.Error(declaringType, "StackTracePatternConverter: StackFrameLevel option \"" + optStr + "\" not a decimal integer.");
}
}
}
///
/// Write the strack frames to the output
///
/// that will receive the formatted result.
/// the event being logged
///
///
/// Writes the to the output writer.
///
///
protected override void Convert(TextWriter writer, LoggingEvent loggingEvent)
{
StackFrameItem[] stackframes = loggingEvent.LocationInformation.StackFrames;
if ((stackframes == null) || (stackframes.Length <= 0))
{
LogLog.Error(declaringType, "loggingEvent.LocationInformation.StackFrames was null or empty.");
return;
}
int stackFrameIndex = m_stackFrameLevel - 1;
while (stackFrameIndex >= 0)
{
if (stackFrameIndex >= stackframes.Length)
{
stackFrameIndex--;
continue;
}
StackFrameItem stackFrame = stackframes[stackFrameIndex];
writer.Write("{0}.{1}", stackFrame.ClassName, GetMethodInformation(stackFrame.Method));
if (stackFrameIndex > 0)
{
// TODO: make this user settable?
writer.Write(" > ");
}
stackFrameIndex--;
}
}
///
/// Returns the Name of the method
///
///
/// This method was created, so this class could be used as a base class for StackTraceDetailPatternConverter
/// string
internal virtual string GetMethodInformation(MethodItem method)
{
return method.Name;
}
#region Private Static Fields
///
/// The fully qualified type of the StackTracePatternConverter class.
///
///
/// Used by the internal logger to record the Type of the
/// log message.
///
private static readonly Type declaringType = typeof(StackTracePatternConverter);
#endregion Private Static Fields
}
}
#endif // !NETCF && NET_2_0