|
JAVA 程式碼分布在不同的目錄中，可以使用 APACHE ANT 或 ECLIPSE 編譯。 如果要把所有類別檔包裝成一個 JAR 檔，以方便複製與管理，可以使用 jar.exe 進行壓縮與包裝 。 |
|
ANT 的用法很簡單，需要一個編譯檔 build.xml 在原始碼的根目錄，接著在該目錄中執行 ant.bat 即可。
案子的根目錄。 
案子的類別庫檔目錄。 
案子的原始碼目錄。這裡顯示出來的是編譯前，actions 目錄中的 JAVA 原始檔。 
build.xml 01 <project name="Database Example" default="compile" basedir="."> 01 <description>This is a build file for the project</description> 01 <property environment="env"/> 01 <property name="tomcat.home" value="${env.CATALINA_HOME}"/> 01 <property name="lib.path" value="lib"/> 01 <property name="classes.path" value="classes"/> 01 <property name="source.path" value="src"/> 01 <path id="classpath"> 01 <pathelement location="${tomcat.home}/lib/servlet.jar"/> 01 </path> 01 <target name="create-dir"> 01 <mkdir dir="${classes.path}"/> 01 </target> 01 <target name="compile" depends="create-dir" 01 description="Compile Java codes"> 01 <javac classpathref="classpath" 01 destdir="${classes.path}" 01 srcdir="${source.path}" 01 includes="**/*.java"/> 01 </target> 01 <target name="clean" description="Remove all generated class files"> 01 <delete includeEmptyDirs="true"> 01 <fileset dir="${classes.path}" includes="**/*"/> 01 </delete> 01 </target> 01 </project> ANT 的執行過程與結果。 
編譯後，產生的類別檔目錄。這裡顯示出來的是編譯後，actions 目錄中的類別檔群。 
最後，將目錄 classes 的所有內容複製 (即目錄 com)，到 C:\Tomcat 5.5\webapps\begjsp-tourism\WEB-INF\classes，即可。 |
|
因為 JAVA 程式碼分布在不同的目錄中，筆者使用 ECLIPSE FOR JAVA，將 JAVA 程式碼放在同一個案子的 src 目錄。 編譯後，將 bin 的 class 目錄複製到 C:\Tomcat 5.5\webapps\begjsp-tourism\WEB-INF\classes。 
編譯前的最後一個動作是，到 ECLIPSE 的功能表 PROJECT 的 PROPERTIES，設定要引入的類別庫。
這些類別庫包括 jsp-api.jar、servlet-api.jar、struts.jar、mm.mysql-2.0.4-bin.jar。
類別庫 jsp-api.jar 和 servlet-api.jar 可以在 C:\Tomcat 5.5\common\lib 找到。 
編譯後，將目錄 bin 的所有內容複製(即目錄 com)，到 C:\Tomcat 5.5\webapps\begjsp-tourism\WEB-INF\classes，即可。 |
|
因為編譯完的類別檔分散在不同的目錄，複製與管理上可能會比較不方便，此時可使用 JAR.EXE 將目錄下的所有類別檔封裝。 這個範例是當類別檔群是在 C:\code\example\classes 的各子目錄中時，將此目錄內的類別檔全部壓縮並包裝能一個 JAR 檔。
完成後，將此 JAR 檔複製到 C:\Tomcat 5.5\webapps\begjsp-tourism\WEB-INF\lib，並清空 ~WEB-INF\classes 目錄內的檔案，即可。 |
|
執行方式是打開瀏覽器，輸入網址 http://localhost:8080/begjsp-tourism/，即可。 
|
|
宣告此 XML 檔的版本規格，版本 XML 1.0，文字的編碼規格為 ISO-8859-1。
宣告此 XML 檔的文件根元素 web-app，內容類型為網路應用程式 Web Application 2.2，根據的文件類型定義檔為 web-app_2_2.dtd。
在本機中檔案 web-app_2_2.dtd 位於 C:\jakarta-struts-1.0.2\lib，路徑已經包含在 TOMCAT 的 JAVA CLASSPATH，此檔案定義 web-app 的文件類型。
在這個範例中會使用到 web-app 的三個子元素 servlet、servlet-mapping、taglib。
宣告一個 ActionServlet，名稱為 action，使用資源檔 ApplicationResources.properties，優先權為二。 在這之後，凡指定 servlet-name 為 action 所宣告的元素，都會歸入到 SERVLET action。
宣告一個 DBInitServlet，名稱為 dbInit，使用 JDBC 驅動程式 org.gjt.mm.mysql.Driver，連結位址是 jdbc:mysql://localhost:3306/tourism_db。 允許最小連結數 1，最大連結數 10， SERVLET dbInit 的優先權為 1，表示為最高優先的 SERVLET。
所有 *.do 的要求都會由 servlet-class 所指示的 org.apache.struts.action.ActionServlet 服務。 ActionServlet 會根據 struts-config.xml 中的 action-mappings 所映射的路徑，執行 *.do 要求的服務。
歡迎畫面的檔案列表，這裡指列出一個檔案，所以 index.jsp 必須存在於網頁應用程式的根目錄。
宣告 STRUTS 的四個標籤函式庫 bean、html、logic、template。
宣告以下資源必須經過 attraction 確認通過後，才允許使用。但筆者覺得好像沒有用到。
宣告認證登入格式為表格登入，發生錯誤時繼續回到原登入頁。
|
|
宣告此 XML 檔的版本規格，版本 XML 1.0，文字的編碼規格為 ISO-8859-1。
宣告此 XML 檔的文件根元素 struts-config， 內容類型為 STRUTS 組態檔 Struts Configuration 1.0， 根據的文件類型定義檔為 struts-config_1_0.dtd。
所有子元素都在會 struts-config 標籤內宣告。
定義子元素 form-bean，包括 attractionForm 和 eventForm。
定義子元素 action-mappings，有 11 個動作要映射，包括 home.do、viewAttraction.do、 registerAttraction.do、editAttraction.do、updateAttraction.do、listEvents.do、 editEvent.do、updateEvent.do、deleteEvent.do、deregisterAttraction.do、logoff.do。 動作 validateEmployee 的動作類別是 com.example.ValidateEmployeeAction，使用的 BEAN 物件為 empForm，範圍為頁範圍。 輸入頁是 inputContent.jsp，動作成功時的轉送頁是 outputContent.jsp。
當 validateEmployee 動作執行時，會從 inputContent.jsp 傳遞四個物件 mapping、form、request、response 給 ValidateEmployeeAction 類別實例。 ValidateEmployeeAction 類別實例會執行其建構子和 perform 方法。 這四個物件會再從類別傳遞給 perform，並執行動作。
動作 fileUpload 的動作類別是 com.example.FileUploadAction，使用的 BEAN 物件為 fileUploadForm。 沒有輸入頁和轉送頁，這應該是是因為輸入和轉送都在同一頁，不需要設定。這個動作在這個範例中沒有用到。
|
|
STRUTS 中，JSP 檔的地位主要是畫面的構成。
透過 JSP 語法和標籤的使用，得到想要的網頁畫面效果。
這個範例使用到 19 個 JSP 檔案。
網頁畫面：
筆者將所有 JSP 檔依功能分類為特殊網頁檔、一般網頁檔、網頁內容檔。
一般網頁檔使用網頁樣板檔，佈置整個網頁的內容。
有些網頁的內容已經由樣板檔固定住，只留下畫面區域 3 給網頁檔使用。
各個網頁檔會取用自己的網頁內容檔，並將其設定到畫面區域 3，以構成完整的網頁畫面。
網頁內容檔雖然也是 JSP 檔，它只是完整網頁的一部分，不能獨自顯示於網頁上。 網頁內容檔會依據網頁樣板檔 template.jsp 的規劃，顯示漁網頁的畫面區域 3。
|
|
INDEX.JSP 是任何客端連結到網站時會觸發的第一個 JSP 網頁檔。 WEB.XML 設定了 INDEX.JSP 為網站的歡迎畫面，STRUTS 的 ACTION SERVLET 面對客端的要求，執行 INDEX.JSP，以回應客端。 INDEX.JSP 的程式碼很簡單的將網頁重新導向到動作 HOME.DO，最後轉送到 HOME.JSP。
HOME.JSP 的顯示畫面。
|
|
HOME.DO 是一個由 STRUTS-CONFIG.XML 定義的動作映射，STRUTS SERVLET 接著會執行其所屬的動作類別 com.wrox.tourism.actions.HomeAction。
HomeAction 類別的 perform 方法執行成功時，會將取得的資料以 attractionList 物件名稱儲存在要求頁物件，一起轉送給 home.jsp。
home.jsp 使用 homeContent.jsp 將資料內容顯示到網頁中，即完成 INDEX.JSP 歡迎網頁檔的資料畫面。
homeContent.jsp 的程式碼可視為 home.jsp 的一部分，所以透過 request 物件傳送給 home.jsp 的資料可以由 homeContent.jsp 直接取用。
這裡使用 STRUTS 邏輯迴圈標籤，將 attractionList 集合物件的內容一個個顯示出來。
迴圈的名稱是 attraction，這個名稱會在每次的迴圈中，代表 attractionList 中的一個物件，物件類別為 com.wrox.tourism.entity.Attraction，是一個 ACTION FORM 類別的實例。
request 表示 attractionList 物件是隨著 request 物件而來的，要到 request 物件中取得此物件。
|
|
當使用者從客端網頁上點了某一個 ATTRATION，會觸發 VIEWATTRACTION.DO 的動作。 VIEWATTRACTION.DO 會以其輸入參數 userId，從資料庫取得匹配的 ATTRACTION 的各項餐數和事件列表。 再將網頁轉送到 VIEWATTRATION.JSP，以顯示該 ATTRACTION 的詳細資訊。 
VIEWATTRACTION.DO 是一個由 STRUTS-CONFIG.XML 定義的動作映射，STRUTS SERVLET 接著會執行其所屬的動作類別 com.wrox.tourism.actions.ViewAttractionAction。
ViewAttraction 類別的 perform 方法執行成功時，會將取得的資料以 attractionForm 和 eventList 物件名稱儲存在要求頁物件，一起轉送給 viewAttraction.jsp。
viewAttraction.jsp 使用 viewAttractionContent.jsp 將資料內容顯示到網頁中，即完成 VIEWATTRACTION.DO 的超連結動作。 viewAttractionContent.jsp 的程式碼可視為 viewAttraction.jsp 的一部分，所以透過 request 物件傳送給 viewAttraction.jsp 的資料可以由 viewAttractionContent.jsp 直接取用。 這裡使用 STRUTS BEAN 寫入標籤將 attrationForm 的內容顯示出來，並使用 STRUTS 邏輯迴圈標籤，將 eventList 集合物件的內容一個個顯示出來。 迴圈的名稱是 event，這個名稱會在每次的迴圈中，代表 eventList 中的一個物件，物件類別為 com.wrox.tourism.entity.Event，是一個 ACTION FORM 類別的實例。 request 表示 eventList 物件是隨著 request 物件而來的，要到 request 物件中取得此物件。 顯示 attractionFrom 的內容。
顯示 evenList 的內容。
|
|
MENU.JSP 是一個比較特別的網頁檔，因為每一個網頁都會出現。 MENU.JSP 可以回到首頁，或到註冊頁，或透過動作映射執行 ATTRACTION、EVENT 的編輯工作。 
|
|
當使用者點了 Home，網頁就回到首頁。
|
|
當使用者點了 Register，進入 ATTRACTION 註冊頁，註冊新的 ATTRACTION。
registerAttraction.jsp 會使用已經取得的 ATTRACTION 資料，繪製成表格給使用者填寫或修改。 當使用者按下 Register Attraction 後，就會觸發 registerAttraction.do 動作。
動作映射 registerAttraction.do 定義在 STRUTS-CONFIG.XML，會執行動作類別 com.wrox.tourism.actions.RegisterAttractionAction。 動作成功時，轉送到 confirmRegistration.jsp，顯示註冊成功訊息。
confirmRegistration.jsp 使用網頁樣板檔製作網頁，並在網頁區域 3 顯示成功訊息，意思是 ATTRACTION 已經成功註冊了。
|
|
當使用者點了 Logon，會執行動作 editAttraction.do，進入 ATTRACTION 註冊頁，註冊新的 ATTRACTION。 這裡使用了 STRUTS 邏輯標籤 notPresent，表示 attraction 角色不存在的話，才顯示這個超連結。 並且要使用這個連結之前，必須得到 attraction 角色的確認，才能執行 editAttraction.do。
|
|
為了實現角色確認，必須指定認證格式和確證方式。 認證格式部分，在 WEB-INF\WEB.XML 中指定 FORM 格式，認證頁為 login.jsp。 
認證格式部分，在 C:\Tomcat 5.5\conf\server.xml 中指定透過資料庫的認證方式。 Realm 是 TOMCAT 用來設定認證工作的描述，在 SERVER.XML 中已經有範本，只要去除註解，改成下面的參數，即可。
|
|
通過認證後，就會執行 editAttraction.do。 動作映射 editAttraction.do 定義在 STRUTS-CONFIG.XML，執行動作類別 com.wrox.tourism.actions.EditAttractionAction。 
動作成功時，網頁進入 editAttraction.jsp，ATTRACTION 編輯頁，註冊新的 ATTRACTION。動作失敗時，回到首頁。
editAttraction.jsp 編輯 ATTRACTION 的內容，包括 password、name、webSite、address、description 等欄位。 完成後，按下 Update Attraction 按鈕，觸發動作 updateAttraction.do，進行更新。
|
|
當已經是登入狀態時，才會顯示這部分的目錄。
|
|
當使用者點了 Attraction Details，執行 editAttraction.do，以 userId 從資料庫讀取 ATTRACTION 資料。 動作成功時，網頁進入 editAttraction.jsp，ATTRACTION 編輯頁，註冊新的 ATTRACTION。
動作映射 editAttraction.do 定義在 STRUTS-CONFIG.XML，執行動作類別 com.wrox.tourism.actions.EditAttractionAction。
EditAttractionAction 會使用 userId ，讀取資料庫相符合的 ATTRACTION，存入要求物件，並轉傳到 editAttraction.jsp。
editAttraction.jsp 編輯 ATTRACTION 的內容，包括 password、name、webSite、address、description 等欄位。 完成後，按下 Update Attraction 按鈕，觸發動作 updateAttraction.do，進行更新。
|
|
當使用者點了 List Events，執行 listEvents.do。 
動作映射 listEvents.do 定義在 STRUTS-CONFIG.XML，會執行動作類別 com.wrox.tourism.actions.ListEventsAction。
動作類別 ListEventsAction 會讀取 ATTRACTION 的所有事件，網頁轉往 listEvents.jsp。
listEvents.jsp 將所有事件條列，每個事件都有二個超連結，可以編輯事件，也可以刪除事件。
當使用者點了事件名稱，就會觸發動作 editEvent.do。 動作映射 editEvent.do 定義在 STRUTS-CONFIG.XML，會執行動作類別 com.wrox.tourism.actions.EditEventAction。 這一部分的動作和加入事件一樣，在下一節解說。 當使用者點了事件後面的 delete，就會觸發動作 deleteEvent.do。 動作映射 deleteEvent.do 定義在 STRUTS-CONFIG.XML，會執行動作類別 com.wrox.tourism.actions.DeleteEventAction。
動作類別 DeleteEventAction 使用 evenId，呼叫業務類別的 removeEvent 方法，移除事件。
業務類別 eventBO 使用 evenId，呼叫事件資料存取類別的 remove 方法，移除事件。
事件資料存取類別的 remove 方法執行資料庫的項目移除描述，將項目從事件目錄移除。
|
|
當使用者點了 Add Event，執行 editEvent.do。 
動作映射 editEvent.do 定義在 STRUTS-CONFIG.XML，會執行動作類別 com.wrox.tourism.actions.EditEventAction。
動作類別 EditEventAction 使用 eventId 讀取事件的資訊，存入 request 物件，轉送到 editEvent.jsp。
editEvent.jsp 將 request 物件傳過來的事件物件會顯示幾個文字區域，用來修改事件內容。 當使用者按下 Update，觸發 updateEvent.do，進行事件更新的動作。
|
|
當使用者點了 Deregister，執行 deregisterAttraction.do。
動作類別 DeregisterAttractionAction 會將 ATTRACTION 刪除，並將登入狀態取消，網頁轉往首頁。
|
|
當使用者點了 Logoff，執行 logoff.do。 動作映射 logoff.do 定義在 STRUTS-CONFIG.XML，會執行動作類別 com.wrox.tourism.actions.LogoffAction。 動作執行成功時，轉送 home.do，這會回到首頁。失敗的話，繼續留在編輯 ATTRACTION 的畫面。
動作類別 LogoffAction 會將登入狀態取消，網頁轉往首頁。
|
|
STRUTS 中，JAVA 語言主要是用在資料與邏輯運算的過程。
取得資料並且對資料做運算，再將資料轉送給 JSP 檔做成網頁是 JAVA 程式碼的功能。
這支程式共有 30 個類別檔分散在四個目錄中。
動作檔：
業務檔：
資料物件檔：
資料存取檔：
資料庫管理檔：
|
|
所有標籤檔都要放在 WEB-INF 目錄，並以 classes 為標籤類別檔的根目錄。 例如標籤類別 com.example.DepartmentTag 的路徑就是 WEB-INF\classes\com\example\DepartmentTag.class。
|
|
所有資源檔都要放在 WEB-INF\classes 目錄。 這支程式有一個資源檔 TourismResources.properties。 這裡設定了一些錯誤訊息的字串內容，透過 error.xxx.xxx 的方式引入 JAVA 程式碼。
|