Beggining JSF: FaceletViewHandler

[Valmir Cinquini]

Thanks for help me.

I'm following a sample code from a book about jsf. Different from the book, I'm using jboss 4.2.3.GA and netbeans 6.8 (the book sample uses tomcat and eclipse).

Everything works fine but there's one clause on the faces-config.xml that I have to comment, otherwise the code doesn't run:

<application>
        <view-handler>com.sun.facelets.FaceletViewHandler</view-handler>
    </application>

When I uncomment the code above, I got the following error:

javax.servlet.ServletException: Error Parsing /form.jsp: Error Traced[line: 1] The markup in the document preceding the root element must be well-formed.
javax.faces.webapp.FacesServlet.service(FacesServlet.java:270)
org.ajax4jsf.webapp.BaseFilter.doFilter(BaseFilter.java:530)
org.ajax4jsf.webapp.BaseXMLFilter.doXmlFilter(BaseXMLFilter.java:178)
org.ajax4jsf.webapp.BaseFilter.handleRequest(BaseFilter.java:290)
org.ajax4jsf.webapp.BaseFilter.processUploadsAndHandleRequest(BaseFilter.java:388)
org.ajax4jsf.webapp.BaseFilter.doFilter(BaseFilter.java:515)
org.jboss.web.tomcat.filters.ReplyHeaderFilter.doFilter(ReplyHeaderFilter.java:96)


I had to remove jsf-api.jar and jsf-impl.jar from the netbeans project becouse they are already present in C:\jboss-4.2.3.GA\server\default\deploy\jboss-web.deployer\jsf-libs directory. If I don't, I got this error:

exception sending context initialized event to listener instance of class org.jboss.web.jsf.integration.config.jbossjsfconfigurelistener

Could someone explain me why these error occurs? And what is the purpose of the <view-handler> tag? The book doesn't explain that.

[Wouter Oet]

The first error is self-describing. form.jsp is not well-formed. It has an error on line 1.
The second error is because your application server is already providing the needed jars.
If you are using maven to build your application you could change the dependency scope to provided for these jars.

[Tim Holloway]

Your book probably didn't cover Facelets. The View Handler is telling Facelets to handle the Views instead of the default JSF View handler.

When you have an error on line 1 of an XML file, you probably didn't start it with the XML Processing Instruction:

<?xml version="1.0" ?>

With appropriate options, if any. You can get this error also if there if a line (even a blank line) preceeding the "*lt;?" or if it doesn't begin in column 1.

[Valmir Cinquini]

Tim

Yes, my book don't cover facelets. I'm looking for some tutorials on the net.

But both web.xml and faces-config.xml start with

<?xml version="1.0" encoding="UTF-8"?>

here they are:

web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">

    <filter>
        <display-name>Ajax4jsf Filter</display-name>
        <filter-name>ajax4jsf</filter-name>
        <filter-class>org.ajax4jsf.Filter</filter-class>
    </filter>

    <filter-mapping>
        <filter-name>ajax4jsf</filter-name>
        <servlet-name>Faces Servlet</servlet-name>
        <dispatcher>REQUEST</dispatcher>
        <dispatcher>FORWARD</dispatcher>
        <dispatcher>INCLUDE</dispatcher>
    </filter-mapping>

    <filter-mapping>
        <filter-name>ajax4jsf</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>


    <servlet>
        <servlet-name>Faces Servlet</servlet-name>
        <servlet-class>javax.faces.webapp.FacesServlet</servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>Faces Servlet</servlet-name>
        <url-pattern>/faces/*</url-pattern>
    </servlet-mapping>
    <session-config>
        <session-timeout>
            30
        </session-timeout>
    </session-config>
    <welcome-file-list>
        <welcome-file>faces/form.jsp</welcome-file>
    </welcome-file-list>
</web-app>

faces-config.xml:

<?xml version='1.0' encoding='UTF-8'?>

<!-- =========== FULL CONFIGURATION FILE ================================== -->

<faces-config version="1.2" 
    xmlns="http://java.sun.com/xml/ns/javaee" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-facesconfig_1_2.xsd">

    <managed-bean>
        <managed-bean-name>autores</managed-bean-name>
        <managed-bean-class>meupacote.web.AutoresAjax4jsf</managed-bean-class>
        <managed-bean-scope>session</managed-bean-scope>
    </managed-bean>

    <navigation-rule>
        <navigation-case>
            <from-outcome>form</from-outcome>
            <to-view-id>/form.jsp</to-view-id>
        </navigation-case>
    </navigation-rule>

    <!--application>
        <view-handler>com.sun.facelets.FaceletViewHandler</view-handler>
    </application-->
</faces-config>

[Tim Holloway]

Here's a good intro to Facelets:

http://www.ibm.com/developerworks/java/library/j-facelets/

And the main site:

https://facelets.dev.java.net/

Google is good for stuff like that.

I'm not sure about the XML file error, since they look correct. But you might want to try putting the comment INSIDE the faces-config (root) element, instead of in front of it. In other words, right before the "managed-bean" element. XML can be fastidious sometimes.