Java代码和界面规范

2022-05-20 04:36:15   文档大全网     [ 字体: ] [ 阅读: ]

#文档大全网# 导语】以下是®文档大全网的小编为您整理的《Java代码和界面规范》,欢迎阅读!
界面,规范,代码,Java
Java代码和界面规范

一、目的 1、为了统一公司软件开发设计过程的编码规范 2、是网站开发人员能很方便的理解每个项目、变量、控件、类、方法的定义。 3、保证编写出的程序都符合相同的规范,保证一致性、统一性。 4、编码规范和约定必须能明显的改善代码可读性,并有助于代码管理。分类范围适用于企业所有基于java平台的软件开发。 二、规范细节 1.代码规范 1)命名规范 1、一个唯一包名的前缀总是全部小写的ASCII字母。 2、类名是一个名词,采用大小写混合的方式,每个单词的首写字母大写。 3、接口的大小写规则与类名相似。 4、方法名是一个动词,采用大小写混合的方式,第一个单词的首写字母小写,其后单词的首写字母大写。 5、变量名不应以下划线或美元符号开头,变量名应简短而且富于描述,应该易于记忆,避免单个字符的变量名,除非是一次性使用的临时变量,第一个单词的首写字母小写。 6、常量的声明,应该全部大写。 2)注释规范 1、所有的源文件都应该在开头有一个注释,其中列出文件名、日期和类的功能概述。 2、每个方法必须添加文档注释(类的mian()方法除外) 3、代码或者实现细节需要15%的注释量。 4、注释使用中文。 3)缩进排版规范 1、避免一行的长度超过60个字符。 2、使用Eclipse的源代码的格式化功能完成代码的缩进和排版。 4)文件名规范

1)一个Java源文件只能存储一个Java类。 2)文件名与Java类名相同。

3)一个类文件的代码行不能超过200行。 5)声明规范

1)一行声明一个变量。

2)不要将不同的类型变量的声明放在同一行。 3)只在代码块的开始处声明变量。

4)避免声明的局部变量覆盖上一级声明的变量。 5)方法与方法之间以空行分隔。 6)语句规范

1)每行至少包含一条简单语句。

2)一个带返回值的return语句不适用小括号“() 3if语句总是用“{”和“}”括起来。

4)当在for语句的初始化或更新子句中使用逗号时,避免因使用3个以上变量而导致复杂度提高。

5)每当switch的一个case顺着往下执行时(因为没有break语句),通常应在break句的位置添加注释。


7)编程规范

1)提供对实例以及类变量的publicprivate访问控制,尽可能不适用默认或protected访问控制。

2)避免用一个对象访问一个类的静态变量和方法,应该用类名代替。 3)避免爱一个语句中给多个变量赋相同的值。

4)如果使用JDBC,考虑使用java.sql.PreparedStatement,而不是java.sql.Statement 2.界面规范 1)原则

1)提供可视反馈。在后台运行长进程时(时间超过10s,视具体情况而定),必须提供进度条等信息提示。

(2)保持界面能很快对用户操作做出反应。 (3)提供快捷键。

(4)界面应该很简单(不是过分单纯化),易于学习,并且易于使用。 (5)界面美观,能够吸引用户。 (6)对同一控件的规范要求应一致。 2)命令行程序运行界面规范 (1)背景为白色,前景为黑色。 (2)字体为宋体24 3)安全性规范

3次输入错误的验证信息后,应该禁用该用户的账户或暂时禁用。 4)界面风格

(1)用户界面控件看起来应该是一致的。 (2)将重要信息放在上面或左边。

(3)使用做对齐来使用户界面控件更易于浏览。

(4)不同界面中的同一功能应该使用同样的图标和图片。图标、图片的色调、风格尽量保持一致。

(5)截屏使用JPEG格式,1024*768*32位色彩。 (6)使用统一的CSS 5)界面控件规范

1总结列表框提供一个标签,必须用标签来表明列表框的用途。 2)使列表框至少5行长,少于5行的列表没有滑块,不便于滚动。 3)将静态文本标签置于相关控件的左边,而不是上面。

4)左对齐静态文本标签,左对齐使得标签外观更有条理,而其易于浏览。

5)避免不好的背景,将文本放在实的、颜色适中的背景上,确保在文本和背景之间存在良好的对比。

6)采用日期和时间拾取控件进行日期输入。 6)字体规范

字体统一使用以下设置:字符集GBK,宋体 7)界面展示规范

1)数据按照类别显示时,每页数据不能超过10行。

2)数据按照列表显示时,第一列为选择控件,其次为数据信息,最后为操作按钮。 8)界面操作规范

1)对输入控件,如果没有输入,应该给出提示的消息框。 2)对输入控件,应给出相应的必填的提示标签。


三、规范代码样列

/**

* s1java.HelloAccp.java * 2007-5-8 * 第一个Java程序 */

package s1java;

public class HelloAccp {

private int classVar1; //存储静态数量 private Object classVar2; //课程 private int instanceVar2; //学生数目 private final int CONSTNUM=5;//存入CVS /**

* @param args

* String[]命令行参数 */

public static void main(String[] args){ //输出对象的描述

System.out.println(new HelloAccp()); } /** *

* return String 类实例的描述字符串 */

public String toString(){ //返回一个描述的字符串 return "Hello Accp 5.0!"; } /**

* @return 返回 calssVar1 */

public int getClassVar1(){ return calssVar1; } /**

* @param classVar1 * 要设置的 classVar1 */

public void setClassVar1(int classVar1){ this.classVar1=classVar1; } }


本文来源:https://www.wddqxz.cn/0c910aa1f524ccbff1218495.html

相关推荐