`
taody
  • 浏览: 100594 次
  • 性别: Icon_minigender_2
  • 来自: 北京
社区版块
存档分类
最新评论

《JAVA代码规范》(二)通用代码格式 - 文件组织(2.1)

 
阅读更多

转自:http://www.javadt.com/thread-353-1-1.html


《JAVA代码规范》(二)通用代码格式 - 文件组织(2.1)

 

2       通用代码格式

2.1      文件组织

一个文件由被空行分割而成的段落以及标识每个段落的可选注释共同组成。超过2000行的程序难以阅读,应该尽量避免。

Java源文件必须遵循以下规则:

Ø        文件头部注释

所有的源文件都应该在开头有一个C语言风格的注释,其中列出文件名、作者、公司、日期、描述、修改说明和版权声明:

/*

File:    OrderSessionBean.java

* Author:  ajava.org-苦力工

* Version:  1.1

* Date:    03/08/2008

* Modify:

* Description:

* Copyright notice

*/

 

Ø        包和引入语句

Java源文件中,第一个非注释行是Package语句。Package 行要在 Import 行之前,Import 中标准的包名要在本地的包名之前,而且按照字母顺序排列。例如:

  package java.awt;

  import java.awt.peer.CanvasPeer;

  import java.io.InputStream;

  import cn.edu.cuit.TestApplication;

 

Ø        类和接口声明

下表描述了类和接口声明的各个部分以及它们出现的先后次序

 

序号

/接口声明的各部分

注解

1

/接口文档注释(/**……*/)

该注释中所需包含的信息。

2

类或接口的声明

 

3

/接口实现的注释(/*……*/)如果有必要的话

该注释应包含任何有关整个类或接口的信息,而这些信息又不适合作为类/接口文档注释。

4

类的(静态)变量

首先是类的公共变量,随后是保护变量,再后是包一级别的变量(没有访问修饰符,access modifier),最后是私有变量。

5

实例变量

首先是公共级别的,随后是保护级别的,再后是包一级别的(没有访问修饰符),最后是私有级别的。

6

构造器

 

7

方法

这些方法应该按功能,而非作用域或访问权限,分组。例如,一个私有的类方法可以置于两个公有的实例方法之间。其目的是为了更便于阅读和理解代码。

转载请注明:http://javadt.com
0
1
分享到:
评论

相关推荐

    javacsv-2.1.jar

    CSV文件格式的基本原理是,每一行都是一条记录,由字段组成,字段之间用逗号分隔。在Java中,处理CSV文件通常需要手动分割字符串或使用正则表达式,而JavaCSV库提供了一个更高效、更便捷的方法。该库的核心类包括`...

    javacsv2.1实例

    javacsv库提供了异常处理机制,如`CSVFormatException`,当CSV文件格式不正确时抛出。 7. **性能优化**:虽然javacsv是一个轻量级库,但为了提高性能,可以考虑缓存读取的行,避免频繁的文件I/O操作。另外,对于...

    Google Java 编程规范(中文版).pdf

    通过遵循Google Java编程规范,开发人员可以编写出更加规范、一致且易于维护的代码。这些规范不仅涵盖了编码格式和样式方面的要求,还涉及到了一些最佳实践和约定,这对于构建高质量的软件系统至关重要。

    JAVA代码编写规范.pdf

    "JAVA代码编写规范.pdf" 本文档主要介绍了 Java 代码编写规范的重要性、基本概念、注释规范等方面的内容。 1. 引言 Java 代码编写规范的目的在于确保代码的可读性、维护性和可靠性。该规范适用于方正春元科技发展...

    Java代码书写规范

    ### Java代码书写规范知识点解析 #### 一、符号命名规则 ...以上是对给定文件中“Java代码书写规范”的知识点详细解析。通过这些规则,可以显著提高代码的可读性和维护性,使代码更加规范、专业。

    Java代码规范

    ### Java代码规范详解 #### 一、概述 本篇文章旨在详细介绍一份个人整理的Java代码规范,这份规范结合了Google的编码规范以及作者所在公司的特定需求。尽管这份文档提供了较为全面的指导原则,但它并不是强制性的...

    java代码书写规范

    ### Java代码书写规范 #### 一、通用规范 ##### 1.1 命名规范 1. **使用全单词表示**:为了提高代码的可读性和易理解性,建议使用完整的单词而非缩写词来命名变量、方法等。例如,使用`firstName`而非`fn`。 2. *...

    java编码规范.pdf

    ### Java编码规范详解 #### 1. 源文件规范 **1.1 文件名** - **规则**:源文件名必须与它所包含的顶级类名完全一致,包括大小写,并且文件扩展名为`...遵循这些规范可以帮助开发团队编写出高质量、可维护的Java代码。

    JAVA编号规范

    本文档“JAVA编号规范”是针对Java编程语言的一套详细规范指南,主要面向普联软件(济南)有限责任公司的开发人员,旨在帮助他们编写高质量的Java代码。 #### 二、文件命名与组织 **2.1 文件后缀** - **.java**:...

    JAVA编码规范全集

    Java源文件的组织方式对于保持代码的整洁和易于理解至关重要。 ##### 3.1 Java源文件 每个Java源文件应该遵循以下结构: 1. **开头注释**:提供版权信息和文件描述。 2. **包声明**:指定文件所属的包。 3. **...

    北斗串口2.1通信协议(北斗卫星导航系统用户终端通用数据接口).docx

    北斗卫星导航系统用户终端通用数据接口是用于规范北斗系统与终端设备之间通信的重要标准,确保数据的准确、高效传输。该文档主要包含了硬件要求、数据传送方式、数据格式协议等关键内容。 首先,硬件方面,北斗终端...

    c3p0-0.9.2.1连接池jar包

    3. **通用工具类**:提供了诸如字符串处理、日期时间操作等常用工具类,简化了c3p0的代码实现。 **配置c3p0连接池** 配置c3p0通常涉及到以下步骤: 1. 添加依赖:在项目中引入c3p0和mchange-commons-java的相关...

    java编码规范

    **7.1 程序代码规范** - 分离业务逻辑:将业务逻辑与视图层分离,提高代码的可维护性。 - 数据绑定:确保模型与视图之间的数据正确绑定。 - 错误处理:合理处理页面请求时可能出现的各种错误情况。 **7.2 文件命名...

    Java语言编码规范

    所有开发者在编写Java代码时,均需严格遵守编码规范,即使规范中未明确提及的细节,也应遵循通用的最佳实践,确保代码的一致性和可维护性。 #### 2. 文件名与组织 文件名和组织结构直接影响到代码库的清晰度和查找...

    java 研发规范

    - XML文件: 同Java代码设置。 - JSP页面: 同Java代码设置。 - JS代码: 同Java代码设置。 #### 二、SVN客户端 **2.1 Eclipse集成** - 使用Eclipse自带的SVN插件或第三方插件,如Subclipse等,实现版本控制功能。...

    代码编写规范

    ##### 3.1 Delphi代码规范 - **BEGIN-END配对**:Delphi代码中,BEGIN和END必须正确配对。 - **命名规范**: - 过程和函数命名:采用有意义的动词或动宾短语,首字母大写。 - 变量命名:使用描述性的名词或形容词+...

    Java编码规范

    Java编码规范的基本原则是确保代码的质量与可维护性。在编写代码时,这些原则应被视为指导方针。 **【原则1】** **保持代码的简明清晰,易读易维护,避免过分的编程技巧。** - **解读:** 这条原则强调了代码的简洁...

Global site tag (gtag.js) - Google Analytics