Spring MVC UTF-8 Encoding

2019-01-01 06:33发布

站内文章 / Java
32 0 0

问题:

At the moment I\'m trying to get started with Spring MVC. While trying things out I ran into an encoding issue.

I want to display UTF-8 characters on my JSP-Pages so I added a String with UTF-8 characters to my ModelAndView. It looks like this:

@Controller
public class HomeController {

    private static final Logger logger = LoggerFactory.getLogger(HomeController.class);

    @RequestMapping(value=\"/\", method=RequestMethod.GET)
    public ModelAndView home() {
        logger.info(\"Welcome home!\");
        return new ModelAndView(\"home\", \"utftest\", \"ölm\");
    }

}

On the JSP page I just want to display the String with UTF-8 characters like this:

<%@ page language=\"java\" pageEncoding=\"UTF-8\"%>
<%@ page contentType=\"text/html;charset=UTF-8\" %>
<%@ taglib uri=\"http://java.sun.com/jsp/jstl/core\" prefix=\"c\" %>
<%@ page session=\"false\" %>
<html>
<head>
    <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">
    <title>Home</title>
</head>
<body>
    <h1>Hello world!</h1>
    <p><c:out value=\"ö\" /></p>
    <p><c:out value=\"${utftest}\"></c:out></p>
</body>
</html>

As result I get following:

Hello world!

ö

ölm

Note that following code <c:out value=\"ö\" /> was displayed without encoding error. I also set the default encoding to UTF-8 in Springsource Tool Suite but I\'m still getting wrong characters.

Edit:

Maybe I should have mentioned that I\'m using a Mac with OS X 10.6. For Spring development I use the Springsource Tool Suite from Spring (http://www.springsource.com/developer/sts). Hope this helps to find out what is wrong with my setting.

Edit 2:

Thanks to McDwell, I just tried out using \"\\u00f6lm\" instead of \"ölm\" in my controller and the encoding issue on the JSP page is gone.

Does that mean my .java files are encoded with wrong character set? Where can I change this in Eclipse?

Thank you.

回答1:

Make sure you register Spring\'s CharacterEncodingFilter in your web.xml (must be the first filter in that file).

<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>

If you are on Tomcat you might not have set the URIEncoding in your server.xml. If you don\'t set it to UTF-8 it won\'t work. Definitely keep the CharacterEncodingFilter. Nevertheless, here\'s a concise checklist to follow. It will definitely guide you to make this work.



回答2:

Ok guys I found the reason for my encoding issue.

The fault was in my build process. I didn\'t tell Maven in my pom.xml file to build the project with the UTF-8 encoding. Therefor Maven just took the default encoding from my system which is MacRoman and build it with the MacRoman encoding.

Luckily Maven is warning you about this when building your project (BUT there is a good chance that the warning disappears to fast from your screen because of all the other messages).

Here is the property you need to set in the pom.xml file:

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    ...
</properties>

Thank you guys for all your help. Without you guys I wouldn\'t be able to figure this out!



回答3:

In addition to Benjamin\'s answer (which I\'ve only skimmed), you need to make sure that your files are actually stored using the proper encoding (that would be UTF-8 for source code, JSPs etc., but note that Java Properties files must be encoded as ISO 8859-1 by definition).

The problem with this is that it\'s not possible to tell what encoding has been used to store a file. Your only option is to open the file using a specific encoding, and checking whether or not the content makes sense. You can also try to convert the file from the assumed encoding to the desired encoding using iconv - if that produces an error, your assumption was incorrect. So if you assume that hello.jsp is encoded as UTF-8, run \"iconv -f UTF-16 -t UTF-8 hello.jsp\" and check for errors.

If you should find out that your files are not properly encoded, you need to find out why. It\'s probably the editor or IDE you used to create the file. In case of Eclipse (and STS), make sure the Text File Encoding (Preferences / General / Workspace) is set to UTF-8 (it unfortunately defaults to your system\'s platform encoding).

What makes encoding problems so difficult to debug is that there\'s so many components involved (text editor, borwser, plus each and every software component in between, in some cases including a database), and each of them has the potential to introduce an error.



回答4:

Easiest solution to force UTF-8 encoding in Spring MVC returning String:

In @RequestMapping, use:

produces = MediaType.APPLICATION_JSON_VALUE + \"; charset=utf-8\"


回答5:

right-click to your controller.java then properties and check if your text file is encoded with utf-8, if not this is your mistake.



回答6:

Depending on how you render your view, you may also need:

@Bean
public StringHttpMessageConverter stringHttpMessageConverter() {
    return new StringHttpMessageConverter(Charset.forName(\"UTF-8\"));
}


回答7:

In addition to Benjamin\'s answer - in case if you are using Spring Security, placing the CharacterEncodingFilter in web.xml might not always work. In this case you need to create a custom filter and add it to the filter chain as a first filter. To make sure it\'s the first filter in the chain, you need to add it before ChannelProcessingFilter in your WebSecurityConfigurerAdapter:

@Configuration
@EnableWebSecurity 
public class SecurityConfig extends WebSecurityConfigurerAdapter {


    @Override
    protected void configure(HttpSecurity http) throws Exception {

        //add your custom encoding filter as the first filter in the chain
        http.addFilterBefore(new EncodingFilter(), ChannelProcessingFilter.class);

        http.authorizeRequests()
            .and()
            // your code here ...
    }
}

The ordering of all filters in Spring Security is available here: HttpSecurityBuilder - addFilter()

Your customer UTF-8 encoding filter can look like following:

public class EncodingFilter extends GenericFilterBean {

    @Override
    public void doFilter(
            ServletRequest request, 
            ServletResponse response,
            FilterChain chain) throws IOException, ServletException {

        request.setCharacterEncoding(\"UTF-8\");
        response.setCharacterEncoding(\"UTF-8\");

        chain.doFilter(request, response);
    }
}

Don\'t forget to add in your jsp files:

<%@ page pageEncoding=\"UTF-8\" contentType=\"text/html; charset=UTF-8\" %>

And remove the CharacterEncodingFilter from web.xml if it\'s there.



回答8:

To solve this issue you need below three steps:

  1. Set page encoding to UTF-8 like below:

    <%@ page language=\"java\" pageEncoding=\"UTF-8\"%>
<%@ page contentType=\"text/html;charset=UTF-8\" %>

  2. Set filter in web.xml file as below:

    <filter>
    <filter-name>encodingFilter</filter-name>
        <filter-lass>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>

  3. Set resource encoding to UTF-8, in case if you are writing any UTF-8 characters in Java code or JSP directly.



标签： java spring-mvc utf-8 character-encoding
举报

收藏的人(0)

Ta的文章 更多文章
登录 后发表评论
0条评论
还没有人评论过~