当前位置: 移动技术网 > IT编程>开发语言>Java > 小议Java的源文件的声明规则以及编程风格

小议Java的源文件的声明规则以及编程风格

2019年07月22日  | 移动技术网IT编程  | 我要评论

java源文件的声明规则
当在一个源文件中定义多个类,并且还有import语句和package语句时,要特别注意这些规则:
一个源文件中只能有一个public类。
一个源文件可以有多个非public类。
源文件的名称应该和public类的类名保持一致。例如:源文件中public类的类名是employee,那么源文件应该命名为employee.java。
如果一个类定义在某个包中,那么package语句应该在源文件的首行。
如果源文件包含import语句,那么应该放在package语句和类定义之间。如果没有package语句,那么import语句应该在源文件中最前面。
import语句和package语句对源文件中定义的所有类都有效。在同一源文件中,不能给不同的类不同的包声明。
类有若干种访问级别,并且类也分不同的类型:抽象类和final类等。这些将在后续章节介绍。
除了上面提到的几种类型,java还有一些特殊的类,如内部类、匿名类。
一个简单的例子

在该例子中,我们创建两个类 employee 和 employeetest,分别放在包 p1 和 p2 中。

employee类有四个成员变量,分别是 name、age、designation和salary。该类显式声明了一个构造方法,该方法只有一个参数。

在eclipse中,创建一个包,命名为 p1,在该包中创建一个类,命名为 employee,将下面的代码复制到源文件中:

package p1;
public class employee{
 string name;
 int age;
 string designation;
 double salary;
 // employee 类的构造方法
 public employee(string name){
  this.name = name;
 }
 // 设置age的值
 public void empage(int empage){
  age = empage;
 }
 // 设置designation的值
 public void empdesignation(string empdesig){
  designation = empdesig;
 }
 // 设置salary的值
 public void empsalary(double empsalary){
  salary = empsalary;
 }
 // 输出信息
 public void printemployee(){
  system.out.println("name:"+ name );
  system.out.println("age:" + age );
  system.out.println("designation:" + designation );
  system.out.println("salary:" + salary);
 }
}

程序都是从main方法开始执行。为了能运行这个程序,必须包含main方法并且创建一个对象。

下面给出employeetest类,该类创建两个employee对象,并调用方法设置变量的值。

在eclipse中再创建一个包,命名为 p2,在该包中创建一个类,命名为 employeetest,将下面的代码复制到源文件中:

package p2;
import p1.*;
public class employeetest{
 public static void main(string args[]){
  // 创建两个对象
  employee empone = new employee("james smith");
  employee emptwo = new employee("mary anne");
  // 调用这两个对象的成员方法
  empone.empage(26);
  empone.empdesignation("senior software engineer");
  empone.empsalary(1000);
  empone.printemployee();
  emptwo.empage(21);
  emptwo.empdesignation("software engineer");
  emptwo.empsalary(500);
  emptwo.printemployee();
 }
}

编译并运行 employeetest 类,可以看到如下的输出结果:

name:james smith
age:26
designation:senior software engineer
salary:1000.0
name:mary anne
age:21
designation:software engineer
salary:500.0

强调一下编程风格
代码风格虽然不影响程序的运行,但对程序的可读性却非常重要。自己编写的程序要让别人看懂,首先在排版方面要非常注意。

其实每个人的编程风格、每个软件开发公司的编程风格都不一样。一个人编写的程序代码,就应该能让别人看懂,甚至是过了很长时间,自己也要看的懂,否则这个程序就成了一个死程序。

编程风格是指编程时的格式,让程序看上去就很有层次感。下面通过一些例子,说明编程风格的重要性:

public class math{
 public static void main(string[] args){
  int x=12;
  double y=12.3d;
  void print(){
   char a='a';
   system.out.println(a);
  }
  system.out.println(x+y);
 }
}

上面程序段的整个排版看起来是否很舒服,并且层次感很强?是否一眼看上去就知道整个程序架构?这里的关键在于缩进,缩进也可以称为跳格。

上面的代码采用的缩进:"public class math" 是顶格的,接着 mian() 方法缩进 4 个空格,在 mian() 方法里面的代码一律缩进 8 个空格,而 print() 方法的主体代码又多缩进 4 个空格。这样整个程序的所属关系就很明显了。mian() 方法属于 math 类,其余的都属于main() 方法,而在 print() 方法内的代码段又属于此方法。规律就是空格多的代码从属于空格少的代码。

我推荐大家使用 tab 键缩进,大部分编辑器(如eclipse)都支持自定义 tab 键的空格数,一般为 4 个空格。

除了缩进,空行也是必要的,先看下列程序代码:

public class math{
 public static void main(string[] args){
  int x=12;
  int y=23;
  void print(){
   // .................
  }
  void view(){
   // ....................
  }
 }
}

上面的程序段,在 print() 方法与 view() 方法之间有空行,用来区分不同的模块。print() 方法与 view() 方法所完成的功能不一样,所以使用空行将它们分开,这样更增加了程序的可读性。

另外,需要注意的是方法或属性的命名。这些名字应该有含义,最好有规律,不要只使用"a"、"b"这种通用变量,适当可以根据变量或函数的功能为其命名。上面的"print",其他程序员一看就知道这个方法,是有关打印或输出的函数。再如:变量名"name",一看就知道是有关名字的变量。所以,一定要命名的有意义,否则程序的可读性不强。

还有一点是有关注释的。在每个方法的方法名旁边,应该添加一些注释,同时在一段程序完成之后,也要对程序的功能及如何操作,做个简单的描述。

只要做到以上几点,这个程序他人来读就很容易。即使自己在很长时间后,再来读程序也会一目了然。

如对本文有疑问, 点击进行留言回复!!

相关文章:

验证码:
移动技术网