使用 Spring MVC 时如何在 Freemarker 视图中设置内容类型？答案

【问题标题】：How to set content-type in Freemarker views when using Spring MVC?使用 Spring MVC 时如何在 Freemarker 视图中设置内容类型？
【发布时间】：2011-11-10 06:00:48
【问题描述】：

我正在使用带有 freemarker 视图的 Sping MVC。我设置了一个 FreeMarkerViewResolver 来解析视图，到目前为止它可以工作，但现在我遇到了编码问题。我所有的视图都是 UTF-8 编码的 HTML 5 页面，我还在 HTML 页面中添加了 <meta charset="UTF-8" />，但字符仍然以错误的编码打印。我用 curl 检查了 HTTP 标头，发现：

k@jules:~$ curl -I http://localhost:8080/testweb/test.view
HTTP/1.1 200 OK
Content-Type: */*;charset=ISO-8859-1

但是当我请求一些不存在的资源（这会产生 Tomcat 错误）时，我会得到这个：

k@jules:~$ curl -I http://localhost:8080/testweb/nothere.html
HTTP/1.1 200 OK
Content-Type: text/html;charset=utf-8

所以 Tomcat 本身会返回正确的内容类型，但 Spring MVC Freemarker 视图不会。

对于 JSP，我可以在 JSP 标头中设置 Content-Type，但是在哪里可以为 freemarker 模板设置呢？我想我必须在 Spring bean 配置中的某个地方执行此操作，但我找不到正确的位置。

【问题讨论】：

标签： spring spring-mvc freemarker

【解决方案1】：

视图解析器（应该在您的 dispatcher-servlet.xml 中）有一个 contentType 属性：

<bean id="viewResolver"
   class="org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver">
    <property name="prefix" value=""/>
    <property name="suffix" value=".ftl"/>
    <property name="contentType" value="text/html;charset=UTF-8"/>
</bean>

【讨论】：

【解决方案2】：

在使用 spring 框架和 freemarker 模板时，我也遇到了显示 UTF-8 字符（如 æ.ø 和 å 等特殊字符）的问题。

我所做的是。

1.确保您的 .ftl 页面使用 utf-8 编码 这是确保未使用 UTF-8 字符集编码的页面可能显示错误数字的重要事项，即使您设置了所有其他要求。检查您的 IDE 设置，找出它将文件设置为的默认编码。然而，我认为今天 Eclipse 和 NetBeans 都将所有文件都设置为 UTF-8 编码作为标准。您必须确保它是 UTF-8 编码，没有 BOM。

2。在模板文件中包含 Meta 标记以设置字符集在包含 <head> 标记的模板 (.ftl) 文件中，设置 <meta>，其属性为 charset="UTF-8"。这是如果您使用 HTML 5。如果您使用 xhtml 或 HTML 4，您的元标记需要看起来像这样

HTML 5 <meta charset="UTF-8" />
HTML 4/XHTML <meta http-equiv="content-type" content="text/html; charset=utf-8"/>

3.确保在部署描述符文件中设置字符编码过滤器 您必须通过字符编码过滤器过滤所有传入/传出请求。此过滤器在您的部署描述符中设置（web.xml / 或 java 等效的 WebApplicationInitializer）。

WebApplicationInitializer（Java 文件）

@Override
public void onStartup(ServletContext servletContext) throws ServletException {
    registerCharacterEncodingFilter(servletContext);
}

/**
 * Filter all incoming requests with character encoding UTF-8
 * @param servletContext 
 */
private void registerCharacterEncodingFilter(ServletContext servletContext) {
    CharacterEncodingFilter encodingFilter = new CharacterEncodingFilter();
    encodingFilter.setEncoding("UTF-8");
    encodingFilter.setForceEncoding(true);
    FilterRegistration.Dynamic characterEncodingFilter = servletContext.addFilter("characterEncodingFilter", encodingFilter);
    characterEncodingFilter.addMappingForUrlPatterns(null, false, "/*");
}

web.xml

<filter>
    <filter-name>encodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <init-param>
        <param-name>encoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
    <init-param>
        <param-name>forceEncoding</param-name>
        <param-value>true</param-value>
    </init-param>
</filter>

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

4.在配置器中设置 FreeMarker 字符编码并查看解析器 您还需要使所有 FreeMarker 文件都使用 UTF-8 进行标准编码，这是通过在 FreeMarkerConfigurer 和 FreeMarkerViewResolver 中将它们的属性设置为 UTF-8 来完成的。这是在您的 spring 应用程序上下文文件中设置的（我将只显示 Java 等效项，因为它在 XML 文件中是相同的）。

/**
 * FreeMarker Configurer will help configure different settings of
 * the FreeMarker template engine.
 * 
 * @return an object of the FreeMarkerConfigurer class.
 */
@Bean
public FreeMarkerConfigurer freemarkerConfig() {
    FreeMarkerConfigurer freeMarkerConfigurer = new FreeMarkerConfigurer();
    freeMarkerConfigurer.setTemplateLoaderPath("/templates/");
    freeMarkerConfigurer.setDefaultEncoding("UTF-8");
    return freeMarkerConfigurer;
}

/**
 * The View resolver to use when resolving FreeMarker views.
 * 
 * @return the View Resolver Object used to resolve FreeMarker views.
 */
@Bean
public FreeMarkerViewResolver viewResolver() {
    FreeMarkerViewResolver viewResolver = new FreeMarkerViewResolver();
    viewResolver.setPrefix("");
    viewResolver.setSuffix(".ftl");
    viewResolver.setCache(false);   //Set to true during production
    viewResolver.setContentType("text/html;charset=UTF-8");
    return viewResolver;
}

希望对你有所帮助:)

【讨论】：

谢谢！对我来说关键的缺失部分是在 FreeMarkerViewResolver 上配置内容类型，我使用的是通过调用 ViewResolverRegistry.freeMarker() 设置的默认值。事实上，一旦我设置了这个，大多数其他编码配置都变成了多余的。