[Asp.net 5] Logging-日志系统的基本架构（下）

接上节内容，我们继续讲解日志的其他部分.

ILoggerProvider以及扩展类

我们在上节的架构图上并没有看到有直接实现该接口的实现类。那么如果将Logger类直接使用会有什么结果呢？

var factory = new LoggerFactory();
var logger = factory.CreateLogger("name");
logger.Log(LogLevel.Debug, , "state", null, null);

这段代码能够正常运行但是不会记录任何日志。因为Logger类并没有直接记录日志的功能，需要通过LoggerFactory的GetProviders方法创建能够直接工作的ILogger类型日志。所以即使现在的工程中没有对于ILoggerProvider的扩展，但是我们可以预测：Microsoft.Framework.Logging.Console、Microsoft.Framework.Logging.NLog、Microsoft.Framework.Logging.TraceSource都会对ILoggerProvider进行实现，当然由于ILoggerProvider会产生ILogger，所以他们也会实现ILogger类。
ILogValues以及扩展

我们看到日志记录类的接口为：Log(LogLevel logLevel, int eventId, object state, Exception exception, Func<object, Exception, string> formatter)

该接口通过formatter将state和exception组合成字符串对象，然后记录到log中。如果使用扩展方法系统传入的formatter永远是：MessageFormatter

        private static string MessageFormatter(object state, Exception error)
        {
            if (state == null && error == null)
            {
                throw new InvalidOperationException("No message or exception details were found " +
                    "to create a message for the log.");
            }

            if (state == null)
            {
                return error.ToString();
            }

            if (error == null)
            {
                return state.ToString();
            }

            return string.Format(CultureInfo.CurrentCulture, "{0}{1}{2}", state, Environment.NewLine, error);
        }

MessageFormatter

如果我们需要记录的信息(state)比较复杂，是一个或多个复杂对象，那么我们一般使用ILogValues对象。

系统中一共为我们提供2个ILogValues接口实现：FormattedLogValues、ReflectionBasedLogValues。

• FormattedLogValues：系统默认扩展传入args以及formatter参数的扩展方法使用，能够将按照formmater的格式，将对象串行成字符串（只支持以及数组）
• ReflectionBasedLogValues：通过反射，获取类的所有属性。（该类会在扩展log中使用）

    public class FormattedLogValues : ILogValues
    {
        private static ConcurrentDictionary<string, LogValuesFormatter> _formatters = new ConcurrentDictionary<string, LogValuesFormatter>();
        private readonly LogValuesFormatter _formatter;
        private readonly object[] _values;

        public FormattedLogValues(string format, params object[] values)
        {
            _formatter = _formatters.GetOrAdd(format, f => new LogValuesFormatter(f));
            _values = values;
        }

        public IEnumerable<KeyValuePair<string, object>> GetValues()
        {
            return _formatter.GetValues(_values);
        }

        public override string ToString()
        {
            return _formatter.Format(_values);
        }
    }

FormattedLogValues

    public class ReflectionBasedLogValues : ILogValues
    {
        public virtual IEnumerable<KeyValuePair<string, object>> GetValues()
        {
            var values = new List<KeyValuePair<string, object>>();
            var properties = GetType().GetTypeInfo().DeclaredProperties;
            foreach (var propertyInfo in properties)
            {
                values.Add(new KeyValuePair<string, object>(
                    propertyInfo.Name,
                    propertyInfo.GetValue(this)));
            }
            return values;
        }
    }

ReflectionBasedLogValues

其他类

• LogLevel：日志的等级
• LogFormatter：与MessageFormatter类似，提供不同的formmater方法。