「java编程规范doc」java编程规范pdf

admin 2023-03-20 11:55:09 501

今天给各位分享java编程规范doc的知识，其中也会对java编程规范pdf进行解释，如果能碰巧解决你现在面临的问题，别忘了关注本站，现在开始吧！

本文目录一览：

1、java合法标识符的三点要求
2、java编程规范！！！
3、介绍下Java程序的结构
4、北大青鸟java培训：Java编程开发规范及其技巧？
5、Java建包命名规范
6、推荐几本javaEE的书籍,经典的。不要李刚的（虽然讲的好，但是繁琐，基础东西太多了）。结合了三大框架的

java合法标识符的三点要求

Java标识符的命名规则：

1）标识符由字母、数字、下划线“_”、美元符号“$”或者人民币符号“￥”组成，并且首字母不能是数字。

2）不能把关键字和保留字作为标识符。

3）标识符没有长度限制。

4）标识符对大小写敏感。Java编程规范：1）类名和接口名：首字母大写，其余字母小写。如SamDoc

2）方法名和变量名：首字母小写，其余的字母大写。

如bothEyesOfDoll。

3）包名：字母全部小写。如，com.abc.dollapp。

4）常量名：采用大写形式，单词之间以下划线“_”隔开。

java编程规范！！！

JAVA代码规范：(1) 类名首字母应该大写。字段、方法以及对象（句柄）的首字母应小写。对于所有标识符，其中包含的所有单词都应紧靠在一起，而且大写中间单词的首字母。例如：

ThisIsAClassName

thisIsMethodOrFieldName

若在定义中出现了常数初始化字符，则大写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。可使库的某一部分"公共化"（一个方法、类或者一个字段等等），就永远不能把它拿出。若强行拿出，就可能破坏其他人现有的代码，使他们不得不重新编写和设计。若只公布自己必须公布的，就可放心大胆地改变其他任何东西。在多线程环境中，隐私是特别重要的一个因素--只有private字段才能在非同步使用的情况下受到保护。 (8) 谨惕"巨大对象综合症"。对一些习惯于顺序编程思维、且初涉OOP领域的新手，往往喜欢先写一个顺序执行的程序，再把它嵌入一个或两个巨大的对象里。根据编程原理，对象表达的应该是应用程序的概念，而非应用程序本身。 (9) 若不得已进行一些不太雅观的编程，至少应该把那些代码置于一个类的内部。 (10) 任何时候只要发现类与类之间结合得非常紧密，就需要考虑是否采用内部类，从而改善编码及维护工作（参见第14章14.1.2小节的"用内部类改进代码"）。 (11) 尽可能细致地加上注释，并用javadoc注释文档语法生成自己的程序文档。 (12) 避免使用"魔术数字"，这些数字很难与代码很好地配合。如以后需要修改它，无疑会成为一场噩梦，因为根本不知道"100"到底是指"数组大小"还是"其他全然不同的东西"。所以，我们应创建一个常数，并为其使用具有说服力的描述性名称，并在整个程序中都采用常数标识符。这样可使程序更易理解以及更易维护。 (13) 涉及构建器和异常的时候，通常希望重新丢弃在构建器中捕获的任何异常--如果它造成了那个对象的创建失败。这样一来，调用者就不会以为那个对象已正确地创建，从而盲目地继续。 (14) 当客户程序员用完对象以后，若你的类要求进行任何清除工作，可考虑将清除代码置于一个良好定义的方法里，采用类似于cleanup()这样的名字，明确表明自己的用途。除此以外，可在类内放置一个boolean（布尔）标记，指出对象是否已被清除。在类的finalize()方法里，请确定对象已被清除，并已丢弃了从RuntimeException继承的一个类（如果还没有的话），从而指出一个编程错误。在采取象这样的方案之前，请确定finalize()能够在自己的系统中工作（可能需要调用System.runFinalizersOnExit(true)，从而确保这一行为）。 (15) 在一个特定的作用域内，若一个对象必须清除（非由垃圾收集机制处理），请采用下述方法：初始化对象；若成功，则立即进入一个含有finally从句的try块，开始清除工作。 (16) 若在初始化过程中需要覆盖（取消）finalize()，请记住调用super.finalize()（若Object属于我们的直接超类，则无此必要）。在对finalize()进行覆盖的过程中，对super.finalize()的调用应属于最后一个行动，而不应是第一个行动，这样可确保在需要基础类组件的时候它们依然有效。 (17) 创建大小固定的对象集合时，请将它们传输至一个数组（若准备从一个方法里返回这个集合，更应如此操作）。这样一来，我们就可享受到数组在编译期进行类型检查的好处。此外，为使用它们，数组的接收者也许并不需要将对象"造型"到数组里。 (18) 尽量使用interfaces，不要使用abstract类。若已知某样东西准备成为一个基础类，那么第一个选择应是将其变成一个interface（接口）。只有在不得不使用方法定义或者成员变量的时候，才需要将其变成一个abstract（抽象）类。接口主要描述了客户希望做什么事情，而一个类则致力于（或允许）具体的实施细节。 (19) 在构建器内部，只进行那些将对象设为正确状态所需的工作。尽可能地避免调用其他方法，因为那些方法可能被其他人覆盖或取消，从而在构建过程中产生不可预知的结果（参见第7章的详细说明）。 (20) 对象不应只是简单地容纳一些数据；它们的行为也应得到良好的定义。 (21) 在现成类的基础上创建新类时，请首先选择"新建"或"创作"。只有自己的设计要求必须继承时，才应考虑这方面的问题。若在本来允许新建的场合使用了继承，则整个设计会变得没有必要地复杂。 (22) 用继承及方法覆盖来表示行为间的差异，而用字段表示状态间的区别。一个非常极端的例子是通过对不同类的继承来表示颜色，这是绝对应该避免的：应直接使用一个"颜色"字段。 (23) 为避免编程时遇到麻烦，请保证在自己类路径指到的任何地方，每个名字都仅对应一个类。否则，编译器可能先找到同名的另一个类，并报告出错消息。若怀疑自己碰到了类路径问题，请试试在类路径的每一个起点，搜索一下同名的.class文件。 (24) 在Java 1.1 AWT中使用事件"适配器"时，特别容易碰到一个陷阱。若覆盖了某个适配器方法，同时拼写方法没有特别讲究，最后的结果就是新添加一个方法，而不是覆盖现成方法。然而，由于这样做是完全合法的，所以不会从编译器或运行期系统获得任何出错提示--只不过代码的工作就变得不正常了。 (25) 用合理的设计方案消除"伪功能"。也就是说，假若只需要创建类的一个对象，就不要提前限制自己使用应用程序，并加上一条"只生成其中一个"注释。请考虑将其封装成一个"独生子"的形式。若在主程序里有大量散乱的代码，用于创建自己的对象，请考虑采纳一种创造性的方案，将些代码封装起来。 (26) 警惕"分析瘫痪"。请记住，无论如何都要提前了解整个项目的状况，再去考察其中的细节。由于把握了全局，可快速认识自己未知的一些因素，防止在考察细节的时候陷入"死逻辑"中。 (27) 警惕"过早优化"。首先让它运行起来，再考虑变得更快--但只有在自己必须这样做、而且经证实在某部分代码中的确存在一个性能瓶颈的时候，才应进行优化。除非用专门的工具分析瓶颈，否则很有可能是在浪费自己的时间。性能提升的隐含代价是自己的代码变得难于理解，而且难于维护。 (28) 请记住，阅读代码的时间比写代码的时间多得多。思路清晰的设计可获得易于理解的程序，但注释、细致的解释以及一些示例往往具有不可估量的价值。无论对你自己，还是对后来的人，它们都是相当重要的。如对此仍有怀疑，那么请试想自己试图从联机Java文档里找出有用信息时碰到的挫折，这样或许能将你说服。 (29) 如认为自己已进行了良好的分析、设计或者实施，那么请稍微更换一下思维角度。试试邀请一些外来人士--并不一定是专家，但可以是来自本公司其他部门的人。请他们用完全新鲜的眼光考察你的工作，看看是否能找出你一度熟视无睹的问题。采取这种方式，往往能在最适合修改的阶段找出一些关键性的问题，避免产品发行后再解决问题而造成的金钱及精力方面的损失。 (30) 良好的设计能带来最大的回报。简言之，对于一个特定的问题，通常会花较长的时间才能找到一种最恰当的解决方案。但一旦找到了正确的方法，以后的工作就轻松多了，再也不用经历数小时、数天或者数月的痛苦挣扎。我们的努力工作会带来最大的回报（甚至无可估量）。而且由于自己倾注了大量心血，最终获得一个出色的设计方案，成功的快感也是令人心动的。坚持****草草完工的诱惑--那样做往往得不偿失

介绍下Java程序的结构

Java语言是面向对象的程序设计语言，Java程序的基本组成单元是类，类体中又可包括属性与方法两部分。而每一个应用程序都必须包含一个main（）方法，含有main（）方法的类称之为主类。

一： Java程序的主类及其格式

作为一个可以独立运行的Java程序，在它的众多类中必须要有一个类作为程序的起始类，为了方便，本书把这个类称为主类。当需要执行一个程序时，人们在java命令后面输入的便是这个主类的文件名（也是主类名），因此主类文件是Java运行环境建立起来之后第一个被装入虚拟机的用户文件。为了使虚拟机可以找到程序运行的起始入口，主类必须为public类，并含有一个在格式上符合约定的入口方法main（），其格式如下：

public static void main（String[] args）{

…

}

其中各参数含义如下。

main:入口方法名称。

args:命令行参数，这是一个String对象数组。

static:修饰字，说明main（）是一个静态方法（类方法）。

public:修饰字，说明main（）具有公有访问属性。

于是，主类框架的源代码如下：

public class 主类名{

…

public static void main（String[] args）{

…

}

Java程序的主类常常使熟悉C/C++的读者感到迷惑：main（）方法不就相当于C/C++程序中的主函数吗，为什么非得把它放到一个类里，难道它有什么不同吗？

没错，Java类中main（）方法就相当于C/C++程序中的主函数，是一个入口函数。之所以把它封装到一个类里，而不像C/C++那样单独作为一个函数来处理，就本书作者的理解，大概Java的设计者们有如下几个方面的考虑。

1）Java既然把所有事物都看成了对象，那么就没有理由不把程序也看成对象，因为程序也是一种事物。既然是对象，那么它就应该属于某个类并以程序名来命名。既然程序是一种类，那么main（）就应该是这个类的一个方法，只不过它有些特殊，它是一个入口方法，并且对它有些特殊规定，例如其名称必须为main（），必须是公有静态方法，有命令行参数等。

2）如果把程序封装成了类，那么包括本程序在内的任何程序就都可以根据需要，随时创建这个类的对象，并通过该对象使用这个类中的资源，这样就便于资源共享，从而提高程序的灵活性。

3）Java程序是一种以类为基本单位的模块化程序，程序被编译后，每一个类会对应生成一个二进制字节码类文件。如果把程序也封装成类，那么它的文件就与其他类文件统一起来，而不会产生其他类型的文件，因而便于管理。

4）之所以把入口方法封装到类中，其根本目的就是要尽可能平等地看待所有的类。因为Java的最终目的是要以类为基本模块来实现可装配软件，如果把main（）方法封装到了一个类中，那么就意味着main（）与类的其他方法没什么本质区别，只不过是分工不同而已。下面很快就会看到，Java的所有类都可以含有一个入口方法而成为主类。也就是说，在Java程序中根本就没有主类、次类之分，这里之所以把带有main（）方法的类称为主类，是为了表达方便。

二： JAVA源程序在命令行下的运行

class Bank{

public void init（）{

System.out.println（"Yes,I can"）；

}

public static void main（String args[]）{

BankAccount ba1 = new BankAccount（100.00）；

System.out.print（"Before transactions, "）；

ba1.display（）；

ba1.deposit（74.35）；

ba1.withdraw（20.00）；

System.out.print（"After transactions, "）；

ba1.display（）；

Bank b = new Bank（）；

b.init（）；

}

class BankAccount{

private double balance;

public BankAccount（double openingBalance）{

balance = openingBalance;

}

public void deposit（double amount）{

balance += amount;

}

public void withdraw（double amount）{

balance -= amount;

}

public void display（）{

System.out.println（"balance = " + balance）；

}

三：完整的java源程序应该包括下列部分

package语句；

import语句；

public classDefinition; // 公共的类定义部分，至多只有一个公共类的定义

// java语言规定该java源程序的文件名必须与该公共类名完全一致

classDefinition; // 类定义部分，可以有0个或多个

interfaceDefinition; // 接口定义部分，可以有0个或多个

package:java编译器为每个类生成一个字节码文件，且文件名与类名相同，这就会带来一个问题：同名的类会发生冲突。package便可管理类命名空间。

一般地，具有相同功能的类放在一个package中。

一个java源程序至多只能有一个公共类的定义。

若java源程序有一个公共类的定义，则该源文件名字必须与该公共类的名字完全相同。

若源程序中不包含公共类的定义，则该文件名可以任意取名。

若一个源程序中有多个类定义，则在编译时将为每个类生成一个。class文件。

三。java编程规范

包名：全小写的名词，中间可由点分割，eg:java.awt.event

类名：首字母大写，多个单词合成，每个单词首字母也要大写，eg: class HelloWorldApp

接口名：同类名，eg: interface Collection

方法名：由多个单词合成，第一个单词通常为动词，首字母小写，中间的每个单词的首字母都要大写，eg: balanceAccount, isButtonPressed

变量名：全小写，一般为名词，eg: length

常量名：基本数据类型的常量名为全大写，如果由多个单词构成，可以用下划线隔开，eg: int YEAR, int WEEK_OF_MONTH

对象类型的常量，则是小写混合，由大写字母把单词隔开

北大青鸟java培训：Java编程开发规范及其技巧？

在用Java进行开发前，一定要牢牢遵守Java的开发规范，只有这样你的Java开发之路才能更加顺畅。

而掌握相应的Java开发技巧，则可以让你工作起来事半功倍。

那在编写代码时有什么开发规范和技巧呢？电脑培训给你详细介绍一下吧。

1、代码编写规范：代码编写遵守Java通用开发规范和必联代码开发规范；每个类及方法都要有合理的注释，并且对注释要持续维护；根据接口需求编写单元测试用例，再编写实现类使得单元测试通过，如此循环往复以使得所有的单元测试通过；要求每个Java方法的代码行数不能超过100行；代码编写按照功能划分，一个接口分为多个方法，每一个方法做什么事情，做到思路清晰；接口设计尽量做到多兼容性，方便后期开发。

2、数据库设计及SQL规范不使用MySQL数据库外键约束，通过应用程序逻辑实现关联约束；适当建立索引，经常作为查询条件的字段、唯一性程度高、长度不是很长的、数量不宜太多，一般一个表的索引数目在5个以内；表名长度不能超过30个字符，表名最好选择一个单词，能够准确清晰明了地表示实体含义，若必须多个单词则以下划线“_”分隔，单词所有字母均小写；

Java建包命名规范

java 的包命名规范如下：

包的命名　（全部小写，由域名定义）

Java包的名字都是由小写单词组成。但是由于Java面向对象编程的特性，每一名Java程序员都可以编写属于自己的Java包，为了保障每个Java包命名的唯一性，在最新的Java编程规范中，要求程序员在自己定义的包的名称之前加上唯一的前缀。由于互联网上的域名称是不会重复的，所以程序员一般采用自己在互联网上的域名称作为自己程序包的唯一前缀。

例如：net.frontfree.javagroup

类的命名（单词首字母大写）

根据约定，Java类名通常以大写字母开头，如果类名称由多个单词组成，则每个单词的首字母均应为大写例如TestPage；如果类名称中包含单词缩写，则这个所写词的每个字母均应大写，如：XMLExample,还有一点命名技巧就是由于类是设计用来代表对象的，所以在命名类时应尽量选择名词。

例如： Graphics

方法的命名（首字母小写，字母开头大写）

方法的名字的第一个单词应以小写字母作为开头，后面的单词则用大写字母开头。

例如：drawImage

常量的命名（全部大写，常加下划线）

常量的名字应该都使用大写字母，并且指出该常量完整含义。如果一个常量名称由多个单词组成，则应该用下划线来分割这些单词。

例如：MAX_VALUE