企业库应用实践系列五：创建模板引擎Library

截至目前，微软Enterprise Library已不断更新至4.1版本，但其精髓仍然是方便开发者快速开发自己的应用程序块。目前介绍Enterprise Library的文章大部分侧重于如何应用其中已有的应用程序块，如Data Access。而对如何创建自己的Enterprise Library则鲜有涉足。本系列笔者将侧重于介绍如何基于Enterprise Library的核心——Configuration和ObjectBuilder，构建属于企业自己的应用程序块以及期间可能出现的一些问题。此方面的高手请飘过。

第一阶段:HelloWorld

第一篇：创建第一个自己的Application Block
第二篇：Application Block生成原理详解
第三篇：自定义功能类的构造函数

第二阶段:实战模板引擎

第四篇: 创建模板引擎框架
第五篇: 创建模板引擎Library
第六篇:构建模板引擎处理逻辑
第七篇:实现模板引擎
第八篇:第二阶段回顾

本篇我们将继续企业库应用实践系列旅程。接上篇，我们将为类库的正常运行继续实现相关的辅助类。

一、为类库生成的辅助类新添一个目标Configuration，将相关的类放在这个文件夹中。

将上篇中的SoureceResolveFactory类文件移至这个文件夹下。

今天其余的类文件也将全部放在此文件夹中。

二、新添用于表达配置文件中配置的SourceResolveSettings类

 1public class SourceResolveSettings : SerializableConfigurationSection
 2    {
 3        public const String SectionName = "sourceResolveConfiguration";
 4
 5        private const string resolversProperty = "resolvers";
 6
 7        private const string defaultResolverProperty = "defaultResolver";
 8
 9        public SourceResolveSettings()
        {
        }

        [ConfigurationProperty( defaultResolverProperty, IsRequired = false )]
        public String DefaultResolverName
        {
            get
            {
                return ( String ) this[ defaultResolverProperty ];
            }
            set
            {
                this[ defaultResolverProperty ] = value;
            }
        }

        [ConfigurationProperty( resolversProperty, IsRequired = false )]
        public NameTypeConfigurationElementCollection<SourceResolveData, SourceResolveData> Providers
        {
            get
            {
                return ( NameTypeConfigurationElementCollection<SourceResolveData, SourceResolveData> ) base[ resolversProperty ];
            }
        }

    }

 

三、新添用于方便读取SourceResolveSettings数据的SourceResolveConfigurationView类

 1public class SourceResolveConfigurationView
 2    {
 3        IConfigurationSource configurationSource;
 4
 5        public SourceResolveConfigurationView( IConfigurationSource configurationSource )
 6        {
 7            if( configurationSource == null )
 8                throw new ArgumentNullException( "配置源不能为空." );
 9
            this.configurationSource = configurationSource;
        }

        public SourceResolveSettings GetSettings()
        {
            return ( SourceResolveSettings ) configurationSource.GetSection( SourceResolveSettings.SectionName );
        }

        public String DefaultResolverName
        {
            get
            {
                return GetSettings().DefaultResolverName;
            }
        }

        public SourceResolveData GetProviderData(String providerName)
        {
            SourceResolveData data = GetSettings().Providers.Get( providerName );

            if( data == null )
            {
                throw new ConfigurationErrorsException(
                    String.Format( "Provider Not Found : {0} ", providerName ) );
            }

            return data;
        }
    }

 

四、创建用于表达功能实现类数据的SourceResolveData类

 1[Assembler(typeof(SoureceResolveAssember))]
 2    public class SourceResolveData : NameTypeConfigurationElement
 3    {
 4        public SourceResolveData()
 5        {
 6        }
 7
 8        public SourceResolveData( String name, Type type ) : base( name, type )
 9        {
        }
    }

 

五、创建对象装配类（主要功能是自定义构造函数，本项目采用不带任何参数的构造函数)

public class SoureceResolveAssember : IAssembler<ISourceResolver,SourceResolveData>
    {
        public ISourceResolver Assemble( IBuilderContext context, SourceResolveData objectConfiguration, IConfigurationSource configurationSource, ConfigurationReflectionCache reflectionCache )
        {
            return ( ISourceResolver ) Activator.CreateInstance( objectConfiguration.Type );
        }
    }

 

六、创建自定义的类工厂

public class SoureceResolveCustomFactory  : AssemblerBasedCustomFactory<ISourceResolver,SourceResolveData>
    {
        protected override SourceResolveData GetConfiguration( string name, IConfigurationSource configurationSource )
        {
            return new SourceResolveConfigurationView( configurationSource ).GetProviderData( name );
        }
    }

 

七、创建用于文件映射的类SourceResolverDataRetriever

 1public class SourceResolverDataRetriever : IConfigurationNameMapper
 2    {
 3        public string MapName( string name, IConfigurationSource configSource )
 4        {
 5            if( !String.IsNullOrEmpty( name ) )
 6                return name;
 7
 8            return new SourceResolveConfigurationView( configSource ).DefaultResolverName;
 9        }
    }

 

八、至此所有的类设计完成，我们再来为功能接口加上标记

    

[ConfigurationNameMapper(typeof(SourceResolverDataRetriever))]
    [CustomFactory(typeof(SoureceResolveCustomFactory))]
    public interface ISourceResolver
    {
        SegmentCollection Translate(String html );
    }

 

编译项目，通过。

至此，我们的类库已经成功构建。下一篇中，我们将开始分析功能接口ISourceResolver的实现。我们的实现机制将采用类似于ObjectBuilder(Enterprise Library的对象生产“流水线”）的方式，使得我们的TemplateEngineer灵活、可扩展。敬请期待。