[Eclipse] 好用的 Task List

哇～好久沒有寫文章了！最近實在太忙碌了！不過忙碌之中也發現一些好用的技巧可以提供工作的效率喔！這也許你已經知道了，但容許我在說一次！

正式開始工作後才發現，使用者需求如雪片般飛來，在加上手邊又有很多系統要弄，一堆事情夾雜在一起就會發現，修了這個系統卻忘了另一個系統要改哪些，導致工作效率就下降了～荷包就跟著縮水，年終相對減少，經濟壓力就變大....扯太多了！

有太多工作要作，我們可以用傳統的紙筆來紀錄，那...紙髒了、掉了、濕了、字看不清楚了...工作效率就下降了～...進入一種無窮迴圈！接下來提供的方法也許不是最好，不過對我來說卻很方便 - Task List，先說好以下的前提是：針對程式碼的部份～

當我們使用 Eclipse 編輯程式時，我們可以寫註解(廢話～)，不過有一些註解對於 Eclipse 來說是有特別處理的，例如：TODO、FIXME 等。當我要開始修改或開發某些程式片段前，我都會先註記 TODO，也就 class 之前或 method 之前加上 //TODO ，當某個程式我現在沒時間思考問題點在哪，但是就是有問題時，我就會註記 //FIXME ，這樣的紀錄 Eclipse 可以幫我們整理出來 workspace 中所有 project 的註記，這樣我們就可以很快的回想自己的工作清單，從 Window -> Show View -> Others 來開啟 Tasks View，如右圖：

從 Tasks View 中我們可以看到一堆已經被註記的工作清單，如左圖。直接對 task 點兩下就可以直接開啟對應的程式碼片段，這樣我們就可以很容易的紀錄我們之前是作到哪了！

這工具對我來說挺不錯用的！尤其在工作越來越多的時候更是一個好得工作利器！與大家分享之～

[Struts2] 在Eclipse中開發Struts2 web project

首先，以下我所使用的eclipse版本為3.3。

1. 在eclipse的command line中我們按下[File]->[New]->[Other…]，如圖一

圖一 [Other…]

2. 按下other後會出現如圖二的畫面後，在web之下選擇Dynamic Web Project。

圖二 Dynamic Web Project

3. 按下 Next 之後，出現圖三的畫面，我們就輸入我們所期望的project name。剩下的設定我們就採用預設值。

圖三 New Dynamic Web Project

4. 接著就按下Finish。我們在Package Explore中的看到Eclipse幫我們建立的樹狀結構如圖四。

圖四 Struts2 web project樹狀結構

5. 接著，我們就到 Struts2 官方網站下載最新的Struts2程式。將下載的檔案作解壓縮後，我們在資料夾中會有apps的資料夾，如圖五。

圖五 Struts2官方檔案解壓縮後

6. 在apps資料夾中我們將struts2-blank.war中的/WEB-INF/lib底下的所有檔案複製到我們剛剛所建立的web project中相對應的位置，也就是/WEB-INF/lib之下。

7. 接著我們就對我們的web project進行refresh，對project按下滑鼠右鍵，在選單中選擇Refresh，如圖六。

圖六 更新project

8. 再來就是要讓我們的web server可以在啟動我們的web app時啟動Struts2的filter。所以我們要在/WEB-INF/web.xml中加入：

<!-- Struts 2 default filter and filter mapping -->
<filter>
    <filter-name>struts2</filter-name>
    <filter-class>
        org.apache.struts2.dispatcher.FilterDispatcher
    </filter-class>
</filter>
<filter-mapping>
    <filter-name>struts2</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

9. 所以完成後的web.xml檔案內容會如圖七。關於web.xml的相關設定請參考tomcat的說明。

圖七 web.xml

10. 再來我們還需要一個struts.xml檔案，這個檔案是Struts2的主要設定檔，在我們的web project中的src資料夾按下右鍵選擇[New]->[Other…]，出現的視窗如同圖二，選擇XML中的XML。然後將新增的檔名設定為struts.xml，這個檔名是不能隨意更改的，不然Struts2會讀取不到。struts.xml檔案內容我們就放入：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
</struts>

11. 這樣就完成初步的佈署了！為了之後要在開發上的方便，我們先將此web project為出成一個war檔案。對我們的project按下右鍵並選擇Export，如圖八。

圖八 匯出專案

12. 接著我們就將project匯出成WAR file，所以選擇Web之下的WAR file，如圖九。

圖九 WAR file

13. 按下Next後，我們要將檔案匯出到我們的目的地。所以設定Destination。指定好儲存位置後就按下Finish。這樣我們之後就可以利用匯入的方式使用了！

[Eclipse Plug-in] Jadclipse

會不會經常在用 Eclipse 時，發現錯誤訊息出現在 console 時，找半天就是沒有看到自己寫的 class 出現在錯誤中勒？反倒是看到一堆 third-party library 或是 jdk 的 classes。我想你如果經常使用 Eclipse 在開發系統，一定會常常碰到這樣的情形。很巧，今天推薦一個 Eclipse 的 Plug-in 叫做 Jadclipse，他原本就是要作 Jad (Java Decompiler)，顧名思義，就是幫助我們將程式反組譯。

Jadclipse 的官方網站

如果你是用 Eclipse Europa(3.3 版)，你就要下載 Jadclipse 3.3 的 plug-in，並且將下載的 .jar 檔案放到 Eclipse 資料夾底下的 plugin 資料夾中。然後使用 console 執行 eclipse.exe -clean 指令，這道指令會告知 Eclipse 去偵測是否有新的 plug-in 被加入 plugin 資料夾中。接著就要在下載 Jad 主程式 下載好的程式直接將其解壓縮，並且放到一個未來不會被誤刪的資料夾中(如：Program Files 資料夾底下)，接著我們就要在 Eclipse 的 Preference 中設定。

如下圖一：

圖一 開啟 Preference 的方式

接著就會開啟 Preference 的設定視窗，在視窗中我們要找到 Java 項目底下的 JadClipse，並且我們設定其中的 Path to Decompile 項目的值為 剛剛安裝的 Jad.exe 的檔案位置。如下圖二：

圖二 JadClipse 設定 Path to Decompile 視窗

最後我們要設定檔案的關聯性，因為我們要將所有的 .class 檔案都交給 Jadclipse 去幫我們反組譯，所以我們在一樣的 Preference 視窗中的 General 項目下的 Editors 的 File Associations 中找到 *.class 預設給 JadClipse 開啟。如下圖三：

圖三 設定檔案關聯性視窗

設定完成後，以後就可以開啟 .class 檔案而不會是一堆不能開啟的檔案了！

好工具與大家分享之～

[Eclipse Plug-in] CodeCover : An open-source glass box testing tool

Introduction

對於測試人員來說，也許 JUnit^[3] 就已經夠用了，但畢竟對於非測試人員來說，JUnit 無法滿足他們的要求，圖形化、數據化的報告是必要的。一個 open-source 的工具 CodeCover^[1] 就是一項不錯的支援工具。他不僅可以像一般的 standalone application 來使用，對於 eclipse^[2] IDE 也有支援的 plug-in。

本文將以安裝、使用以及產生測試報告的架構來說明 CodeCover 工具。

Install

若您是想要使用 standalone 的版本，請由下列網址下載：

http://downloads.sourceforge.net/codecover/codecover-batch-1.0.tar.bz2

若您是想要使用 eclipse^[2] plug-in的版本，請遵循以下的安裝步驟：

1. 啟動您的 Eclipse^[2]

2. 從功能列中選擇 [Help] -> [Software Updates] -> [Find and Install]

圖一：安裝 eclipse plug-in

3. 在開啟的新視窗中選擇 [Search for new features to install] 並且按下確定

圖二：搜尋新的plug-in

4. 接著在視窗的右邊按下 [New Remote Site]

圖三：新增 Remote Site

5. 在新的 New Remote Site 視窗中填入以下資訊：

               Name: CodeCover Update Site

               URL:  http://update.codecover.org/

6. 新增了新的 Remote Site 之後，原先的 Install 視窗會自動將您剛才新增的 Remote Site 勾選好，接著就是按下 [Finish]

7. 接下來的視窗會出現目前有哪些更新或是新的 plug-in 可供您安裝，請勾選 CodeCover^[1] ，並按下 [Next]

8. 接下來的安裝 Eclipse^[2] 也許會問您是否要安裝此元件，請您就選擇 [Install All] 來安裝全部的 plug-in

How to

1. 首先要請您先安裝 statement coverage plug-in，請參考 Install Section

2. 對於該專案要使要 statement coverage plug-in ，請記得對該專案開啟 statement coverage plug-in

對該專案按下右鍵，選擇 properties

圖四：開啟專案的 Properties 視窗

開啟視窗後，選擇 CodeCover^[1]，在右邊會出現設定，請將 Enable CodeCover 勾起，並且至少選擇一項需要用到的功能

圖五：對該專案開啟 CodeCover 功能

3. 再來就是要開啟對哪些 class 需要作 statement coverage，並對該package (如此會對所有的 package 底下的所有 sub-packages 都執行相同的動作)按下右鍵，將Use For Coverage Measurement 打勾

圖六：勾選欲使用 CodeCover 的package

4. 接著就是對某個 test code 作執行的動作，例如使用testcode.basic_data.Basic_dataTestSuit ，開啟該檔案後，在功能列表中按下 run按鈕右邊的下拉式選單

圖七：開啟執行的功能

接著選擇 Run As -> CodeCover Measurement For JUnit。

圖八：對測試檔執行 CodeCover Measurement For JUnit

5. 在等待測試後會出現 JUnit^[3] 的測試視窗，告知是否有測試成功，綠色的 bar就是代表成功，而紅色的bar 就是表示測試中有出現錯誤或是與測試的期望值不符的情況，此時您就可以在錯誤的回報視窗中了解錯誤的來源。

圖九：JUnit 測試結果視窗

6. 接著就是開啟 CodeCover^[1] 的報告視窗並將剛剛的測試結果勾起，接著就可以到 Coverage 視窗中觀看測試的百分比。

Coverage 視窗開啟方式：[window] -> [show view] -> [other...] -> [CodeCover]之下選擇 [Coverage] 就可以開啟。

圖十：選擇 CodeCover 測試結果報告

您可以透過觀看所有 class 來方便觀察，或是您希望使用哪種方式觀看，在coverage 視窗右上角的按鈕可以選擇。

圖十一：觀看 CodeCover 的測試結果

Create a report

1. 經由 Eclipse^[2] 來產生 CodeCover^[1] 測試過後的測試報告，請您先選擇功能列中的 [File] -> [Export]

圖十二：產生測試報告的匯出步驟

2. 在 Export 視窗中，請您選擇 [CodeCover] 階層之下的 [Coverage Result Export] 並按下 [Next]

圖十三：選擇 Coverage Result Export

3. 在 [Export Wizard] 視窗中選擇您剛才所測試過的測試結果，在下方的 [Export Type and Destination] 中的 [Type] 請選擇 [Report]，並且選擇您想要匯出的目的地的檔案(預設的檔案格式為 *.xml)，並按下 [Next]

圖十四：選擇欲匯出的測試結果、測試報告的形式以及測試報告的目的地

4. 在下一個視窗畫面中，您必須選擇您的 [Report Template] (請您先下載 CodeCover 的 standalone 版本，並且在解壓縮後的資料夾內您會有 /report-templates/，若您想要 export 為 HTML 樣式，請選擇 HTML_Report_Hierarchic.xml)，按下 [Next] 之後就會開始產生結果報告

圖十五：選擇測試報告的 Report Template

5. 在產生完結果報告後，請您到您方才指定的匯出位置觀看報告結果。產生的結果報告會以資料夾的方式出現，請您選擇資料夾中任一個index.html，並且以瀏覽器開啟該檔案，報告會以階層式的排列來產生報告。

圖十六：測試報告的HTML形式範例

Reference

[1] CodeCover 官方網站 http://codecover.org/index.html

[2] Eclipse IDE 官方網站 http://www.eclipse.org/

[3] JUnit 官方網站 http://www.junit.org/