本文為原創,如需轉載,請注明作者和出處,謝謝!
源碼與jar包下載(將rar改成jar,直接放在WEB_INF\lib目錄中即可)
眾所周知,Strut 2的Action類通過屬性可以獲得所有相關的值,如請求參數、Action配置參數、向其他Action傳遞屬性值(通過chain結果)等等。要獲得這些參數值,我們要做的唯一一件事就是在Action類中聲明與參數同名的屬性,在Struts 2調用Action類的Action方法(默認是execute方法)之前,就會為相應的Action屬性賦值。
要完成這個功能,有很大程度上,Struts 2要依賴于ValueStack對象。這個對象貫穿整個Action的生命周期(每個Action類的對象實例會擁有一個ValueStack對象)。當Struts 2接收到一個.action的請求后,會先建立Action類的對象實例,并且將Action類的對象實例壓入ValueStack對象中(實際上,ValueStack對于相當一個棧),而ValueStack類的setValue和findValue方法可以設置和獲得Action對象的屬性值。Struts 2中的某些攔截器正是通過ValueStack類的setValue方法來修改Action類的屬性值的。如params攔截器用于將請求參數值映射到相應成Action類的屬性值。在params攔截器中在獲得請求參數值后,會使用setValue方法設置相應的Action類的屬性。
從這一點可以看出,ValueStack對象就象一個傳送帶,當客戶端請求.action時,Struts 2在創建相應用Action對象后就將Action對象放到了ValueStack傳送帶上,然后ValueStack傳送帶會帶著Action對象經過若干攔截器,在每一攔截器中都可以通過ValueStack對象設置和獲得Action對象中的屬性值。實際上,這些攔截器就相當于流水線作業。如果要對Action對象進行某項加工,再加一個攔截器即可,當不需要進行這項工作時,直接將該攔截器去掉即可。
下面我們使用一個例子來演示這個過程。在這個例子中實現了一個攔截器,該攔截器的功能是將一個屬性文件中的key-value對映射成相應的屬性的值。如下面是一個屬性文件的內容:
name = 超人
price = 10000
我們可以在Action類中定義name和price屬性,在Action中引用這個攔截器后,就會自動為屬性賦值。
在使用該攔截器有如下規則:
1. 攔截器讀取的屬性文件路徑由path參數指定。
2. 屬性文件的編碼格式由encoding參數指定,默認值是UTF-8。
3. 如果某個key中包含有“.”(該符號不能出現在標識符中),則有如下處理方法:
(1)將Action類的屬性名定義為去掉“.”的key。例如,key為person.name,而屬性名可定義為personname。
(2)將Action類的屬性名定義為將“.”替換成其他字符的表示符號。例如,key為person.name,而屬性名可定義為person_name,其中“_”由separator參數指定。
4. 如果key太長,也可以直接使用Action參數進行映射,例如,key為country.person.name,可做如下映射:
<param name="countrypersonname">name</param>
要注意的是,name屬性值不能包含“.”,因此,應將key值中的“.”去掉。現在就可以直接在Action類中定義名為name的屬性的,name屬性的值會與key值相同。
5. 上面所有的規則可以同時使用。
攔截器的源代碼:
package interceptors;
import java.util.Enumeration;
import java.util.Map;
import java.util.Properties;
import java.io.InputStream;
import java.io.FileInputStream;
import com.opensymphony.xwork2.ActionContext;
import com.opensymphony.xwork2.ActionInvocation;
import com.opensymphony.xwork2.config.entities.ActionConfig;
import com.opensymphony.xwork2.interceptor.AbstractInterceptor;
import com.opensymphony.xwork2.util.ValueStack;
public class PropertyInterceptor extends AbstractInterceptor
{
private static final String DEFAULT_PATH_KEY = "path";
private static final String DEFAULT_ENCODING_KEY = "encoding";
private static final String DEFAULT_SEPARATOR_KEY = "separator";
protected String pathKey = DEFAULT_PATH_KEY;
protected String encodingKey = DEFAULT_ENCODING_KEY;
protected String separatorKey = DEFAULT_SEPARATOR_KEY;
public void setPathKey(String pathKey)
{
this.pathKey = pathKey;
}
public void setEncodingKey(String encodingKey)
{
this.encodingKey = encodingKey;
}
public void setSeparatorKey(String separatorKey)
{
this.separatorKey = separatorKey;
}
@Override
public String intercept(ActionInvocation invocation) throws Exception
{
ActionConfig config = invocation.getProxy().getConfig();
Map<String, String> parameters = config.getParams();
if (parameters.containsKey(pathKey))
{
String path = parameters.get(pathKey);
String encoding = parameters.get(encodingKey);
String separator = parameters.get(separatorKey);
if (encoding == null)
encoding = "UTF-8";
if (separator == null)
separator = "";
path = invocation.getAction().getClass().getResource(path)
.getPath();
Properties properties = new Properties();
InputStream is = new FileInputStream(path);
java.io.Reader reader = new java.io.InputStreamReader(is, encoding);
properties.load(reader);
ActionContext ac = invocation.getInvocationContext();
ValueStack stack = ac.getValueStack();
System.out.println(stack.hashCode());
Enumeration names = properties.propertyNames();
while (names.hasMoreElements())
{
// 下面會使用setValue方法修改ValueStack對象中的相應屬性值
String name = names.nextElement().toString();
if (!name.contains("."))
stack.setValue(name, properties.get(name));
String newName = null;
newName = parameters.get(name.replaceAll("\\.", ""));
if (newName != null)
stack.setValue(newName, properties.get(name));
if (!separator.equals(""))
{
newName = name.replaceAll("\\.", "");
stack.setValue(newName, properties.get(name));
}
newName = name.replaceAll("\\.", separator);
stack.setValue(newName, properties.get(name));
}
}
return invocation.invoke();
}
}
用于測試的Action類的源代碼:
package actions;
public class MyAction
{
private String name;
private Integer price;
private String log4jappenderstdout;
private String log4j_rootLogger;
private String conversionPattern;
public String getName()
{
return name;
}
public void setName(String name)
{
this.name = name;
}
public Integer getPrice()
{
return price;
}
public void setPrice(Integer price)
{
this.price = price;
}
public String getLog4jappenderstdout()
{
return log4jappenderstdout;
}
public void setLog4jappenderstdout(String log4jappenderstdout)
{
this.log4jappenderstdout = log4jappenderstdout;
}
public String getLog4j_rootLogger()
{
return log4j_rootLogger;
}
public void setLog4j_rootLogger(String log4j_rootLogger)
{
this.log4j_rootLogger = log4j_rootLogger;
}
public String getConversionPattern()
{
return conversionPattern;
}
public void setConversionPattern(String conversionPattern)
{
this.conversionPattern = conversionPattern;
}
public String execute()
{
System.out.println("name:" + name);
System.out.println("price:" + price);
System.out.println("log4jappenderstdout:" + log4jappenderstdout);
System.out.println("log4j_rootLogger:" + log4j_rootLogger);
System.out.println("conversionPattern:" + conversionPattern);
return null;
}
}
Action類的配置代碼如:
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.1//EN"
"http://struts.apache.org/dtds/struts-2.1.dtd">
<struts>
<package name="struts" extends="struts-default">
<interceptors>
<interceptor name="property"
class="interceptors.PropertyInterceptor" />
<interceptor-stack name="myStack">
<interceptor-ref name="defaultStack" />
<interceptor-ref name="property" />
</interceptor-stack>
</interceptors>
<action name="test" class="actions.MyAction">
<interceptor-ref name="myStack" />
<param name="path">/log4j.properties</param>
<param name="encoding">UTF-8</param>
<param name="separator">_</param>
<param name="log4jappenderstdoutlayoutConversionPattern">
conversionPattern
</param>
</action>
</package>
</struts>
請將log4j.properties文件復制到WEB-INF\classes目錄,并在該文件中加入name和price屬性。
測試結果:
name:中國
price:34
log4jappenderstdout:org.apache.log4j.ConsoleAppender
log4j_rootLogger:error, stdout
conversionPattern:%d{ABSOLUTE} %5p %c{1}:%L - %m%n
由于property攔截器在defaultStack后引用,因此,在該攔截器中設置的屬性值是最終結果,如果將property攔截器放在defaultStack前面(將兩個<interceptor-ref>元素掉換一下),就可以通過同名勝Action配置參數或請求參數來干預最終究輸出結果了。
下一篇:
Struts 2雜談(2):如何向標簽文件中的Struts 2標簽傳遞參數值
新浪微博:http://t.sina.com.cn/androidguy 昵稱:李寧_Lining