企业库（V4.1）入门学习手记

企业库整体概览

引用 Alex Homer 的企业库开发指导中的企业库组建依赖关系图图：

使用企业库配置编辑工具：

A）数据访问（Data Access）
1）配置文件
　　在配置文件中（App.config 或 Web.config）编辑定义数据库连接串，使用  DatabaseFactory.CreateDatabase(数据库连接串的配置名称) 来创建 Database 实例。
　　配置文件中各项配置信息默认是明文保存的，在企业库配置信息编辑器（EntLibConfig.exe）中可以设置是否加密保存，各个程序块的根节点和“Application Settings”节点、“Environments”下的“Environment”子节点都可以选择，提供的 ProtectionProvider 有：RsaProtectedConfigurationProvider、DataProtectionConfigurationProvider。
2）数据库类 Database
属性

ConnectionString

数据库连接串。只读。

方法

CreateConnection	创建一个数据库连接 DbConnection ，并返回。在手动控制事务时可以使用。
GetSqlStringCommand	根据SQL命令获取一个 SqlCommand 实例。
GetStoredProcCommand	根据存储过程名获取一个 DbCommand 实例。
ExecuteReader	获取一个 IDataReader 实例，以便逐行读取数据。
ExecuteNonQuery	执行一个SQL命令（select类型除外）或存储过程，同时返回命令执行所影响到记录数。
ExecuteScalar	执行一个SQL命令（select类型）或存储过程，返回满足条件的数据的第一行第一列的数值；如果没有数据，则返回 null （此种情况需要在程序中注意）。
ExecuteDataSet	执行一个SQL命令（select类型）或存储过程，返回一个 DataSet 实例，此 DataSet 包含了满足条件的数据； DataSet 中的各个 DataTable 的名称默认是以“Table”开始命名的，其后则自动加入序号，如有3个 DataTable 则依次是“Table”、“Table1”、“Table2”。
LoadDataSet	执行一个SQL命令（select类型）或存储过程，并将满足条件的数据填充到一个已创建的 DataSet 中，同时使用传入的 tableNames 参数来对 DataSet 中的各个 DataTable 命名。
UpdateDataSet	根据变更的 DataSet（使用 getChanges 获取） 和 insert、update、delete各自的 DbCommand 的SQL语句（要求有参数），使用参数 TableName 来明确 DataSet 中要保存的目标 DataTable ，保存数据更新到数据库中，返回执行成功的记录数。如果已经明确保存的具体动作类型（插入、修改、删除），则可以选择性地对 insert、update、delete各自的 DbCommand 赋值传入，如果不需要则可以传入 null 来代替。

3）使用 SqlDataAdapter 来保存数据

string mySql = "select * from MyTable where 1 = 0";
DataSet dsChanges = myDataSet.GetChanges();
SqlDataAdapter adapter = (SqlDataAdapter)db.GetDataAdapter();
adapter.SelectCommand = (SqlCommand)db.GetSqlStringCommand(mySql));
SqlCommandBuilder builder = new SqlCommandBuilder(adapter);
bool saved = adapter.Update(dsChanges) > 0;

4）控制事务

using(DbConnection conn = db.CreateConnection())
{
    DbTransaction trans = conn.BeginTransaction();
    try
    {    
    ...
    trans.Commit();
    }
    catch(Exception ex)
    {
    trans.Rollback();
    }
}

using(TransactionScope scope = new TransactionScope(TransactionScopeOption.RequiresNew))
{
    try
    {
    ...
    scope.Complete();
    }
    catch(Exception ex)
    {
    }
}

B）异常处理（Exception Handling）
实现步骤：
①定义异常策略：Exception Policy
②选择指定异常类型：Exception Type
设定属性：PostHandlingAction，决定是否重新抛出异常。
③定义异常处理器：Exception Handler
Wrap Handler  　封装。
Replace Handler  替换；同 Wrap Handler，另外可以抛出新的不同类型的异常。
Logging Handler  日志记录，添加异常错误信息到操作系统的日志当中。须与 Logging 程序块配合。
Custom Handler  自定义。实现接口 IExceptionHandler 的方法 HandleException 即可，同时须在类定义中使用属性 [ConfigurationElementType(typeof(CustomHandlerData))] 。
④使用
ExceptionPolicy.HandleException(异常, 异常策略名称)

C）日志记录（Logging）

属性：TracingEnabled	关闭或打开日志记录的功能。
过滤器：Filters	设置源类别是否可以进行日志记录。
源类别：Category Sources	对不同的源定义不同的类别，同时指定该类别使用的跟踪监听器（可以是多个）。
特殊类别：Special Sources	错误、警报、未处理的异常、所有事件。指定各自的跟踪监听器。
跟踪监听器：Trace Listeners	设定记录日志信息的具体实现方式，指定各自的记录格式助手。如果是自定义，则须从 CustomTraceListener 继承，可以覆盖基类方法 TraceData、Write、WriteLine，同时须在类定义中使用属性 [ConfigurationElementType(typeof(CustomTraceListenerData))] 。
记录格式助手：Formatters	对记录的日志信息设置格式。
记录器：Logger	记录日志的供调用的类。方法 GetFilter、ShouldLog、Write。
记录实体项：LogEntry	记录项。有属性：Message、Priority、Severity、EventId、Categories。
日志过滤器：ILogFilter	主要在 Logger 中使用。属性 Enabled ，方法 ShouldLog 。

D）数据检验（Validation）
主要的实现途径有三种：
①企业库配置编辑工具
②类定义的源文件（使用属性定义）
③VS的IDE设计器
添加引用 Microsoft.Practices.EnterpriseLibrary.Validation.Integration.WinForms.dll 。

TextBox控件设计界面：

TextBox属性编辑界面：

在企业库配置编辑工具中的操作步骤大致为：
①选择已有的类或数据类型或定义新的类或数据类型。
②针对相应的类或数据类型定义检验规则集，可以定义多个规则集 Rule Set。
③在规则集中添加需要检验的数据项目（成员、方法、属性），对每个数据项目设定检验器 Validator，可以定义多个检验器。

E）统一与依赖注入（Unity Dependency Injection）
这方面的内容比较难理解。
统一容器类：IUnityContainer  方法 Resolve、RegisterInstance、GetInstance、RegisterType。

引用 Alex Homer 的企业库开发指导中的依赖注入的概览图：

F）缓存（Caching）
个人认为比较简单。
缓存管理器：ICacheManager  通过 CacheFactory.GetCacheManager 获得。方法 Contains、Add、Remove、Flush。

G）加密解密（Cryptography）
个人认为最容易理解和使用。
加密解密管理器：Cryptographer  方法 CreateHash、CompareHash、EncryptSymmetric、DecryptSymmetric。

H）安全（Security）
先在配置工具中定义验证规则，然后再程序中使用。感觉有点乱。
验证提供者：IAuthorizationProvider  通过 AuthorizationFactory.GetAuthorizationProvider(配置名称) 获得。方法 Authorize。
安全缓存提供者：ISecurityCacheProvider  通过 SecurityCacheFactory.GetSecurityCacheProvider(配置名称) 获得。方法 GetIdentity、SaveIdentity、ExpireIdentity。
会员类：MemberShip  方法 ValidateUser。
角色类：Roles   方法 CreateRole、AddUsersToRole、RemoveUserFromRole、RoleExists、GetRolesForUser。
标识：IIdentity   通过 GenericIdentity 获得，给 SaveIdentity 使用。
令牌：IToken   由 SaveIdentity 获得，给 GetIdentity 使用。

注意：
1）需要先编译项目文件，获得相应的 Assembly 之后，才可以在配置编辑工具中选择使用自定义的数据项目。
2）要使用 Security 程序块，需要对工程的目标数据库进行 ASP.NET 注册，运行 aspnet_regsql.exe（在 Microsoft.NET\Framework\v2.0.50727 目录下） 进行操作即可。