JAVA编码规范

合集下载

java编码规则

java编码规则

java编码规则(最新版)目录1.Java 编码规范简介2.Java 编码的基本规则3.Java 编码的进阶规则4.Java 编码的特殊规则5.Java 编码规范的实际应用正文【Java 编码规范简介】Java 编码规范,是指在编写 Java 程序时遵循的一种编码风格和规则。

遵循 Java 编码规范,可以提高代码的可读性、可维护性和可扩展性,从而提高软件开发的效率和质量。

【Java 编码的基本规则】1.遵循统一的编码风格:整个项目或团队应该遵循统一的编码风格,如缩进、空格、换行等。

2.使用有意义的命名:变量、方法、类等命名应该具有明确、简洁、描述性强的特点。

3.合理使用注释:对于复杂的代码、算法等,应该使用注释进行解释说明,提高代码的可读性。

4.遵循面向对象编程原则:尽量使用封装、继承、多态等面向对象编程原则,提高代码的可扩展性和可维护性。

【Java 编码的进阶规则】1.遵循接口隔离原则:不应该强迫客户端依赖于它们不使用的方法,应该尽量减少非抽象类和接口中的方法数量。

2.遵循依赖倒置原则:高层模块不应该依赖于低层模块,二者都应该依赖于抽象。

3.遵循单一职责原则:类应该有明确的职责,应该只有一个原因改变。

【Java 编码的特殊规则】1.异常处理:应该正确处理异常,避免出现未处理的异常。

2.集合使用:应该正确使用集合,避免出现空指针、越界等错误。

3.多线程编程:应该正确使用多线程编程,避免出现死锁、资源竞争等问题。

【Java 编码规范的实际应用】遵循 Java 编码规范,不仅可以提高代码的质量,还可以提高团队的开发效率,降低维护成本。

java 编码规则

java 编码规则

java 编码规则
Java编码规则是指在编写Java程序时需要遵循的一系列规范和约定,旨在提高代码的可读性、可维护性和可扩展性。

下面是一些常见的Java编码规则:
1. 代码缩进:使用四个空格进行缩进,不要使用制表符。

2. 代码行长度:每行代码尽量不超过80个字符,超过时可以换行。

3. 命名规范:使用驼峰命名法,即首字母小写,后面每个单词的首字母大写。

4. 类名:类名使用名词或名词短语,首字母大写。

5. 方法名:方法名使用动词或动词短语,首字母小写。

6. 变量名:变量名使用名词或名词短语,首字母小写。

7. 常量名:常量名应全部大写,并用下划线分隔单词。

8. 注释:为代码添加适当的注释,解释代码的用途、实现细节等。

9. 空格使用:在运算符两侧、逗号后面、冒号后面等地方使用空格,增加代码的可读性。

10.代码格式化:使用合适的缩进、空行、大括号等格式化代码,以增强可读性。

遵循这些Java编码规则可以使你的代码更易于理解和维护。

此外,还可以使用一些静态代码分析工具来自动检查代码是否符合编码规范,如Checkstyle、FindBugs等。

编码规则的遵守不仅仅是个人习惯的问题,也是一个团队合作的重要环节,通过统一的编码规范可以提高代码的一致性,方便开发人员的协作和项目的维护。

Java 程序编码规范

Java 程序编码规范

Java 程序编码规范(初学者要牢记)所有的程序开发手册都包含了各种规则。

一些习惯自由程序人员可能对这些规则很不适应,但是在多个开发人员共同写作的情况下,这些规则是必需的。

这不仅仅是为了开发效率来考虑,而且也是为了后期维护考虑。

命名规范定义这个规范的目的是让项目中所有的文档都看起来像一个人写的,增加可读性,减少项目组中因为换人而带来的损失。

(这些规范并不是一定要绝对遵守,但是一定要让程序有良好的可读性)Package 的命名Package 的名字应该都是由一个小写单词组成。

Class 的命名Class 的名字必须由大写字母开头而其他字母都小写的单词组成Class 变量的命名变量的名字必须用一个小写字母开头。

后面的单词用大写字母开头。

Static Final 变量的命名Static Final 变量的名字应该都大写,并且指出完整含义。

参数的命名参数的名字必须和变量的命名规范一致。

数组的命名数组应该总是用下面的方式来命名:byte[] buffer;而不是:byte buffer[];方法的参数使用有意义的参数命名,如果可能的话,使用和要赋值的字段一样的名字:SetCounter(int size){this.size = size;}Java 文件样式所有的Java(*.java) 文件都必须遵守如下的样式规则版权信息版权信息必须在java 文件的开头,比如:/*** Copyright ? 2000 Shanghai XXX Co. Ltd.* All right reserved.*/其他不需要出现在javadoc 的信息也可以包含在这里。

Package/Importspackage 行要在import 行之前,import 中标准的包名要在本地的包名之前,而且按照字母顺序排列。

如果import 行中包含了同一个包中的不同子目录,则应该用* 来处理。

package .stats;import java.io.*;import java.util.Observable;import hotlava.util.Application;这里java.io.* 使用来代替InputStream and OutputStream 的。

java编码规则

java编码规则

java编码规则摘要:1.Java 编码规范简介2.Java 命名规范3.Java 代码排版规范4.Java 注释规范5.Java 编码实践建议正文:Java 编码规范简介Java 编码规范是为了提高代码的可读性和可维护性,降低程序出错概率,以及便于团队合作而制定的一系列规则。

遵循这些规范可以使代码更加统一和规范,有助于提高开发效率。

Java 命名规范1.包名:使用小写字母,每个单词的首字母大写,用下划线分隔。

2.类名:使用大写字母,每个单词的首字母大写,用下划线分隔。

3.变量名:使用小写字母,每个单词的首字母小写,用下划线分隔。

4.常量名:使用大写字母,每个单词的首字母大写,用下划线分隔。

5.方法名:使用小写字母,第一个单词的首字母大写,用下划线分隔。

Java 代码排版规范1.每行代码不超过79 个字符。

2.类与方法之间空一行。

3.方法内的逻辑块之间空一行。

4.注释与代码保持一定间距。

5.遵循统一的缩进风格。

Java 注释规范1.单行注释:使用双斜杠(//)或斜杠加星号(/*)开头。

2.多行注释:使用斜杠加星号(/*)开头,星号加斜杠(*/)结尾。

3.注释内容简洁明了,阐述代码的功能、原理、注意事项等。

4.保持注释与代码的同步更新。

Java 编码实践建议1.使用有意义的命名,避免使用模糊或过于简化的命名。

2.遵循编码规范,保持代码的一致性。

3.合理使用注释,提高代码的可读性。

4.保持代码简洁,避免过长的方法或类。

5.使用设计模式,提高代码的可重用性和可扩展性。

6.编写单元测试,保证代码质量。

java 规范

java 规范

java 规范Java的编码规范是一种旨在提高代码质量和可维护性的指南。

以下是Java编码规范的一些重要原则和规定。

1. 命名规范:- 类名应使用大写字母开头的驼峰命名规范,如:ClassName。

- 方法名、变量名应使用小写字母开头的驼峰命名规范,如:methodName。

- 常量名应使用全部大写的蛇形命名规范,如:CONSTANT_NAME。

2. 缩进和空格:- 使用四个空格进行缩进,不要使用Tab键。

- 二元操作符前后应添加空格,如:a + b。

- 不要在括号内添加空格,如:(a + b)。

3. 大括号和代码块:- 大括号应与相关的代码放在同一行,如:```if (condition) {// code here} else {// code here}```- 单行的代码块也应使用大括号包裹起来。

4. 注释:- 使用Javadoc格式的注释来描述类、方法等的用途。

- 在代码中添加必要的注释,解释代码的逻辑和实现细节。

5. 异常处理:- 建议使用try-catch语句来处理可能抛出异常的代码块。

- 不要捕获所有异常,只捕获你能够处理的异常。

6. 包的命名:- 包的命名应全部使用小写字母,多个单词之间用点号分隔,如:com.example.packageName。

7. 类的设计:- 类的设计应符合单一职责原则,即每个类只有一个主要职责。

- 类应该是可扩展和可重用的,应遵循开闭原则。

8. 方法的设计:- 方法应该尽量简洁,只做一件事情。

- 方法的命名应能清楚地描述它的功能和返回值类型。

9. 代码的可读性:- 避免使用过长的代码行,一行不应超过80个字符。

- 使用空行来分隔逻辑上不同的代码块。

- 使用合适的缩进和空格来增加代码的可读性。

这些只是Java编码规范的一部分内容,旨在提高代码的可读性、可维护性和一致性。

遵循这些规范可以帮助团队成员更好地理解和修改代码,减少潜在的错误和问题。

java编码规范

java编码规范

JAVA语言编程格式规范2014.03目录1. 前言--------------------------------------------------------------------------------------------------------------------------------- 42. 试用范围--------------------------------------------------------------------------------------------------------------------------- 43. 重要性说明 ----------------------------------------------------------------------------------------------------------------------- 44. JAVA命名规范-------------------------------------------------------------------------------------------------------------------- 54.1 公共约定-------------------------------------------------------------------------------------------------------------------- 54.2 Java文件、包 -------------------------------------------------------------------------------------------------------------- 54.3包结构---------------------------------------------------------------------------------------------------------------------- 54.3.1 Java工程包结构 -------------------------------------------------------------------------------------------------- 54.3.2 Maven工程包结构(标准java项目) -------------------------------------------------------------------------- 64.3.3 Web工程包结构(非Maven工程)----------------------------------------------------------------------------- 74.3.4 Web工程包结构(Maven工程) -------------------------------------------------------------------------------- 84.3.5 其他部分的包命名 ---------------------------------------------------------------------------------------------- 94.4 包的引入-------------------------------------------------------------------------------------------------------------------- 94.5 包的命名规范 ------------------------------------------------------------------------------------------------------------- 94.6 类--------------------------------------------------------------------------------------------------------------------------- 104.7 接口------------------------------------------------------------------------------------------------------------------------ 104.8 方法------------------------------------------------------------------------------------------------------------------------ 104.9 变量------------------------------------------------------------------------------------------------------------------------ 104.10 实例变量 ---------------------------------------------------------------------------------------------------------------- 104.11 常量 ---------------------------------------------------------------------------------------------------------------------- 114.12 组件/部件 --------------------------------------------------------------------------------------------------------------- 114.13 集合 ---------------------------------------------------------------------------------------------------------------------- 114.14 神秘的数 ---------------------------------------------------------------------------------------------------------------- 114.15 其他 ---------------------------------------------------------------------------------------------------------------------- 114.16 Java异常----------------------------------------------------------------------------------------------------------------- 124.17 数组命名 ---------------------------------------------------------------------------------------------------------------- 124.18 数据库表命名规则 --------------------------------------------------------------------------------------------------- 124.19 数据库字段命名规则 ------------------------------------------------------------------------------------------------ 124.20 JSP文件命名 ----------------------------------------------------------------------------------------------------------- 124.21 Servlet类命名 ---------------------------------------------------------------------------------------------------------- 125. 修饰符 ---------------------------------------------------------------------------------------------------------------------------- 135.1.1 按照功能分------------------------------------------------------------------------------------------------------ 135.1.2 按照类型分------------------------------------------------------------------------------------------------------ 135.1.3 各种修饰符与访问修饰符的说明-------------------------------------------------------------------------- 156. 排版------------------------------------------------------------------------------------------------------------------------------- 187. 注释------------------------------------------------------------------------------------------------------------------------------- 208. 声明------------------------------------------------------------------------------------------------------------------------------- 248.1 每行声明变量的数量-------------------------------------------------------------------------------------------------- 248.2 初始化--------------------------------------------------------------------------------------------------------------------- 248.3 布局------------------------------------------------------------------------------------------------------------------------ 248.4 类和接口的声明 -------------------------------------------------------------------------------------------------------- 259. 语句------------------------------------------------------------------------------------------------------------------------------- 259.1 简单语句------------------------------------------------------------------------------------------------------------------ 259.2 复合语句------------------------------------------------------------------------------------------------------------------ 259.3 返回语句------------------------------------------------------------------------------------------------------------------ 269.4 if, if-else, if else-if else语句------------------------------------------------------------------------------------------- 269.5 for语句 -------------------------------------------------------------------------------------------------------------------- 269.6 while语句----------------------------------------------------------------------------------------------------------------- 269.7 do-while语句------------------------------------------------------------------------------------------------------------- 279.8 switch语句---------------------------------------------------------------------------------------------------------------- 279.9 try-catch语句------------------------------------------------------------------------------------------------------------- 2710. 编码惯例 ----------------------------------------------------------------------------------------------------------------------- 2810.1 提供对实例以及类变量的访问控制----------------------------------------------------- 错误!未定义书签。

2023-Java编码规范-1

2023-Java编码规范-1

Java编码规范Java编码规范是指在Java语言开发过程中对代码格式、命名规范、注释等方面的规范。

它涵盖了许多方面,包括代码格式、命名规范、注释等等,并且会让代码更加易于理解和维护。

下面分步骤来阐述Java 编码规范。

1.代码格式- 代码缩进:使用四个空格。

- 代码行长度:每行不超过80个字符。

- 代码块括号:左大括号放在语句后,右大括号独立一行。

- 空行:在方法或类中的单独任务之间使用空白行来分隔。

- 其他注意事项:避免使用过多的空格,在行末不要有空格,避免使用tab字符。

2.命名规范- 包名:使用小写字母,多个单词使用.分割。

- 类名:使用驼峰命名法,每个单词首字母大写。

- 方法名:使用驼峰命名法,每个单词首字母小写。

- 变量名:使用驼峰命名法,每个单词首字母小写。

- 常量名:所有字母大写,单词之间用_分割。

- 其他注意事项:名称应该避免缩写,可读性要优先。

3.注释- 类、方法和变量都应该进行注释。

- 类和方法的注释应当使用javadoc格式。

- 变量和常量可以使用单行注释或行尾注释。

- 注释要避免使用无意义的话语,应该简明扼要地描述该元素的意义。

Java编码规范对开发人员来说是非常重要的,这能让代码更清晰、可读性更强,并且统一规范有助于团队协作的进行。

了解并遵循Java编码规范,可以帮助开发人员编写出高质量的Java代码,从而提高代码质量,减少bug的出现,提高项目的稳定性。

此外,标准的Java编码规范可以方便代码的查看和维护,便于未来项目的扩展。

因此,遵循Java编码规范是每个Java开发人员的责任和义务。

JAVA编码规范

JAVA编码规范
e.g.:
if (abc) {
}
for (int i = 0; i < 10; ++i) {
}
do {
} while (false);
try {
} catch (IOException e) {
} finally {
}
3.2 类命名不得使用拼音, 不得使用 My New Test 等无意义的词,要求类名见名知义。
3.3 类合理分包,如 cn.neiwang.emm.ui 中仅应放界面相关的类,不应该放日志模块。
3.4 package 行和 import 行间有且仅有一个空行。 import 结束和 类、接口的开始有且仅有一个空行。
Java编程规范
总体规则
(1) java 代码不得使用IDE自带的格式化,应该仅依赖于编码者去组织。
(2) 源码文件一律使用utf-8编码
(3) 不得因引用的包未使用、变量未使用等问题产生代码警告。
(4) 会显示在任意界面上的字符串严禁硬编码在java代码中,应由资源提供(国际化)
1. 基本规范
e.g.:
String fileName = userInfo.getFileName();
而不是:
String filename = userInfo.getFileName();
也不是:
String file_name = userInfo.getFileName();
1.9 不省略大括号。
e.g.:
if (sucess) {
return true;
}
而不是
if (sucess)

java编码规则

java编码规则

java编码规则【实用版】目录1.Java 编码规范概述2.Java 编码规则详解2.1 命名规范2.2 注释规范2.3 代码格式化2.4 控制结构2.5 数据类型及操作2.6 异常处理2.7 类与对象2.8 接口与继承2.9 泛型2.10 集合框架2.11 多线程正文【提纲】详解1.Java 编码规范概述Java 编码规范,顾名思义,是指在编写 Java 程序时遵循的一系列规则和约定。

这些规范旨在提高代码的可读性、可维护性和可扩展性,帮助开发者编写出高质量的 Java 代码。

Java 编码规范主要涵盖了命名规范、注释规范、代码格式化、控制结构、数据类型及操作、异常处理、类与对象、接口与继承、泛型、集合框架和多线程等方面。

2.Java 编码规则详解2.1 命名规范Java 命名规范主要包括以下几方面:- 类名、接口名和枚举常量名应使用驼峰命名法,即每个单词的首字母大写,除第一个单词外。

- 方法名和变量名应使用驼峰命名法,但第一个单词的首字母小写。

- 常量名应使用大写字母和下划线组合。

- 注释名应以双斜杠(//)开头。

2.2 注释规范注释是程序员对代码的解释和说明,有助于提高代码的可读性。

Java 注释规范要求:- 单行注释以双斜杠(//)开头。

- 多行注释以斜杠星号(/*)开头,以星号斜杠(*/)结尾。

- 注释应简洁明了,避免过多冗余。

2.3 代码格式化代码格式化是指按照一定的风格对代码进行排版,以提高代码的可读性。

Java 代码格式化要求:- 每行代码的长度不超过 80 个字符。

- 语句之间留有空格,以提高可读性。

- 适当的换行和缩进,使代码结构更清晰。

2.4 控制结构Java 控制结构包括条件语句、循环语句和分支语句等。

控制结构应简洁明了,避免过于复杂的逻辑。

2.5 数据类型及操作Java 数据类型包括基本数据类型和引用数据类型。

数据类型操作应遵循以下规范:- 变量应在使用前初始化。

- 避免使用未初始化的变量。

Java编码规范

Java编码规范
4.1 方法排版规则
规则4.1.1 方法名和其后的括弧之间不应有空格 示例:
int getResult(int forInt, char forChar)
规则4.1.2 缩进采用4个空格 注意:一定要使用空格键。这样可以避免使用不同的编辑器阅读程序 时,因TAB键所设臵的空格数目不同而造成程序布局不整齐。
4.排版规则
4.2 语句排版规则
建议4.2.13 关键词try catch finally和后面的括号之间加一个空格 示例:
try { statements; } catch (ExceptionClass e) { statements; } try { statements; } catch (ExceptionClass e) { statements; } finally { statements; }
示例:
package com.sitech.crmpd.core.codegen;
import java.sql.DatabaseMetaData; import java.sql.ResultSet;
import com.sitech.crmpd.core.config.Config; import com.sitech.crmpd.core.jdbc.ConnectionFactory;
2.文件体系结构规则
2.2 源文件结构规则
规则2.2.3 类变量的声明顺序是 public,protected,package,private 公共变量(Public) 保护变量(Protected) 包一级别的变量(没有访问修饰符) 私有变量(Private)
2.文件体系结构规则
5.注释规则
规则5.1.2 如果对文件进行了修改,必须说明修改目的、修改日期、修改 人,并变更版本信息 示例:

java 编码规范

java 编码规范

java 编码规范《Java编码规范》1. 代码风格- 代码缩进:使用4个空格进行缩进,不使用制表符。

- 行长限制:每行代码不超过80个字符,超出则进行换行。

- 行尾空格:行尾不留空格。

- 行尾注释:行尾注释与代码之间至少保留2个空格的距离。

- 命名规范:使用驼峰命名法,类名首字母大写,变量和方法名首字母小写。

- 常量命名:常量使用全大写字母,并用下划线分隔单词。

- 空行:类与方法之间保留一个空行,方法内逻辑块之间保留一个空行。

2. 注释规范- 文件注释:每个源文件的头部必须包含文件注释,说明该文件的作者、日期等信息。

- 类注释:每个类的头部必须包含类注释,描述该类的作用、用法等。

- 方法注释:每个方法必须包含方法注释,描述该方法的功能、参数、返回值等。

- 代码注释:在代码中需要加入注释说明的地方,添加合理的注释来增加代码可读性。

3. 包和导入规范- 包名规范:包名全部小写,多个包名之间用英文句点"."分隔,采用反域名形式命名。

- 导入规范:不要使用通配符"*"导入整个包,应明确导入所需的类。

4. 类和接口规范- 类结构顺序:依次按照成员变量、构造方法、普通方法的顺序来编写类的结构。

- 成员变量声明:先声明公有的静态常量,再声明私有的静态变量,接着声明私有的实例变量。

- 构造方法:在类的开头部分声明构造方法,按照方法名和参数顺序进行编写。

- 方法和变量:局部变量应放在使用的最近位置上,避免声明太早或太迟,增加代码的可读性。

5. 异常处理规范- 异常的捕获和处理:在可能发生异常的地方进行捕获和处理,而不是简单地将异常抛出给上层调用者。

- 不要捕获并忽略异常:捕获异常后应该进行适当的处理,而不是简单地将异常信息打印出来或者忽略它们。

6. 标准化代码结构- 采用分层结构:将代码按照功能、模块进行划分,每个模块或类负责一部分功能。

- 逻辑清晰:保持代码逻辑清晰,避免重复、冗余的代码,使用合适的设计模式来优化代码结构。

Java编码规范

Java编码规范

Java编码规范目录目录 (2)1.编码规范的重要性 (3)2. Java源文件结构 (3)2.1开头注释 (3)2.2 包和引入 (3)3. 缩进排版 (4)3.1 缩进长度 (4)3.2 行长度 (4)3.3 换行 (4)3.4 方法声明缩进 (4)3.5 if语句换行 (5)3.6三元运算表达式缩进 (5)4. 注释 (5)4.1 有效的注释 (5)4.2 注释的方式 (6)4.3 实现注释的使用 (6)5. 空白 (6)5.1 空行 (6)5.2 空格 (7)6. 命名规范 (7)6.1包名 (7)6.2类名和接口名 (8)6.3方法名 (8)6.4存取性方法名 (8)6.5属性名 (8)6.6变量名 (8)6.7一些建议 (9)7. 声明 (9)8. 表达式与语句 (9)9. 类和接口 (9)10.编程习惯 (10)1.编码规范的重要性*编码规范可以改善软件的可读性,可以让程序员尽快理解新代码。

*几乎没有任何一个软件,在其整个生命同期中,均由最初的开发人员来维护。

*一个合格的软件,生命周期中80%的花费在于维护。

2. Java源文件结构2.1开头注释所有的源文件都应该在开头有一个C语言风格的注释,其中列出类名、版本信息,创建日期和版权声明:/ **类名**版本信息**创建日期**版权声明* /2.2 包和引入先写包语句,再写引入语句。

package行和import行之间留一行空行。

引入的标准包名要在本地包名之前,并且包名按照字母顺序排列。

如果import 行中包含了同一个包中的类超过5个,则用* 来处理。

import的标准包和本地包之间留一行空行。

示例:package mon;import java.io.*;import java.sql.DatabaseMetaData;import java.sql.ResultSet;import com.xinma.plan.BaseDao;import com.xinma.plan.dao.SysEquipmentDao;3. 缩进排版3.1 缩进长度缩进一般采用4个空格。

Java 语言编码规范

Java 语言编码规范

Java语言编码规范目录一、规范简介 (1)1目的 (1)2范围 (1)3参考文档 (1)4说明 (1)二、 JAVA编码规范 (1)2缩进排版(I NDENTATION) (2)2.1 行长度(Line Length) (2)3注释(C OMMENTS) (2)4声明(D ECLARATIONS) (3)4.1 每行声明变量的数量(Number Per Line) (3)4.2 初始化(Initialization) (3)5空白(W HITE S PACE) (3)5.1 空行(Blank Lines) (3)5.2 空格(Blank Spaces) (4)6命名规范(N AMING C ONVENTIONS) (4)7性能考虑 (5)7.1 使用 StringBuffer 对象 (5)7.2 可移植性 (5)7.3 换行 (5)7.4 PrintStream (6)三、JSP编码规范 (6)四、SERVLET编码规范 (7)五、JSP和SERVLET编程注意事项 (7)六、代码范例(CODE EXAMPLES) (7)一、规范简介1 目的制订本规范的目的是为培养规范设计和编程,养成良好的习惯,增强JAVA类软件产品的稳定、健壮、可靠性;同时也为提高软件的可读性,可以让程序员尽快而彻底地理解新的代码,使产品可维护性提高而制定的强制性规范,同时也是代码复审的依据。

2 范围本规范适用于公司JAVA类代码(包括JSP)的代码编写标准。

适用于代码编写阶段和代码维护阶段。

3 参考文档《SUN JAVA代码编写规范》。

4 说明本文档包括java编码规范,jsp编码规范,servlet编码规范。

struts代码规范请参阅《struts编码规范.doc》。

二、java编码规范1.1.1 开头注释(Beginning Comments)所有的源文件都应该在开头有一个Java语言风格的注释,其中列出标题、描述、日期和版权声明:/*** <p>Title: 标题</p>* <p>Description: 描述</p>* <p>Copyright: Copyright (c) 2007</p>* <p>Company:华胜天成</p>* @author: 张三* @version 1.0*/1.1.2 包和引入语句(Package and Import Statements)在多数Java源文件中,第一个非注释行是包语句。

JAVA最全的编码规范

JAVA最全的编码规范

JAVA最全的编码规范(1) 类名首字母应该大写。

字段、方法以及对象(句柄)的首字母应小写。

对于所有标识符,其中包含的所有单词都应紧靠在一起,而且大写中间单词的首字母。

例如:ThisIsAClassNamethisIsMethodOrFieldName若在定义中出现了常数初始化字符,则大写static final基本类型标识符中的所有字母。

这样便可标志出它们属于编译期的常数。

Java包(Package)属于一种特殊情况:它们全都是小写字母,即便中间的单词亦是如此。

对于域名扩展名称,如com,org,net或者edu等,全部都应小写(这也是Java 1.1和Java 1.2的区别之一)。

(2) 为了常规用途而创建一个类时,请采取"经典形式",并包含对下述元素的定义:equals()hashCode()toString()clone()(implement Cloneable)implement Serializable(3) 对于自己创建的每一个类,都考虑置入一个main(),其中包含了用于测试那个类的代码。

为使用一个项目中的类,我们没必要删除测试代码。

若进行了任何形式的改动,可方便地返回测试。

这些代码也可作为如何使用类的一个示例使用。

(4) 应将方法设计成简要的、功能性单元,用它描述和实现一个不连续的类接口部分。

理想情况下,方法应简明扼要。

若长度很大,可考虑通过某种方式将其分割成较短的几个方法。

这样做也便于类内代码的重复使用(有些时候,方法必须非常大,但它们仍应只做同样的一件事情)。

(5) 设计一个类时,请设身处地为客户程序员考虑一下(类的使用方法应该是非常明确的)。

然后,再设身处地为管理代码的人考虑一下(预计有可能进行哪些形式的修改,想想用什么方法可把它们变得更简单)。

(6) 使类尽可能短小精悍,而且只解决一个特定的问题。

下面是对类设计的一些建议:一个复杂的开关语句:考虑采用"多形"机制数量众多的方法涉及到类型差别极大的操作:考虑用几个类来分别实现许多成员变量在特征上有很大的差别:考虑使用几个类(7) 让一切东西都尽可能地"私有"--private。

java编码规则

java编码规则

Java编码规则是指在编写Java代码时应该遵循的一些规范和约定。

这些规则可以帮助开发者提高代码的可读性、可维护性和可扩展性。

以下是一些常见的Java编码规则:
1. 命名规范:类名使用大写字母开头的驼峰式命名法,方法名和变量名使用小写字母开头的驼峰式命名法。

2. 缩进规范:每个缩进级别使用4个空格,而不是制表符,这样可以避免在不同的编辑器中出现不同的缩进距离。

3. 注释规范:每个类和方法都应该有文档注释,说明它们的作用、参数、返回值和异常等信息。

同时,对于复杂的代码块也应该添加注释。

4. 包命名规范:包名应该全部使用小写字母,并且应该基于域名反转命名。

例如,com.example.app。

5. 文件命名规范:类文件应该与类名相同,并使用驼峰式命名法。

例如,MyClass.java。

6. 代码风格规范:代码应该按照一定的风格排列,例如在每个方法之间应该有空行,在每个语句结束时应该使用分号,在括号周围不应该有空格等。

7. 异常处理规范:对于可能抛出异常的代码块,应该使用try-catch语句或者声明抛出异常。

同时,应该在捕获异常时至少打印异常信息。

8. 安全性规范:应该避免使用不安全的函数,例如eval()和exec()
等,应该使用安全的函数或者自己实现安全策略。

9. 性能规范:应该尽可能地优化代码,例如避免使用不必要的对象、减少方法调用次数等。

以上是一些常见的Java编码规则,当然还有很多其他的规则可以根据需要进行补充和完善。

java编码规范

java编码规范

java编码规范Java编码规范是为了提高代码的可读性、可维护性和可重用性而制定的规范。

本文将向您介绍一些常见的Java编码规范,以帮助您编写高质量的Java代码。

1. 命名规范- 类名使用大写开头的驼峰命名法,例如`MyClass`。

- 方法名使用小写开头的驼峰命名法,例如`myMethod`。

- 变量名使用小写的驼峰命名法,例如`myVariable`。

- 常量名使用全大写并用下划线分隔单词,例如`MAX_SIZE`。

- 包名使用全小写并用点分隔单词,例如`com.example.myapp`。

2. 注释规范- 类、方法和变量前应添加注释,说明其作用和用法。

- 可以使用`//`进行行注释,例如:`// This is a comment`。

- 可以使用`/* */`进行块注释,例如:```/** This is a block comment* It can span multiple lines*/```- 每个文件应包含版权信息和作者信息的注释。

3. 缩进规范- 使用4个空格进行缩进,不使用制表符。

- 每个代码块应该有一个缩进级别。

4. 括号规范- 左括号应该在语句或声明的同一行,并在后面加上一个空格。

- 右括号应该独占一行。

```if (condition) {// code here}```5. 空格规范- 在二元运算符之间、逗号之后和分号之后应添加一个空格。

- 在关键字和左括号之间、左括号和参数之间、方法名和左括号之间不应有空格。

6. 异常处理规范- 在可能引发异常的代码周围使用`try-catch`块来处理异常。

- 在`catch`块中处理异常,不要简单地打印异常信息。

- 在方法声明中使用`throws`关键字指定可能抛出的异常。

7. 包规范- 包名应该反映代码的层次结构和功能。

- 不要使用Java的保留关键字作为包名。

8. 导入规范- 不要使用通配符导入,应该明确导入需要使用的类。

Java编码规范

Java编码规范

文档版本:1.0编码规范1、排版规范1- 1:程序块要采用缩进风格编写,缩进的空格数为4个。

说明:对于由开发工具自动生成的代码可以有不一致。

1- 2:相对独立的程序块之间、变量说明之后必须加空行。

示例:如下例子不符合规范。

if (!valid_ni(ni)){... // program code}repssn_ind = ssn_data[index].repssn_index;repssn_ni = ssn_data[index].ni;应该改进为如下书写方法:if (!valid_ni(ni)){... // program code}repssn_ind = ssn_data[index].repssn_index;repssn_ni = ssn_data[index].ni;1- 3:较长的语句(>80字符)要分成多行书写,长表达式要在低优先级操作符处划分新行,操作符放在新行之首,划分出的新行要进行适当的缩进,使排版整齐,语句可读。

1- 4:循环、判断等语句中若有较长的表达式或语句,则要进行适应的划分,长表达式要在低优先级操作符处划分新行,操作符放在新行之首。

示例:if ((taskno < max_act_task_number)&& (n7stat_stat_item_valid (stat_item))){... // program code}1- 5:若方法或过程中的参数较长,则要进行适当的划分。

1- 6:不允许把多个短语句写在一行中,即一行只写一条语句。

示例:如下例子不符合规范。

rect.length = 0; rect.width = 0;应如下书写rect.length = 0;rect.width = 0;1- 7:if、for、do、while、case、switch、default等语句自占一行,且if、for、do、while等语句的执行语句部分无论多少都要加括号{}。

JAVA编码规范

JAVA编码规范

Java编码规范一、命名规范1. 类名首字母应该大写。

属性(成员变量)、方法、对象变量以及所有标识符(如形式参数、实际参数、局部变量)的首字母应小写,其中包含的所有单词都应紧靠在一起,而且大写中间单词的首字母。

例如:类名:ThisIsAClassName 属性或方法名:thisIsMethodOrFieldName对象变量:thisIsAClassVariable2. Java 包(Package)属于一种特殊情况,它们全都是小写字母,即便中间的单词亦是如此。

对于全局包,将你的Internet 域名反转并接上包名,例如:pany.package另外,package 行要在import 行之前,import 中标准的包名要在本地的包名之前,而且按照字母顺序排列。

如果import 行中包含了同一个包中的不同子目录,则应该用* 来处理。

例如package .stats;import java.io.*;import java.util.Observable;import hotlava.util.Application;这里java.io.* 是用来代替InputStream and OutputStream 的。

3. 接口(Interface):采用完整的英文描述符说明接口封装,所有单词的第一个字母大写。

习惯上,名字后面加上后缀able,ible 或者er。

例如:Contactable,Prompter。

4. 组件(Component)使用完整的英文描述来说明组件的用途,末端应接上组件类型。

例如:okButton,customerList,fileMenu。

5. 类中常用方法的命名:类的获取方法(一般具有返回值)一般要求被方法名使用被访问字段名,前面加上前缀get,如getFirstName(), getLastName()。

类的布尔型的判断方法一般要求方法名使用单词is 做前缀,如isPersistent(),isString()。

相关主题
  1. 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
  2. 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
  3. 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。

代码规范前言本文档基本遵循Sun's Coding Conventions,补充了其中没有说明或者有所改动的地方。

规范等级说明∙级别I: 默认级别,要求所有项目中的所有成员遵守。

∙级别II: 建议所有项目中的所有成员遵守。

∙级别III: 鼓励各个项目根据实际情况执行。

1.1 缩进4个空格常被作为缩进排版的一个单位。

代码中不允许使用Tab(建议在IDE将Tab设置为4个空格)。

1.2 换行每行120字符--因为已是1024*768的年代。

1.3 命名规则∙不允许使用汉语拼音命名∙遇到缩写如XML时,仅首字母大写,即loadXmlDocument()而不是loadXMLDocument() ∙Package名必须全部小写,尽量使用单个单词∙Interface名可以是一个名词或形容词(加上'able','ible', or 'er'后缀),如Runnable,Accessible。

为了基于接口编程,不采用首字母为I或加上IF后缀的命名方式,如IBookDao,BookDaoIF。

∙局部变量及输入参数不要与类成员变量同名(get/set方法与构造函数除外)1.4 声明∙修饰符应该按照如下顺序排列:public, protected, private, abstract, static, final, transient, volatile, synchronized, native, strictfp。

∙类与接口的声明顺序(可用Eclipse的source->sort members功能自动排列):1.静态成员变量/ Static Fields2.静态初始化块/ Static Initializers3.成员变量/ Fields4.初始化块/ Initializers5.构造器/ Constructors6.静态成员方法/ Static Methods7.成员方法/ Methods8.重载自Object的方法如toString(), hashCode() 和main方法9.类型(内部类) / Types(Inner Classes)同等的类型,按public, protected, private的顺序排列。

2.1 注释类型2.1.1 JavaDoc注释略。

2.1.2 失效代码注释由/*...*/界定,标准的C-Style的注释。

专用于注释已失效的代码。

/** Comment out the code* String s = "hello";* System.out.println(s);*/2.1.3 代码细节注释由//界定,专用于注释代码细节,即使有多行注释也仍然使用//,以便与用/**/注释的失效代码分开除了私有变量外,不推荐使用行末注释。

class MyClass {private int myField; // An end-line comment.public void myMethod {//a very very long//comment.if (condition1) {//condition1 comment...} else {//elses condition comment...}}}2.2 注释的格式∙注释中的第一个句子要以(英文)句号、问号或者感叹号结束。

Javadoc生成工具会将注释中的第一个句子放在方法汇总表和索引中。

∙为了在JavaDoc和IDE中能快速链接跳转到相关联的类与方法,尽量多的使用@see xxx.MyClass,@see xx.MyClass#find(String)。

∙Class必须以@author 作者名声明作者,不需要声明@version与@date,由版本管理系统保留此信息。

(II)∙如果注释中有超过一个段落,用<p>分隔。

(II)∙示例代码以<pre></pre>包裹。

(II)∙标识(java keyword, class/method/field/argument名,Constants) 以<code></code>包裹。

(II)∙标识在第一次出现时以{@linkxxx.Myclass}注解以便J avaDoc与IDE中可以链接。

(II) 2.3 注释的内容2.3.1 可精简的注释内容注释中的每一个单词都要有其不可缺少的意义,注释里不写"@param name -名字"这样的废话。

如果该注释是废话,连同标签删掉它,而不是自动生成一堆空的标签,如空的@param nam e,空的@return。

2.3.2 推荐的注释内容∙对于API函数如果存在契约,必须写明它的前置条件(precondition),后置条件(postcondition),及不变式(invariant)。

(II)∙对于调用复杂的API尽量提供代码示例。

(II)∙对于已知的Bug需要声明。

(II)∙在本函数中抛出的unchecked exception尽量用@throws说明。

(II)2.3.3 Null规约如果方法允许Null作为参数,或者允许返回值为Null,必须在JavaDoc中说明。

如果没有说明,方法的调用者不允许使用Null作为参数,并认为返回值是Null Safe的。

/*** 获取对象.** @ return the object to found or null if not found.*/Object get(Integer id){...}2.3.4 特殊代码注释∙代码质量不好但能正常运行,或者还没有实现的代码用//TODO: 或//XXX:声明∙存在错误隐患的代码用//FIXME:声明3.1基本规范1.当面对不可知的调用者时,方法需要对输入参数进行校验,如不符合抛出IllegalArgumentException,建议使用Spring的Assert系列函数。

2.隐藏工具类的构造器,确保只有static方法和变量的类不能被构造实例。

3.变量,参数和返回值定义尽量基于接口而不是具体实现类,如Map map = new HashMap();4.代码中不能使用System.out.println(),e.printStackTrace(),必须使用logger打印信息。

3.2 异常处理1.重新抛出的异常必须保留原来的异常,即throw new NewException("message", e); 而不能写成throw new NewException("message")。

2.在所有异常被捕获且没有重新抛出的地方必须写日志。

3.如果属于正常异常的空异常处理块必须注释说明原因,否则不允许空的catch块。

4.框架尽量捕获低级异常,并封装成高级异常重新抛出,隐藏低级异常的细节。

(III)3.3 代码度量3.3.1 耦合度度量∙DAC度量值不要不大于7 ( III )解释:DAC(Data Abstraction Coupling)数据抽象耦合度是描述对象之间的耦合度的一种代码度量。

DAC度量值表示一个类中有实例化的其它类的个数。

∙CFO度量值不要不大于20 ( III )解释:CFO(Class Fan Out)类扇出是描述类之间的耦合度的一种代码度量。

CFO度量值表示一个类依赖的其他类的个数。

3.3.2 方法度量∙方法(构造器)参数在5个以内( II )太多的方法(构造器)参数影响代码可读性。

考虑用值对象代替这些参数或重新设计。

∙方法长度150行以内( II )∙CC 度量值不大于10(III )解释:CC(CyclomaticComplexity)圈复杂度指一个方法的独立路径的数量,可以用一个方法内if,while,do,for,catch,switch,case,?:语句与&&,||操作符的总个数来度量。

∙NPath度量值不大于200 ( III )解释:NPath度量值表示一个方法内可能的执行路径的条数。

3.3.3 其他度量∙布尔表达式中的布尔运算符(&&,||)的个数不超过3个(III)∙if语句的嵌套层数3层以内(II)∙文件长度2000行以内(II)∙匿名内部类20行以内( II )太长的匿名内部类影响代码可读性,建议重构为命名的(普通)内部类。

3.4 JDK5.01.不需要关心的warning信息用@SuppressWarnings("unused"),@SuppressWarnings("unchecked"), @SuppressWarnings("serial") 注释。

使用Eclipse的代码校验功能已经排除了很多问题。

再配合使用Checkstyle检查,总共二层的校验涵盖了Java编码大部分的Guide Line。

1.Eclipse:在Windows->Preferences->Java-Compiler->Errors/Warnings中,按本文档将一些原来Ignore的规则打开。

2.CheckStyle:安装CheckStyle的Eclipse插件,在Windows->Preferences->CheckStyle导入_checks_eclipse.xml的规则。

1.Sun's Coding Conventions Sun MicroSystem;2.The Elements of Java Style Scott W. Ambler 等著;3.代码检测工具的规则:checkstyle,。

相关文档
最新文档