HS系统开发模式说明

1、HS系统开发模式文档类不治理规范文档编号T03-00003-050205来源部门技术部研发部门应用范围技术部保密级不修订历史记录日期版本讲明作者2005-3-221.2修订01：将BD对象的维护接口将自身往DA传递，更新为传递直接参数，即传递需要的数据属性参数。董应群2005-2-51.0Create董应群目 录 TOC * MERGEFORMAT 1、目的 PAGEREF _Toc99095113 h 22、系统命名空间的命名体系 PAGEREF _Toc99095114 h 23、系统中的对象数据组织模式 PAGEREF _Toc99095115 h 44、系统中的对象数据的处理方式 PA

2、GEREF _Toc99095116 h 55、HS信息处理模式原理图 PAGEREF _Toc99095117 h 116、对象数据类差不多接口 PAGEREF _Toc99095118 h 127、DS层信息处理模式 PAGEREF _Toc99095119 h 138、UI层的检测逻辑实现规则 PAGEREF _Toc99095120 h 149、代码示例 PAGEREF _Toc99095121 h 15目的规范化系统的开发模式；规范化系统中对象的组织；提高系统的开发效率；提高系统的维护效率；降低系统的BUG率。系统命名空间的命名体系在HS环境中进行对象和工具集的再次组合的体系。便于合

3、理地组织各类对象和个性化工具集合。差不多命名体系所有的HS环境中的对象和工具全部在Hotsales命名空间下。按如下形式进行展开：Hotsales.子系统命名空间/全局共享层次空间.下级子系统命名空间/系统对象逻辑层次命名空间全局共享层次命名空间Hotsales.SystemFramework /全局系统框架命名空间，在子系统中也能够提供自己的系统框架命名空间。Hotsales.Common /全局系统工具集合命名空间，在子系统中也有自己的通用工具集合命名空间。系统对象逻辑层次命名空间具体层次描述见“T03-00005HS软件系统的实现规则.doc”层名命名标识层描述备注业务外观层Busine

4、ssFacadeBusinessFacadeBF提供业务处理的集成化接口，起UI层和业务逻辑处理层的交互代理。业务规则层BusinessRuleBusinessRulesBR系统中个性化业务逻辑处理中心采纳复数形式业务数据对象层BusinessDataBusinessDataBD系统中业务数据的对象层具体子系统的通用层CommonCommonCM系统中的工具集合体数据访问层DataAccessDataAccessDA系统中数据访问层，是对象化数据与关系型数据的交互代理。数据存储层DataStoreDataStoreDS数据处理层，提供存储过程处理/访问数据，甚至包含部分业务逻辑的处理。在DB中

5、实现系统框架层SystemFrameworkSystemFrameworkSF系统框架层，提供系统配置信息的处理系统通用层SystemCommonSystemCommonSC系统通用工具集合Web层WebWebUI系统中用户接口，提供页面逻辑的处理，结合业务逻辑进行部分离散业务逻辑的处理。服务器端处理工具ServerSS各类自动化性质的工具的服务器端处理工具集合Web方式提供的服务HttpProviderHP采纳WEB方式提供服务的工具集合HS的所有系统中各子系统命名空间总揽该信息需要与“F05-00006系统架构.xls”中的命名空间保持一致。子系统名称及编号、代号命名空间头部备注人事治理

6、M01、HotHRHotsales.HR目前要紧包含企业组织结构、人员系统治理 M02、HotUM*Hotsales.System系统体系结构、权限等治理业务处理 M03、HotBizHotsales.Business销售订单（业务）、合同治理销售治理M45 SaleManageM04、HotSaleClewHotsales.SaleManageHotsales.SaleManage.ClewHotsales.SaleManage.Chance销售线索、销售机会M05、HotSaleChance客户治理 M06、HotCustomerHotsales.CustomerInfo客户资料治理（涉及

7、全面客户资料：客户、供应商等）服务与支持 M07、HotServiceHotsales.Service服务与支持财务治理 M08、HotFinanceHotsales.Finance财务治理办公基础辅助工具T00T01、HotSMSHotsales.OA.SMS短信服务提醒服务（通过内部消息、短信、邮件来实现）内部消息服务系统事件工作流（目前要紧涉及到审批流和审批工具）工作打算（包含打算安排，同时调用提醒工具）邮件工具（群发、定向发送）T02、HotREMINDHotsales.OA.RemindT03、HotMESSAGEHotsales.OA.MessageT04、HotSEHotsale

8、s.OA.SystemEventT05、HotWFHotsales.OA.WorkFlowT06、HotWPHotsales.OA.WorkPlanT07、HotMailerHotsales.OA.MailerT08、HotGTaskHotsales.OA.GeneralTaskT09 HotFaxHotsales.OA.Fax传真治理中心内部交流T20、HotAdviceHotsales.OA.AdviceCenter建议中心T21、HotNewsHotsales.OA.NewsCenter新闻中心T22、HotbbsHotsales.OA.BBSBBS产品治理 M09、HotProdHot

9、sales.Product产品治理市场治理 M10、HotMarkHotsales.Marketing市场治理系统设置 M30、SysSetupHotsales.SysSet系统设置治理系统框架 T90、HotSystemFrameworkHotsales.SystemFramework系统框架通用工具 HotCRMCommonHotsales.Common通用工具编号规则：M开头，企业信息化治理系统P开头，企业信息化生产过程治理信息系统，车间生产治理、生产跟踪E开头，企业信息化工程技术子系统，如，CAD、CAPP等T开头，企业信息化工具系统S开头，企业信息化治理集成系统HS体系中的商用系统代

10、码集成商用系统编号代号名称S01HotCRM客户关系治理系统系统中的对象数据组织模式系统中特定对象数据采纳两类数据对象进行封装和传递。存放单一对象信息的特定对象数据，采纳实际的对象，对象的属性是该对象对应的HSF规范视图的所有属性和特定大字节属性（具体定义见“T03-00007HS DB治理规范.doc”）。命名规范为：XXData存放多个对象信息的对象集合数据，采纳DataTable对象来存储该对象集的列表数据。其中不能包含特定的大字节属性。命名规范为：XXTable用于UI显示的信息传输模式所谓信息传输模式：指函数参数的类型范围。在UI中显示的信息仅仅来源于两类信息载体，DataTable

11、和特定的对象。用于数据表格/DataGrid、下拉列表框、列表框、控件数组等信息显示，采纳通用DataTable作为信息的载体进行信息的传输。信息的传输方向：“DSUI”；用于非上述页面元素的显示，采纳特定的对象作为信息的载体进行信息的传输。信息传输方向“DSUI”特定统计性质的数据的显示，可能来源于DataTable或特定的函数参数，甚至函数的返回值。非UI显示（逻辑处理需要）的信息传输模式用于逻辑处理需要进行信息的猎取，能够依照需要进行信息的传递，但一般采纳“用于UI显示的信息传输模式”。专门情况依照需要用户能够自行决定信息传输模式。系统中的对象数据的处理方式系统中任何对象都对应一个对象数

12、据类，所有特定对象信息的传输是通过该类的对象进行传输的。该对象的属性是该对象对应的数据表的所有属性，和该数据表对应的视图扩充过来的属性。与特定对象相关的类及其差不多功能假设对象名为Object。层次类名功用BusinessFacadeObjectSystem提供UI需要的所有个性化接口，包含简单的参数规范性检测。一般没有属性，纯粹的方法封装体。BusinessRulesObject提供个性化业务逻辑处理引擎。没有参数检测。一般没有属性，纯粹的方法封装体。BusinessDataObjectData提供当前对象的个性化属性封装体。属性范围：该对象对应的数据表的所有属性，和该数据表对应的视图扩充过

13、来的属性。提供基于编号的属性猎取接口，集成到类的初始化方法中。同时提供基于独立命名的差不多信息维护接口（新建、基于主键的修改）CommonObjectTool与特定子系统相关的通用工具封装体。一般没有属性，纯粹的方法封装体。DataAccessObjects提供与特定对象相关的数据表的访问接口。系统通过该层连接远程DB，执行DS层的SP，进行系统需要的数据处理。特定对象的个性化类系统中将提供差不多属性和操纵属性。在所有的属性猎取接口中需要自己再生成SQL代码片段，应全面防止注入式SQL病毒。属性提供了该对象对应的数据表的所有属性，和该数据表对应的视图扩充过来的属性。即该对象对应的视图的所有属性

14、和大字节属性。某些类还提供了个不专门的统计属性，这些属性的设置需要通过非编号的扩展信息猎取接口来进行信息的设置。定义属性的时候需要初始化属性，依照不同的类型进行如下初始化数值类型：初始化为“0”字符型：初始化为“”日期型：初始化为“1990-1-1”引用型：初始化为“null”构造函数系统提供了基于配置的属性初置构造函数，即提供通过编号和XML文件配置的初始化类时应该设置的属性值。假如用户提供的构造函数和扩展函数中编号没有定义，则统统默认为“2”。即指定了无效的编号，则初始化为全部视图属性。差不多编号：内置的构造函数编号0：空对象，初始化一个空对象，不从DS层猎取任何信息。用于创建和修改对象信

15、息时使用。1：全部直接属性，猎取所有视图/数据表中有对应字段的属性，含大字节属性。2：全部视图属性，猎取所有视图属性，不含大字节属性。这是默认方式，即无参构造函数默认采纳该编号。3：名称属性，仅仅ID属性和名称/描述属性。4：大字节属性，仅仅ID属性和所有大字节属性。5：其它属性，仅仅ID属性和其它非视图/数据表属性。扩展编号：又称配置编号，基于配置文件的信息猎取接口。配置文件参见“T03-00010系统属性设置配置策略.doc”扩展属性设置接口基于配置文件进行和特定的命名属性串进行对象属性的设置。扩展信息猎取接口支持所有编号的对象属性设置。系统中所有编号的属性设置差不多上通过一个统一的函数来

16、进行的。/函数讲明：标准扩展方式设置对象属性（依照配置编号或直接命名属性串设置特定对象的属性）成功设置特定对象属性，无返回值（void）。否则抛出错误（M3000209F）接口参数：配置编号：int attributeNo 关键字：int keyword /具体命名和类型采纳该对象对应的关键字的名称和类型命名属性串：string attributeString /重载接口参数参数格式：命名属性串：string attributeString，用逗号隔开的命名属性串处理方法：直接调用DA层同名同参接口具体调用：命名空间：Hotsales.子系统命名空间.BusinessData系统类名：Obje

17、ctData处理方法：public void ExtendSetAttribute(int keyword, int attributeNo)处理方法：public void ExtendSetAttribute(int keyword, string attributeString) /重载接口参考用例：直接见接口模型（调用讲明处出现）/扩展属性猎取接口通过属性方式访问特定对象的属性，需要通过构造函数、扩展属性设置函数事先进行对象属性的赋值。同时还需要保证执行了正确的属性设置方法，即应用了正确的属性设置编号。否则可能猎取系统默认的属性值，而非实际的属性值。此种方法为事先设置方式。此处提供的扩

18、展属性猎取接口，是即时属性猎取接口。该接口将即时调用对应的DA层接口取猎取相关属性。并返回对应属性加载的Hashtable对象。/函数讲明：标准扩展方式猎取对象属性（依照直接命名属性串猎取特定对象的属性）成功返回特定属性加载的Hashtable对象。否则抛出错误（M3000210F）接口参数：关键字：int keyword /具体命名和类型采纳该对象对应的关键字的名称和类型命名属性串：string attributeString 参数格式：命名属性串：string attributeString，用逗号隔开的命名属性串处理方法：直接调用DA层同名同参接口具体调用：命名空间：Hotsales.子

19、系统命名空间.BusinessData系统类名：ObjectData处理方法：public Hashtable ExtendGetAttribute(int keyword, string attributeString) 参考用例：直接见接口模型（调用讲明处出现）/维护接口系统提供了创建对象和依照对象关键字进行信息的更新的接口。注意：创建和更新的逻辑条件在BR层进行，此处的接口仅仅进行实际的创建和更新操作。现在需要利用该对象作为函数参数，进行相关处理：在UI层给对象的属性赋值通过BF层传输到BR层在BR层处理完相关逻辑条件后，再执行该对象的特定维护接口。辅助接口，私有接口猎取指定属性编号/用

20、户化属性串对应的标准命名属性串/函数讲明：猎取指定属性编号/用户化属性串对应的标准命名属性串成功返回特定的命名属性串。否则抛出错误（M3000211F）接口参数：属性编号：int attributeNo 命名属性串：string attributeString /重载接口参数参数格式：命名属性串：string attributeString，用逗号隔开的命名属性串处理方法：内置编号采纳类常量模式非内置编号采纳从XML文件猎取，然后解析命名属性串命名属性串需要进行解析。具体调用：命名空间：Hotsales.子系统命名空间.BusinessData系统类名：ObjectData处理方法：priva

21、te string ParseAttributeString(int attributeNo) 处理方法：private string ParseAttributeString(string attributeString) 参考用例：直接见接口模型（调用讲明处出现）/依据命名属性串从DA层猎取对应的数据/函数讲明：依据命名属性串从DA层猎取对应的数据成功返回特定属性数据。否则抛出错误（M3000212F）接口参数：关键字：int keyword /具体命名和类型采纳该对象对应的关键字的名称和类型命名属性串：string attributeString 参数格式：命名属性串：string at

22、tributeString，用逗号隔开的命名属性串处理方法：直接调用DA层同名同参接口具体调用：命名空间：Hotsales.子系统命名空间.BusinessData系统类名：ObjectData处理方法：private DataTable GetGrivenAttributeInfos(int keyword, string attributeString) 参考用例：直接见接口模型（调用讲明处出现）/将猎取的数据加载到对象对应的属性中/函数讲明：将猎取的数据加载到对象对应的属性中成功将特定的属性加载到对象的特定属性中。否则抛出错误（M3000213F）接口参数：属性数据：DataTable

23、attributeData 处理方法：直接将数据表中的信息加载到对象的属性中，采纳逐一加载法进行加载具体调用：命名空间：Hotsales.子系统命名空间.BusinessData系统类名：ObjectData处理方法：private void SetAttributesFromDataTable(DataTable attributeData) 参考用例：直接见接口模型（调用讲明处出现）/将猎取的数据加载到Hashtable中/函数讲明：将猎取的数据加载到Hashtable中成功返回特定属性加载的Hashtable对象。否则抛出错误（M3000214F）接口参数：属性数据：DataTable

24、attributeData 处理方法：直接调用DA层同名同参接口具体调用：命名空间：Hotsales.子系统命名空间.BusinessData系统类名：ObjectData处理方法：private Hashtable CreateHashtableFromDataTable(DataTable attributeData) 参考用例：直接见接口模型（调用讲明处出现）/依据命名属性串和对象关键字实例化加载对象属性/函数讲明：依据命名属性串和对象关键字实例化加载对象属性成功将加载当前对象的属性。否则抛出错误（M3000218F）接口参数：关键字：int keyword /具体命名和类型采纳该对象对

25、应的关键字的名称和类型命名属性串：string attributeString 具体调用：命名空间：Hotsales.子系统命名空间.BusinessData系统类名：ObjectData处理方法：private void LoadObjectAttribute(int keyword, string attributeString) 参考用例：直接见接口模型（调用讲明处出现）/依据属性编号和对象关键字实例化加载对象属性/函数讲明：依据属性编号和对象关键字实例化加载对象属性成功将加载对象的属性。否则抛出错误（M3000219F）接口参数：关键字：int keyword /具体命名和类型采纳该对

26、象对应的关键字的名称和类型属性编号：string attributeNo具体调用：命名空间：Hotsales.子系统命名空间.BusinessData系统类名：ObjectData处理方法：private void LoadObjectAttribute(int keyword, int attributeNo) 参考用例：直接见接口模型（调用讲明处出现）/检测属性的猎取是否合法，即是否初始化了/函数讲明：检测属性的猎取是否合法，即是否初始化了合法将直接进行过程下一步操作。不合法和出现错误都将抛出错误（M3000220F）接口参数：属性名称：string fieldName具体调用：命名空间：

27、Hotsales.子系统命名空间.BusinessData系统类名：ObjectData处理方法：private void CheckAttributeIsInitialized(string fieldName)参考用例：直接见接口模型（调用讲明处出现）/复位对象数据相关属性/函数讲明：复位对象数据相关属性成功将直接复位对象的相关属性，即按标准设置对象属性的初始化值。出现错误都将抛出错误（M3000221F）接口参数：无具体调用：命名空间：Hotsales.子系统命名空间.BusinessData系统类名：ObjectData处理方法：private void ResetDataRelaAt

28、tributes()参考用例：直接见接口模型（调用讲明处出现）/HS信息处理模式原理图对象数据类差不多接口类名：ObjectData差不多常量和非公开域SYSTEM_NO定义该对象隶属的子系统编码，具体子系统编码见系统架构.xlsglobalAtrributeArray全局属性数组，与全局属性串对应作用：提高检测效率使用的差不多治理/操纵属性CurrentAttributeNo只读提供当前设置对象属性的属性编号假如是采纳命名属性串的方式，则值为“-1”作用：使用户能够检测其在初始化对象的时候使用哪个初始化编号GlobalAttributeString只读提供当前对象的用逗号隔开的全部命名属性串

29、作用：用于生成标准SQL语句的命名属性参考。CurrentAttributeString只读提供设置当前对象属性的命名属性串假如用户提供的内置编号，系统需要提供所有内置编号对应命名属性串；假如用户提供的是扩展编号，系统将从“T03-00010系统属性设置配置策略.doc”配置文件中猎取命名属性串；假如用户采纳的命名属性串方式的扩展设置接口，则直接为扩展设置方式的命名属性串。假如用户初始化空对象，则给对象属性赋值时，系统将自动装配该属性值。即用户给了哪几个属性赋了值，系统将自动生成这几个对象的命名属性串。作用：用户利用属性值的时候能够检测该利用是否合法。CheckReadProperty可读写，

30、默认为“false”操纵用户利用对象属性值的时候，系统是否需要检测，用户是否设置了特定的属性值。构造函数带参数：ObjectData(int keyword, int attributeNo) /主键的具体命名和类型采纳该对象对应的关键字的名称和类型无参数：ObjectData(int keyword):this(keyword,2) 扩展属性设置函数属性编号：ExtendSetAttribute(int keyword, int attributeNo)命名属性串：ExtendSetAttribute(int keyword, string attributeString)扩展属性猎取函数p

31、ublic Hashtable ExtendGetAttribute(int keyword, string attributeString)维护函数void CreateObject(具体的数据属性参数) 修订01/创建对象void ModifyObject(具体的数据属性参数) /综合修改对象void ModifyObjectXX(具体的数据属性参数) /修改对象指定的属性，其中XX代表指定的属性辅助接口private string ParseAttributeString(int attributeNo) /猎取指定属性编号/用户化属性串对应的标准命名属性串private string ParseAttributeString(string attributeString) /猎取指定属性编号/用户化属性串对应的标准命名属性串private DataTable GetGrivenAttributeInfos(int keyword, string attributeString) /依据命名属性串从DA层猎取对应的数据private void SetAttributesFromDataTable(DataTa