把 JSF、Spring 與 iBatis 湊在一起時,最容易出錯的地方往往不是程式碼,而是幾個 XML 設定檔之間的銜接。以下記錄組裝過程中的關鍵設定。
关键是註冊兩個 listener:一個啟動 MyFaces,一個啟動 Spring 的根容器。順序上讓 Spring 的 ContextLoaderListener 在後,確保 JSF 元件初始化時 Spring 已就緒。
<listener>
<listener-class>
org.apache.myfaces.webapp.StartupServletContextListener
</listener-class>
</listener>
<listener>
<listener-class>
org.springframework.web.context.ContextLoaderListener
</listener-class>
</listener>
把 BasicDataSource 與 SqlMapClient 都宣告在 Spring 裡,iBatis 就不需要自己管連線與設定檔載入。
<!-- 資料來源 -->
<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource"
destroy-method="close">
<property name="driverClassName">
<value>com.mysql.jdbc.Driver</value>
</property>
<property name="url">
<value>jdbc:mysql://192.168.102.19/bookadmin</value>
</property>
<property name="username"><value>bookadmin</value></property>
<property name="password"><value>db_password</value></property>
</bean>
<!-- iBatis SqlMap 客戶端 -->
<bean id="sqlMapClient"
class="org.springframework.orm.ibatis.SqlMapClientFactoryBean">
<property name="configLocation">
<value>classpath:thiz/ks/bookadmin/dao/ibatis/SqlMapConfig.xml</value>
</property>
<property name="dataSource"><ref bean="dataSource" /></property>
</bean>
最後一項 dataSource 千萬別漏掉。如果只給 configLocation,SqlMapClient 會照 iBatis 自己的設定去找連線,前面定義的 dataSource 形同白寫——這是這個組合最常見的踩雷點。
iBatis 的 SqlMapConfig.xml 與 JSF 的 faces-config.xml 則照各自慣例撰寫即可。
${db.password} 這類佔位符,搭配 PropertyPlaceholderConfigurer 從外部設定檔或環境變數注入。classpath: 前綴要求檔案在 classpath 上,放在 WEB-INF/classes 底下最保險。