使Eclipse符合Java編程規範

 編程規範是很重要的東西,能讓團隊的代碼易於閱讀和維護,也便於日後的功能擴展。
  工慾善其事必先利其器!作爲一個Java程序員,與Eclipse打交道可能是一輩子的事情。將Eclipse設置爲符合公司編程規範的模式,將節省我們很多時間。
  使用Eclipse的都知道 Ctrl + F 這個快捷鍵的作用,就是自動將書寫的代碼排版,變得易於閱讀。
  剛進入公司的時候,老程序員告訴我,不要使用這個快捷鍵,因爲它會使代碼變亂,例如自動讓一個很長方法的不同參數整理到不同行上。其實他不知道的是,Ctrl + F是基於一定規則的,這些規則都是可以自己設置的。
  將Eclipse按照公司編程規範設置好了之後,寫完代碼,一個Ctrl + Shift + F,頁面就會變得整潔又好看。閱讀別人的代碼的時候,也是一樣。
  這裏不講正規的編程規範,只講怎麼根據編程規範,一步步來設置我們的Eclipse。
  1、 設置JDK版本、編碼格式
  Eclipse中的基本設置都是在Windows ->  Preferences 中設置的。而Java編程的個性化設置就位於Windows ->  Preferences -> Java中。
  (1)、JDK版本
  進行Java開發,首先要設置JDK版本。MyEclipse有自帶的Jdk,而eclipse沒有。
  採用如下的步驟設置自定義的JDK。
  首先在Java -> Complier中,將Compiler compliance level 設置爲1.6 。
  然後在Java -> Installed JREs右邊目錄中,可以看到JDK地址,需要增加JDK,可以通過add -> Stankard VM -> Next ->Directory ,定位到JDK文件夾,Finish!
  (2)、編碼格式
  preferences->General 點擊 workspace,右邊下面有一個Text file encoding,點擊Other,選擇Utf-8,以後新建的項目都是utf-8編碼的。
  2、Java Doc設置(註釋模版)
  Window -> Preferences -> Java -> Code Style 中有大量設置代碼風格的設置,註釋模版在Code Style->Code Templates中設置。
  (1)、文件頭JavaDoc模版設置:
  Comments -> Files,右邊點擊Edit...,將公司文件頭JavaDoc範例覆蓋進去,如下:
  /**
  * Copyright <year> Xxx Inc.
  */
  (2)、類/接口、方法等JavaDoc模版設置都跟上面類似:
  同理,Comments -> type設置類/接口JavaDoc模版,Methods設置方法。
  3、代碼風格設置
  我們可以根據需要設置自己的Formatter。
  在Code Style選項中,選擇Formatter我們選擇新建自己的Formatter,點擊"New...",設置名稱。
  隨後跳轉到風格詳細設置頁面。
  下面詳細講一下Fomatter的風格設置頁面的各個選項卡。
  (1)設置Eclipse中的tab鍵爲4個空格,這個比較麻煩。
  首先,在第一個選項卡Indentation下有一個Tab policy選項,選擇spaces only 保存即可。
  然後,設置用空格代替TAB,window->preference ->General->Editors->Text Editors,右側有一個insert space for tabs,選中,保存;
  (2)第一個選項卡Indentation就是設置縮進的,選擇後,右邊的Preview有直接變化,可觀察。
  Statements within 'switch' body 選項一般應該勾上。
  (3)第二個選項卡Braces是設置括號是否換行。
  一般除了class/Interface和數組(即第一個和最後一個)設置爲Same Line之外,其他都設置爲Next Line。
  (4)第三個選項卡White Space是設置空格的。
  一般逗號後必須空一格、所有的運算符、賦值符前後必須空一格,所有關鍵字與其它關鍵字、非關鍵字之間必須空一格。
  由於設置太繁瑣,這裏就不一一列出了,很簡單。
 (5)第四個選項卡Blank Lines是設置空行的。
  (6)第五個選項卡New Lines是設置大括號換行的。
  (7)第六個選項卡Control Statements是設置控制語句格式的。
  Insert new Line before 'else' in an 'if' statement這個選項一般要勾上。
  (8)第七個選項卡Line Wrapping是設置行距、縮進、行最大長度的各種具體數值。
  這裏,爲了使自動格式化的時候不會隨便換行,可以將Maximum line width設置的大一點,我就直接設爲500。
  (9)第八個選項卡Comments是設置註釋格式的。
  (10)第九個選項卡Off/On Tags是設置註釋中標籤開關的。
  4、 鏈接JDK類庫幫助文檔(API)
  我們知道,在Eclipse中,對着某個類使用 Shift+F2 可以打開它的API文檔,可是,由於各種原因,經常打不開,而實際上這個是可以設置的。如下:
  (1) Window -> Preferences -> Java -> Installed JREs
  選中已有的使用中的JDK,點擊右邊的Edit
  對話框中央有一個JRE system libraries列表,裏面有9個jar包。
  (2)展開一個Jar包,裏面有2個文件,一個是類源文件src.zip,一個是javadoc location:(none),我們要做的就是把這個空地址替換成我們硬盤上API文檔的實際地址。選擇javadoc location,點擊右邊的Javadoc Location...選項,在彈出框中點擊Browse...,輸入硬盤上API文檔的實際地址即可。
  (3)依次把每個jar包都設置一遍,最後,當我們選擇某個JDK類的,Shift + F2的時候,就可以在eclipse中直接打開該類相應的API文檔了。
  5、編碼格式、字體、背景顏色設置
  除了上面關乎編程規範的設置外,很多個性化的設置可以讓Eclipse更易於使用。
  (1)、字體設置
  preferences->General->Appearance->Colors and Fonts 右邊列表選擇 Java-> Java Editor Text Font,點擊Edit...就可以改變java字體了。
  這裏的字體設置並不會影響xml、txt、properties 等文件的字體,而初始化xml、txt、properties 文件的字體一般都很小,不易觀察,看下面的設置。
  (2)、xml、txt、properties 字體設置
  preferences -> General -> Appearance -> Colors and Fonts 右邊列表選擇 Basic -> Text font ,點擊Edit...就可以改變字體了。
  有時候覺得控制檯的字體不醒目,想換一種,可以採用下面的方式。
  (3)、debug字體設置
  preferences -> Appearance -> colors and fonts 右邊列表選擇 debug -> console font ,點擊Edit...就可以改變字體了。
  其他的字體設置都大概類似。
  長期對着電腦,白亮的色彩會讓程序員眼睛發昏,注意力不能集中,設置一下背景顏色,可以很好的緩解這個問題。
  (4)、背景顏色設置
  preferences -> Editors ->Text Editors 選中它,右邊的面板有一個Appearance color options,用來設置各種模塊的顏色。
  選擇Background color,去掉右邊的System Default的勾選,點擊Color,在裏面設置顏色。
  眼科專家推薦背景顏色爲:色調85、飽和度123、亮度205,設置完,美觀大方的淺綠色就出現了。


發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章