Parser Schemas– Easy and Powerful parsing of XML-based languages

/***********************************************************************\
 * Comnicate.CodeDom.Xml.ParserSchemas                                 *
 * Parses xml-based languages according to a user defined schema.      *
 * Copyright � 2005 Tomas Deml (as Comnicate!)                         *
 *                  tomasdeml@msn.com                                  *
 *                                                                     *
 * This library is free software; you can redistribute it and/or       *
 * modify it under the terms of the GNU Lesser General Public          *
 * License as published by the Free Software Foundation; either        *
 * version 2.1 of the License, or (at your option) any later version.  *
 *                                                                     *
 * This library is distributed in the hope that it will be useful,     *
 * but WITHOUT ANY WARRANTY; without even the implied warranty of      *
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU   *
 * Lesser General Public License for more details.                     *
\***********************************************************************/

using System;
using System.Collections.Generic;
using System.Text;
using Comnicate.CodeDom.Xml.ParserSchemas.Rules.Evaluated;
using System.Xml.XPath;
using Comnicate.CodeDom.Xml.ParserSchemas.Rules.Evaluation;

namespace Comnicate.CodeDom.Xml.ParserSchemas.Rules
{
    /// <summary>
    /// Represents the rule matching text child of an element.
    /// </summary>
    public class TextRule : ValidatingNonParentalRule
    {
        #region .ctors

        /// <summary>
        /// Initializes a new instance of the <see cref="TextRule"/> class.
        /// </summary>
        public TextRule() : base(String.Empty) { }

        /// <summary>
        /// Initializes a new instance of the <see cref="TextRule"/> class.
        /// </summary>
        /// <param name="valueValidator">An instance of a class implementing the <see cref="IValueValidator"/> interface that will validate the value of the attribute.</param>
        public TextRule(IValueValidator valueValidator) : base(String.Empty, valueValidator) { }

        #endregion

        #region Properties

        /// <summary>
        /// Gets the information about the type of the node navigator that can be matched by this rule.
        /// </summary>
        public override XPathNodeType MatchingNodeType
        {
            get 
            {
                return XPathNodeType.Text;
            }
        }

        #endregion

        #region Methods

        /// <summary>
        /// Parses the node navigator the XPathNavigator instance is pointed to, according to the rule.
        /// </summary>
        /// <param name="nodeNavigator">XPathNavigator instance pointing to the node navigator to parse.</param>
        /// <returns>Evaluated rule.</returns>
        public override EvaluatedNonParentalRule Evaluate(XPathNavigator nodeNavigator)
        {
            // Null?
            if (nodeNavigator == null) throw new ArgumentNullException("nodeNavigator");

            // Evaluated rule
            EvaluatedNonParentalRule result = new EvaluatedNonParentalRule(this);

            // Resolve value
            this.ResolveValueOptions(nodeNavigator, result);

            // Validate value
            this.ValidateValue(nodeNavigator.Value);

            // Return evaluted eventData
            return result;
        }

        #endregion
    }
}