JSF--javax.faces.context.FacesContext

[转载]JSF--javax.faces.context.FacesContext

阅读：304 2011-11-10 23:13

标签： 转载

原文地址： JSF--javax.faces.context.FacesContext

原文作者： Step_Forward

FacesContext保存了组件书的一个引用，由它为请求进行渲染；贯穿整个请求处理生命周期，你可以通过FacesContext访问组件树；而且贯穿整个生命周期，你可以更改或替换他的当前组件树。
对每个JSF请求，FacesServlet对象都会为其获取一个javax.faces. context.FacesContext类的实例。FacesServlet对象将下列3个取自Web容器的对象传给javax.faces.context.FacesContextFactory对象的getFacesContext方法，以此来做到这一点：
javax.servlet.ServletContext
javax.servlet.ServletRequest
javax.servlet.ServletResponse
这意味着FacesContext的实例里包含了所有处理JSF请求所需的每个请求的状态信息。图3-1展示了FacesContext实例里封装的其他一些对象。
1.获取当前实例
一个经常用到的方法是静态的getCurrentInstance方法，它返回当前的FacesContext实例。此方法的签名如下：
public static FacesContext getCurrentInstance()
下面的代码是一个用此方法获取FacesContext当前实例的例子：
FacesContext facesContext = FacesContext.getCurrentInstance();
2.添加和获取消息
在请求处理生命周期里，可能会遇到错误。比如，当验证器执行输入验证时，因为用户输入了不正确的值，验证可能失败；当组件试图把输入值转换为绑定到组件的模型对象所需的类型时，也可能会失败。所有消息都必须存放FacesContext实例里以备后面进行处理。比如，您可能希望在页面里显示错误消息，从而为用户更正错误提供帮助。
错误消息是由javax.faces.application.Message接口来表示的，您可以通过使用FacesContext类的addMessage方法向FacesContext实例里添加Message对象。这个方法的签名如下：
public abstract void addMessage(UIComponent component, Message message)
如果component不为空，新加入的message就关联到component上。否则，它就不与任何特定组件的实例相关。举例来说，验证器在验证组件值失败时可调用FacesContext的addMessage方法，传入值无效的组件及一个包含特定错误消息的Message对象。
所有添加到FacesContext实例的Message对象都被加入到一个集合里。可通过调用getMessages方法的两个重载方法之一来获取加入的Message对象：
public abstract Iterator getMessages()
public abstract Iterator getMessages(UIComponent component)
第一种形式的调用在一个Iterator里返回所有Message对象，而第二种形式的调用则仅返回与给定UIComponent相关联的Message对象。
3. 向Response对象里写入信息
为了向Response对象里写入信息，FacesContext类提供了两个属性，一个是javax.faces.Context.ResponseStream类型，另一个是javax.faces.context.ResponseWriter类型。
ResponseStream类型的对象用于输出二进制数据，而ResponseWriter类型的对象则用于输出字符。这些属性的读取方法和赋值方法如下：
public abstract ResponseStream getResponseStream()
public abstract void setResponseStream(ResponseStream responseStream)
public abstract ResponseWriter getResponseWriter()
public abstract void setResponseWriter(ResponseWriter responseWriter)
4.操作请求处理生命周期
FacesContext类还提供了两个方法与请求处理生命周期进行交互：
在当前阶段的处理完成后，调用renderResponse方法通知JSF实现把控制权转到呈现响应阶段。也就是说，处于当前阶段和呈现响应阶段之间的所有其他阶段都不再执行。
调用responseComplete方法，告诉JSF实现此次请求的HTTP响应已经完成(比如在使用了HTTP重定向的情况下)。因此，当前阶段完成后，必须中止请求处理生命周期的处理。
这些方法的签名如下：
public abstract void renderResponse()
public abstract void responseComplete()
5.获取其他请求状态信息
其他每个请求的状态信息封装在ExternalContext对象里，可以使用getExternalContext方法获取该对象：
public abstract ExternalContext getExternalContext()