编码规范
编码规范
(V.01仅供内部使用)
一、布局结构规范
每个源程序文件的头部必须包含文件头部说明(文件名称、软件版权、功能说明、系统版本、开发人员、开发时间)和修改记录说明(修改日期、修改人员、修改说明)。
每个函数头部必须包含函数头部说明(使用https://www.360docs.net/doc/1313726597.html,会自动生成XML格式注释框架。)。
二、书写排版规范
2.1、空行
每个函数定义结束之后都要加一个或若干个空行。
在一个函数体内,变量定义与函数语句之间要加空行。
逻揖上密切相关的语句之间不加空行,其它地方应加空行分隔。
2.2、对齐
程序的分界符‘{’和‘}’永远都单独成行并且位于同一列,同时与引用它们的语句左对齐。
2.3、缩行
用缩行显示程序结构,使排版整齐,缩进量统一使用TAB,而不能用空格补齐。
同层次的代码在同层次的缩进层上。
三、语言规范
3.1、常量
全用大写字母命名,用下划线分割单词。
3.2、变量
声明变量的同时对变量进行初始化,严禁使用未经初始化的变量。
3.3、表达式
如果代码行中的运算符比较多,用括号确定表达式的操作顺序,避免使用默认的优先级。
不要有多用途的复合表达式(例如:d = (a = b + c) + r;该表达式既求a 值又求d 值。应该拆分为两个独立的语句:a = b + c;d = a + r;)。
尽量避免含有否定运算的条件表达式(如: if (!(num >= 10))应改为: if
(num < 10))。
3.4、语句
if 语句本身自占一行,执行语句不得紧跟其后。不论执行语句有多少都要加{}。
3.5、属性
原则上,字段(Field)是不能公开的,要访问字段的值,一般使用属性。属性以简洁清晰的名词命名。
3.6、函数
不要将正常值和错误标志混在一起返回。正常值用输出参数获得,而错误用异常捕获。
在函数体的“入口处”,对参数和通过其它途径进入函数体内的变量(如文件句柄等)的有效性进行检查。
函数的功能要单一,不要设计多用途的函数。
避免函数有太多的参数,参数个数尽量控制在5 个以内。如果参数太多,在使用时容易将参数类型或顺序搞错。
3.7、注释
边写代码边注释,修改代码同时修改相应的注释,以保证注释与代码的一致性。不再有用的注释要及时删除。
对于全局数据(全局变量、常量定义等)必须要加注释。
当代码比较长,特别是有多重嵌套时,应当在一些段落的结束处加注释,便于阅读。
四、命名规范
4.1、命名空间
命名空间构成方法:公司名.产品名[.组件名]
命名空间以.分割的每个节都建立一个文件夹,使命名空间和文件夹保持一致;
4.2、文件
采用小写字母命名文件,避免取一些比较通俗的文件名,如:main.cs
文件名称应尽量和文件中的类名相同。如:frLogin.cs文件中是frmLogin 类的定义。
4.3、https://www.360docs.net/doc/1313726597.html,控件
阿里巴巴编码规范题库
1.如何处理单元测试产生的数据,下列哪些说法是正确的?ABC A .测试数据入库时加特殊前缀标识。 B .测试数据使用独立的测试库。 C .自动回滚单元测试产生的脏数据。 D .无须区别,统一在业务代码中进行判断和识别。 多选2.关于并发处理,下列哪些说法符合《阿里巴巴Java开发手册》:ABC A .线程资源必须通过线程池提供,不允许在应用中自行显式创建线程。 B .同步处理时,能锁部分代码区块的情况下不要锁整个方法;高并发时,同步调用应该考虑到性能损耗。 C .创建线程或线程池时,推荐给线程指定一个有意义的名称,方便出错时回溯。 D .推荐使用Executors.newFixedThreadPool(int x)生成指定大小的线程池。(线程池不允许使用Executors 去创建,而是通过ThreadPoolExecutor 的方式) 多选3.下列哪些说法符合《阿里巴巴Java开发手册》:ACD A .对于“明确停止使用的代码和配置”,如方法、变量、类、配置文件、动态配置属性等要坚决从程序中清理出去,避免造成过多垃圾。 B .永久弃用的代码段注释掉即可,即不用加任何注释。 C .对于暂时被注释掉,后续可能恢复使用的代码片断,在注释代码上方,统一规定使用三个斜杠(///)来说明注释掉代码的理由。 D .不要在视图模板中加入任何复杂的逻辑。 多选4.关于分页查询,下列哪些说法符合《阿里巴巴Java开发手册》:ABC A .分页查询,当统计的count为0时,应该直接返回,不要再执行分页查询语句。 B .iBATIS自带的queryForList(String statementName,int start,int size)分页接口有性能隐患,不允许使用。 C .定义明确的sql查询语句,通过传入参数start和size来实现分页逻辑。 D .可使用存储过程写分页逻辑,提高效率。 多选5.根据《阿里巴巴Java开发手册》,以下功能必须进行水平权限控制校验的有:ABCD A .订单详情页面。 B .类目管理后台。 C .店铺装修后台。 D .订单付款页面 多选1.关于多线程并行处理定时任务的情况,下列哪些说法符合《阿里巴巴Java开发手册》:BCD A .推荐使用Timer方式处理。 B .推荐使用ScheduledExecutorService方式处理。 C .Timer运行多个TimeTask时,只要其中之一没有捕获抛出的异常,其它任务便会自动终止运行。 D .ScheduledExecutorService并发运行多个定时任务时,其中某线程抛出异常,不会影响到其它线程的继续运行。
编码规范
编码规范 1.编写目的 本规范的目的在于编写可靠的、一致的、便于理解的JAVA源代码,并且写出的代码被其他人阅读,所有的JAVA代码保持良好的致性,容易在以后的阶段中进行维护和升级。同时,也是为了通过一定时间的实践,增加我们的软件产品的投入产出量,以提高我们的工作效率。 2.适应范围 适用于JAVA程序开发人员,或后续开发人员。可以方便系统的开发与维护,使系统开发与维护可以顺利展开。 3.代码命名一般原则 我们开发的是一个JSP新闻发布系统,用的编码方式是JAVA,因此用的命名总原则是: 3.1.用全英文单词命名的方式,准确地描述变量、属性、类等。 如:使用firstNname、grandTotal、等命名就比x1、y1、fn等更容易让人理解其含义,尽管它们的长度要大一些。 3.2.采用一些更加准确的术语来命名。 例如:如果我们的用户称他们的clients为customers ,那么我们就应该用customer来命名,而不是采用client来命名。这是一些细微的地方,但也希望能注意。 3.3.采用大小写混合的方式来命名,以便命名有很好的可读性。 在JAVA代码中,将采用如下原则:类或接口命名中每个单词的首字母均大写,而单词的剩余部分均小写。其它像变量、成员方法、属性等除第一个单词全部小写以外,其它单词的首写字母均大写,而单词的剩余部分均小写。 3.4.尽量少用单词的缩写形式,但如果一定要用,则选择大家通用的缩写方式,并且要在本JAVA源代码中坚持用它,而不要一会用这种缩写方式,一会用那种 缩写方式。 比如,如果要用“number”的缩写方式,则可用“no”或“num”两种缩写方式,而不要用“nu”这种大家不常用的缩写方式,并且要保持不变。 3.5.尽量避免太长的命名,一般以少于20个字符为宜。
(整理)06 中国移动网络代维管理系统技术规范 编码规范分册V1.1.
中国移动通信企业标准 中国移动网络代维管理系统技术规范 编码规范分册 版本号:1.1.0 2012年9月发布2012年9月实施 中国移动通信集团公司
目录 1 编号规范 (2) 1.1 省级代维组织编号 (2) 1.2 地市级以下代维组织编号 (2) 1.3 人员编码 (2) 1.4 工单编号 (2) 1.5 公告编号 (2) 1.6 业务联系函编号 (2) 1.7 代维资料编号 (3) 2 编码规范 (3) 2.1 省份代码 (3) 2.2 地市 (4) 2.3 工作类别 (5) 2.4 代维专业类型 (6) 2.5 紧急程度 (6) 2.6 满意度 (6) 3 修订记录 (6)
前言 《中国移动网络代维管理系统技术规范》规定了中国移动网络代维管理系统的建设目标、建设原则、体系结构、功能结构、接口要求、技术要求,供中国移动内部和系统开发、集成厂商共同使用;是中国移动网络代维管理系统建设所依据的技术规范,用于指导全网代维管理IT化手段建设、开发与应用。 本分册是《中国移动网络代维管理系统技术规范》系列分册之一。《中国移动网络代维管理系统技术规范》系列分册的结构、名称如下: 本规范由中国移动通信集团公司网络部制订,由集团公司网络部归口和解释。 本规范起草单位:中国移动通信集团公司网络部。 本规范主要起草人:王晓琦、石晓萍、王烨、周林、夏凡超、王鹏、徐智岳、杜传业、马松、吴丹、贺军、云雅琼、杜珍祥、童克波、吕晓敏、周云斌、陈为国、陆旻、许贤、周敏、郭艺娴、赵珺、陈宏宇、于洪亮、吕敏、徐铁瑛、诸圣勇、谭凌凯、文晓林、唐继志、霍廷瑞、杨竹。
1 编号规范 1.1省级代维组织编号 DW+3位自增序号,如:DW001;建议加移动标识,如:CMJSDW001、CMZJDW001 1.2地市级以下代维组织编号 以江苏为例,5级组织结构进行参考,如下: 办事处:上级组织编号+所属地市编码+2位自增序号,如:DW0011401 项目部:上级组织编号+ 2位自增序号,如:DW001140101 驻点:上级组织编号+ 2位自增序号,如:DW00114010101 小组:上级组织编码+3位自增序号,如:DW00114010101001 1.3人员编码 DW+12位人员编码,关于代维人员编码规则(共计12位数字)如下: 1-3位代维公司编码; 4-5位地市编码; 6-9位代维人员加入系统年月,如0902; 10-13位代表入职代维公司的第几个员工。从0001开始的4位自增序号。 1.4工单编号 1.5公告编号 1.6业务联系函编号
【编号规则】工程信息编码标准
QB ****公司企业标准 信息分类和编码 第3分册工程信息分类和编码 (初稿) 20XX-XX-XX 发布 20XX -XX -XX 发行 *****有限责任公司 发 布 ICS XXX 备案号XXX
目次 前言 (3) 引言 (4) 1范围 (5) 2规范性引用文件 (5) 3术语和定义 (5) 4分类原则和方法 (6) 4.1基本原则 (6) 4.2分类对象的层面划分 (6) 4.3工程信息分类 (7) 4.4工程信息整体框架 (8) 5编码方法 (9) 5.1基本原则 (9) 5.2码值 (9) 5.3代码组结构和层次 (10) 5.3.1交互定位码 (10) 5.3.2项目编码 (10) 5.3.3管理属性编码 (11) 5.3.4设计属性编码 (11) 5.3.5合同属性编码 (12) 5.3.6档案属性编码 (12) 5.3.7采购、财务、招标信息属性编码 (13) 5.3.8非项目信息编码 (13) 6分类与代码表 (14) 6.1非项目信息分类标识码(30301) (14) 6.2省电网公司及直属单位编码(30302) (14) 6.3工程项目建设管理单位代码(30303) (15) 6.4项目属性代码(30304) (18) 6.5综合指标(30305) (19) 6.6立项时间(30306) (20) 6.7批次项目标识码(30307) (21) 6.8信息属性码分类(30308) (21) 6.9项目阶段代码((30309) (22) 6.10工作分解代码(30310) (22) 6.11信息创建部门代码(30311) (23) 6.12设计资料分类代码(30314) (24) 6.13设计阶段代码(30315) (24) 6.14类目代码(30316) (25)
C#通用编码规范
C#通用编码规范 Posted on 2010-11-03 15:31 gczhao阅读(71) 评论(0)编辑收藏 本文转自https://www.360docs.net/doc/1313726597.html,/usernam egaorn/archive/2007/10/20/1834275.aspx 基本命名规范 注记: Pascal 大小写形式:所有单词第一个字母大写,其他字母小写。 Cam el 大小写形式:除了第一个单词,所有单词第一个字母大写,其他字母小写。 对于在页面中的类,类名使用Pascal大小写形式,当然,这个类名通常情况下与前台页面的文件名是一致的,比如,对于一个页面HelloWorld.aspx,其类名会如下定义: public class HelloWorld : Page { … } 对于类库中的类,则应按照约定加一定的前缀,通常是小写字母c,比如一个通用类可以如下定义:public class cHelloWorld { … } 自然的,相应文件名也是遵循此定义格式,在本例中,为cHelloWorld.cs 类中的方法都使用Pascal大小写形式 public class HelloWorld { void SayHello ( string userName ) { … } } 变量和方法中的参数使用Cam el 大小写形式 public class HelloWorld { int totalCount = 0; void SayHello ( string userName ) { string fullMessage = "Hello " + userName; … } } 常量的定义 常量名通常全部采用单词的大写,单词之间以下划线“ _ ”隔开。
医疗保障定点医疗机构等10项信息业务编码规则和方法
医疗保障定点医疗机构等10项信息业务 编码规则和方法 一、定点医疗机构编码规则和方法 定点医疗机构编码分3个部分共12位,通过大写英文字母和阿拉伯数字按特定顺序排列表示。其中,第1部分是定点医疗机构标识码,第2部分是行政区划代码,第3部分是定点医疗机构顺序码。定点医疗机构编码结构见图1: 图1 定点医疗机构编码结构 第1部分:定点医疗机构标识码,用1位大写英文字母“H”表示。 第2部分:行政区划代码,采用《中华人民共和国行政区划代码》(GB/T2260),用6位阿拉伯数字表示。其中,前两位代码表示省级行政区(省、自治区、直辖市),中间两位代码表示市级行政区(市、地区、自治州、盟),后两位代码表示县级行政区(县、自治县、县级市、旗、自治旗、市辖区、林区、特区)。 第3部分:定点医疗机构顺序码,对同一市级行政区(市、地区、自治州、盟)下的定点医疗机构赋予的顺序码,用5
位阿拉伯数字表示。 二、医保医师编码规则和方法 医保医师编码分3部分共13位,通过大写英文字母和阿拉伯数字按特定顺序排列表示。其中,第1部分是医保医师标识码,第2部分是行政区划代码,第3部分是医保医师顺序码。医保医师编码结构见图2: 图2 医保医师编码结构 第1部分:医保医师标识码,用1位大写英文字母“D”表示。 第2部分:行政区划代码,采用《中华人民共和国行政区划代码》(GB/T2260),用6位阿拉伯数字表示。其中,前两位代码表示省级行政区(省、自治区、直辖市),中间两位代码表示市级行政区(市、地区、自治州、盟),后两位代码表示县级行政区(县、自治县、县级市、旗、自治旗、市辖区、林区、特区)。 第3部分:医保医师顺序码,对同一市级行政区(市、地区、自治州、盟)下的医保医师赋予的顺序码,用6位阿拉伯数字表示。 三、医保护士编码规则和方法
编码规范
黄金定律 永远遵循同一套编码规范 -- 可以是这里列出的,也可以是你自己总结的。如果你发现本规范中有任何错误,敬请指正。通过为本规范添加或贡献内容。 不管有多少人共同参与同一项目,一定要确保每一行代码都像是同一个人编写的。HTML 语法 ?用两个空格来代替制表符(tab) -- 这是唯一能保证在所有环境下获得一致展现的方法。 ?嵌套元素应当缩进一次(即两个空格)。 ?对于属性的定义,确保全部使用双引号,绝不要使用单引号。 ?不要在自闭合(self-closing)元素的尾部添加斜线 -- HTML5 规范中明确说明这是可选的。 ?不要省略可选的结束标签(closing tag)(例如, 或