記下來

一路上踩到的坑、遇到的問題，一點一滴記下來，希望能幫助到需要的人~

Struts 1.3 + Spring 3.2 + Hibernate 3.6 錯誤筆記

作者: · 最後更新 · 發表於 · 網頁後端 / Web Server

買了一本「王者歸來 Java Web 整合開發 (第二版)」，書中包含了 JSP + Servlet + Struts + Hibernate + Spring 等的教學及範例，K了一個星期後，發現最困難的部份竟然在環境架設上，光是環境架設就花了好長的時間，再來是設定檔，小蛙的 Eclipse 有些設定檔的 auto-complete 跑不出東西，加上每個版本的套件下載下來後的 Jar 檔、設定檔都不相同，不同版本的整合方式也不同 … 花了很久的時間在環境架設及設定檔上，這篇文章不記錄完整經過(忘的差不多了)，只挑著把過程中要注意的事情及錯誤記錄下來。

  1. 隱藏 .jsp 頁面，對外以 .do 為主

    將 jsp 頁面通通放在 WEB-INF 底下，可自行建立其他分類資料夾，ex. pages, pages/admin, pages/member … 等。並且在 struts-conf.xml 中設定

    <action-mappings>
    <action path="/index" type="org.apache.struts.actions.ForwardAction" parameter="/WEB-INF/pages/index.jsp"></action>
</action-mappings>

  2. java.lang ClassNotFoundException 各式各樣怪怪的情況

    這情況太容易出現了，小蛙原本使用 Eclipse IDE 裡面自訂 User Library 的功能，卻一直報錯，最後把所有會用到的 Spring, Struts Jar 通通放在 Web/WEB-INF/lib 下，這些怪裡怪氣的錯誤就自己消失了 …

  3. 亂碼處理

    這應該是最容易遇到的問題，有幾項前提要先遵守：

    R1.  必須先將每一頁 JSP 或每一個 Servelt 設定成 UTF-8 編碼(小蛙直接用 UTF-8 編碼，可以省掉 BIG5 的一些麻煩)，如果是 Eclipse 專案請確定專案編碼為 UTF-8，有些文字編輯器可以看到目前檔案編碼。

    R2. 設定 JSP 表頭：
            <%@ page language=”java” contentType=”text/html; charset=UTF-8″ pageEncoding=”UTF-8″%>

    R3. html meta：
            <meta http-equiv=”Content-Type” content=”text/html; charset=UTF-8″>

    以上三個一定要指定同一編碼，確定之後接下來四種方法只要選一種來做就可以了：

    • 勤勞工人法：

      在每個 JSP 頁面及每個 Servelt 中設定

      request.setCharacterEncoding("UTF-8");
response.setCharacterEncoding("UTF-8");
    • 源頭搞定法：

      使用 tomcat 預設過濾器 (在 Tomcat安裝目錄/conf/ web.xml 中解開註解)

      <filter>
    <filter-name>setCharacterEncodingFilter</filter-name>
    <filter-class>org.apache.catalina.filters.SetCharacterEncodingFilter</filter-class>
    <init-param>
        <param-name>encoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
    <async-supported>true</async-supported>
</filter>
<filter-mapping>
    <filter-name>setCharacterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>
    • 自我肯定法：

      自定義過濾器
      CharacterEncodingFilter.java

      package com.hans.filter;
import java.io.IOException;
import javax.servlet.Filter;
import javax.servlet.FilterChain;
import javax.servlet.FilterConfig;
import javax.servlet.ServletException;
import javax.servlet.ServletRequest;
import javax.servlet.ServletResponse;
public class CharacterEncodingFilter implements Filter {
	private String characterEncoding;
	@Override
	public void init(FilterConfig config) throws ServletException {
		characterEncoding = config.getInitParameter("encoding");
	}
	@Override
	public void doFilter(ServletRequest request, ServletResponse response,
			FilterChain chain) throws IOException, ServletException {
		request.setCharacterEncoding(characterEncoding);
		response.setCharacterEncoding(characterEncoding);
		chain.doFilter(request, response);
	}
	@Override
	public void destroy() {
		characterEncoding = null;
	}
}

      web 下的 web.xml 加入對應

      <filter>
    <filter-name>CharacterEncodingFilter</filter-name>
    <filter-class>com.hans.filter.CharacterEncodingFilter</filter-class>
    <init-param>
        <param-name>encoding</param-name>
        <param-value>utf-8</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>CharacterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>
    • 套件嵌用法：

      使用 Spring 過濾器

      <filter>
    <filter-name>CharacterEncodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <init-param>
        <param-name>encoding</param-name>
            <param-value>utf-8</param-value>
    </init-param>
    <init-param>
        <param-name>forceEncoding</param-name>
      	<param-value>true</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>CharacterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

      以上幾種方法可以挑選適用於自己的方法來用，勤勞工人法是比較累一點，每一頁都要記得檢查，不然就可能在表單傳遞的時候發生亂碼。

  4. JNDI 錯誤

    javax.servlet.ServletException: javax.servlet.jsp.JspException: Unable to get connection, DataSource invalid: "org.apache.tomcat.dbcp.dbcp.SQLNestedException: Cannot create JDBC driver of class '' for connect URL 'null'"
javax.servlet.ServletException: org.apache.jasper.JasperException: javax.servlet.ServletException: javax.servlet.jsp.JspException: Unable to get connection, DataSource invalid: "org.apache.tomcat.dbcp.dbcp.SQLNestedException: Cannot create JDBC driver of class '' for connect URL 'null'"

    明明設定上沒有什麼問題，卻發生以上 exception，設定檔如下(MySQL)：

    <Resource name="jdbc/TestDB" auth="Container" type="javax.sql.DataSource"
	   maxActive="5" maxIdle="2" maxWait="60"
	   username="your_account" password="your_password" driverClassName="com.mysql.jdbc.Driver"
	   url="jdbc:mysql://your_domain:3306/your_database?characterEncoding=UTF-8"/>

    不管設定在 server.xml 的 <GlobalNamingResources> 標籤中、設定在 <Host> 標籤下或是設定在 localhost/context.xml 下都會出現上面的錯誤，如果有遇到這樣問題的網友，試試看設定在 Tomcat安裝目錄/conf/context.xml 裡面就不會發生這個錯誤囉！如果用這個方法要把 mysql-connector-java-5.1.22-bin.jar 複製到 Tomcat安裝目錄/conf/ 資料夾下。

    在 Spring 中加入上述 DataSource，可以供其他部份使用(透過 id 指定)

    <!-- 吃 tomcat 內部設定的 jndi 不然就要自己設定 -->
<bean id="dataSource" class="org.springframework.jndi.JndiObjectFactoryBean">
    <property name="jndiName" value="java:comp/env/jdbc/TestDB"></property>
</bean>

  5. Struts 標籤設定

    前面提到書上的範例是寫

    <%@ taglib uri="http://jakarta.apache.org/struts/tags-bean" prefix="bean" %>
<%@ taglib uri="http://jakarta.apache.org/struts/tags-html" prefix="html" %>

    Eclipse 頻頻出現錯誤訊息，後來才查到 1.3 版要改成以下才可以使用

    <%@ taglib uri="http://struts.apache.org/tags-bean" prefix="bean" %>
<%@ taglib uri="http://struts.apache.org/tags-html" prefix="html" %>

  6. struts-conf.xml 錯誤

    如果使用 1.3 的表頭檔是沒辦法設定標籤的

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

    要把它改成 1.2 版本的，並且要注意每個 tag 之間的順序，這邊出錯的時候 Eclipse 會列出順序，照著排就可以了。

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

  7. Action 中使用 getDataSource 錯誤

    書上的範例以及網路上查到的資料都說在 Struts Action 中，可以透過 getDataSource(request).getConnection(); 的方式來取得連接池的 Connection，實際上試了之後才會發現 1.3 根本就沒有 getDataSource 這個方法，繞了好久才找到必須透過以下方式取得剛剛設定在 context.xml 中的 datasource。

    DataSource ds = (DataSource)new InitialContext().lookup("java:comp/env/jdbc/TestDB");
Connection conn = ds.getConnection();

  8. Spring, Struts 接合

    接著設定 struts-config.xml 加入 <controller> 及 <plug-in> 標籤，這邊家玩如果有 ClassNotFoundException 一樣參考這篇文章第 2 點說明，Eclipse 有報錯要注意 tag 間的順序。

    <controller processorClass="org.springframework.web.struts.DelegatingRequestProcessor"></controller>
<plug-in className="org.springframework.web.struts.ContextLoaderPlugIn">
    <set-property value="/WEB-INF/beans-conf.xml" property="contextConfigLocation"/>
</plug-in>

    原本 struts-config.xml 中的 action 設定如下

    <action-mappings>
    <!-- 這種是預設到特定頁面的，為了隱藏 jsp -->
    <action path="/index" type="org.apache.struts.actions.ForwardAction" parameter="/WEB-INF/pages/index.jsp"></action>
    <!-- 接合 Spring 後的寫法，注意 action path (struts) 要跟 bean name (spring) 一致-->
    <action path="/hello2">
        <forward name="helloUser" path="/WEB-INF/pages/footer.jsp"></forward>
    </action>
</action-mappings>

    Spring 設定 beans-conf.xml 如下 (範例參考自良葛格學習筆記，userChecker 及 HelloAction 請參考 良葛格學習筆記)

    <bean id="userChecker" class="com.hans.pojo.UserChecker"></bean>
<!-- bean name 要跟 struts 裡面設定的 action path 一致 -->
<bean name="/hello2" class="com.hans.struts.action.HelloAction2">
    <property name="userChecker" ref="userChecker" />
</bean>
  9. Hibernate – getHibernateTemplate().find() 錯誤
    小蛙讓 MemberDao 繼承 HibernateDaoSupport 操作資料庫上比較方便，但透過 HibernateTemplate().find() 查找資料的時候(程式碼如下)

    List<Member> list = this.getHibernateTemplate().find("from Member member");
if(list.size() > 0)
    return list.get(0);

    出現以下錯誤

    javax.servlet.ServletException: org.springframework.orm.hibernate3.HibernateQueryException: unexpected token: member near line 1, column 29 [from com.hans.entity.Member member]; nested exception is org.hibernate.hql.ast.QuerySyntaxException: unexpected token: member near line 1, column 29 [from com.hans.entity.Member member]

    把 from Member member 改成 from member，出現下面錯誤

    javax.servlet.ServletException: org.springframework.orm.hibernate3.HibernateQueryException: unexpected token: member near line 1, column 6 [from member]; nested exception is org.hibernate.hql.ast.QuerySyntaxException: unexpected token: member near line 1, column 6 [from member]

    改成 from Member 之後才可正常執行，後來在這篇文章看到原來 … member 是保留字 … 難怪怎麼試都會錯，還以為自己哪裡有問題。

參考資料：

  1. Struts+Spring+Hibernate项目框架构建中的问题及解决方法集锦（1） @ Morecans的专栏
    http://blog.csdn.net/morecans/article/details/1686416
  2. Spring Gossip: 在 Struts 中整合 Spring @ 良葛格學習筆記
    http://caterpillar.onlyfun.net/Gossip/SpringGossip/StrutsSpring.html 
  3. Hibernate 查詢數據時報錯，請問這是什麽原因呢？急死了！ @ JWorld@TW
    http://www.javaworld.com.tw/jute/post/view?bid=41&id=171839

你可能也想知道：

    標籤：

    發佈留言

    發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *

    這個網站採用 Akismet 服務減少垃圾留言。進一步了解 Akismet 如何處理網站訪客的留言資料。