关于JSF2中自定义组件处理表单值的一些问题

在应用JSF2框架的时候，有时候会想要自定义一些功能比较复杂的组件。

在组件的定义中，我使用的是直接从UIComponentBase继承实现组件。仅仅是将组件渲染至浏览器很简单，只要实现encodeAll(或者encodeBegin等方法)就可以了。

但其中对于值的处理碰见了一些问题。

比如当把组件嵌入一个表单中，组件的值会正常提交，并且该值也会存储在ExternalContext的一个Map中，通过getRequestParameter()方法可以得到改Map。该Map中存储了所有表单的值。对于Map中的值可以在JSF框架下的任何对象通过获得当前的FacesContext进而得到ExternalContext而取得相应的值。在托管bean中也可以，就像下面这样：

       FacesContextcontext = FacesContext.getCurrentInstance();
       Map<String,String> map =context.getExternalContext().getRequestParameterMap();
       for(String key:map.keySet()){
           System.out.println(key + "------" + map.get(key));
       }

但这样写的话，在渲染的组件中，必须明确定义组件的name属性，因为在ParameterMap中的值就是按照通常的表单的名值对存储的。

在JSF中应用托管bean，通过EL直接将值绑定到托管bean的某一属性上。这是通过ValueExpression实现的。通过组件的getValueExpression(String s)方法可以获得某一个属性的ValueExpression对象值ve。但初始时通过ve.getValue(ELContextcontext)方法并不能得到提交的值。该值需要通过ve.setValue手动设置。就像下面这样：

       Map<String,String>requestMap=context.getExternalContext().getRequestParameterMap();
       String submitValue = requestMap.get(this.getClientId());
       ValueExpression ve =this.getValueExpression("value");
       ve.setValue(context.getELContext(), submitValue);

一旦设置这个值后，StateHelper就可以通过eval方法取得相应的值，但不能通过get方法得到该值。如果想要通过get方法取得值的话，需要显示的使用put方法设置StateHelper。

同时，在执行ve.setValue方法后，托管bean的属性也就相应地绑定了所需的值。

以上的过程都应该在组件的decode方法中进行，decode方法组JSF应用程序的生命周期的应用请求值阶段被调用，此时对值进行相应的处理便于在以后的生命周期中使用。

下面是一个简单的自定义组件

@FacesComponent(createTag = true,tagName="test",namespace="http://chl290115231.com/mmis2")
public class HtmlTestInput extends UIComponentBase implements ValueHolder{
    
    enum PropertyKeys{
        value,
        converter
    }
     

    @Override
    public Object getLocalValue() {
        return this.getStateHelper().get(PropertyKeys.value);
    }

    @Override
    public Object getValue() {
        return this.getStateHelper().eval(PropertyKeys.value);
    }

    @Override
    public void setValue(Object value) {
        this.getStateHelper().put(PropertyKeys.value, value);
    }

    @Override
    public Converter getConverter() {
        return (Converter)this.getStateHelper().get(PropertyKeys.converter);
    }

    @Override
    public void setConverter(Converter converter) {
        this.getStateHelper().put(PropertyKeys.converter, converter);
    }

    @Override
    public String getFamily() {
        return "my.components";
    }
    
    @Override
    public void encodeAll(FacesContext context) throws IOException{
        ResponseWriter writer = context.getResponseWriter();
        writer.startElement("input", this);
        writer.writeAttribute("name",this.getClientId(), "name");
        writer.writeAttribute("type", "text", null);
        writer.endElement("input");
    }
    
    @Override
    public void decode(FacesContext context){
        Map<String,String> requestMap = context.getExternalContext().getRequestParameterMap();
        String submitValue = requestMap.get(this.getClientId());
        ValueExpression ve = this.getValueExpression("value");
        ve.setValue(context.getELContext(), submitValue);
        System.out.println("VE HtmlTestInput: "+ve.getValue(context.getELContext()));
        Object v1 = getLocalValue();//这是null值
        Object v2 = getValue();//这能够取得正确的值
        System.out.println("HtmlTestInput V1: "+v1);
        System.out.println("HtmlTestInput V2: "+v2);
    }
    
}