作者在這裏創建的是maven工程,沒有了解過如何使用maven的同學請先學習如何使用maven搭建項目。
一、jar包引入
作者引入的是2.3.7版本的struts2-core包。
pom的配置可以在http://mvnrepository.com網站搜索到。
<dependency>
<groupId>org.apache.struts</groupId>
<artifactId>struts2-core</artifactId>
<version>2.3.7</version>
</dependency>
使用maven可以方便的將核心jar包依賴的其他jar包自動導入。所以在pom只需要指定一個struts2-core的依賴就可以了。
二、web.xml配置
因爲struts2的控制器是基於攔截器實現的。所以我們需要在web.xml文件中配置好FileterDispatcher攔截器,並且攔截所有servlet請求。
<!-- 定義struts2的攔截器 -->
<filter>
<filter-name>struts2</filter-name>
<filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-class>
<!-- 此處用來配置struts.xml的位置-->
<init-param>
<param-name>config</param-name>
<param-value>struts-default.xml,struts-plugin.xml,struts.xml</param-value>
</init-param>
</filter>
<!-- 定義攔截器攔截的請求,這裏配置成攔截所有請求 -->
<filter-mapping>
<filter-name>struts2</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
不同版本struts2的攔截器類請看這裏
maven項目因爲目錄結構不同於普通的web項目。一般把配置文件放在/src/main/resource目錄下。所以會導致struts.xml文件讀取不到–進而導致請求頁面出現here is no Action mapped for action name xxxx。出現這樣的情況應如代碼塊中的代碼一樣在web.xml文件中指定攔截器讀取的配置文件–標籤。
ps: struts2的配置文件可以設置設置多個選項使用逗號隔開。搜索是從classpath根目錄開始的,所以讀者可以自己設置struts.xml存放的路徑記得放在/src/main/resource/目錄下即可。
三、struts2.xml配置
1. 基礎struts2.xml文件
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.3//EN"
"http://struts.apache.org/dtds/struts-2.3.dtd">
<struts>
<!-- 未設置內容 -->
</struts>
如果讀者不是引入2.3版本的struts2,應將上面的配置文件中http://struts.apache.org/dtds/struts-2.3.dtd改爲http://struts.apache.org/dtds/struts-2.x.dtd–x爲你的版本。
2. 標籤
<package name="user" namespace="/user">
</package>
屬於的子標籤。其作用是爲了更好地管理配置信息,實現配置的重用。
屬性
- name:定義包的名稱,在被別的包繼承時使用。唯一不能重複。
- namespace:定義了url請求和package的映射。可以重複。
- extends:指向被繼承的package的name。一般要繼承struts-default。
- abstract:設置爲true則這個package僅用作組織配置信息。不映射任何請求到action。
3. 標籤
<action name="login" class="struts2.basic.action.UserAction" method="login">
</action>
action的作用作爲邏輯控制器,處理請求並返回邏輯視圖
屬性
- name:與所屬package的namespace組成一個action請求。必選。
- class:定義action的處理類。可選。
- method:定義處理類具體執行的方法,默認爲excute。可選。
4. 標籤
<!-- result定義了action的返回邏輯視圖和物理視圖的映射 -->
<result name="page">/user/login.jsp</result>
<result name="success">/user/profile.jsp</result>
是屬於的子標籤。
result的作用是定義了action邏輯視圖和物理視圖之間的映射關係。
屬性
- name:與action返回的結果對應。缺省值爲success。
- type:默認爲dispatch。返回頁面。後文再詳細介紹
ps:邏輯視圖淺顯的講就是一個字符串。物理視圖就是返回的jsp頁面。
代碼示例
可以在github下載study項目中的struts2.basic項目。查看示例源碼
struts2.basic源碼地址
問題與解決
- jsp頁面EL表達式無效?
解決:jsp頁面添加如下代碼
<%@ page isELIgnored="false" %>
2.struts-default.xml文件沒找到。
解決:和自己配置的struts.xml一樣,在web.xml中指定struts-default.xml的搜索路徑。
讀者有任何有關疑問都歡迎留言,所反饋問題與解決方法最後都會找個時間加入到study項目的wiki中。
最後
這會是一場持久戰。