| #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.Collections; |
| |
| using log4net.Core; |
| |
| namespace log4net.Util |
| { |
| /// <summary> |
| /// Manages a mapping from levels to <see cref="LevelMappingEntry"/> |
| /// </summary> |
| /// <remarks> |
| /// <para> |
| /// Manages an ordered mapping from <see cref="Level"/> instances |
| /// to <see cref="LevelMappingEntry"/> subclasses. |
| /// </para> |
| /// </remarks> |
| /// <author>Nicko Cadell</author> |
| public sealed class LevelMapping : IOptionHandler |
| { |
| #region Public Instance Constructors |
| |
| /// <summary> |
| /// Default constructor |
| /// </summary> |
| /// <remarks> |
| /// <para> |
| /// Initialise a new instance of <see cref="LevelMapping"/>. |
| /// </para> |
| /// </remarks> |
| public LevelMapping() |
| { |
| } |
| |
| #endregion // Public Instance Constructors |
| |
| #region Public Instance Methods |
| |
| /// <summary> |
| /// Add a <see cref="LevelMappingEntry"/> to this mapping |
| /// </summary> |
| /// <param name="entry">the entry to add</param> |
| /// <remarks> |
| /// <para> |
| /// If a <see cref="LevelMappingEntry"/> has previously been added |
| /// for the same <see cref="Level"/> then that entry will be |
| /// overwritten. |
| /// </para> |
| /// </remarks> |
| public void Add(LevelMappingEntry entry) |
| { |
| if (m_entriesMap.ContainsKey(entry.Level)) |
| { |
| m_entriesMap.Remove(entry.Level); |
| } |
| m_entriesMap.Add(entry.Level, entry); |
| } |
| |
| /// <summary> |
| /// Lookup the mapping for the specified level |
| /// </summary> |
| /// <param name="level">the level to lookup</param> |
| /// <returns>the <see cref="LevelMappingEntry"/> for the level or <c>null</c> if no mapping found</returns> |
| /// <remarks> |
| /// <para> |
| /// Lookup the value for the specified level. Finds the nearest |
| /// mapping value for the level that is equal to or less than the |
| /// <paramref name="level"/> specified. |
| /// </para> |
| /// <para> |
| /// If no mapping could be found then <c>null</c> is returned. |
| /// </para> |
| /// </remarks> |
| public LevelMappingEntry Lookup(Level level) |
| { |
| if (m_entries != null) |
| { |
| foreach (LevelMappingEntry entry in m_entries) |
| { |
| if (level >= entry.Level) |
| { |
| return entry; |
| } |
| } |
| } |
| return null; |
| } |
| |
| #endregion // Public Instance Methods |
| |
| #region IOptionHandler Members |
| |
| /// <summary> |
| /// Initialize options |
| /// </summary> |
| /// <remarks> |
| /// <para> |
| /// Caches the sorted list of <see cref="LevelMappingEntry"/> in an array |
| /// </para> |
| /// </remarks> |
| public void ActivateOptions() |
| { |
| Level[] sortKeys = new Level[m_entriesMap.Count]; |
| LevelMappingEntry[] sortValues = new LevelMappingEntry[m_entriesMap.Count]; |
| |
| m_entriesMap.Keys.CopyTo(sortKeys, 0); |
| m_entriesMap.Values.CopyTo(sortValues, 0); |
| |
| // Sort in level order |
| Array.Sort(sortKeys, sortValues, 0, sortKeys.Length, null); |
| |
| // Reverse list so that highest level is first |
| Array.Reverse(sortValues, 0, sortValues.Length); |
| |
| foreach (LevelMappingEntry entry in sortValues) |
| { |
| entry.ActivateOptions(); |
| } |
| |
| m_entries = sortValues; |
| } |
| |
| #endregion // IOptionHandler Members |
| |
| #region Private Instance Fields |
| |
| private Hashtable m_entriesMap = new Hashtable(); |
| private LevelMappingEntry[] m_entries = null; |
| |
| #endregion // Private Instance Fields |
| } |
| } |