eclipse - 在 JSF 项目中通过 <welcome-file> 设置默认主页

Question

当我从 Eclipse 使用 Tomcat 8.0 启动 Java EE 项目时，我无法设置在浏览器中加载的默认页面。 我正在尝试学习 JSF，所以我关注了 this tutorial

一切正常，但我只能在右键单击 login.xhtml 或 welcome.xhtml 文件并选择“Run As/Run”时才能看到创建的页面在服务器上”。

到目前为止，我创建的所有其他 Web 应用程序在我启动整个项目时都加载了默认页面。默认行为是加载 index.html 页面(或者可能是 index.jsp，如果有的话)。因此，我将 index.html 和 index.xhtml 页面添加到我的项目中的 WEB-INF 文件夹中，希望其中至少有一个会被显示。但是，没有任何反应。浏览器总是只显示 localhost:8080/JSFFaceletsTutorial/ URL 上的页面，但页面是白色的，甚至没有错误消息。我想我在解决这个问题的过程中一直遇到错误 404，但是，我无法再重现这个错误，我不记得是什么原因造成的。

我发现有可能 change the default starting page

但是，它对我也不起作用。无论我是否编辑 web.xml 文件，我都会得到相同的结果。

更令人费解的是，当我尝试更改 Web 浏览器时:“Window/Web Browser/...”它在外部 Web 浏览器中的行为有一段时间不同于在内部 Eclipse Web 浏览器中的行为。内部总是空白页面 - 但外部网络浏览器曾经设法显示 index.html 页面 - 但它是一些过时的版本。尽管我非常确定我编辑了它，保存了更改，重新启动了服务器……但它仍然向我显示了该页面的过时版本。 即使在这种情况下，它仍然忽略了在 web.xml 文件中所做的更改。 但是当我现在尝试时，它再次在所有浏览器中显示空白页面。除了编辑 web.xml 文件之外，我不知道我所做的任何更改...

我的猜测是问题出在我还没有完全掌握的 JSF 技术上。这是因为当我选择使用右键单击“Run As/Run on Server”运行 login.xhtml 和 welcome.xhtml 页面时，这些页面的 URL 位于 localhost:8080: 路径为 /JSFFaceletsTutorial/faces/login.xhtml 和 /JSFFaceletsTutorial/faces/welcome.xhtml。这很奇怪，因为我的项目中没有任何目录“faces”。 输入所有可能的排列:

<welcome-file-list>
    <welcome-file>faces/index.html</welcome-file>
    <welcome-file>faces/index.xhtm</welcome-file>
</welcome-file-list>

在 web.xml 中也没有帮助。当我在那里输入完整地址时也没有帮助。

这是我在控制台中收到的警告(我跳过了 INFO 日志条目):

"Dec 19, 2014 9:39:55 AM org.apache.tomcat.util.digester.SetPropertiesRule begin WARNING: [SetPropertiesRule]{Server/Service/Engine/Host/Context} Setting property 'source' to 'org.eclipse.jst.jee.server:JSFFaceletsTutorial' did not find a matching property. ... WARNING: JSF1074: Managed bean named 'loginBean' has already been registered. Replacing existing managed bean class type com.tutorial.LoginBean with com.tutorial.LoginBean. Dec 19, 2014 9:39:57 AM org.apache.coyote.AbstractProtocol start"

不过我不确定这是否有帮助。 我现在没主意了。

Answer 1

首先，<welcome-file>不代表“默认主页”的路径。它代表文件夹中包含的物理文件的文件名，当一个文件夹 像/ 时，您希望将其用作默认文件。 , /foo/ , /foo/bar/ , 等等。

因此，在 JSF 2.x 风格中，这基本上是:

<welcome-file-list>
    <welcome-file>index.xhtml</welcome-file>
</welcome-file-list>

这样，如果最终用户请求 /你有 /index.xhtml , 然后它就会被送达。或者，如果最终用户请求 /foo你有 /foo/index.xhtml , 然后它会被服务，等等。如果没有这样的文件，那么会返回一个 404 错误。

现在，您似乎已经映射了您的 FacesServlet在前缀 <url-pattern> 上的 /faces/* .这是 JSF 1.0/1.1 时代的遗留物，现在真的不推荐使用。也许您正在阅读针对 JSF 1.x 的过时教程，或者最初是为 JSF 1.x 编写的维护不善的教程，然后粗心地为 JSF 2.x 更新而不是从头开始重写。

那个教程好像也没给你讲解some servlet basics .即，为了让 XHTML 页面中的 JSF 组件运行并生成一些 HTML 输出，FacesServlet必须在请求 XHTML 页面时调用。当您像这样请求 XHTML 页面时 /index.xhtml , 而 FacesServlet正在映射到 /faces/* ，那么它就不会被调用。然后浏览器将检索原始的未解析的 JSF 源代码，而不是生成的 HTML 输出。您可以通过在网络浏览器中右键单击查看源代码来查看它。你应该像这样请求页面 /faces/index.xhtml这样 FacesServlet可以运行并生成浏览器可以理解和呈现的 HTML 输出。

这与欢迎文件搭配起来效果不佳。这完全解释了为什么在使用 index.xhtml 时会得到一个“干净的白色”(空白)页面。作为欢迎文件(一些劣质的网络浏览器如 IE 会混淆 prompt a download dialog 因为包含原始 XHTML 源代码的响应中缺少/错误的内容类型)。 FacesServlet根本就没有被调用。摆脱老式的/faces/* URL 模式并使用 JSF 2.x 思维 *.xhtml改为 URL 模式。

<servlet-mapping>
    <servlet-name>facesServlet</servlet-name>
    <url-pattern>*.xhtml</url-pattern>
</servlet-mapping>

这样欢迎文件就可以工作了，您可以直接请求它的物理 URL 来打开 JSF 页面，而无需使用虚拟 URL。这在 JSF 1.x 中是不可能的，因为它会让 FacesServlet在无限循环中运行并调用自身并导致堆栈溢出。

另见:

• 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

---

至于那些警告，它们无关但很容易搜索到。