如何在IceFaces1.8遗留项目中设置HTML5的DOCTYPE？

我之前也折腾过IceFaces 1.8这类遗留项目的DOCTYPE替换问题，没法升级框架的情况下，给你几个实用的方案：

方案1：直接手动添加HTML5 DOCTYPE #

移除模板里的<ice:outputDeclaration>标签，然后在template.xhtml的最最顶部（所有其他代码之前，包括<html>标签和命名空间声明）手动写入：

<!DOCTYPE html>

⚠️ 注意：一定要放在最开头，否则IceFaces可能还是会渲染出原来的HTML4 DOCTYPE。另外，部分老组件可能在HTML5下有轻微的样式兼容问题，需要微调CSS来适配。

方案2：用JSF核心标签输出DOCTYPE #

如果直接写不行（比如IceFaces渲染时覆盖了你的DOCTYPE），可以用JSF的<f:verbatim>标签来强制输出HTML5 DOCTYPE，同时移除原来的<ice:outputDeclaration>：

<f:verbatim><![CDATA[<!DOCTYPE html>]]></f:verbatim>

这个标签会绕过IceFaces的自动DOCTYPE处理，直接把内容输出到页面头部，同样要确保它在页面的最开头位置。

方案3：通过Servlet Filter拦截替换 #

如果以上两种方法都失效，说明IceFaces在渲染过程中强制注入了HTML4 DOCTYPE，这时候可以用Servlet Filter来拦截响应内容，替换成HTML5的版本：

1. 创建一个自定义Filter类：

import javax.servlet.*;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.http.HttpServletResponseWrapper;
import java.io.CharArrayWriter;
import java.io.IOException;
import java.io.PrintWriter;

public class Html5DoctypeFilter implements Filter {

    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
        // 初始化逻辑，空实现即可
    }

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
        HttpServletResponseWrapper wrappedResponse = new HttpServletResponseWrapper((HttpServletResponse) response) {
            private PrintWriter writer;
            private CharArrayWriter charArrayWriter;

            @Override
            public PrintWriter getWriter() throws IOException {
                if (writer == null) {
                    charArrayWriter = new CharArrayWriter();
                    writer = new PrintWriter(charArrayWriter);
                }
                return writer;
            }

            @Override
            public void flushBuffer() throws IOException {
                if (writer != null) {
                    writer.flush();
                    // 替换HTML4 DOCTYPE为HTML5版本
                    String pageContent = charArrayWriter.toString();
                    pageContent = pageContent.replace(
                        "<!DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">",
                        "<!DOCTYPE html>"
                    );
                    // 输出修改后的内容
                    response.getWriter().write(pageContent);
                    charArrayWriter.reset();
                }
            }
        };
        chain.doFilter(request, wrappedResponse);
    }

    @Override
    public void destroy() {
        // 销毁逻辑，空实现即可
    }
}

2. 在web.xml中配置这个Filter，让它拦截所有xhtml请求：

<filter>
    <filter-name>Html5DoctypeFilter</filter-name>
    <filter-class>com.yourpackage.Html5DoctypeFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>Html5DoctypeFilter</filter-name>
    <url-pattern>*.xhtml</url-pattern>
</filter-mapping>

这个方案比较“硬核”，但能确保最终输出的是HTML5 DOCTYPE，适合IceFaces强制生成旧DOCTYPE的场景。

额外注意事项 #

• 测试前一定要清空浏览器缓存，避免旧的DOCTYPE被缓存导致测试结果不准确。
• 同步更新页面的<meta>标签，把原来的<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">换成HTML5标准的<meta charset="UTF-8">。
• 部分IceFaces 1.8的老组件（比如某些布局、弹窗组件）可能在HTML5下有样式或行为异常，需要针对性调整CSS或JS来修复。

内容的提问来源于stack exchange，提问作者theprogrammer