小議Java的源文件的聲明規(guī)則以及編程風(fēng)格
Java源文件的聲明規(guī)則
當(dāng)在一個源文件中定義多個類,并且還有import語句和package語句時,要特別注意這些規(guī)則:
一個源文件中只能有一個public類。
一個源文件可以有多個非public類。
源文件的名稱應(yīng)該和public類的類名保持一致。例如:源文件中public類的類名是Employee,那么源文件應(yīng)該命名為Employee.java。
如果一個類定義在某個包中,那么package語句應(yīng)該在源文件的首行。
如果源文件包含import語句,那么應(yīng)該放在package語句和類定義之間。如果沒有package語句,那么import語句應(yīng)該在源文件中最前面。
import語句和package語句對源文件中定義的所有類都有效。在同一源文件中,不能給不同的類不同的包聲明。
類有若干種訪問級別,并且類也分不同的類型:抽象類和final類等。這些將在后續(xù)章節(jié)介紹。
除了上面提到的幾種類型,Java還有一些特殊的類,如內(nèi)部類、匿名類。
一個簡單的例子
在該例子中,我們創(chuàng)建兩個類 Employee 和 EmployeeTest,分別放在包 p1 和 p2 中。
Employee類有四個成員變量,分別是 name、age、designation和salary。該類顯式聲明了一個構(gòu)造方法,該方法只有一個參數(shù)。
在Eclipse中,創(chuàng)建一個包,命名為 p1,在該包中創(chuàng)建一個類,命名為 Employee,將下面的代碼復(fù)制到源文件中:
package p1; public class Employee{ String name; int age; String designation; double salary; // Employee 類的構(gòu)造方法 public Employee(String name){ this.name = name; } // 設(shè)置age的值 public void empAge(int empAge){ age = empAge; } // 設(shè)置designation的值 public void empDesignation(String empDesig){ designation = empDesig; } // 設(shè)置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方法開始執(zhí)行。為了能運行這個程序,必須包含main方法并且創(chuàng)建一個對象。
下面給出EmployeeTest類,該類創(chuàng)建兩個Employee對象,并調(diào)用方法設(shè)置變量的值。
在Eclipse中再創(chuàng)建一個包,命名為 p2,在該包中創(chuàng)建一個類,命名為 EmployeeTest,將下面的代碼復(fù)制到源文件中:
package p2; import p1.*; public class EmployeeTest{ public static void main(String args[]){ // 創(chuàng)建兩個對象 Employee empOne = new Employee("James Smith"); Employee empTwo = new Employee("Mary Anne"); // 調(diào)用這兩個對象的成員方法 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 類,可以看到如下的輸出結(jié)果:
Name:James Smith Age:26 Designation:Senior Software Engineer Salary:1000.0 Name:Mary Anne Age:21 Designation:Software Engineer Salary:500.0
強調(diào)一下編程風(fēng)格
代碼風(fēng)格雖然不影響程序的運行,但對程序的可讀性卻非常重要。自己編寫的程序要讓別人看懂,首先在排版方面要非常注意。
其實每個人的編程風(fēng)格、每個軟件開發(fā)公司的編程風(fēng)格都不一樣。一個人編寫的程序代碼,就應(yīng)該能讓別人看懂,甚至是過了很長時間,自己也要看的懂,否則這個程序就成了一個死程序。
編程風(fēng)格是指編程時的格式,讓程序看上去就很有層次感。下面通過一些例子,說明編程風(fēng)格的重要性:
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); } }
上面程序段的整個排版看起來是否很舒服,并且層次感很強?是否一眼看上去就知道整個程序架構(gòu)?這里的關(guān)鍵在于縮進,縮進也可以稱為跳格。
上面的代碼采用的縮進:"public class math" 是頂格的,接著 mian() 方法縮進 4 個空格,在 mian() 方法里面的代碼一律縮進 8 個空格,而 print() 方法的主體代碼又多縮進 4 個空格。這樣整個程序的所屬關(guān)系就很明顯了。mian() 方法屬于 math 類,其余的都屬于main() 方法,而在 print() 方法內(nèi)的代碼段又屬于此方法。規(guī)律就是空格多的代碼從屬于空格少的代碼。
我推薦大家使用 tab 鍵縮進,大部分編輯器(如Eclipse)都支持自定義 tab 鍵的空格數(shù),一般為 4 個空格。
除了縮進,空行也是必要的,先看下列程序代碼:
public class math{ public static void main(String[] args){ int x=12; int y=23; void print(){ // ................. } void view(){ // .................... } } }
上面的程序段,在 print() 方法與 view() 方法之間有空行,用來區(qū)分不同的模塊。print() 方法與 view() 方法所完成的功能不一樣,所以使用空行將它們分開,這樣更增加了程序的可讀性。
另外,需要注意的是方法或?qū)傩缘拿?。這些名字應(yīng)該有含義,最好有規(guī)律,不要只使用"a"、"b"這種通用變量,適當(dāng)可以根據(jù)變量或函數(shù)的功能為其命名。上面的"print",其他程序員一看就知道這個方法,是有關(guān)打印或輸出的函數(shù)。再如:變量名"name",一看就知道是有關(guān)名字的變量。所以,一定要命名的有意義,否則程序的可讀性不強。
還有一點是有關(guān)注釋的。在每個方法的方法名旁邊,應(yīng)該添加一些注釋,同時在一段程序完成之后,也要對程序的功能及如何操作,做個簡單的描述。
只要做到以上幾點,這個程序他人來讀就很容易。即使自己在很長時間后,再來讀程序也會一目了然。
相關(guān)文章
Java使用application.property讀取文件里面的值
本文通過實例代碼給大家介紹了Java使用application.property讀取文件里面的值,需要的朋友可以參考下2018-10-10Java語言實現(xiàn)簡單FTP軟件 FTP本地文件管理模塊實現(xiàn)(9)
這篇文章主要為大家詳細(xì)介紹了Java語言實現(xiàn)簡單FTP軟件,F(xiàn)TP本地文件管理模塊的實現(xiàn)方法,具有一定的參考價值,感興趣的小伙伴們可以參考一下2017-04-04SSM框架通過mybatis-generator自動生成代碼(推薦)
這篇文章主要介紹了SSM框架通過mybatis-generator自動生成代碼,本文通過實例代碼給大家介紹的非常詳細(xì),對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值,需要的朋友可以參考下2017-11-11因Spring AOP導(dǎo)致@Autowired依賴注入失敗的解決方法
這篇文章主要給大家介紹了因Spring AOP導(dǎo)致@Autowired依賴注入失敗的解決方法,文中通過示例代碼給大家介紹的非常詳細(xì),對大家具有一定的參考學(xué)習(xí)價值,需要的朋友們下面跟著小編來一起學(xué)習(xí)學(xué)習(xí)吧。2017-07-07