在应用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);
}
}