SpringMVC表格提交中文乱码和配置logback

news2025/1/26 14:22:05

最佳解决方案还是使用Spring提供的过滤器，将其配置到WEB.XML文件中：

<filter>
    <filter-name>characterEncodingFilter</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>characterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

这里需要注意的是倒数第二行，<url-pattern>的设置，是/*，如果只写一个/是发挥不了作用的。

另外，在SpringMVC项目中，使用System.out.println输出查看起来都很麻烦，这里建议使用logback，使用的时候三步走：

1 通过pom.xml安装合适的版本。大家都知道SFL4J是一套规范，而LOGBACK其实是它的一种实现。所以安装的时候要将两者全部安装：

 <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-api</artifactId>
      <version>1.7.6</version>
      <scope>compile</scope>
    </dependency>

    <!-- logback日志工具核心包 -->
    <dependency>
      <groupId>ch.qos.logback</groupId>
      <artifactId>logback-core</artifactId>
      <version>1.2.3</version>
      <scope>compile</scope>
    </dependency>

    <!-- logback-classic实现slf4j接口，作为日志工具 -->
    <dependency>
      <groupId>ch.qos.logback</groupId>
      <artifactId>logback-classic</artifactId>
      <version>1.2.3</version>
      <scope>compile</scope>
    </dependency>

这里要注意版本号问题。在纯Spring环境下，lgoback1.23可以和slf4j2.05很好的合作。但是在SpringMVC环境下，2.05版本的sl4j启动时会报NoClassDefFoundError

NoClassDefFoundError: org/slf4j/impl/StaticLoggerBinder

所以在SpringMVC环境中只能降级SFL4J到1.76版本。

另外，为了能够在SPringMVC中使用，还需要安装一个LOGBACK针对SPringMVC的扩展：

    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-api</artifactId>
      <version>1.7.6</version>
      <scope>compile</scope>
    </dependency>

    <!-- logback日志工具核心包 -->
    <dependency>
      <groupId>ch.qos.logback</groupId>
      <artifactId>logback-core</artifactId>
      <version>1.2.3</version>
      <scope>compile</scope>
    </dependency>

    <!-- logback-classic实现slf4j接口，作为日志工具 -->
    <dependency>
      <groupId>ch.qos.logback</groupId>
      <artifactId>logback-classic</artifactId>
      <version>1.2.3</version>
      <scope>compile</scope>
    </dependency>

    <!-- 配合SpringMVC，将logback添加到WEB.XML中作为监听器，方便输出logger -->
    <dependency>
      <groupId>org.logback-extensions</groupId>
      <artifactId>logback-ext-spring</artifactId>
      <version>0.1.5</version>
    </dependency>

这个logback-extensions并不是LOGBACK的标准组件，是专门为SPringMVC环境开发的。

2 JAR安装完毕就是配置logback.xml，位置是在resources文件夹下。我的logback.xml只配置了控制台输出：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>

    <contextListener class="ch.qos.logback.classic.jul.LevelChangePropagator">
<!--        To Logback be able to propagate its configuration to JUL (java.util.logging) it is neccessary to add-->
        <resetJUL>true</resetJUL>
    </contextListener>

    <appender name="console" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{5} - %msg%n</pattern>
        </encoder>
    </appender>

    <logger name="com.piglite" level="debug"/>

    <logger name="org.springframework" level="info"/>

    <root level="info">
        <appender-ref ref="console" />
    </root>
</configuration>

这里可以把输出日志的level设定的高一些。

3. 将LOGBACK作为服务器的监听器，将LOGBACK配置到WEB.XML中：

<context-param>
    <param-name>logbackConfigLocation</param-name>
    <param-value>classpath:logback.xml</param-value>
</context-param>
<listener>
    <listener-class>ch.qos.logback.ext.spring.web.LogbackConfigListener</listener-class>
</listener>

注意，这个<listener-class>就是来自logback-extensions。

经过以上三步，LOGBACK的配置就算完成了。现在就在需要输出的地方使用logger进行输出即可。

例如有这样一个Controller：

@Controller
@RequestMapping(value = "/user")
public class UserController {

    private static List<User> userList;
    private static Logger logger= LoggerFactory.getLogger(UserController.class);

    @PostConstruct
    public void initUserList(){
        logger.info("initUserList execute...");
        userList = new ArrayList<>();
    }
    @GetMapping("/register")
    public String register(){
        return "registerForm";
    }

    @PostMapping("/register")
    public String handleRegister(@RequestParam("loginname") String lname,
                                 @RequestParam("password") String pwd,
                                 @RequestParam("username") String uname){

        logger.info("收到的提交信息是：loginname：{}，password：{}，username：{}",lname,pwd,uname);
        User user = new User(lname, pwd, uname);
        logger.info("创建了user对象：{}",user);
        userList.add(user);
        return "loginForm";
    }

    @RequestMapping("/login")
    public String login(@RequestParam("loginname") String lname,
                        @RequestParam("password") String pwd,
                        Model model){

        for (User user:userList) {
            if(user.getLoginname().equals(lname)&&
            user.getPassword().equals(pwd)){
                model.addAttribute("username",user.getUsername());
                return "loginSucess";
            }
        }
        model.addAttribute("msg","用户名或密码错误!");
        return "loginForm";
    }

}

代码逻辑非常简单，GET方式访问/user/register获得registerForm.jsp视图，填入内容之后以POST方式提交到/user/register，handleRegister方法根据表单提交内容创建User对象并添加到userList中，随后返回loginForm.jsp。用户继续在loginForm.jsp中填写内容后提交，然后login方法根据loginForm.jsp提交内容判断userList中是否有这个用户，根据实际情况附加不同的信息后FORWARD到不同的页面。有这个用户，就附加username，跳转到loginSucess.jsp，没有这个用户，就附加msg，跳转回loginForm.jsp。

这里有两个地方使用到了logger试图在控制台输出日志：

1. UserController被Spring创建出来后，logger输出日志并将userList初始化。

2.收到registerForm.jsp中表单提交信息后，通过logger把使用@RequestParam提取的内容输出。然后在利用logger把利用提交信息创建的User对象输出了一下。

registerForm.jsp的代码：

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE>
<html>
<head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    <title>注册页面</title>
</head>
<body>
    <h3>注册页面</h3>
    <form action="register" method="post">
         <table>
             <tr>
                <td><label>登录名: </label></td>
                 <td><input type="text" id="loginname" name="loginname" ></td>
             </tr>
             <tr>
                <td><label>密码: </label></td>
                 <td><input type="password" id="password" name="password"></td>
             </tr>
             <tr>
                <td><label>用户名: </label></td>
                 <td><input type="text" id="username" name="username" ></td>
             </tr>
             <tr>
                 <td><input id="submit" type="submit" value="注册"></td>
             </tr>
         </table>
    </form>
</body>
</html>

部署程序后看效果：