How to set JSF2 <welcome-file> with faces servlet mapping?

jsf-2 java-ee-6
oidsman picture oidsman · Jan 6, 2011 · Viewed 18.4k times · Source

I have a simple JSF2 app using Facelets. My web.xml is set as follows:-

<servlet-mapping>
<servlet-name>Faces Servlet</servlet-name>
<url-pattern>*.jsf</url-pattern>
</servlet-mapping>

I want to set the app to default to the welcome page which is /pages/login.xhtml. I can't seem to get the welcome-file setting to pick up this when going to the context root in the browser.

My web.xml welcome setting is as follows:-

<welcome-file-list>
<welcome-file>/pages/login.jsf</welcome-file>
</welcome-file-list>

How do I force the welcome-page to goto the login page and ensure it goes through the faces servlet?

If I use the following the page displays but it hasn't gone through the faces servlet and so faces components aren't rendered:-

<welcome-file-list>
<welcome-file>pages/login.xhtml</welcome-file>
</welcome-file-list>

Any help appreciated!

Answer

Brian Leathem picture Brian Leathem · Jan 6, 2011

You have to create an empty login.jsf file, adjacent to your login.xhtml file. For some reason this hack is needed to trick the servlet container into thinking your welcome file exists.

Note: The response served will still be the JSF response using your login.xhtml file, not the empty login.jsf file you create.

Related questions

Java EE 6: Target Unreachable, identifier 'helloBean' resolved to null

I am trying to get a simple JSF 2 tutorial example to work. I am using the dynamic web project in Eclipse and publishing to a Glassfish 3 server (run -> run on server). The first index.xhtml page loads correctly, …

Read More
Initialization of List in a JSF Managed bean

I' have a question about initialization of List in the POJO as it follows the next code: public class Person { //other fields... private List<String> friends=new ArrayList<>(); public List<String> getFriends() { return friends; } …

Read More
Faces Navigation not really working in JSF2

I'm using JSF 2.0 this is my faces-config.xml <?xml version="1.0" encoding="UTF-8"?> <!-- This file is not required if you don't need any extra configuration. --> <faces-config version="2.0" xmlns="http://java.sun.com/xml/ns/…

Read More