财 付 通 客 服 电 话 是 多 少

1、 本文由lingyijianb贡献 doc文档可能在WAP端浏览体验不佳。建议您优先选择TXT，或下载源文件到本机查看。 2010 总体设计规范 2010 总体设计规范 修订历史记录 日期 版本 作者 说明 2010-1-21 V1.0 Duch,gejm,yangds,luj 2010 总体设计规范 1. 2. 综述 3 UI 界面设计规范 3 2.1. 2.2. 2.3. 2.4. 风格 3 布局 3 字体及色彩 4 各控件规范 5 DateTimePicker 5 ComboBox 5 GroupBox 6 ToolTip 6 UI 参考附件 6 存储过程规范6 存储过程的异常处理(提高

2、存储过程的健壮性) 6 存储过程的错误日志 7 存储过程的调试 7 3. 数据访问层设计规范 6 3.1. 3.2. 3.3. 3.4. 3.5. 3.6. 3.7. 3.8. 3.9. 3.10. 3.11. 3.12. 数据库命名规范 8 编辑接口(先图后说明) 9 接口名称规范 10 接口注释规范 13 方法名称规范 14 服务实现类 15 业务逻辑实现类 15 日志处理 17 方法颗粒化 17 面向对象思想 17 SQLHelper 数据库连结 17 2010 总体设计规范 1. 综述 1. 为确保新版 SSEIS，界面风格统一、便于以后维护特制定本规范; 2. 为了统一公司软件开发设

3、计过程的 UI 界面设计规范; 3. 使开发人员能很方便的理解每个变量，控件，方法的意义; 4. 为了保证编写出的程序都符合相同的规范，保证一致性、统一性而建立的 UI 界面设计规范; 5. 为了统一公司软件开发过程中数据访问层的设计编写规范; 6. 本规范还在进一步完善中。 保障约定 1. 研发各小组组长，带头实施本规范，督促检查小组内各研发人员使用本规范。 2. 针对自主产权的控件，各研发小组、各组员，可以提改进建议，不得各自为阵，自建一套。 与本规范不相符合的，测试组视作 BUG 报告。 3. 测试组定期在代码中搜索 MessageBox,发现源码中使用了 MS 的 MessageBox

4、，视作 BUG 报 告。 4. 测试组定期在代码中搜索其他与如下规范相近的控件，发现不符合相，视作 BUG 报表。 5. 开发准备工作完成后，开发人员宣誓，确保规范实施。 范围 1）本规范适用于开发组全体人员，作用于软件项目开发的代码编写阶段和后期维护阶段。 2. UI 界面设计规范 2.1. 风格 1） 不要设计 Form， 要做 Control， 继承 UserControl， 控件名称以 “ctl” 开头， 设置都与 Windows 默认的一致。 2） 如果要弹出 Form，通过主程序 IMainFrame 中的 IFrameManager 的 CreateForm()来实现。 3） 只

5、有不相干的信息才考虑放到不同的 TabPage 中。 4） 窗体弹出的层数不应超过 3 层。 5） 报错页面的风格一致，统一所有报错页面，以对话框形式友好地提示用户，提示内容必须 具有指导意义，不要擅自用 MessageBox 显示错误信息，用统一的提示信息模块。 6） 鼠标默认显示箭头，若悬浮于链接时状态显示手型；系统忙时显示沙漏形状。 7） 打开新增（修改）页面时，光标初始定位在第一个待输入的文本区、选项框、按钮等。 8） 因输入不正确提示用户重新输入时，光标默认 focus 在出错的输入区，并全选错误输入。 9） 若必填项未填写完毕就提交，应给出说明信息并能自动获得焦点。 10） 可写控

6、件检测到非法输入后应给出说明并能自动获得焦点。 2.2. 布局 1） 界面的容器用 TableLayoutPanel 来约束各控件的位置。 2010 总体设计规范 2） 窗体控件布局和间距尽量与 Windows 标准保持一致，控件和边缘间距为 3;UI 元素采用自上 而下的从左至右的布局。 3） 尽量采用 Dock 和 Anchor 来布局;Anchor 一般为 （Left, Right）或 Dock 一般为 Fill 来控制不 是自动调整大小的控件。 4） 界面上的所有元素要注意 Tab 的访问顺序， 界面设计好后点击 “Tab 键顺序” 按钮进行设置， 从上而下，从左至右。 如： 此为“T

7、ab 键顺序”按钮。 2.3. 字体及色彩 1）所有字体为默认值，为“FlatStyle 宋体, 9pt” 。 2）界面 BackColor 默认为 Control 的背景色，不要修改。 3）不可修改的字段，统一使用灰色文字显示，控件底色灰化。 （如下图） 图1. 注：设置为灰化属性优先顺序为：ReadOnly、Enable。 4）必填项用红色英文的星（*）来标识，该标识放于必填项 Label 之后。 （如下图） 图2. 5）外部验证内容通过项用绿勾（）来标识。 （如下图） 图3. 6）如果提交时验证不满足的信息，对应输入框为红色，底色为粉红色。 （如下图） 图4. 2.4. 各控件规范 图5

8、. 2010 总体设计规范 在文本框内起到提示作用的文字，用水印模式灰色斜体显示。 （如下图） 图6.“完成活动” 2010 总体设计规范 图7. 2.5. UI 参考附件 3. 数据访问层设计规范 3.1. 存储过程规范catch 捕获异常机制 示例代码： DECLARE strErrorMessage NVARCHAR(4000) Begin try -这里写要执行的代码 End try BEGIN CATCH set strErrorMessage = cast(ERROR_LINE() as nvarchar(20)+'行,'+ERROR_MESSAGE() inser

9、t into A_SQLError(ProName, ErrInfo, CreateDate) values(ERROR_PROCEDURE(),strErrorMessage, getdate(); -将错误日志记录到错误日志表中 END CATCH 2010 总体设计规范 存储过程的错误日志 1. 为方便将来的错误调试，可以把数据库的错误信息记录到记录存储过程错误的专用表中.表 中主要存放一下字段。 ID(自增长字段) bigint ProName(存储过程名称) nvarchar(250) ErrInfo(错误信息： 主要存放错误行号、 数据库错误提示信息、 字符文本的 SQL 语句)

10、nvarchar(max) CreateDate(创建时间) datetime 2. SQL 中可参考的函数： ERROR_NUMBER() 返回错误号。 ERROR_MESSAGE() 返回错误消息的完整文本，此文本包括为任何可替换参数（如长度、对象 名或时间）提供的值。 ERROR_SEVERITY() 返回错误严重性。 ERROR_STATE() 返回错误状态号。 ERROR_LINE() 返回导致错误的例程中的行号。 ERROR_PROCEDURE() 返回出现错误的存储过程或触发器的名称。 存储过程的调试 数据库中直接调试 在 Visual Studio 的服务器资源管理器中，右键单

11、击某个数据库对象，然后 选择“单步执行××”。 例如，当你右键单击一个存储过程的时候，弹出菜单中就会包含一个“单 步执行存储过程”的选项。 调试窗口截图如下： 图8. 2010 总体设计规范 它的调试快捷键和 vs 的调试快捷键一样的。注意点：在调试时最好加上事务，不要把测试信息 写入表中。 3.2. 数据库命名规范 图9.Developer Express 部门、岗位树，统一由权限管理模块相关人员提供控件，其他研发小组、开发人员可以提修改 建议，不得各自为阵，自建一套。 2010 总体设计规范 图10. 或其他什么方法。 该方法，将统一定位帮助，统一报告 BUG。 统一的

12、部门树 列表控件，统一使用杜工的列表控件（甘特图控件） ，有什么问题，大家可以提改进建议。 图11. 列表控件 列表数据的读取，统一采用 QReport 提供的报表方案，用 QReport 设计器设计，由 QReport 相 关组件展示、分页、打印、输出 Excel、输出 pdf 等，便于以后修改。 没有特强逻辑的数据增删改，也尽量使用 QReport 提供的数据编辑工具、组件。 业务层开发规范 3.3. 编辑接口(先图后说明) 2010 总体设计规范 图12. 第一步:右击项目或文件夹，选择添加，选择类 图13. 第二步：选择接口，填写名称，名称“ IManageRightFacade.cs

13、” ，点击添加，如在 TFS 环境下添 加会弹出签出界面，点击“确定” 。 3.4. 接口名称规范 1. 2. 3. 4. 接口前缀添加 I 开始【大写的 I 表示接口】 接口操作意图 【新增 New，删除 Del，修改 Update，读取 Load，管理 Manage】 被作用对象名称 【员工 Employee，岗位 Position，权限 Right】 被应用层的名称 【业务逻辑层 Rule，服务实现层 Facade】 示例：I + Manage + Right +Fa?ade +.cs 规则：前缀 + 接口操作意图+被作用对象名称+被应用层的名称+文件类型后缀 2010 总体设计规范 图

14、14. 第三步：选择项目下引用右击鼠标，选择“添加引用” 。 图15. 2010 总体设计规范 图16. 第五步：接口 Interface 前面空一格添加 Public。 说明：public 关键字类型和类型成员的访问修饰符。公共访问是允许的最高访问级别。对访问 公共成员没有限制。 技巧：如需要了解更多信息，只需把光标定位到你所要了解词汇，或者选择单词，按 “F1”键， 弹出 MSDN 帮助. 图17. 第六步:应用命名空间，using 开头，将 System.ServiceModel 引入， 引入的命名空间要与 namespace 关键字一行语句空开一行。 说明： using 指令有两个用途

15、： 1. 允许在命名空间中使用类型，这样，您就不必在该命名空间中限定某个类型的使用:Using System .Text; 2. 为命名空间或类型创建别名。这称为“using 别名指令” 2010 总体设计规范 图18. 正确写法： 图19. 错误写法： 图20. 第七步：在服务接口上方添加ServiceContract 。 说明 ServiceContractAttribute 类 1.指示接口或类在 Windows Communication Foundation (WCF) 应用程序中定义服务协 定。 图21. 3.5. 接口注释规范 / / depiction：<对该接口的说明&

16、gt; / 2010 总体设计规范 / Writer：作者中文名 / Create Date：<方法创建日期，格式：YYYY-MM-DD> 第八步： 必须说明该接口的用途，谁是编辑者，编辑的日期 图22. 3.6. 方法名称规范 前缀 + 操作对象 + 操作条件 = 方法名称 前缀：Load 读取 ，New 新增 ，Update 修改，De l 删除，Search 查询，Is 判断 操作对象：Right ，Employee 等 操作条件：IN 在什么里边 属性规范请参阅： http:/server2/Sites/SSEIS2008-v1/SSEIS2008/开发规范 /SSEIS2

17、008 产品编程指 南.Doc 2010 总体设计规范 第九步 :编写方法 3.7. 服务实现类 using (TransactionScope _tran = new TransactionScope() /调用 Rule 代码功能代码 _tran.Complete(); return true; 3.8. 业务逻辑实现类 1. 类名称规则 操作对象+管理方式+层次 = 类名称 操作对象：Right ，Employee 等。 管理方式：Factory， Manage，等。 层次：Rule 等。 示例： RightManageRule; 2. 方法名称规则 前缀 + 操作对象 + 操作条件 =

18、 方法名称 2010 总体设计规范 前缀：Load 读取 ，New 新增 ，Update 修改，De l 删除，Search 查询，Is 判断 操作对象：Right ，Employee 等 操作条件：IN 在什么里边， 属性规范请参阅：http:/server2/Sites/SSEIS2008-v1/SSEIS2008/开发规范/SSEIS2008 产品编程指 南.Doc 3. 释放资源 功能逻辑类，统一继承 IDispose 接口。 示例：定义私有变量 图23. 使用完毕后不要等到垃圾回收机制来回收，实现 IDispose 方法， 图24. 调用方式：using(类型 实例化名称 = new

19、 类型() 当前语句调用完毕后即释放对象，对象必须继承 IDispose 接口。 4. 杜绝未将对象引用到实例化 用户自定义类型，引用类型 必须判断当前被实例化对象是否为 null If(实例化对象 != null) 继续下步代码流程 5. 捕获异常 try /容易报错的功能代码 catch (“异常类型”，ex) ApplicationLog.WriteError(ApplicationLog.FormatException(ex，AppUtil.Bl_EXCEPTION); 2010 总体设计规范 /返回条件 Finally /不管是否报异常都必定要执行 Finnaly 这里的语句 说明： try 里面是执行代码，其中的代码"可能"产生异常. catch 是对产生异常后的处理代码，可以抛出异常，也可以显示异常，也可以弹出某中提示，总 之 catch 里是任何代码都行，如