Struts2中的ValueStack类

        众所周知，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，可做如下映射：
        <paramname="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>  

<?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配置参数或请求参数来干预最终究输出结果了。
        action实例、xxxScope对象都在ValueStack内，直接使用${}调用。
        使用append标签时，没有所谓的将map和list集合对象连接起来的说法，创建map对象的语法为#{:,}，如果省略冒号，则默认value为null。
        StackContext 中的对象可以理解为struts2标签库使用的专用对象，比如通过value属性调用：value="#xxx.xxx.xxx..."
        ValueStack是StackContext的顶级对象，可以不需要#前缀使用，StackContext中的某些已建立对象可以通过比如在某些标签中设置var属性调入根对象ValueStack，达到省略#号的目的。在实际中则可以理解为在标签内临时新建的一个或多个对象，通过var属性指定的名称访问value="xxx.xxx.xxx...."
        ${requestScope.xxx.name} 与 <s:propertyvalue="#request.xxx.name"/>（escapse属性设置为false） 表达的内容相同，都是输出request范围内的xxx对象的name属性值，且无论是否该值包含html代码；