手把手教你在IDEA中创建一个Maven+Spring MVC的入门项目

Posted 2021-09-20 格子衫111

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了手把手教你在IDEA中创建一个Maven+Spring MVC的入门项目相关的知识，希望对你有一定的参考价值。

文章目录

**步骤分析** > 1. 创建web项目，导入SpringMVC相关坐标 > 2. 配置SpringMVC前端控制器 DispathcerServlet > 3. 编写Controller类和视图页面 > 4. 使用注解配置Controller类中业务方法的映射地址 > 5. 配置SpringMVC核心文件 spring-mvc.xml

1. 创建web项目，导入SpringMVC相关坐标

项目创建完毕，目录结构如图所示。但是目前只是一个普通的jar工程，那么如何将它转换成一个web工程呢？

1）首先，在pom.xml文件中将打包方式从默认的jar包改成war包

<!-- 设置为web工程 -->
<packaging>war</packaging>

2）在main目录下创建webapp目录

创建webapp目录后，此目录上会有一个蓝色圆点图标，表示这是一个资源文件。PS：如果没有蓝色圆点，可刷新一下maven依赖。

3）点开工具栏的 Project Structure, 配置生成 WEB-INF 目录和web.xml文件

注意，如果生成后的WEB-INF不在webapp目录下，需要将WEB-INF目录移动到webapp目录下

4）在pom.xml中导入SpringMVC相关坐标
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>org.zwt</groupId>
    <artifactId>springmvc_quickstart</artifactId>
    <version>1.0-SNAPSHOT</version>

    <!-- 设置为web工程 -->
    <packaging>war</packaging>

    <!-- 导入SpringMVC相关坐标-->
    <dependencies>
        <!--springMVC坐标-->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>5.1.5.RELEASE</version>
        </dependency>
        <!--servlet坐标-->
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.1.0</version>
            <scope>provided</scope>
        </dependency>
        <!--jsp坐标-->
        <dependency>
            <groupId>javax.servlet.jsp</groupId>
            <artifactId>jsp-api</artifactId>
            <version>2.2</version>
            <scope>provided</scope>
        </dependency>
    </dependencies>

</project>

导入后刷新maven

2. 配置SpringMVC前端控制器DispatcherServlet

web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
         http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">

<!--    springmvc的前端控制器：DispatcherServlet-->
    <servlet>
        <servlet-name>DispatcherServlet</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    </servlet>
    
    <servlet-mapping>
        <servlet-name>DispatcherServlet</servlet-name>
<!--     匹配路径(拦截路径)
        /会匹配到不带后缀的访问路径，如：/login，无法匹配到带后缀的访问路径，如:/hello.jsp
        /*会匹配到所有的访问路径，不管有没有带后缀-->
        <url-pattern>/</url-pattern>
    </servlet-mapping>
</web-app>

3.编写Controller类和视图页面

/WEB-INF/pages/ success.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>succuss</title>
</head>
<body>
    <h3>Spring MVC入门成功</h3>
</body>
</html>

UserController.java

public class UserController {

    public String quick() {
        // 业务逻辑
        System.out.println("quick running......");
        // 视图跳转
        return "/WEB-INF/pages/success.jsp";
    }
}

4.使用注解配置Controller类中业务方法的映射地址

UserController.java

@Controller
public class UserController {
    
    @RequestMapping("/quick")
    public String quick() {
        // 业务逻辑
        System.out.println("quick running......");
        // 视图跳转
        return "/WEB-INF/pages/success.jsp";
    }
}

5.配置SpringMVC核心文件spring-mvc.xml

spring-mvc.xml

<beans xmlns="http://www.springframework.org/schema/beans"
               xmlns:mvc="http://www.springframework.org/schema/mvc"
               xmlns:context="http://www.springframework.org/schema/context"
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xsi:schemaLocation="http://www.springframework.org/schema/beans
       http://www.springframework.org/schema/beans/spring-beans.xsd
       http://www.springframework.org/schema/mvc
       http://www.springframework.org/schema/mvc/spring-mvc.xsd
       http://www.springframework.org/schema/context
       http://www.springframework.org/schema/context/spring-context.xsd">

<!--配置注解扫描-->
<context:component-scan base-package="com.zwt.controller"/>

</beans>

ps：目前没有整合Spring，对象是存到了Spring MVC所创建出来的IOC容器中

至此，项目初创建完成。
就算将此项目部署到tomcat启动，也是无法访问到quick方法的，因为虽然编写了spring-mvc的配置文件，又配置了注解扫描，但是sping-mvc.xml是没有被加载的，所以，要借助DispatcherServlet前端控制器完成对spring-mvc.xml文件的加载。
怎么配置呢，主要通过新增 init-param 标签和 load-on-startup标签：
web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
         http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">

    <!-- springmvc的前端控制器：DispatcherServlet-->
    <servlet>
        <servlet-name>DispatcherServlet</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>

        <!-- 初始化参数，加载spring-mvc配置文件-->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:spring-mvc.xml</param-value>
        </init-param>

        <!-- 设置startup参数为整数，使应用在启动时，就完成对servlet的实例化和初始化操作-->
        <load-on-startup>2</load-on-startup>
    </servlet>
    
    <servlet-mapping>
        <servlet-name>DispatcherServlet</servlet-name>
<!--     匹配路径(拦截路径)
        /会匹配到不带后缀的访问路径，如：/login，无法匹配到带后缀的访问路径，如:/hello.jsp
        /*会匹配到所有的访问路径，不管有没有带后缀-->
        <url-pattern>/</url-pattern>
    </servlet-mapping>
</web-app>