JavaServer Faces Unit Test Framework

Question

Based on my knowledge, there isn't any handy JSF Unit test tools. To facilitate UI developers and QAs to do test, I have created a prototype project to evaluate a solution.
For a Simple JSF enabled JSP file:
<?xml version="1.0" encoding="UTF-8"?>
<jsp:root version="1.2" xmlns:f="http://java.sun.com/jsf/core" xmlns:h="http://java.sun.com/jsf/html" xmlns:jsp="http://java.sun.com/JSP/Page">
   <jsp:directive.page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" />
     <f:view>
          <h:form>
            <h:outputText value="Please input:"/>
               <h:inputText id="input1"/>
            <br/>
            <h:outputText value="Please input a integer:"/>
               <h:inputText style="width:50px;" converter="javax.faces.Integer"/>
            <h:commandButton value="Submit"/>     
       </h:form>
   </f:view>
</jsp:root>writing a HttpUnit to this page is obviously difficult:
1) Hard to pin-point the html element rendered by input1, because up-level NamingContainer h:form is missing id.
2) More difficult to find the second InputText, because missing two ids.
3) How to assert if the converter really works or not, we can't assert any object in PageBean by HttpUnit.
4) Much more difficult to find those html element if there are several level NamingContainer, such as the component nested within "for-loop".
I perfer not to write HttpUnit and seperate JUnit to PageBean, so if the follow JSP can be used in both test and production environment, work will be much easier:
* test1.jsp
<?xml version="1.0" encoding="UTF-8"?>
<jsp:root version="1.2" xmlns:test="http://www.yourcompany.com/jsf/test"  xmlns:f="http://java.sun.com/jsf/core" xmlns:h="http://java.sun.com/jsf/html" xmlns:jsp="http://java.sun.com/JSP/Page">
   <jsp:directive.page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" />
     <f:view>
        <test:parameter name="abc" value="def"/><!-- setting request parameter -->
          <h:form>
            <h:outputText value="Please input:"/>
               <h:inputText>
               <test:set value="hello"
/> <!-- emulate inputing "hello" to the text box -->
               <test:assert phase="afterUpdateModelValues" description="InputText1" var="input1" value="#{input1=='hello'}"/><!-- you can try other JSF phases as well, here var "input1" is parent jsf component -->
                  <test:assert description="InputText1" var="input1" value="#{input1=='hello'}"/>
<!-- use default phase "afterRenderResponse", here var "input1" is HtmlElement fetched from rendered page by HttpUnit -->
            </h:inputText>
            <br/>
            <h:inputText style="width:50px;" converter="javax.faces.Integer">
               <test:set actions="all" value="123"/>
               <test:assert phase="afterUpdateModelValues" description="Input2 Class Name" var="input2CN" value="#{input2CN.class.name == 'java.lang.Integer'}"/>
               <test:assert description="InputText2 value in afterRenderResponse phase" var="input2" value="#{input2=='123'}"/>
               <test:assert description="InputText2 Style" var="input2Style" valueAttribute="style" value="#{input2Style=='width:20px;height:25px;'}"/>
            </h:inputText>
            <br/>
            <h:commandButton value="Submit">
               <test:action description="Test Sumbit"/><!-- support multi actions -->
            </h:commandButton>     
       </h:form>
   </f:view>
</jsp:root> For production jsp you can use normal url, http://server:port/yourapp/faces/test1.jsp, those test:xxx components won't do anything.
For testing a single page, http://server:port/yourapp/faces/TestAction?view=/test1.jsp
For testing more pages, http://server:port/yourapp/faces/TestAction?suite=/suite1.xml and write file:
* suite1.xml
<?xml version='1.0' encoding='UTF-8'?>
<TestSuite>
   <page>/test1.jsp</page>
   <page>/test2.jsp</page>
</TestSuite> After running this test suite in sun jsf1.0 runtime, the result comes:
<?xml version="1.0" encoding="UTF-8" ?>
<Test suite="/suite1.xml">
  <Page id="/test1.jsp">
    <Action id="_id13" time="0 hour(s) 0 minute(s) 0 second(s) 31 millisecond(s)" description="Test Sumbit">
      <Assert id="_id5" description="InputText1">
         <afterUpdateModelValues pass="true" />
      </Assert>
      <Assert id="_id9" description="Input2 Class Name">
         <afterUpdateModelValues pass="true" />
      </Assert>
      <Assert id="_id6" description="InputText1">
         <afterRenderResponse pass="true" />
      </Assert>
      <Assert id="_id10" description="InputText2 value in afterRenderResponse phase">
         <afterRenderResponse pass="true" />
      </Assert>
      <Assert id="_id11" description="InputText2 Style">
         <afterRenderResponse pass="false" />
      </Assert>
    </Action>
  </Page>
  <Page id="/test2.jsp">
  </Page>
</Test> So far, if you think this idea is good for you, you can get the src code at the end of this post.
Furthermore, you can make improvement to this as well, such as implement concurrent and repeatable test.
Anyway, don't expect this two days prototype is quite robust, and coding is not my day to day work either.
If you have any questions or idea, please drop me a line: [email protected], [email protected]
*  jsftest.tld
<?xml version="1.0"?>
<!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"
"http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd">
<taglib>
     <tlib-version>1.0</tlib-version>
     <jsp-version>1.2</jsp-version>
     <short-name>test</short-name>
     <uri>http://www.yourcompany.com/jsf/test</uri>
     <display-name>JSF Test Tag Library</display-name>
     <description></description>
     <tag>
          <name>action</name>
          <tag-class>com.yourcompany.jsf.ui.test.taglib.ActionTag</tag-class>
          <body-content>empty</body-content>
          <display-name>Action</display-name>
          <description>JSF test submit action</description>
          <attribute>
               <name>binding</name>
               <required>false</required>
               <rtexprvalue>true</rtexprvalue>
          </attribute>
          <attribute>
               <name>id</name>
               <required>false</required>
               <rtexprvalue>true</rtexprvalue>
          </attribute>
          <attribute>
               <name>description</name>
               <required>false</required>
               <rtexprvalue>true</rtexprvalue>
          </attribute>
     </tag>     
     <tag>
          <name>assert</name>
          <tag-class>com.yourcompany.jsf.ui.test.taglib.AssertTag</tag-class>
          <body-content>empty</body-content>
          <display-name>Assert</display-name>
          <description>JSF test assertion</description>
          <attribute>
               <name>binding</name>
               <required>false</required>
               <rtexprvalue>true</rtexprvalue>
          </attribute>
          <attribute>
               <name>id</name>
               <required>false</required>
               <rtexprvalue>true</rtexprvalue>
          </attribute>
          <attribute>
               <name>actions</name>
               <required>false</required>
               <rtexprvalue>true</rtexprvalue>
                        <description>default value is "all", means all actions, use "," as delimeter</description>
          </attribute>
          <attribute>
               <name>phase</name>
               <required>false</required>
               <rtexprvalue>true</rtexprvalue>
                        <description>effective value can be anyone of: afterRestoreView,
                               beforeApplyRequestValues, afterApplyRequestValues,
                               beforeProcessValidations, afterProcessValidations,
                               beforeUpdateModelValues,  afterUpdateModelValues,
                               beforeInvokeApplication,  afterInvokeApplication,
                               beforeRenderResponse,     afterRenderResponse
                             The default value is afterRenderResponse, this assertion will be applied to HtmlElement rather than JSF Component.
                        </description>
          </attribute>
          <attribute>
               <name>value</name>
               <required>false</required>
               <rtexprvalue>true</rtexprvalue>
                        <description>must be boolean, means pass test or not</description>
          </attribute>
          <attribute>
               <name>var</name>
               <required>false</required>
               <rtexprvalue>true</rtexprvalue>
                        <description>variable name, used to define a request attribute which can be used in valueBinding language</description>
          </attribute>
          <attribute>
               <name>valueAttribute</name>
               <required>false</required>
               <rtexprvalue>true</rtexprvalue>
                        <description>The default is "value".
                                     var will be bound to this attribute.
                                     var will be bound to the rendered HtmlElement if the phase="afterRenderResponse",
                                     otherwise var will be bound to parent component.
                        </description>
          </attribute>
          <attribute>
               <name>postback</name>
               <required>false</required>
               <rtexprvalue>true</rtexprvalue>
                        <description>The default is "true".
                                     Currently only support true;
                        </description>
          </attribute>
          <attribute>
               <name>description</name>
               <required>false</required>
               <rtexprvalue>true</rtexprvalue>
          </attribute>
     </tag>
     <tag>
          <name>parameter</name>
          <tag-class>com.yourcompany.jsf.ui.test.taglib.ParameterTag</tag-class>
          <body-content>empty</body-content>
          <display-name>Set</display-name>
          <description>JSF test request parameter setter</description>
          <attribute>
               <name>binding</name>
               <required>false</required>
               <rtexprvalue>true</rtexprvalue>
          </attribute>
          <attribute>
               <name>id</name>
               <required>false</required>
               <rtexprvalue>true</rtexprvalue>
          </attribute>
          <attribute>
               <name>actions</name>
               <required>false</required>
               <rtexprvalue>true</rtexprvalue>
                        <description>default value is "all", means all actions, use "," as delimeter</description>
          </attribute>
          <attribute>
               <name>name</name>
               <required>true</required>
               <rtexprvalue>true</rtexprvalue>
          </attribute>
          <attribute>
               <name>value</name>
               <required>true</required>
               <rtexprvalue>true</rtexprvalue>
          </attribute>
     </tag>
     <tag>
          <name>set</name>
          <tag-class>com.yourcompany.jsf.ui.test.taglib.SetTag</tag-class>
          <body-content>empty</body-content>
          <display-name>Set</display-name>
          <description>JSF test component value setter</description>
          <attribute>
               <name>binding</name>
               <required>false</required>
               <rtexprvalue>true</rtexprvalue>
          </attribute>
          <attribute>
               <name>id</name>
               <required>false</required>
               <rtexprvalue>true</rtexprvalue>
          </attribute>
          <attribute>
               <name>actions</name>
               <required>false</required>
               <rtexprvalue>true</rtexprvalue>
                        <description>default value is "all", means all actions, use "," as delimeter</description>
          </attribute>
          <attribute>
               <name>value</name>
               <required>true</required>
               <rtexprvalue>true</rtexprvalue>
          </attribute>
     </tag>
</taglib>
*  faces-config.xml
<?xml version="1.0"?>
<!DOCTYPE faces-config PUBLIC
  "-//Sun Microsystems, Inc.//DTD JavaServer Faces Config 1.1//EN"
  "http://java.sun.com/dtd/web-facesconfig_1_1.dtd">
<faces-config>
  <component>
    <component-type>com.yourcompany.jsf.ui.test.Action</component-type>
    <component-class>com.yourcompany.jsf.ui.test.component.Action</component-class>
  </component>
  <component>
    <component-type>com.yourcompany.jsf.ui.test.Assert</component-type>
    <component-class>com.yourcompany.jsf.ui.test.component.Assert</component-class>
  </component>
  <component>
    <component-type>com.yourcompany.jsf.ui.test.Parameter</component-type>
    <component-class>com.yourcompany.jsf.ui.test.component.Parameter</component-class>
  </component>
  <component>
    <component-type>com.yourcompany.jsf.ui.test.Set</component-type>
    <component-class>com.yourcompany.jsf.ui.test.component.Set</component-class>
  </component>
  <lifecycle>
      <phase-listener>com.yourcompany.jsf.ui.test.listener.TestPhaseListener</phase-listener>
      <phase-listener>com.yourcompany.jsf.ui.test.listener.TestAssertPhaseListener</phase-listener>
  </lifecycle>
</faces-config>
*  TestPhaseListener.java
package com.yourcompany.jsf.ui.test.listener;
import java.io.InputStream;
import java.lang.reflect.Method;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Iterator;
import java.util.List;
import javax.faces.application.ViewHandler;
import javax.faces.component.UIComponent;
import javax.faces.component.UIViewRoot;
import javax.faces.context.FacesContext;
import javax.faces.context.ResponseWriter;
import javax.faces.event.PhaseEvent;
import javax.faces.event.PhaseId;
import javax.faces.event.PhaseListener;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import org.w3c.dom.Document;
import org.w3c.dom.NodeList;
import org.w3c.dom.Text;
import com.meterware.httpunit.HTMLElement;
import com.meterware.httpunit.PostMethodWebRequest;
import com.meterware.httpunit.WebConversation;
import com.meterware.httpunit.WebRequest;
import com.meterware.httpunit.WebResponse;
import com.sun.faces.renderkit.html_basic.HtmlResponseWriter;
import com.yourcompany.jsf.ui.component.UIIterate;
import com.yourcompany.jsf.ui.test.component.Action;
import com.yourcompany.jsf.ui.test.component.Assert;
import com.yourcompany.jsf.ui.test.component.Parameter;
import com.yourcompany.jsf.ui.test.component.Set;
import com.yourcompany.jsf.ui.test.report.Constants;
import com.yourcompany.jsf.ui.test.report.TestAction;
import com.yourcompany.jsf.ui.test.report.TestAssert;
import com.yourcompany.jsf.ui.test.report.TestPage;
import com.yourcompany.jsf.ui.test.report.TestReport;
import com.yourcompany.jsf.ui.util.ComponentUtil;
public class TestPhaseListener implements PhaseListener {
     public TestPhaseListener() {
          super();
          // TODO Auto-generated constructor stub
     /* (non-Javadoc)
      * @see javax.faces.event.PhaseListener#afterPhase(javax.faces.event.PhaseEvent)
     public void afterPhase(PhaseEvent event) {
          if(-1 != event.getFacesContext().getViewRoot().getViewId().indexOf("TestAction")){
               FacesContext context =      event.getFacesContext();
               ViewHandler vh = context.getApplication().getViewHandler();
               HttpServletRequest request = (HttpServletRequest)context.getExternalContext().getRequest();
               TestReport report = new TestReport();
               request.getSession().setAttribute(Constants.TEST_REPORT_SESSION_ATTRIBUTE_ID, report);
               String suitefile = request.getParameter("suite");
               List pages = new ArrayList(5);
               if(suitefile==null){
                    pages.add(request.getParameter("view"));
               }else{
                    report.setSuiteId(suitefile);
                    try{
                         DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
                      factory.setValidating(false);
                      factory.setNamespaceAware(false);
                      DocumentBuilder builder = factory.newDocumentBuilder();
                      InputStream ins = context.getExternalContext().getResourceAsStream(suitefile);
                      Document doc = builder.parse(ins);
                      NodeList pageNodes = doc.getElementsByTagName("page");
                      for(int i=0; i<pageNodes.getLength(); i++){
                           pages.add(((Text)pageNodes.item(i).getFirstChild()).getData());
                    }catch(Exception e){
                         report.setException(e);
               for(Iterator p=pages.iterator(); p.hasNext(); ){
                    String viewId = (String)p.next();
                    UIViewRoot view = vh.restoreView(context, viewId);
                    if(view==null){
                         try{
                            WebConversation wc = new WebConversation();
                            wc.putCookie("JSESSIONID", request.getSession().getId());
                            String url = getUrl(request, viewId);
                            WebResponse wr = wc.getResponse(url);
                         }catch(Exception e){
                              report.setException(e);
                         view = vh.restoreView(context, viewId);
                    try{
                         Method doActionMethod = TestPhaseListener.class.getDeclaredMethod("doAction", new Class[]{Action.class, FacesContext.class, HttpServletRequest.class, UIViewRoot.class, String.class});
                         ComponentUtil.iterateComponent(view, Action.class, this, doActionMethod, new Object[]{context, request, view, viewId});
                    }catch(Exception e){
                         report.setException(e);
               //render report
               renderReport(context, report);
               request.getSession().removeAttribute(Constants.TEST_REPORT_SESSION_ATTRIBUTE_ID);
               context.responseComplete();
     /* (non-Javadoc)
      * @see javax.faces.event.PhaseListener#beforePhase(javax.faces.event.PhaseEvent)
     public void beforePhase(PhaseEvent event) {
     /* (non-Javadoc)
      * @see javax.faces.event.PhaseListener#getPhaseId()
     public PhaseId getPhaseId() {
           return PhaseId.RESTORE_VIEW;
     private String getUrl(HttpServletRequest request, String viewId){
          return request.getScheme()+"://" + request.getServerName()+":"+request.getServerPort()+request.getContextPath()+"/faces"+viewId;
     protected void doAction(Action action, FacesContext context, HttpServletRequest request, UIViewRoot view, String viewId){
          try{
                  WebConversation wc = new WebConversation();
                  wc.putCookie("JSESSIONID", request.getSession().getId());
                  String url = getUrl(request, viewId);
                  WebRequest wrq = new PostMethodWebRequest(url);
                  wrq.setParameter(Constants.TEST_VIEW_PARAMETER, viewId);
                  wrq.setParameter(Constants.TEST_ACTION_PARAMETER, action.getId());
                  //set parameters
                  try{
                       Method doParameterMethod = TestPhaseListener.class.getDeclaredMethod("doParameter", new Class[]{Parameter.class, String.class, WebRequest.class});
                       ComponentUtil.iterateComponent(view, Parameter.class, this, doParameterMethod, new Object[]{action.getId(), wrq});
                  }catch(Exception e){
                       e.printStackTrace();
                  //set attributes
                  //set values
                  try{
                       Method doSetMethod = TestPhaseListener.class.getDeclaredMethod("doSet", new Class[]{Set.class, FacesContext.class, String.class, WebRequest.class});
                       ComponentUtil.iterateComponent(view, Set.class, this, doSetMethod, new Object[]{context, action.getId(), wrq});
                  }catch(Exception e){
                       e.printStackTrace();
                  //do test actions
                  String formId = null;
                  if(formId!=null)wrq.removeParameter(formId);
                  formId = ComponentUtil.getForm(action).getClientId(context);
                  wrq.setParameter(formId, action.getParent().getClientId(context));
                  long start = System.currentTimeMillis();
                  WebResponse wrp = wc.getResponse(wrq);
                  //System.out.println(wrp.getText());
                  //do assertions
                  try{
                       Method doAssertMethod = TestPhaseListener.class.getDeclaredMethod("doAssert", new Class[]{Assert.class, FacesContext.class, HttpServletRequest.class, String.class, String.class, String.class, WebResponse.class});
                       ComponentUtil.iterateComponent(view, Assert.class, this, doAssertMethod, new Object[]{context, request, viewId, action.getId(), action.getDescription(), wrp});
                  }catch(Exception e){
                       e.printStackTrace();
                  TestReport report = (TestReport)request.getSession().getAttribute(Constants.TEST_REPORT_SESSION_ATTRIBUTE_ID);
                 report.getPage(viewId).getAction(action.getId()).setTime(System.currentTimeMillis()-start);
               }catch(Exception e){
                    e.printStackTrace();
     protected void doParameter(Parameter parameter, String actionId, WebRequest wrq){
           if("all".equals(parameter.getActions()) || Arrays.asList(parameter.getActions().split(",")).contains(actionId))wrq.setParameter(parameter.getName(), parameter.getValue());
     protected void doSet(Set set, FacesContext context, String actionId, WebRequest wrq){
           if("all".equals(set.getActions()) || Arrays.asList(set.getActions().split(",")).contains(actionId))wrq.setParameter(set.getParent().getClientId(context), set.getValue());
     protected void doAssert(Assert ast, FacesContext context, HttpServletRequest request, String viewId, String actionId, String actionDescription, WebResponse wrp){
          if(("all".equals(ast.getActions()) || Arrays.asList(ast.getActions().split(",")).contains(actionId)) && "afterRenderResponse".equals(ast.getPhase())){
                TestReport report = (TestReport)request.getSession().getAttribute(Constants.TEST_REPORT_SESSION_ATTRIBUTE_ID);
                try{
                     HTMLElement targetElement = wrp.getElementWithID(ast.getParent().getClientId(context));
                     if(targetElement==null)targetElement = wrp.getElementsWithName(ast.getParent().getClientId(context))[0];
                     if(targetElement==null)request.setAttribute(ast.getVar(), null);
                     else request.setAttribute(ast.getVar(), targetElement.getAttribute(ast.getValueAttribute()));
                     //report assert
                     report.report(viewId, actionId, actionDescription, ast.getId(), ast.getDescription(), ast.getPhase(), (Boolean)ast.getValue(), null);
                }catch(Exception e){
                     report.report(viewId, actionId, actionDescription, ast.getId(), ast.getDescription(), ast.getPhase(), Boolean.FALSE, e);
     protected void renderReport(FacesContext context, TestReport report){
          try{
               HttpServletResponse response = (HttpServletResponse)context.getExternalContext().getResponse();
               response.setContentType("text/xml; charset=UTF-8");
               response.setHeader("Cache-Control", "no-cache");
               ResponseWriter writer = new HtmlResponseWriter(response.getWriter(), null, null);
               context.setResponseWriter(writer);
               writer.startDocument();
               writer.write("<?xml version=\"1.0\" encoding=\"UTF-8\"?>\r\n");
               writer.startElement("Test", null);
               if(report.getSuiteId()!=null)writer.writeAttribute("suite", report.getSuiteId(), null);
               for(Iterator p=report.listPages().iterator(); p.hasNext(); ){
                    TestPage page = (TestPage)p.next();
                    writer.startElement("Page", null);
                    writer.writeAttribute("id", page.getViewId(), null);
                    for(Iterator i=page.listActions().iterator(); i.hasNext(); ){
                         TestAction action = (TestAction)i.next();
                         writer.startElement("Action", null);
                         writer.writeAttribute("id", action.getId(), null);
                         writer.writeAttribute("time", getElapsedTime(action.getTime()), null);
                         if(action.getDescription()!=null)writer.writeAttribute("description", action.getDescription(), null);
                         for(Iterator j=action.getAsserts().values().iterator(); j.hasNext(); ){
                              TestAssert ast = (TestAssert)j.next();
                              writer.startElement("Assert", null);
                              writer.writeAttribute("id", ast.getId(), null);
                              if(ast.getDescription()!=null)writer.writeAttribute("description", ast.getDescription(), null);
                              for(Iterator k=ast.getStatus().keySet().iterator(); k.hasNext(); ){
                                   String phase = (String)k.next();
                                   writer.startElement(phase, null);
                                   writer.writeAttribute("pass", ast.getStatus().get(phase).toString(), null);
                                   writer.endElement(phase);
                              if(ast.getException()!=null){
                                   writer.startElement("Exception", null);
                                   StackTraceElement[] stack = ast.getException().getStackTrace();
                                   for(int m=0; m<stack.length; m++){
                                        writer.write(stack[m].toString());
                                        writer.write("\r\n");
                                   writer.endElement("Exception");
                              writer.endElement("Assert");
                         if(action.getException()!=null){
                              writer.startElement("Exception", null);
                              StackTraceElement[] stack = action.getException().getStackTrace();
                              for(int m=0; m<stack.length; m++){
                                   writer.write(stack[m].toString());
                                   writer.write("\r\n");
                              writer.endElement("Exception");
                         writer.endElement("Action");
                    if(page.getException()!=null){
                         writer.startElement("Exception", null);
                         StackTraceElement[] stack = page.getException().getStackTrace();
                         for(int m=0; m<stack.length; m++){
                              writer.write(stack[m].toString());
                              writer.write("\r\n");
                         writer.endElement("Exception");
                    writer.endElement("Page");
               if(report.getException()!=null){
                    writer.startElement("Exception", null);
                    StackTraceElement[] stack = report.getException().getStackTrace();
                    for(int m=0; m<stack.length; m++){
                         writer.write(stack[m].toString());
                         writer.write("\r\n");
                    writer.endElement("Exception");
               writer.endElement("Test");
               writer.endDocument();
               response.getWriter().flush();
               response.getWriter().close();
          }catch(Exception e){
               e.printStackTrace();
      public static String getElapsedTime(long millis) {
               long hours, minutes, seconds, ms;
               hours = millis / 3600000;
               millis = millis - (hours * 3600000);
               minutes = millis / 60000;
               millis = millis - (minutes * 60000);
               seconds = millis / 1000;
               ms = millis - (seconds * 1000);
               return hours
                    + " hour(s) "
                    + minutes
                    + " minute(s) "
                    + seconds
                    + " second(s) "
                    + ms
                    + " millisecond(s)";
*  TestAssertPhaseListener.java
package com.yourcompany.jsf.ui.test.listener;
import java.lang.reflect.Method;
import java.util.Arrays;
import javax.faces.component.UIViewRoot;
import javax.faces.context.FacesContext;
import javax.faces.event.PhaseEvent;
import javax.faces.event.PhaseId;
import javax.faces.event.PhaseListener;
import javax.servlet.http.HttpServletRequest;
import org.apache.commons.beanutils.PropertyUtils;
import com.yourcompany.jsf.ui.test.component.Assert;
import com.yourcompany.jsf.ui.test.report.Constants;
import com.yourcompany.jsf.ui.test.report.TestReport;
import com.yourcompany.jsf.ui.util.ComponentUtil;
public class TestAssertPhaseListener implements PhaseListener {
     public TestAssertPhaseListener() {
          super();
          // TODO Auto-generated constructor stub
     /* (non-Javadoc)
      * @see javax.faces.event.PhaseListener#afterPhase(javax.faces.event.PhaseEvent)
     public void afterPhase(PhaseEvent event) {
          if(PhaseId.RENDER_RESPONSE.equals(event.getPhaseId()))return;
          iterateAssert(event, false);
     /* (non-Javadoc)
      * @see javax.faces.event.PhaseListener#beforePhase(javax.faces.event.PhaseEvent)
     public void beforePhase(PhaseEvent event) {
          if(PhaseId.RESTORE_VIEW.equals(event.getPhaseId()))return;
          iterateAssert(event, true);
     public PhaseId getPhaseId() {
           return PhaseId.ANY_PHASE;
     protected void iterateAssert(PhaseEvent event, boolean before){
          FacesContext context = event.getFacesContext();
          HttpServletRequest request = (HttpServletRequest)context.getExternalContext().getRequest();
          String viewId = request.getParameter(Constants.TEST_VIEW_PARAMETER);
          String actionId = request.getParameter(Constants.TEST_ACTION_PARAMETER);
          if(actionId!=null){
               TestReport report = (TestReport)request.getSession().getAttribute(Constants.TEST_REPORT_SESSION_ATTRIBUTE_ID);
               UIViewRoot view = context.getViewRoot();
               if(view==null)return;
               try{
                    Method doAssertMethod = TestAssertPhaseListener.class.getDeclaredMethod("doAssert", new Class[]{Assert.class, FacesContext.class, HttpServletRequest.class, String.class, String.class, String.class});
                    ComponentUtil.iterateComponent(view, Assert.class, this, doAssertMethod, new Object[]{context, request, viewId, actionId, this.getAssertPhase(event.getPhaseId(), before)});
               }catch(Exception e){
                    report.getPage(viewId).getAction(actionId).setException(e);
     protected void doAssert(Assert ast, FacesContext context, HttpServletRequest request, String viewId, String actionId, String assertPhase){
           if(("all".equals(ast.getActions()) || Arrays.asList(ast.getActions().split(",")).contains(actionId)) && assertPhase.equals(ast.getPhase())){
                TestReport report = (TestReport)request.getSession().getAttribute(Constants.TEST_REPORT_SESSION_ATTRIBUTE_ID);
                try{
                     request.setAttribute(ast.getVar(), PropertyUtils.getProperty(ast.getParent(), ast.getValueAttribute()));
                     //report assert
                     report.report(viewId, actionId, null, ast.getId(), ast.getDescription(), ast.getPhase(), (Boolean)ast.getValue(), null);
                }catch(Exception e){
                     report.report(viewId, actionId, null, ast.getId(), ast.getDescription(), ast.getPhase(), Boolean.FALSE, e);
     protected String getAssertPhase(PhaseId phaseId, boolean before){
          String perfix = before ? "before" : "after";
          if(PhaseId.RESTORE_VIEW.equals(phaseId))return perfix+"RestoreView";
          if(PhaseId.APPLY_REQUEST_VALUES.equals(phaseId))return perfix+"ApplyRequestValues";
          if(PhaseId.PROCESS_VALIDATIONS.equals(phaseId))return perfix+"ProcessValidations";
          if(PhaseId.UPDATE_MODEL_VALUES.equals(phaseId))return perfix+"UpdateModelValues";
          if(PhaseId.INVOKE_APPLICATION.equals(phaseId))return perfix+"InvokeApplication";
          if(before && PhaseId.RENDER_RESPONSE.equals(phaseId))return "beforeRenderResponse";
          return "";
*  UIIterate.java
// This class brings "                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              

Answer 1

To Neoreborn:
If I understand right, Shale only provides some mock core JSF objects and extends JUnit so that you can do junit test to your java classes.
What I concern is to test Pages(JSP) rather than java classes. I want to assert component attribute values within all lifecycle including rendered HTML script. Currently, there isn't any good tools to do this kind of JSP Unit test, am I right?