Eclipse Quick Start

Speaker: Ray Lee

Time : Forty-Five min.

大綱

善用線上輔助說明 利用 Eclipse 開發 Java 應用程式 如何外掛 開發 WEB 應用程式 運用 CheckStyle 運用 CVS 共同開發專案 包裝 JAR 、 WAR 、 EAR 檔

下載 Eclipse 請至 http://www.eclipse.org/downloads/index.php下載 Eclipse3.0.1

下載 Eclipse

下載 Eclipse下載 eclipse-SDK-3.0.1-win32.zip 檔案

安裝 Eclipse

為了方便管理與開發 Eclipse 專案，請先在硬碟 C 槽建立 IDE 目錄。 把下載 eclipse-SDK-3.0.1-win32.zip 檔案解壓縮到 C\:IDE 。 解壓縮後， 您硬碟會多出一個 eclipse 子目錄，如下圖

安裝 Eclipse eclipse 子目錄下的 eclipse.exe 就是 Eclipse 的主程式。

執行 Eclipse.exe 的前置作業 在執行 eclipse.exe 之前，請先安裝 Java 2 SDK ，並且設定 JAVA_HOME 環境變數，將該環境變數的內容，

設定為您硬碟內 Java 2 SDK 的安裝位置。設定完成之後，才可以執行 eclipse.exe 檔案。

執行 Eclipse.exe 的前置作業 第一次進入 Eclipse 時，會出現要求選取工作區的畫面，請將此工作區更改為 c:\IDE\

workspace

善用線上輔助說明 請按說明說明內容

開發 Java 應用程式的基本設定 開發 Java 程式的時候，各個 Java 原始檔案與編譯後的類別檔案，有約定俗成

的 擺放方式。比方說，原始檔案放在 src 目錄，類別檔案放在 classes 目錄。所

以，在開始撰寫 Java 程式之前，請完成以下的設定。 首先，請選取 Eclipse 功能表的 Window 、 Preferences ，然後展開左邊樹狀

結構的 Java 節點，畫面如下：

在 build path 子項目中，請將 Source and output folder 窗格內的選項，從 Project 改為 Folders ，並且將 Output folder name 由 bin 改為 classes 。這樣，待會開始建立新專案的時候， Eclipse 就會自動建立 src 與 classes 這兩個子目錄，按照套件名稱在其下建立子目錄，分別存放 Java 原始檔案與類別檔案。記得按下右下角的 Apply 按鈕，否則您所做的變動，就不會套用到 Eclipse 之中。最後按下確定即可。

開發 Java 應用程式的基本設定

利用 Eclipse 開發 Java 應用程式

每個以 Eclipse 開發的檔案，都必須隸屬於某個專案之中。因此，我們必須先建 立一個專案。請選取 Eclipse 功能表的 FileNewProject

利用 Eclipse 開發 Java 應用程式 點選 Java 專案，並按下一步

利用 Eclipse 開發 Java 應用程式 輸入專案名稱，並按下一步

利用 Eclipse 開發 Java 應用程式

因為我們之前已經進行過一些基本的設定，所以這時候您就可以看到畫面中 Source folders on build path 窗格內自動出現 Java_Test/src ，以及 Default output folder 窗格內自動出現JavaTest/classes 。最後按下完成即可。

利用 Eclipse 開發 Java 應用程式

在 Java_Test 專案上按滑鼠右鈕， NEWCLASS

利用 Eclipse 開發 Java 應用程式

輸入類別檔案名稱 HelloWorld 及套件名稱 Test ( 非必要 ) ，按下完成

利用 Eclipse 開發 Java 應用程式

可於 main 方法中撰寫程式碼

利用 Eclipse 開發 Java 應用程式

Eclipse 的習慣是，每個能夠執行的東西都必須要有一個所謂的組態設定 (Configuration) ，請選取 Eclipse

功能表的 RunRun...Java Application ，此時 eclipse 就會很聰明地完成 HelloWorld 的組態設定

如何外掛

外掛”中文化套件”： NLpack-eclipse-SDK-3.0.x-win32.zip(http://eclipse.cdpa.nsysu.edu.tw)

外掛 JSP 安裝套件： emf-sdo-runtime-2.0.1 (

http://www.eclipse.org/downloads/download.php?file=/tools/emf/downloads/drops/2.0.1/R200409171617/emf-sdo-runtime-2.0.1.zip)

lomboz.301.zip (http://forge.objectweb.org/project/showfiles.php?group_id=97&release_id=603)

外掛的方式 : 1. 用 Link 的方式、 2, 直接放置

如何外掛 ( 用 Link 的方式 )

請先於 C:\IDE 目錄下建立 plugins 及 translation 目錄

如何外掛 再於 C:\IDE\plugins 目錄中新增 lomboz 及 sdo 目錄，準備放置 JSP 外掛程式

如何外掛 將中文化 NLpack-eclipse-SDK-3.0.x-win32.zip 解壓縮至 C:\IDE\translation

如何外掛 將 emf-sdo-runtime-2.0.1.zip 外掛至 C:\IDE\plugins\sdo

如何外掛 安裝 lomboz 前，請於 C:\IDE\plugins\lomboz 目錄新增 eclipse 目錄

如何外掛 將 lomboz.301.zip 外掛解壓縮至 C:\IDE\plugins\lomboz\eclipse

如何外掛

安裝完外掛程式，請於 C:\IDE\eclipse 目錄下建立一 links 目錄，讓 Eclipse 開發平台可以連結我們所安裝的外掛程式

如何外掛

請於 links 目錄中建立三個文字檔， lomboz.txt 、 sdo.txt 、 trans.txt

如何外掛

請於 lomboz.txt 輸入右邊的文字 path=c:/IDE/plugins/lomboz 請於 sdo.txt 輸入右邊的文字 path=c:/IDE/plugins/sdo 請於 trans.txt 輸入右邊的文字 path=c:/IDE/translation

( 以上 , 請注意 , 路徑的分隔為 "/", 而非 "\")

如何外掛 ( 直接放置 )

Eclipse ：假設安裝於 C:\IDE\eclipse 目錄下

When open a Plugin file ， if you see … A. “eclipse” directory 將 eclipse 目錄解壓縮於 C:\IDE B. “plugins” & “features” 將 plugins 和 features 目錄解

壓 縮於 C:\IDE\eclipse

C. “com.XXX.XXX” 將 com.XXX.XXX 目錄解壓縮於 C:\IDE\eclipse\plugin

開發 JSP 的前置作業 請先裝好 Tomcat5.0.28 選擇“視窗 / 喜好設定”後 , 展開“ Java/ 建置路徑 / 類別路徑變數 " 後 , 選擇 " 新建 "

變數 " 名稱 " 請輸入 "JDK_TOOLS", 並按 " 檔案 " 選取 C:/ jdk/lib/tools.jar, 之後請選 " 確定 "

開發 JSP 的前置作業

接著 , 選 Lomboz, 設定 JDK Tools.jar 後請按 " 套用 "

開發 JSP 的前置作業

接著展開Lomboz,選擇Server Definitions,其中Server Types,

Application Server directory, 和 Classpath Variable 都要作適當設定

開發 JSP 的前置作業

於 Server Classpath 中新增 bootstrap.jar , 請按 Add Librarytomcat5 / bin / bootstrap.jar

開發 JSP 的前置作業

於 Project Classpath 中新增 bootstrap.jar 、 servlet-api.jar 、 jsp-api.jar , 請按 Add Librarytomcat5 / bin / bootstrap.jar 及 Add Librarytomcat5 / common/lib/ servlet-api.jar && jsp-api.jar

開發 JSP 的前置作業

以上步驟都設好後按"確定",接著,要選擇"視窗/自訂視景",

將"Lomboz J2EE Wizards"勾選後按"確定"

開發 JSP 專案

開始建立新 JSP 專案 , 請選擇 " 新增專案” ,

選擇 "Lomboz J2EE Project"

開發 JSP 專案

輸入專案名稱 , 本例命名為 "JspTest", 按 " 下一步 "

開發 JSP 專案

再選 " 下一步 "

開發 JSP 專案

請選擇 "Add...", 並在 Module Name: 處輸入模組的名稱 , 本例輸入 "Test" 後再按 " 確定 "

開發 JSP 專案

再選 "Targeted Servers“, 請選擇開發 module 所使用的 Application Server,

本例是使用 Tomcat v5.0.x, 所以選好後按 "Add....", 再按 " 完成 "

開發 JSP 專案 程式自動判別專案為 Java 開發案 , 請選擇 " 是 "

開發 JSP 專案

系統自動在“ JspTest” 專案下的 Test 模組下建立二個檔案 , 分別是 “index.jsp” 和“ error.jsp” 和設定檔目錄“ WEB-INF” 及相關的設定檔 , 若要新建其他程式 , 請選擇 "Test" 按右鍵選 " 新建 / 檔案

開發 JSP 專案

請輸入檔案名稱 , 本例命名為 "first.jsp" 後按 " 完成 "

開發 JSP 專案 接著 , 在程式撰寫區輸入程式碼 , 並在工具列選取 "J2EE Project Outliner" 的 icon

開發 JSP 專案 可看到顯示區多了 "Lomboz J2EE View" 的顯示視窗 , 結果如下圖 :

如何執行 JSP 專案

因為新建的 JspTest 專案是存於 C:\IDE\workspace 目錄中， 為了讓 Tomcat 能找到 JspTest 專案，須修改 tomcat5/conf

中的 server.xml 檔

如何執行 JSP 專案

<Server>............<Host>............

<Context path="/Test" docBase="C:\IDE\workspace\JspTest\Test"              workDir="C:\IDE\workspace\JspTest\Test"  debug="0"                crosscontext="true" reloadable="true"></Context>

</Host>...........</Server>

於 <Host> 標籤中加入黃色的文字( 其目的為告訴 Tomcat ，專案 JspTest 的工作目錄 ) ，然後存檔

如何執行 JSP 專案 若要在 eclipse 啟動 Tomcat , 請在 Test 模組名稱下按右鍵 , 選擇 " 執行 / 執行

如何執行 JSP 專案

於建立、管理與執行配置中新建一新建配置，並修改此新建配置的名稱及主要類別如圖

如何執行 JSP 專案 請將“ VM 引數”中的引數刪除 , 再按 " 套用 " 之後按 " 執行 "

啟動 Tomcat

已啟動 Tomcat

讓專案顯示於 browser 上

要讓專案顯示於 browser 上，請於 Test 上按滑鼠右鈕 Lomboz J2EE / Show in browser

讓專案顯示於 browser 上

網頁上若出現” Welcome” 就一切 ok 了…

運用 Checkstyle 請至 http://sourceforge.net/projects/eclipse-cs/下載 CheckStyle 外掛程式 CheckStyle For Eclipse(com.atlassw.tools.eclipse.checkstyle_3.5.0-bin) 請直接將該檔解壓縮至 C:\IDE\eclipse\plugins 目錄下，並重新開啟 Eclipse ，請按說明 / 關於

Eclipse Platform/ 外掛程式詳細資料，確定 CheckStyle 已正確外掛於 Eclipse 上

運用 Checkstyle 假如今天我想制定一個 check style ，請按視窗 / 喜好設定 /Checkstyle/Add

請輸入 Check Style 的名稱

若想增加 rule ，請按 add rule

運用 Checkstyle 輸入 CheckStyle 名稱” CheckLength” ，並按頁籤Size ViolationsAdd Rule在Select Rule 下拉選單中選取 Maximun Line Length 確定

選取限制程式每行長度的選項

運用 Checkstyle規定每行不得超過 80 個字元，若超過則出現 Severity 訊息

如何於專案中引用 Checkstyle請於專案上按滑鼠右鈕選取 CheckstyleAdd ，在 Checkstyle File Set Editor 中輸入File Set Name 跟 Check Configuration 確定

如何於專案中引用 Checkstyle程式於執行後，若不符合 Checkstyle 規定將出現下圖的訊息

如何共用 Checkstyle制定者利用 Export將Checkstyle 匯出於某個 repository ，其它開發者即可使用 Import 將該 Checkstyle 匯入使用

連結資料庫的前置作業

請於 C 槽下建於一 java 目錄，並將 mysql-4.0.21-win-noinstall 安裝於 C:\java 目錄下

本專案將以 mysql-4.0.21-win-noinstall 為例，示範 Eclipse 如何連結資料庫

連結資料庫的前置作業解壓縮完後執行” c:\java\mysql-4.0.21-win\bin\winmysqladmin.exe”

解壓縮完後執行接著輸入 DBA 的 user name 及 password, 例如 user_name=“root”,Password=“123456” ，這組 user_name 和 Password 要記住 , 以後連結資料庫時用得到

連結資料庫的前置作業 輸入完後按 "OK", 可看到右下角有紅綠燈且亮綠燈代表 MySQL 已正常運

作了 , 未來要執行 MySQL 只要執行 "c:\java\mysql-4.0.21-win\bin\winmysqladmin.exe" 即可

連結資料庫的前置作業接著要安裝 Java 連結 MySQL 的 JDBC(mysql-connector-java-3.0.15-ga.zip)

，請將該檔解壓縮至 C:\java

連結資料庫的前置作業 等解壓縮完成 , 將 "c:\java\mysql-connector-java-3.0.15-ga\mysql-connector-java-3.0.15-ga-bin.jar"

這個檔案複製到 "c:\jdk\jre\lib\ext\" 目錄內

連結資料庫請按照前面章節自行建立一 Java Project ，並於該專案上按滑鼠右鈕建置路徑 / 新增外 Jar ，將 C:\jdk\jre\lib\ext\mysql-connector-java-3.0.15-ga-bin 匯入該專案

連結資料庫請按照前面章節自行建立一 Java Application File

如何讓 Eclipse 連上 CVS新建專案選擇視窗開啟視景其它選取 CVS Repository Exploring

當出現下圖時請對左側空白處按滑鼠右鍵新建儲存圖的位置

如何讓 Eclipse 連上 CVS請依下圖輸入，使用者及密碼請依個人輸入

如何讓 Eclipse 連上 CVS當正確連上 CVS 時，左側空白處將出現一個金色罐狀圖示及 CVS 儲存庫的位置

如何共用專案對欲共用的專案按滑鼠右鈕 TeamShare Project 當出現下列視窗時請按下一步

如何共用專案若不想更新模組名稱，請按下一步

如何共用專案此時按下完成即可將該專案加入 CVS 中

如何交付檔案請於欲交付的檔案上按滑鼠右鈕 TeamCommit

如何讓專案出庫當其他人想將新的 CVS 模組出庫請前面的步驟建立儲存庫位置對儲存庫視圖中的模組按滑鼠右鈕 Check Out As 當出現下列視窗按完成即可讓該專案出庫

讓專案同步化對該專案按滑鼠右鈕 TeamSynchronize with Repository 即可讓該模組同步化同步化有三種模式，欲了解其意義請見下頁註解：

IncomingOutgoing

Incoming/Outgoing

讓專案同步化 Incoming 模式： 顯示自從上次你利用儲存庫做同步化、更新或交付程式碼之後，任何儲存庫中有變動過的

檔案。

Outgoing 模式： 顯示自從上次你利用儲存庫做同步化、更新或交付程式碼之後，任何本端電腦有變動過的

檔案。

Imcoming/Outgoing 模式： 顯示自從上次你利用儲存庫做同步化、更新或交付程式碼之後，任何儲存庫或本端電腦有

變動過的檔案。

貼上版本標籤當建立程式的里程碑版時，可以替這個版本貼上一個版本標籤，請對該專案按滑鼠右鈕TeamTag As Version，輸入版本標示

注意：該版本不能含空格或這些字元 【 $ , . : ; @ | 】

貼上版本標籤此時即可於 CVS Repository 視圖中的 Version 節點找到此版本

將標籤版本出庫及替代你也可以替這個貼上標籤的模組版本做出庫的動作，在 CVS Repository 視圖下對該模組按滑鼠右鍵 Check Out As… ，也可以在 Package Explorer 視圖下對該模組按滑鼠右鍵 Replace withAnother Branch or Version 選擇你要替代當前的版本

建立分支如果想為軟體開發其它的分線，對該專案按滑鼠右鍵 TeamBranch ，若想將該分支合併回主開發線，在 Package Explorer 下對該專案按滑鼠右鍵

TeamMerge

包裝 JAR 檔請於任一專案上按滑鼠右鍵匯出選取 JAR File 下一步

包裝 JAR 檔請勾選欲匯出的專案，並輸入欲匯出的目的地，下一步

包裝 JAR 檔此步驟按預設即可，請按下一步

包裝 JAR 檔請輸入主要類別，並按完成

包裝 WAR 檔

當我們一開建立 Tomcat Project 時，開發軟體就會將相關的檔案

滙入，而我們現在要用到的是 build.xml 這個 ant來包裝 war

包裝 WAR 檔

上一列告訴 Eclipse 此檔案 (build.xml) 的位置

上一列是描述 war 要存放的目錄位置

上一列是描述 war 的檔案名稱

上一列是描述指向 Ant日後會用到的 JDT 編譯器的配接器

包裝 EAR 檔請於某 Porject 上按滑鼠右鈕新建 Lomboz Ear Modual ，建立一 Ear Modual ，並將所需之 War 及 Jar 建於該 Modual 上

Q & A

Eclispe跟 oc4j的版本整合 怎麼引進 tag library 在 build path下， JRE_LIB變數跟 JRE儲存器的不同