ASP.NET企业开发框架IsLine FrameWork系列之十三--框架配置信息大全(上)
IsLine FrameWork一个是支持企业应用系统开发的框架,开发人员可以在其基础上对企业所需的应用系统进行快速开发,目前版本为V1.0版,随着需求的不断完善,IsLine FrameWork的版本也在不断升级。
IsLine FrameWork完成了对数据源、服务器端变量、缓存、日志、异常、安全性能等元素的封装,支持多种数据库、多个数据库同时操作;支持跨方法的事物;支持多个日志渲染器同时工作,这意味着开发人员可以同时将分类日志信息写入不同的目标。该框架以配置文件为中心,所有变更动作(例如改变数据库、改变日志记录介质等)都可以通过修改配置文件完成,这一篇文章就为大家总结了IsLine FrameWork中所有用到的配置信息,大家可以当做字典使用,欢迎大家阅读。
先来回顾一下IsLine FrameWork总体命名空间框架图:
IsLine FrameWork配置项保存在web.config中,配置内容主要分布在以下三个节点中:
- 位于<configSections></configSections>节点中的内容,主要以<sectionGroup></sectionGroup>标签体现
- 位于<appSettings>之前的内容
- 位于<appSettings></appSettings>之间的内容,主要以<add>标签体现
以上三部分不必同时出现,只需根据实际需要匹配出现。下面将按照命名空间顺序,给大家介绍相关配置项的信息。
一.IsLine.Data命名空间
这部分主要决定了所操作的数据库类型与位置,以及其他数据库方面的配置信息,有两种方式实现:
方式一.
Step 1.在<configSections>与</configSections>中加入:
<sectionGroup name="IsLine.Data.Configuration">
<section name="DataBaseConnection" type="IsLine.Data.Configuration.SuitConfig"/>
</sectionGroup>
Step 2.在</configSections>后加入:
·如果你希望使用SQL SERVER数据库(无版本限制):
<IsLine.Data.Configuration>
<DataBaseConnection>
<DBType>IsLine.Data.DataTypeEnum.DataBaseType.SqlServer</DBType>
<Server>IP</Server>
<UserID>sa</UserID>
<PwdType>Cryptography.None</PwdType>
<Pwd>111111</Pwd>
<DataBase>UML</DataBase> //SqlServer only
</DataBaseConnection>
</IsLine.Data.Configuration>
· 如果你希望使用Oracle数据库:
<IsLine.Data.Configuration>
<DataBaseConnection>
<DBType>IsLine.Data.DataTypeEnum.DataBaseType.Oracle</DBType>
<Server>IP</Server>
<UserID>ID</UserID>
<PwdType>Cryptography.Decrypting</PwdType>
<Pwd>111111</Pwd>
<OtherPlus>Provider=MSDAORA.1; Persist Security Info=False;</OtherPlus>
</DataBaseConnection>
</IsLine.Data.Configuration>
节点含义:
参数 |
含义 |
DBType |
指明了需要使用的数据库种类 |
Server |
数据库地址 |
UserID |
用户名 |
Pwd |
密码 |
PwdType |
密码加密类型,可以从以下表格中的枚举值中选取 |
DataBase |
数据库名称(仅在DBType 为SQL SERVER时,该项有效) |
OtherPlus |
Oracle特征配置选项,可以为空(仅在DBType 为Oracle时,该项有效) |
PwdType参数支持的枚举:
枚举 |
含义 |
Cryptography.Decrypting |
使用了IsLine.Security空间下的加密算法加密了密码。设置该枚举值后,Pwd须为IsLine.Security.Cryptography 空间下的static string Decrypting (string Source, string Key)方法加密后的值 |
Cryptography.StrengthDecrypting |
使用了IsLine.Security空间下的强加密算法加密了密码。设置该枚举值后,Pwd须为IsLine.Security.Cryptography 空间下的static string StrengthDecrypting (string str,string key)方法加密后的值 |
Cryptography.None |
密码不加密。设置该枚举值后,Pwd须为明文 |
注意,如果你使用了密文方式配置密码,你必须使用以下方式指定加密时用到的种子:
<add key="IsLine.Security.Configuration.TokenKey" value="IsLine"/>
方式二. 使用<add>标签完成配置工作
·如果你希望使用Oracle数据库,则添加以下配置信息:
<add key="IsLine.Data.Configuration.OracleConnectString" value="Data Source=DS;
User;Password=11111;Integrated Security=no;Enlist=false;Pooling=true;" />
·如果你希望使用SQL SERVER数据库,则添加以下配置信息:
<add key=" IsLine.Data.Configuration.SqlServerConnectString" value="Server=IP;
User;Pwd=111111;DataBase=db;" />
配置Oracle连接串时,Data Source含义为指定tnsnames文件中Oracle节点名称。
以上两个方法(方式一与方式二),可任选其一,如果两种方法同时存在,则方法一优先级高于方法二,方法一有效。如果希望同时使用多个数据库,可以利用<add>标签添加数据库信息,然后利用DataProvider中方法参数区分使用不同的连接串,具体请参见之前的文章。
二.IsLine.AppLog日志部分
目前日志模块支持将日志写入文件、sql语句形式写入SQL数据库、存储过程形式写入SQL数据库、sql语句形式写入Oracle数据库、存储过程形式写入Oracle数据库以及邮件通知,以下列出所有已经内置支持的配置方式,各位可以根据实际情况进行增减:
Step 1.如果你需要将日志写入数据库,需要做一些先导工作,例如建立表、触发器等。
如果是Oracle数据库,请通过以下步骤完成先导工作:
a.使用以下附件建表
https://files.cnblogs.com/isline/ILFW日志模块建表.rar
b. 使用以下附件建立序列
https://files.cnblogs.com/isline/ILFW日志模块序列.rar
c. 使用以下附件建触发器:
https://files.cnblogs.com/isline/ILFW日志模块触发器.rar
d.如果希望使用sql语句记录日志,那么请在step 3中,保持“OracleUsingTextRender”节点默认值即可,该节点中已经对sql语句有所配置。
e.如果希望使用存储过程记录日志,使用以下附件建立存储过程
https://files.cnblogs.com/isline/ILFW日志模块存储过程.rar
如果是SQL SERVER数据库,请通过以下步骤完成先导工作:
a.使用以下附件建表
https://files.cnblogs.com/isline/ILFW日志模块建SQL表.rar
b.如果希望使用sql语句记录日志,那么请在step 3中,保持“SQLServerUsingTextRender”节点默认值即可,该节点中已经对sql语句有所配置。
c.如果希望使用存储过程记录日志,使用以下附件建立存储过程
https://files.cnblogs.com/isline/ILFW日志模块建SQL存储过程.rar
Step 2.在<configSections>与</configSections>中加入:
<sectionGroup name="IsLine.AppLog.Configuration">
<section name="FileRender" type="IsLine.Data.Configuration.SuitConfig"/>
<section name="OracleUsingSPRender" type="IsLine.Data.Configuration.SuitConfig"/>
<section name="OracleUsingTextRender" type="IsLine.Data.Configuration.SuitConfig"/>
<section name="SQLServerUsingSPRender" type="IsLine.Data.Configuration.SuitConfig"/>
<section name="SQLServerUsingTextRender" type="IsLine.Data.Configuration.SuitConfig"/>
<section name="MailRender" type="IsLine.Data.Configuration.SuitConfig"/>
</sectionGroup>
参数说明:
参数 |
说明 |
FileRender |
将日志记录至文本文件 |
OracleUsingSPRender |
使用存储过程,将日志记录至Oracle |
OracleUsingTextRender |
使用sql语句,将日志记录至Oracle |
SQLServerUsingSPRender |
使用存储过程,将日志记录至SQL Server |
SQLServerUsingTextRender |
使用sql语句,将日志记录至SQL Server |
MailRender |
将日志发送邮件至收件人 |
以上参数节点可根据需要保留,将不需要的节点删除即可,注意,节点名称和数量要与Step 3中的一一对应。当然,你也可以自定义日志渲染节点,将日志信息输出至电视机,详细方法见《ASP .NET企业开发框架IsLine FrameWork系列》文章。
未完 待续
我是李鸣(Aicken) 欢迎您关注我的下一篇文章。
IsLine FrameWork是一个开源的企业级系统开发框架,目前已有以下系列:
IsLine FrameWork系列之一--第一次的亲密接触
IsLine FrameWork系列之四--DataProvider 数据访问(上)
IsLine FrameWork系列之五--DataProvider 数据访问(中)
IsLine FrameWork系列之六--DataProvider 数据访问(下)
IsLine FrameWork系列之七--AppLogProvider日志框架(上)
IsLine FrameWork系列之八--AppLogProvider日志框架(下)
IsLine FrameWork系列之九--ExceptionProcessProvider异常框架(上)
IsLine FrameWork系列之十--ExceptionProcessProvider异常框架(下)
李鸣(aicken)原创 转载注明