JSF Faces API中的FacesContext和ExternalContext.docVIP

HYPERLINK /blog/434969 JSF Faces API中的FacesContext和ExternalContext 关键字: facescontext和externalcontext 在Faces API中有两个类是要经常使用的. 一个是FacesContext 一个是ExternalContext.首先讲解如何使用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实例里封装的其他一些对象。 3.2.1? 获取当前实例 一个经常用到的方法是静态的getCurrentInstance方法，它返回当前的FacesContext实例。此方法的签名如下： public static FacesContext getCurrentInstance() 下面的代码是一个用此方法获取FacesContext当前实例的例子： FacesContext facesContext = FacesContext.getCurrentInstance(); 3.2.2? 获取和修改组件树 FacesContext实例里最重要的内容是请求页面的组件树。组件树是由javax.faces.tree.Tree类来表示的(本章后面的“使用Tree类”一节会讨论)。FacesContext实例的tree属性就是Tree对象。 要获取或修改Tree对象，可使用tree属性的读取方法和赋值方法： public abstract Tree getTree() public abstract void setTree(Tree tree) 3.2.3? 添加和获取消息 在 请求处理生命周期里，可能会遇到错误。比如，当验证器执行输入验证时，因为用户输入了不正确的值，验证可能失败；当组件试图把输入值转换为绑定到组件的模 型对象所需的类型时，也可能会失败。所有消息都必须存放到FacesContext实例里以备后面进行处理。比如，您可能希望在页面里显示错误消息，从而 为用户更正错误提供帮助。 错误消息是由javax.faces.application.Message接口(第11章再详细讨论)来表示的，您可以通过使用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.2.4? 添加和获取请求处理事件 UIComponent 可以生成FacesEvent对象。比如，当单击一个UICommand组件时，它会生成一个ActionEvent对象(ActionEvent类是 FacesEvent类的子类)。这个FacesEvent对象需要在FacesContext实例里保存起来，以备请求处理生命周期里的下一步处理事件 时所用。 可通过使用FacesC