Set default home page via <welcome-file> in JSF project
First of all, the <welcome-file>
does not represent the path to the "default home page". It represents the filename of the physical file contained in the folder which you'd like to serve up as default file when a folder like /
, /foo/
, /foo/bar/
, etc is requested.
So, in JSF 2.x flavor, that would basically be:
<welcome-file-list>
<welcome-file>index.xhtml</welcome-file>
</welcome-file-list>
This way, if the enduser requests /
and you have /index.xhtml
, then it will be served. Or, if the enduser requests /foo
and you have /foo/index.xhtml
, then it will be served, etc. If there is no such file, then a 404 error will be returned.
Now, you appear to have mapped your FacesServlet
on a prefix <url-pattern>
of /faces/*
. This is a leftover from JSF 1.0/1.1 ages and really not recommended these days. Perhaps you were reading an outdated tutorial targeted at JSF 1.x, or a poorly maintained tutorial which was originally written for JSF 1.x and then uncarefully updated for JSF 2.x instead of rewritten from scratch.
That tutorial did also not seem to have explained you some servlet basics. Namely, in order to get JSF components in the XHTML page to run and generate some HTML output, the FacesServlet
has to be invoked when the XHTML page is being requested. When you request the XHTML page like so /index.xhtml
, while the FacesServlet
is being mapped on /faces/*
, then it won't be invoked. The browser would then retrieve the raw unparsed JSF source code instead of the generated HTML output. You can see it by rightclick, View Source in webbrowser. You should have requested the page like so /faces/index.xhtml
so that the FacesServlet
can run and produce HTML output which the browser can understand and present.
That only doesn't go well together with welcome files. This totally explains why you get a "clean white" (blank) page when using index.xhtml
as welcome file (some inferior webbrowsers like IE would confusingly prompt a download dialog because of missing/wrong content type on the response containing raw XHTML source code). The FacesServlet
was simply not being invoked. Just get rid of the old fashioned /faces/*
URL pattern and use the JSF 2.x minded *.xhtml
URL pattern instead.
<servlet-mapping>
<servlet-name>facesServlet</servlet-name>
<url-pattern>*.xhtml</url-pattern>
</servlet-mapping>
This way the welcome files should work and you can just open JSF pages by directly requesting its physical URL without hassling with virtual URLs. This was not possible in JSF 1.x because it would let the FacesServlet
run in an infinite loop calling itself and cause a stack overflow.
See also:
- JSF Facelets: Sometimes I see the URL is .jsf and sometimes .xhtml. Why?
- Setting application URL on WAS server, where does /faces/ come from?
- What is the difference between creating JSF pages with .jsp or .xhtml or .jsf extension
- Why can web.xml welcome-file be located inside WEB-INF
- How to use a sub-folder as web.xml welcome directory
As to those warnings, they are unrelated but quite googlable.