Towards a Declarative SAX Framework : Part 1 - A Simple SAX-to-C#-Mapping

#region Copyright
/*********************************************************************************
 * Copyright (c) 2004 by Martin Friedrich										 *
 * Permission to freely distribute, modify and compile these sources and		 *
 * binaries as long as this copyright notice is included.						 *
 * Use of code on your risk!													 *
 * *******************************************************************************/
#endregion

using System;
using System.Xml;

namespace SaxParserSupport
{
	namespace Impl 
	{

		/// <summary>
		/// Implements a <tt>SaxParser</tt> which performs validation while reading. The
		/// actual validation and parsing is done by a <tt>System.Xml.XmlValidatingReader</tt>
		/// instance.
		/// <seealso cref="SaxParserSupport.Impl.SaxParserImpl"/>
		/// <seealso cref="SaxParserSupport.Impl"/>
		/// </summary>
		public class SaxValidatingParserImpl : SaxParserImpl
		{

			/// <summary>
			/// Constructs a <tt>SaxValidatingParserImpl</tt> from a stream <tt>src</tt>.
			/// </summary>
			/// <param name="src">The stream to be read from</param>
			public SaxValidatingParserImpl( System.IO.Stream src ) : base( src )
			{
			}

			/// <summary>
			/// Constructs a <tt>SaxValidatingParserImpl</tt> that uses the given
			/// <tt>XmlReader</tt> instance for parsing.
			/// </summary>
			/// <remarks>
			/// <list type="bullet">
			/// <item><tt>src</tt> should be of class <tt>System.Xml.XmlValidatingReader</tt>.
			/// If this is not the case, no validation is done when 
			/// <tt>SaxParserSupport.SaxParser.parse()</tt> is called.</item>
			/// <item>The ctor doesn't check for validation features present or
			/// being enabled, nor does it switch on validation</item>
			/// </list></remarks>
			/// <param name="src">The <tt>XmlReader</tt> instance to be used</param>
			public SaxValidatingParserImpl( System.Xml.XmlReader src ) : base( src )
			{
			}

			/// <summary>
			/// <p>Creates a <see cref="System.Xml.XmlValidatingReader" /> instance 
			/// from stream <tt>src" </tt>.</p>
			/// <p>The reader has XSD schema validation enabled and it's <tt>resolver</tt>
			/// property is set up for default credentials.</p>
			/// </summary>
			/// <param name="input">The stream to be read from</param>
			/// <returns>An instance of class <tt>System.Xml.XmlValidatingReader</tt></returns>
			/// <seealso cref="System.Net.CredentialCache"/>
			protected override System.Xml.XmlReader createXmlReader( System.IO.Stream input )
			{
				XmlParserContext parserctx = new XmlParserContext( null, null, "", XmlSpace.None );
				XmlValidatingReader reader = new XmlValidatingReader( input, XmlNodeType.Document, parserctx );

				XmlResolver resolver = new XmlUrlResolver();
				resolver.Credentials = System.Net.CredentialCache.DefaultCredentials;
				reader.XmlResolver = resolver;
				reader.ValidationType = ValidationType.Schema;

				return reader;
			}
		}
	}
}