// Copyright (c) 2008, NTT DATA Corporation.
//
// Licensed 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.

using System;
using System.Configuration;
using System.Xml;
using TERASOLUNA.Fw.Common.Configuration;

namespace TERASOLUNA.Fw.Web.Configuration.ExceptionCode
{
    /// <summary>
    /// 構成ファイル内の exceptionCodeConfiguration セクションを表します。
    /// </summary>
    /// <remarks>
    /// <see cref="ConfigurationSection"/> クラスを拡張した、exceptionCodeConfiguration カスタム構成ハンドラです。
    /// 詳細については、<see cref="ConfigurationSection"/> を参照してください。
    /// </remarks>
    public class ExceptionCodeConfigurationSection : ConfigurationSection
    {
        /// <summary>
        /// exceptionCodeConfiguraiton の要素名です。
        /// </summary>
        /// <remarks>
        /// この定数の値は "exceptionCodeConfiguration" です。
        /// </remarks>
        private static readonly string SECTION_NAME = "exceptionCodeConfiguration";

        /// <summary>
        /// <see cref="FilesCollection"/> コレクションの要素名です。
        /// </summary>
        /// <remarks>
        /// この定数の値は "files" です。
        /// </remarks>
        private const string FILES_ELEMENT_NAME = "files";

        /// <summary>
        /// <see cref="ExceptionCodeCollection"/> コレクションの要素名です。
        /// </summary>
        /// <remarks>
        /// この定数の値は "exceptionCodeConfiguration" です。
        /// </remarks>
        private const string EXCEPTION_TRANSITION_CONFIGURATION_ELEMENT_NAME = "exceptionCodeConfiguration";

        /// <summary>
        /// exceptionCode 要素の exceptionType 属性名です。
        /// </summary>
        /// <remarks>
        /// この定数の値は "exceptionType" です。
        /// </remarks>
        private static readonly string EXCEPTION_TYPE_ATTRIBUTE_NAME = "exceptionType";

        /// <summary>
        /// exceptionCode 要素の code 属性名です。
        /// </summary>
        /// <remarks>
        /// この定数の値は "code" です。
        /// </remarks>
        private static readonly string CODE_ATTRIBUTE_NAME = "code";

        /// <summary>
        /// 外部設定ファイルのXML名前空間です。
        /// </summary>
        /// <remarks>
        /// この定数の値は "http://www.terasoluna.jp/schema/ExceptionCodeSchema.xsd" です。
        /// </remarks>
        private static readonly string XML_NAMESPACE = "http://www.terasoluna.jp/schema/ExceptionCodeSchema.xsd";

        /// <summary>
        /// 外部設定ファイルのXML名前空間プレフィックスです。
        /// </summary>
        /// <remarks>
        /// この定数の値は "ex" です。
        /// </remarks>
        private static readonly string XML_NAMESPACE_PREFIX = "ex";

        /// <summary>
        /// 外部設定ファイルマージ処理で基準とする要素の XPATH です。
        /// </summary>
        /// <remarks>
        /// この定数の値は "ex:exceptionCodeConfiguration" です。
        /// </remarks>
        private static readonly string SECTION_XPATH = XML_NAMESPACE_PREFIX + ":exceptionCodeConfiguration";

        /// <summary>
        /// 外部設定ファイルマージ処理でマージする要素の XPATH です。
        /// </summary>
        /// <remarks>
        /// この定数の値は "ex:exceptionCodeConfiguration/ex:exceptionCode" です。
        /// </remarks>
        private static readonly string ELEMENT_XPATH = SECTION_XPATH + "/" + XML_NAMESPACE_PREFIX + ":exceptionCode";

        /// <summary>
        /// XMLスキーマファイルの完全名です。
        /// </summary>
        /// <remarks>
        /// この定数の値は "TERASOLUNA.Fw.Web.Configuration.ExceptionCode.ExceptionCodeConfiguration.xsd" です。
        /// </remarks>
        private static readonly string XML_SCHEMA_FILE_NAME = "TERASOLUNA.Fw.Web.Configuration.ExceptionCode.ExceptionCodeConfiguration.xsd";


        /// <summary>
        /// <see cref="ExceptionCodeConfigurationSection"/> クラスの新しいインスタンスを初期化します。
        /// </summary>
        /// <remarks>デフォルトコンストラクタです。</remarks>
        public ExceptionCodeConfigurationSection()
        {
        }

        /// <summary>
        /// files 要素を取得します。
        /// </summary>
        /// <remarks>
        /// exceptionCodeConfiguration セクションから、 <see cref="FilesCollection"/> クラスのインスタンスを取得します。
        /// </remarks>
        [ConfigurationProperty(FILES_ELEMENT_NAME, IsDefaultCollection = false, IsRequired = true)]
        public FilesCollection Files
        {
            get
            {
                FilesCollection filesCollection = (FilesCollection)base[FILES_ELEMENT_NAME];
                return filesCollection;
            }
        }

        /// <summary>
        /// exceptionCodeConfiguration 要素を取得します。
        /// </summary>
        ///<remarks>
        /// exceptionCodeConfiguration セクションから、 <see cref="ExceptionCodeCollection"/> クラスのインスタンスを取得します。
        /// </remarks>
        [ConfigurationProperty(EXCEPTION_TRANSITION_CONFIGURATION_ELEMENT_NAME, IsDefaultCollection = false)]
        public ExceptionCodeCollection ExceptionCodeCollection
        {
            get
            {
                ExceptionCodeCollection exceptionCodeCollection = (ExceptionCodeCollection)base[EXCEPTION_TRANSITION_CONFIGURATION_ELEMENT_NAME];
                return exceptionCodeCollection;
            }
        }

        /// <summary>
        /// files 要素の設定内容から exceptionCode 要素を生成して exceptionCodeConfiguration 要素に追加します。
        /// </summary>
        /// <remarks>
        /// <para><see cref="MergeConfiguration"/> オブジェクトを生成し、外部設定ファイルの設定情報をマージします。</para>
        /// <para>マージした外部設定ファイルの内容から <see cref="ExceptionCodeElement"/> オブジェクトを生成し、
        /// <see cref="ExceptionCodeCollection"/> に追加します。</para>
        /// </remarks>
        /// <exception cref="ArgumentException">
        /// 次のような場合に例外をスローします。
        /// <list type="bullet">
        /// <item>
        /// 外部設定ファイルマージ処理で基準とする要素の XPATH が不正です。
        /// </item>
        /// <item>
        /// 外部設定ファイルマージ処理でマージする要素の XPATH が不正です。
        /// </item>
        /// </list>
        /// </exception>
        /// <exception cref="ConfigurationErrorsException">
        /// <list type="bullet">
        /// <item>
        /// 構成ファイルの外部設定ファイルマージ処理で基準とする要素の XPATH の設定情報が不正です。
        /// </item>
        /// <item>
        /// ファイルの読み込み失敗です。
        /// </item>
        /// <item>
        /// 外部設定ファイルマージ処理で基準とする要素の XPATH が XML スキーマ検証エラーです。
        /// </item>
        /// <item>
        /// 外部設定ファイルマージ処理で基準とする要素の XPATH に 外部設定ファイルマージ処理でマージする要素の XPATH をマージ後に、XML スキーマ検証エラーです。
        /// </item>
        /// </list>
        /// </exception>
        public virtual void CreateExceptionCodeElements()
        {
            // 外部設定ファイルの設定情報をマージする
            MergeConfiguration mgConfig = new MergeConfiguration(XML_NAMESPACE, XML_NAMESPACE_PREFIX, XML_SCHEMA_FILE_NAME);
            mgConfig.LoadConfig(SECTION_NAME, Files);
            XmlDocument xmlDoc = mgConfig.MergeXmlDocument(SECTION_XPATH, ELEMENT_XPATH);

            // 外部設定ファイルの設定情報をexceptionCodeConfiguration要素に追加する
            AddExceptionCodeElements(xmlDoc);
        }

        /// <summary>
        /// 外部設定ファイルの内容から exceptionCode 要素を生成し、exceptionCodeConfiguration 要素に追加します。
        /// </summary>
        /// <param name="xmlDoc">外部設定ファイルの内容を保持する <see cref="XmlDocument" /> 。</param>
        private void AddExceptionCodeElements(XmlDocument xmlDoc)
        {
            XmlNodeList list = xmlDoc.DocumentElement.ChildNodes;

            foreach (XmlNode node in list)
            {
                if (node is XmlElement)
                {
                    string exceptionType = node.Attributes[EXCEPTION_TYPE_ATTRIBUTE_NAME].InnerText;
                    string code = node.Attributes[CODE_ATTRIBUTE_NAME].InnerText;
                    ExceptionCodeElement element = new ExceptionCodeElement(exceptionType, code);
                    ExceptionCodeCollection.Add(element);
                }
            }
        }
    }
}
