#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 using System; using System.Globalization; using System.Text; using System.IO; using log4net.Core; using log4net.Util; namespace log4net.Layout.Pattern { /// /// Converter to output and truncate '.' separated strings /// /// /// /// This abstract class supports truncating a '.' separated string /// to show a specified number of elements from the right hand side. /// This is used to truncate class names that are fully qualified. /// /// /// Subclasses should override the method to /// return the fully qualified string. /// /// /// Nicko Cadell public abstract class NamedPatternConverter : PatternLayoutConverter, IOptionHandler { private int m_precision = 0; #region Implementation of IOptionHandler /// /// 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() { m_precision = 0; if (Option != null) { string optStr = Option.Trim(); if (optStr.Length > 0) { int precisionVal; if (SystemInfo.TryParse(optStr, out precisionVal)) { if (precisionVal <= 0) { LogLog.Error(declaringType, "NamedPatternConverter: Precision option (" + optStr + ") isn't a positive integer."); } else { m_precision = precisionVal; } } else { LogLog.Error(declaringType, "NamedPatternConverter: Precision option \"" + optStr + "\" not a decimal integer."); } } } } #endregion /// /// Get the fully qualified string data /// /// the event being logged /// the fully qualified name /// /// /// Overridden by subclasses to get the fully qualified name before the /// precision is applied to it. /// /// /// Return the fully qualified '.' (dot/period) separated string. /// /// abstract protected string GetFullyQualifiedName(LoggingEvent loggingEvent); /// /// Convert the pattern to the rendered message /// /// that will receive the formatted result. /// the event being logged /// /// Render the to the precision /// specified by the property. /// sealed override protected void Convert(TextWriter writer, LoggingEvent loggingEvent) { string name = GetFullyQualifiedName(loggingEvent); if (m_precision <= 0 || name == null || name.Length < 2) { writer.Write(name); } else { int len = name.Length; string trailingDot = string.Empty; if (name.EndsWith(DOT)) { trailingDot = DOT; name = name.Substring(0, len - 1); len--; } int end = name.LastIndexOf(DOT); for(int i = 1; end > 0 && i < m_precision; i++) { end = name.LastIndexOf('.', end - 1); } if (end == -1) { writer.Write(name + trailingDot); } else { writer.Write(name.Substring(end + 1, len - end - 1) + trailingDot); } } } #region Private Static Fields /// /// The fully qualified type of the NamedPatternConverter class. /// /// /// Used by the internal logger to record the Type of the /// log message. /// private readonly static Type declaringType = typeof(NamedPatternConverter); private const string DOT = "."; #endregion Private Static Fields } }