湖北省系统错误

EXB湖北信用信息标准EXBXXX-2015湖北省信用信息公共服务平台开发编码规范2015-XX-XX发布2015-XX-XX实施XXXXX发布湖北省信用信息公共服务平台建设项目开发编码规范1目录前言.
21.
范围.
错误!
未定义书签.
2.
规范性引用文件.
43.
术语和定义54.
信用信息使用分级.
错误!
未定义书签.
5.
信用信息使用分类.
错误!
未定义书签.
5.
1法人信用信息使用分类错误!
未定义书签.
5.
1.
1信用信息分类.
错误!
未定义书签.
5.
1.
2信用信息事项.
错误!
未定义书签.
5.
2自然人信用信息分类错误!
未定义书签.
5.
2.
1信用信息分类.
错误!
未定义书签.
5.
2.
2信用信息事项.
错误!
未定义书签.
湖北省信用信息公共服务平台建设项目开发编码规范2前言本标准由湖北省改革和发展委员会提出.
本标准由湖北省改革和发展委员会归口.
本标准由湖北省改革和发展委员会负责解释.
本标准起草单位:湖北省改革和发展委员会、东软集团股份有限公司.
本标准主要起草人:湖北省信用信息公共服务平台建设项目开发编码规范31.
范围本规范为一套编写J2EE代码的标准和约定.
它以软件工程原则为基础,使代码易于理解.
同时,将带来更大的一致性,使软件开发团队的效率得到提高本规范适用于任何基于J2EE规范的项目,本工程所有子项目中代码开发的均应遵守这个规范.
湖北省信用信息公共服务平台建设项目开发编码规范42.
规范性引用文件下列文件中的条款通过本标准的引用而成为本标准的条款.
凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本标准.
然而,鼓励根据本标准达成协议的各方,研究是否可使用这些文件的最新版本.
凡是不注日期的引用文件,其最新版本适用于本标准.
湖北省信用信息公共服务平台建设项目开发编码规范53.
术语和定义下列术语和定义适用于本标准.
1、J2EE(Java2Platform,EnterpriseEdition)J2EE核心是一组技术规范与指南,其中所包含的各类组件、服务架构及技术层次,均有共同的标准及规格,让各种依循J2EE架构的不同平台之间,存在良好的兼容性,解决过去企业后端使用的信息产品彼此之间无法兼容,企业内部或外部难以互通的窘境.
2、JavaJava是一种可以撰写跨平台应用程序的面向对象的程序设计语言.
3、Jsp(JavaServerPages)其根本是一个简化的Servlet设计,是一种动态网页技术标准.
4、Servlet是在服务器上运行的小程序.
5、JavaScriptJavaScript一种直译式脚本语言,是一种动态类型、弱类型、基于原型的语言,内置支持类型.
6、异常(Exception)指非正常情况,本质上是程序上的错误,包括程序逻辑错误和系统错误.
如使用空的引用、数组下标越界、内存溢出错误等.
湖北省信用信息公共服务平台建设项目开发编码规范64.
Java编码规范4.
1包和引入语句包定义packagecom.
xypt.
code;类型引入importcom.
xypt.
code.
Coding;4.
2命名规范4.
2.
1包命名包名称必须全部用小写.
命名方式:业务领域名.
系统标识.
层名,如com.
xypt.
code.
系统标识如下:序号系统名称/数据库名称系统标识1信用信息公共服务平台系统XYPT2信用信息汇集系统HJXT…4.
2.
2类命名类名以英文单词取名,首字母必须大写,如果名称是多个英文单词则以驼峰形式表示,每个单词首字母大写,如CreditLevel.
避免使用单词的缩写,除非它的缩写已经广为人知,如HTTP.
类名中不允许特殊符号出现,如"_"、"-".
4.
2.
3变量命名变量的命名采用大小写混合的形式,采用具有实际意义的英文单词表示,单词第一个字母小写,如果由多个单词组成,则中间单词的第一个字母大写.
单字符的变量名一般只用于生命期非常短暂的变量.
如:i,j,k,m,n一般用于int.
如果湖北省信用信息公共服务平台建设项目开发编码规范7变量是集合,则变量名应用复数,即以小写s结尾定义变量的位置,在类定义的开始,按照public,protected,private顺序放置.
定义local变量尽量在那段代码的开始处,如方法的开始处.
如果是if,for,while段,尽量在左大括号"{"的下一行处定义要使用的local变量.
4.
2.
4常量命名常量的命名建议都为大写字母,并用下划线分隔单词,如:publicstaticfinalStringFUNCTION_LIST="function_list";4.
2.
5方法命名方法命名采用"动作+属性"的方法.
并且,动作以小写字母开始,属性以大写字母开始.
常用的动作有:is、get、set、save、add、del等.
规则名称规则说明新增数据addXXX或newXXX等修改数据updateXXX或modifyXXX,editXXX等变更数据alertXXX或changeXXX等删除数据delXXX保存数据saveXXX、判断isXXX返回值为布尔型查看详细信息viewXXX查询数据queryXXX或getXXX等进入某个功能页面entryXXX下一步next、nextToXXX或entryXXX湖北省信用信息公共服务平台建设项目开发编码规范84.
3编码规范4.
3.
1程序基本构成公用元素公用元素指"公用变量"、"公用类"等,由于公用元素对程序中所有类都是可见的,故对它们的修改将会对整个程序造成影响.
"公用变量"过多也会破坏数据的隐藏性,与"面向对象编程"的规范不符.
所以,公用变量的使用请慎重考虑.
函数返回值注意函数返回值的初始化.
代码段注释"//"注释用于对程序的注解等.
注释用于对程序修改时临时删除部分程序代码.
注:是否作为"临时代码删除和对程序的注释"仅作为参考,根据具体情况而定设定初值所有变量均应设定其初值,而且变量的初值不应依靠编译程序自动设定.
错误返回值调用方法后,应检查errno或方法返回值,以确定操作是否完成.
若返回错误,返回对应的错误编码.
内存释放当原先分配的内存不在需要时,应将其释放.
类及方法注释在类、方法开始之前需要添加中文注释,类和方法的注释采用Java自动生成的注释格式,即输入/**回车后生成的注释格式.
1、类注释格式:/***Title:[信用信息编码]*Description:[信用信息编码类]*Copyright:Copyright(c)2015*Company:东软集团股份有限公司(NEUSOFT)*@create[创建人][创建时间]湖北省信用信息公共服务平台建设项目开发编码规范9*@update[修改人][修改时间]*@version$Revision$*/2、函数注释格式:/***函数功能说明*创建者名字创建日期*修改者名字修改日期*修改内容*@param参数名称参数类型参数说明*@return返回值类型返回值说明*/注:a.
循环语句和判断语句前必须注释.
b.
特殊变量声明时需要注释.
3、程序段注释格式:/***修改者:修改日期:*修改说明:*/4、变量或属性注释格式://说明或者/***说明*/4.
3.
2代码格式1、格式缩进用分层缩进的写法显示嵌套结构的层次;巢串式陈述句应比外层陈述句内缩四格.
【范例】importjava.
util.
*;importjava.
awt.
*;importjava.
applet.
Applet;湖北省信用信息公共服务平台建设项目开发编码规范10importjava.
awt.
event.
*;importjavax.
swing.
*;/***Title:[JApplet定义]*Description:[JApplet定义]*Copyright:Copyright(c)2015*Company:东软集团股份有限公司(NEUSOFT)*@create[创建人][创建时间]*@update[修改人][修改时间]*@version$Revision$*/publicclassWFextendsJAppletimplementsActionListener{WFPanelwfpanel;PanelcontrolPanel;WFPropwfprop;NodePropnodeprop;EdgePropedgeprop;JButtonjbAddNode=newJButton("添加节点");JButtonjbAddEdge=newButton("添加路由");JButtonjbDelNode=newButton("删除节点");JButtonjbDelEdge=newButton("删除路由");JButtonjbClose=newButton("关闭");privateJPaneljpPane=null;privateJToolBarjtbTools=null;privateJPaneljpCanvas=null;privateJNodePropjnpNodeProp=null;}2、空白行逻辑上相关序代码与其前后之程序代码间应以空白行加以分隔;在注释段与程序段、以及不同程序段插入空行,每行只写一条语句.
【说明】适当地使用空白行可以使程序的逻辑结构更清楚,而提高其可读性.
湖北省信用信息公共服务平台建设项目开发编码规范114.
3.
3异常处理在当前的系统架构中,系统自下而上被分为持久化层、业务处理层、请求处理层、界面层,本规范约定了持久层、业务处理层、请求处理层的异常处理机制.
异常处理总原则:1、下层只向上层抛一类异常.
如:业务处理层只向请求处理层抛ApplicationException异常.
2、为了使系统能够更好的跟踪运行情况,必须把底层异常放入新异常中.
如:thrownewApplicationException("查询单位时发生系统异常",e)3、如果一个层要抛出多个异常,那么所有自定义异常必须统一继承一个父类异常.
这样上层可以通过父类异常捕获4、异常统一在请求处理层,即action里进行处理,请求处理层以下的层次在处理异常时,只需要把底层的异常类放到本层约定的异常类中,并抛出,如有需要可以加适当的异常消息,并不需要记录LOG,LOG在框架里会自动处理.
4.
3.
4事务处理当前的系统架构中支持嵌套事务,事务管理必须通过系统框架提供的事务管理类(TransManager)来完成.
事务调用方法:1、开始事务:trans.
begin()2、提交事务:trans.
commit()3、回滚事务:trans.
rollback()事例代码:try{trans=newTransManager();flag=trans.
begin();//事务开始.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
if(1==flag)湖北省信用信息公共服务平台建设项目开发编码规范12trans.
commit();//事务提交}catch(OPExceptione){try{trans.
rollback();//事务回滚}catch(OPExceptione1){thrownewApplicationException(e1);}thrownewApplicationException(e);湖北省信用信息公共服务平台建设项目开发编码规范135.
Jsp编码规范5.
1文件路径规范jsp文件到业务子应用文件夹之间的文件夹层次及文件夹名称同java源码包保持一致.
5.
2文件命名规范两种命名结构:1.
数据主体名称_用途;2.
数据主体名称_谓词_用途;数据主体名称采用英文单词,具体使用的单词可以参照数据表名称,取数据表名称的实体含义部分(即业务线、一级模块分组以外的部分).
用途如:main(主窗口)、add(添加页面)、edit(编辑页面)、view(查看页面).
Jsp文件名采用全部小写的形式;可使用时字符包括小写英文字母、_、阿拉伯数字,并且必须以英文字母开头;单词之间以下划线进行分割.
示例:user_main.
jsp、user_edit.
jspuser_register_main.
jsp湖北省信用信息公共服务平台建设项目开发编码规范146.
JavaScript编码规范6.
1文件路径规范Js文件和对应的jsp文件放到同一目录下,文件目录规范见jsp编码规范部分.
6.
2命名规范6.
2.
1文件命名Js文件名和对应的jsp文件名保持一致.
6.
2.
2类命名命名规则同JAVA.
6.
2.
3方法命名命名规则同JAVA.
私有方法用前面加"_"符号进行区别.
全局函数前面加"g"符号进行区别.
所有的函数必须在使用前声明.
内函数的声明跟在var的后面,这样可以帮助判断那些变量是在函数范围内的.
6.
2.
4变量命名命名规则同JAVA局部变量前面加"_"符号进行区别.
(可选)全局变量前面加"g"符号进行区别.
在开发中,所有的变量必须在使用前声明好,这样做可以让代码变的易读,并且可以很好的找出那些因没有声明而被编译为全局的变量.
声明变量时将var放在声明的最前部,将每个变量单独成一行,并在其后加以注释,顺序以字母排序.