JAVA学习提高之－－－－如何用Eclipse和Tomcat Plugin来建立一个开发环境

此文件就是在說如何設定Eclipse和安裝Tomcat Plugin整合到Eclipse中，可以簡單的啟動、停止、重啟Tomcat，在Eclipse內的視窗中看到Tomcat顯示的狀態訊息、除錯和即時的改變程式碼，等等的，讓程式開發變成很愉快的事情喔。

準備工作，我使用下列的系統和軟體
Windows XP
Eclipse 3.12
Tomcat 5.5.15(要下載.zip解壓縮版，不要用.exe安裝版)
Sysdeo Tomcat Plugin Launcher v3.1final

WebWork

安裝Tomcat Plugin
有許多給Eclipse用的Tomcat Plugin軟體，而這裡是用Sysdeo的Tomcat Plugin來整合Eclispe和Tomcat，下載Sysdeo Tomcat Plugin的網頁在http://www.sysdeo.com/eclipse/tomcatplugin
解壓縮下載的檔案到<ECLIPSE_HOME>/plugins的資料夾中。

安裝Tomcat
如果還沒有下載Tomcat那就來這裡http://tomcat.apache.org/下載吧，記得要下載.zip版本，解壓縮就可以安裝好Tomcat喔。

在Eclipse中設定Tomcat Plugin
啟動/重啟Eclipse這樣才會載入剛剛按裝的Plugin。
如果剛剛安裝的Plugin有啟動，那馬上可以在Eclipse選單下方看到新的三個圖示。
這三個按鈕的功能是啟動、停止、重啟Tomcat用的。
現在設定這個Plugin，在Windows -> Preference.點選Tomcat文字.
Tomcat version選下載的版本，這裡用Version 5.x 版，再選擇<TOMCAT_HOME>就是剛剛安裝解壓縮Tomcat的資料夾。Context decleration mode 就是選Server.xml。
Advanced就是預設的不用更動，JVM Settings 需要確定有選擇一個JRE。
洏Source Path確定有勾選Automatically compute source path.
這樣就按OK按鈕關掉視窗。

建立一個新的專案
好，我們在Eclipse中建立一個專案，而專案的目錄結構如下，可以在Window-->Show View選Navigator模式來建資料夾。
<project_home>
+ src
+ java
+ webapp
+ WEB-INF
+ classes
+ lib
在lib資料夾可以把需要使用到的.jar檔放到此資料夾中，這裡我放入下列檔案
commons-logging.jar
freemarker.jar
javamail.jar
log4j-1.2.9.jar
ognl.jar
oscore.jar
rife-continuations.jar
servletapi.jar
spring.jar
webwork-2.2.1.jar
xwork.jar

有些設定檔案比較適合放在class
path下的，這樣比較好做不用WebContainer的測試。所以呢，在src/java的資料夾中需要放入整合Spring的設定檔和Log4J的
設定檔log4j.properties，WebWork的設定檔webwork.properties和XWork的設定檔案xwork.xml，下列
是此四個設定檔案的內容
Spring設定檔applicationContext.xml一開始是空的。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">
<beans default-autowire="byName">
</beans>

Log4J的設定檔案log4j.properties。
log4j.rootLogger=INFO, console

log4j.appender.console=org.apache.log4j.ConsoleAppender
log4j.appender.console.layout=org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern=%d{dd MMM yyyy HH:mm:ss} %-5p %c - %m%n

#log4j.category.org.springframework=DEBUG
#log4j.category.com.opensymphony.webwork=DEBUG
#log4j.category.com.opensymphony.xwork=DEBUG

webwork.properties的內容，這是給開發環境使用的設定，運行環境要另外寫過喔。
webwork.locale=zh_TW

webwork.objectFactory = spring
webwork.devMode = true
webwork.configuration.xml.reload = true
webwork.url.http.port = 8080

xwork.xml是來設定動作(action)的檔案
<!DOCTYPE xwork PUBLIC "-//OpenSymphony Group//XWork 1.1.1//EN" "http://www.opensymphony.com/xwork/xwork-1.1.1.dtd">
<xwork>
<include file="webwork-default.xml"/>
<package name="default" extends="webwork-default">
</package>
</xwork>

而在WEB-INF資料夾中需要web.xml檔案才是個JAVA網頁程式，web.xml內容如下。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app id="WebApp_ID">
<display-name>acelife</display-name>

<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>
classpath:/applicationContext*.xml
</param-value>
</context-param>

<filter>
<filter-name>webwork</filter-name>
<filter-class>com.opensymphony.webwork.dispatcher.FilterDispatcher</filter-class>
</filter>

<filter-mapping>
<filter-name>webwork</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>

<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>

<welcome-file-list>
<welcome-file>index.html</welcome-file>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
</web-app>

到目前為止幾乎已經完成WebWork程式設定了，再來就是告訴Eclipse編譯過的class要放到webapp/WEB-INF
/classes，可以在Project-->Properties然後選則Java Build Path底下有個Default
output folder瀏覽選向webapp/WEB-INF/classes資料夾。然後上面的Source移除原來的專案名稱，點選Add
Folder..重新選到
專案名稱下的src的java資料夾打就好，按OK按鈕，再按OK按鈕，就完成Java編譯輸出class的設定。
點選上面Libaries頁面，點右邊的Add JARs..把專案裡面的webapp/WEB-INF/lib的jar檔全部選進去，按OK完成網頁程式需要的jar檔設定。
再
來點選左邊Tomcat來設定與Tomcat的整合，在General這頁，有個Is Tomcat Project要打勾，Context
Name就是Application Name，輸入想要的名稱，如/demo，切記要輸入/斜線喔。底下有個Subdictionary to
set as web application root(optional)
因為我們的jsp網頁和WEB-INF放在webapp裡面，所以這裡就填/webapp(記得加/斜線)就好了。

最後我們在專案資料夾上點選滑鼠右鍵，跳出一個選單，選Tomcat Project的Add Tomcat library to
project build path，來設定與Tomcat的lib關連；再重複一次選Tomcat Project的Create JSP
work dictionary，就可以看到專案資料夾裡面多一個work資料夾，所有runtime時產生的程式碼Java、class都會在這裡面。

好，完成全部設定了，我們先寫一個靜態網頁看看有沒有與Tomcat整合，在webapp資料夾中建立一個文件index.html內容就是最有名的Hello World。
<html>
<body>
<h1>Hello World</h1>
<p/>
</body>
</html>

現在，點選Eclipse選單下方三個Tomcat圖示，左邊那個圖示來啟動Tomcat，在Eclipse下方的視窗中可以看到Tomcat運行的訊息。
然後我們開啟瀏覽器輸入http://localhost:8080/加上application名稱，如果剛剛設定的是/demo，那輸入http://localhost:8080/demo就可以看到Hello World訊息在瀏覽器中，這也表示Tomcat運作正常。

再來我們要開始寫WebWork程式了。我們先建立一個Class檔案叫做HelloAction，應該建立在專案裡的src/java資料夾中，內容如下。
package us.arez.action;

import com.opensymphony.xwork.ActionSupport;

public class HelloAction extends ActionSupport {

private String world;

public String getWorld() {
return world;
}

public void setWorld(String world) {
this.world = world;
}

public String execute() throws Exception {
world = "Hello World from your Action";
return SUCCESS;
}
}

因此我們必須去更改xwork.xml的內容，知道這個動作(action)的存在。
<!DOCTYPE xwork PUBLIC "-//OpenSymphony Group//XWork 1.1.1//EN" "http://www.opensymphony.com/xwork/xwork-1.1.1.dtd">
<xwork>
<include file="webwork-default.xml"/>
<package name="default" extends="webwork-default">
<action name="hello" class="us.arez.action.HelloAction">
<result name="success">hello.jsp</result>
</action>
</package>
</xwork>

然後需要在歡迎頁面加入這個動作(action)的連結，所以我們更改index.html的內容為：
<html>
<body>
<h1>Hello World</h1>
<p/>

<a href="hello.action">Hello World Action</a>

</body>
</html>

最後我們還需要為這個動作(action)設定一個結果返回頁面，所以在webapp資料夾中建立了一個hello.jsp檔案。
<%@ taglib uri="/webwork" prefix="ww"%>

<html>
<body>
<h1>This is my first WebWork action</h1>
<p/>
What did the action say? <ww:property value="world"/>

</body>
</html>

現在按瀏覽器重新整理的按鈕，可以看到網頁內多了一個連結，點下去這個連結，就會執行WebWork動作(action)並秀出結果返回頁面。
現在更新HelloAction.java的內容，如把world = "Hello World from your Action";改成world = "Hello World Wonderfully";，儲存檔案，然後點選瀏覽器的重新整理按鈕，看到畫面的改變了吧，這不是很棒嗎！！

除錯
並沒什麼問題，只要在程式碼設定中斷點，然後就可以在Tomcat中除錯了，真的是簡單愉快的事情阿。

相关文章还有：
http://cwiki.apache.org/WW/setting-up-eclipse-with-tomcat.html