1. 新建 spring-mvc 项目
2. 配置文件
3. 配置 TomcatServer
4. 写一个简单的 HelloController
5. 其他
6. 异常记录
参考

基础：完成 Tomcat 的安装，并与 IDEA 集成
- 注意：IDEA 社区版可以使用 Smart Tomcat 插件，具体配置项目的方法可见；
  1. 新建 spring-mvc 项目
注意：location 中对应 name 的文件必须点击右边的文件符号在本地对应找到，所以事先应先建好；

下一步是配置 maven 的路径，注意对应好 maven 的 setting.xml 和 repository 路径，其中 repository 路径可作在 setting.xml 中修改标签；

为了解决 maven 创建项目加载过慢的问题，可以在 properties 中添加： archetypeCatalog:internal；

在 main 路径下，创建两个子文件：java、resource，右键 mark directory as 对应选择：Source root 和 Resource root；

2. 配置文件

2.1 配置 src 路径下的 pom.xml ，并导入依赖包

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>cn.tjufe</groupId>
  <artifactId>springmvc_1</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>war</packaging>
  <name>springmvc_1 Maven Webapp</name>
  <!-- FIXME change it to the project's website -->
  <url>http://www.example.com</url>
  <!--版本锁定-->
  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
    <spring.version>5.0.2.RELEASE</spring.version>
  </properties>
  <dependencies>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-web</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>servlet-api</artifactId>
      <version>2.5</version>
      <scope>provided</scope>
    </dependency>
    <dependency>
      <groupId>javax.servlet.jsp</groupId>
      <artifactId>jsp-api</artifactId>
      <version>2.0</version>
      <scope>provided</scope>
    </dependency>
  </dependencies>
  <build>
    <finalName>springmvc_day01_01_start</finalName>
    <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
      <plugins>
        <plugin>
          <artifactId>maven-clean-plugin</artifactId>
          <version>3.0.0</version>
        </plugin>
        <!-- see http://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_war_packaging -->
        <plugin>
          <artifactId>maven-resources-plugin</artifactId>
          <version>3.0.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-compiler-plugin</artifactId>
          <version>3.7.0</version>
        </plugin>
        <plugin>
          <artifactId>maven-surefire-plugin</artifactId>
          <version>2.20.1</version>
        </plugin>
        <plugin>
          <artifactId>maven-war-plugin</artifactId>
          <version>3.2.0</version>
        </plugin>
        <plugin>
          <artifactId>maven-install-plugin</artifactId>
          <version>2.5.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-deploy-plugin</artifactId>
          <version>2.8.2</version>
        </plugin>
      </plugins>
    </pluginManagement>
  </build>
</project>

2.2 配置 src/main/webapp/WEB-INF/web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app>
  <display-name>Archetype Created Web Application</display-name>
  <!--配置解决中文乱码的过滤器-->
  <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>
  </filter>
  <filter-mapping>
    <filter-name>characterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
  </filter-mapping>
  <servlet>
    <servlet-name>dispatcherServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:springmvc.xml</param-value>//说明 ioc 容器的文件路径
    </init-param>
    <load-on-startup>1</load-on-startup>//确定初始化的优先级，数字越小，优先级越高
  </servlet>
  <servlet-mapping>
    <servlet-name>dispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>
</web-app>

若遇到报错：The content of element type “web-app” must match “(icon?,display- name?,description?…
- 解决方法：调整配置的顺序，删除 • <!DOCTYPE web-app PUBLIC”-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN…….”
  2.3 配置 src/main/resources/springmvc.xml
注意：文件的名字必须与 web.xml 中对应一致

注意：使用能自动加载 RequestMappingHandlerMapping（处理映射器）、RequestMappingHandlerAdapter（处理适配器），可用在 springmvc.xml 配置文件中替代注解处理器和适配器的配置，但是视图解析器得自己配置；

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xmlns:context="http://www.springframework.org/schema/context"
     xmlns:mvc="http://www.springframework.org/schema/mvc"
     xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
      http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.1.xsd
      http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.1.xsd">
  <!-- 包扫描 -->
  <context:component-scan base-package="cn.tjufe"/>
  <!-- 视图解析器对象-->
  <bean id="internalResourceViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
      <property name="prefix" value="/WEB-INF/pages/"></property>
      <property name="suffix" value=".jsp"></property>
  </bean>
  <!--开启 SpringMVC 框架注解的支持-->
  <mvc:annotation-driven/>

3. 配置 TomcatServer

4. 写一个简单的 HelloController

调用逻辑

结果

5. 其他

5.1 请求参数的绑定

补充：@RequestParam 和 @PathVariable 注解（通常使用 PathVariable 作为动态 URI 的参数注入）

用 IDEA 实现简单的 SpringMVC 程序 - 图14

5.2 自定义类型转换器

5.3 响应数据和结果视图

如果想将响应数据返回的话，可使用参数 Model、ModelAndView 或 HttpServletResponse；
返回的字符串一般是响应的结果视图 xxx.jsp；
处理返回结果为 void 时，除了可使用转发（依赖 request）或重定向（依赖 response），也可以利用 response.getWriter() 直接响应结果；
以下案例 1、2 实现的功能一样，且 1 的底层调用逻辑就是 2 ；

推荐使用关键字（forward:xxx，rediret:xxx）来进行返回值为 String 类型的转发或重定向操作

@Controller
@RequestMapping("/user/")
public class ParamController {
  //1. 返回的是字符串
  @RequestMapping("getUser1")
  public String getUser(Model model){   
      User1 user = new User1();
      user.setId("1");
      user.setAge(18);
      model.addAttribute("user",user);
      return "result01";
  }
  //2. 返回的是ModelAndView
  @RequestMapping("testModelAndView")
  public ModelAndView testModelAndView(){
      ModelAndView mv = new ModelAndView();
      User1 user = new User1();
      user.setId("1");
      user.setAge(18);
      mv.addObject("user",user);
      mv.setViewName("result01");
      return mv;
  }
  //返回为空 void
  @RequestMapping("dealVoid")
  public void getUser(HttpServletRequest request, HttpServletResponse response) throws Exception {
      System.out.println("dealVoid 方法执行了...");
      //编写请求转发的程序
//        request.getRequestDispatcher("/WEB-INF/pages/result01.jsp").forward(request, response);
      //重定向
//        response.sendRedirect(request.getContextPath() + "/index.jsp");
      response.setCharacterEncoding("UTF-8");
      response.setContentType("text/html;charset=UTF-8");
      //直接进行响应
      response.getWriter().print("你好");
      return;
  }
  /**
   * 使用关键字来进行返回值为String类型的转发或重定向操作
   * @return
   */
  @RequestMapping("testForwardOrRedirect")
  public String testForwardOrRedirect(){
      System.out.println("testForwardOrRedirect方法执行了");
//        return "forward:/WEB-INF/pages/result01.jsp";
      return "redirect:/index.jsp";
  }
}

5.4 Ajax 与 JSON 字符串

在 pom.xml 中需要导入的 jar 包

  <dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.9.0</version>
  </dependency>
  <dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-core</artifactId>
    <version>2.9.0</version>
  </dependency>
  <dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-annotations</artifactId>
    <version>2.9.0</version>
  </dependency>

5.6 文件上传

pom.xml 中的 jar 包配置

  <!--文件上传-->
  <dependency>
    <groupId>commons-fileupload</groupId>
    <artifactId>commons-fileupload</artifactId>
    <version>1.3.1</version>
  </dependency>
  <dependency>
    <groupId>commons-io</groupId>
    <artifactId>commons-io</artifactId>
    <version>2.4</version>
  </dependency>
  <!--实现跨服务器的文件上传-->
  <dependency>
    <groupId>com.sun.jersey</groupId>
    <artifactId>jersey-core</artifactId>
    <version>1.18.1</version>
  </dependency>
  <dependency>
    <groupId>com.sun.jersey</groupId>
    <artifactId>jersey-client</artifactId>
    <version>1.18.1</version>
  </dependency>

（1）传统文件上传

  @RequestMapping("testFileUpLoad")
  public String testFileUpLoad(HttpServletRequest request) throws Exception {
      System.out.println("文件上传....");
      // 1. 上传的位置
      String path = request.getSession().getServletContext().getRealPath("/uploads/");
      // 2. 判断路径是否存在，并创建该文件夹
      File file = new File(path);
      if (!file.exists()) {
          file.mkdir();
      }
      // 3. 解析 request 对象，获取上传文件项
      DiskFileItemFactory factory = new DiskFileItemFactory();
      ServletFileUpload upload = new ServletFileUpload(factory);
      List<FileItem> items = upload.parseRequest(request);
      // 4. 遍历判断当前 item 对象是否是上传文件项
      for (FileItem item:items){
          if (item.isFormField()) {
              //说明是普通表单项
          } else {
              String filename = item.getName();
              //通过 UUID 把文件的名称设置为唯一值
              String uuid = UUID.randomUUID().toString().replace("-","");
              filename = uuid + "_" + filename;
              //依据获取的文件名称和设定的文件路径完成文件上传
              item.write(new File(path, filename));
              //删除临时文件
              item.delete();
          }
      }
      return "result01";
  }

（2）SpringMVC 文件上传

  @RequestMapping("testFileUpLoad2")
  public String testFileUpLoad2(HttpServletRequest request, MultipartFile upload) throws Exception {
      System.out.println("文件上传...");
      // 1. 上传的位置
      String path = request.getSession().getServletContext().getRealPath("/uploads/");
      // 2. 判断路径是否存在，并创建该文件夹
      File file = new File(path);
      if(!file.exists()){
          file.mkdir();
      }
      // 3. 通过 MultipartFile 解析 request 对象来获取上传文件项
      String filename = upload.getOriginalFilename();
      String uuid = UUID.randomUUID().toString().replace("-","");
      filename = uuid + "_" + filename;
      // 4. 通过 MultipartFile 完成文件上传
      upload.transferTo(new File(path, filename));
      return "result01";
  }

（3）跨服务器文件上传

注意两点，一是 index.jsp 中的文件命名，而是 spring.mvc 配置 multipartResolver 的 id 默认不能修改；

    @RequestMapping("testFileUpLoad3")
    public String testFileUpLoad3(MultipartFile upload) throws Exception {
        System.out.println("跨服务器文件上传...");
        //1.定义要上传的文件服务器路径
        String path = "http://localhost:9090/uploads/";
        //2.通过 MultipartFile 解析 request 对象来获取上传文件项
        String filename = upload.getOriginalFilename();
        String uuid = UUID.randomUUID().toString().replace("-","");
        filename = uuid + "_" + filename;
        //3.创建客户端的对象,并和图片服务器进行连接
        Client client = Client.create();
        WebResource webResource =  client.resource(path + filename);
        //4.上传文件
        webResource.put(upload.getBytes());
        return "result01";
    }

5.7 spring MVC 异常处理

5.8 自定义拦截器

通过定义两个 MyInterceptor 来测试拦截链的执行顺序

5.9 springmvc 常用注解

6. 异常记录
requestBody 从客户端传来的 json 字符串乱码，会导致服务端的 json 无法被 spring 自动解析成相应的 bean 对象；

maven 在新添依赖包的时候，如果某次下载失败，之后会自动跳过，解决方法有两个：
- 一是找到 maven 的 repository，从中找到下载失败的文件夹然后删掉（里边没有下载好 jar 包），然后再到右边的 maven 图标点更新；
- 二是在 maven_repository 的官网找到对应的包并下载下来（ps. 官网会提供对应 jar 包在 pom.xml 中的 dependecy 描述）；
跨服务器上传文件的时候，报错 404（还未解决，实在不知道怎么搞）
- 尝试一：将 web.xml 中 servlet 的 readOnly 设置为 false；
- 尝试二：在 server.xml 添加一个配置在标签内部

尝试三：在 server.xml 添加 connector；
https://blog.csdn.net/weixin_43705313/article/details/103126093 此博文中提到的第二种解决 404 的方式，用 IDEA 集成工具配置，奈何自己用的是 IDEA 社区版，下的 smart tomcat 也不支持该操作，作罢。。

参考

黑马教程-springmvc教程IDEA版

用 IDEA 实现简单的 SpringMVC 程序

1. 新建 spring-mvc 项目