// 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.Sql
{
    /// <summary>
    /// 構成ファイル内の sqlConfiguration セクションを表します。
    /// </summary>
    /// <remarks>
    /// <see cref="ConfigurationSection"/> クラスを拡張した、sqlConfiguration カスタム構成ハンドラです。
    /// 詳細については、<see cref="ConfigurationSection"/> を参照してください。
    /// </remarks>
    public class SqlConfigurationSection : ConfigurationSection
    {
        /// <summary>
        /// sqlConfiguration の要素名です。
        /// </summary>
        /// <remarks>
        /// この定数の値は "sqlConfiguration" です。
        /// </remarks>
        private const string SECTION_NAME = "sqlConfiguration";

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

        /// <summary>
        /// <see cref="SqlsCollection"/> の要素名です。
        /// </summary>
        private const string SQLS_ELEMENT_NAME = "sqls";

        /// <summary>
        /// sql 要素の name 属性名です。
        /// </summary>
        /// <remarks>
        /// この定数の値は "name" です。
        /// </remarks>
        private const string NAME_ATTRIBUTE_NAME = "name";

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

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

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

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

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

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

        /// <summary>
        /// files 要素を取得します。
        /// </summary>
        /// <remarks>
        /// sqlConfiguration セクションから <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>
        /// sqls 要素を取得します。
        /// </summary>
        /// <remarks>
        /// sqlConfiguration セクションから <see cref="SqlsCollection"/> を取得します。
        /// </remarks>
        [ConfigurationProperty(SQLS_ELEMENT_NAME, IsDefaultCollection = false)]
        public SqlsCollection Sqls
        {
            get
            {
                SqlsCollection sqlsCollection = (SqlsCollection)base[SQLS_ELEMENT_NAME];
                return sqlsCollection;
            }
        }

        /// <summary>
        /// files 要素の設定内容から sql 要素を生成して sqls 要素に追加します。
        /// </summary>
        /// <remarks>
        /// <para><see cref="MergeConfiguration"/> オブジェクトを生成し、外部設定ファイルの設定情報をマージします。</para>
        /// <para>マージした外部設定ファイルの内容から <see cref="SqlElement"/> オブジェクトを生成し、 <see cref="SqlsCollection"/> に追加します。</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 CreateSqlElements()
        {
            // 外部設定ファイルの設定情報をマージする
            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);

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

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

            foreach (XmlNode xmlNode in xmlNL)
            {
                if (xmlNode is XmlElement)
                {
                    string name = xmlNode.Attributes[NAME_ATTRIBUTE_NAME].InnerText;
                    string statement = xmlNode.InnerText;
                    SqlElement sqlElement = new SqlElement(name, statement);
                    Sqls.Add(sqlElement);
                }
            }
        }

    }
}
