SpringMVC学习（一）——快速搭建SpringMVC开发环境（非注解方式）

2023-11-09

1、开发环境准备

1.1、首先电脑需要安装JDK环境（略）

说明：本机使用的是JDK1.8.0_45，一定要记得配置环境变量。

1.2、准备一个以供开发的tomcat

说明：本机使用的是Tomcat 8.0.35。

1.3、准备Maven工具

说明：因为本机使用的是maven构建项目，本机使用的Maven版本为apache-maven-3.1.0。

1.4、准备IDE编译器

说明：本次开发使用的是IDEA，如果使用Eclipse也不影响开发。

1.5、准备一个本地的数据库，

说明：本机使用的是mysql数据库，目的是为了测试数据库连接以及访问，数据库版本为mysql 5.1.41。

注意一下，上面是本次开发使用的开发环境的前期准备工作，如果是没有进行过开发的小白可提前把开发环境搭建好，搭建开发环境的案例很多，本次就不再赘述了。

2、搭建SpringMVC开发环境

2.1、创建web工程

首先使用Maven工具创建一个webapp工程，选择 File -> New Module ->Maven，选中“Create from archetype”，选择如下图的webapp工程
使用maven创建webapp
然后选择“下一步”填入相应的字段知道完成项目创建，如果此处创建过程非常慢，请参考注意事项3.1。

2.2、使用maven引入相关的依赖

本例中使用的spirngmvc的版本为4.3.25.RELEASE

    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>
        </dependency>

        <!-- springmvc核心依赖 -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <!-- tomcat中存在此web运行的jar包 -->
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.0.1</version>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>javax.servlet.jsp</groupId>
            <artifactId>jsp-api</artifactId>
            <version>2.2</version>
            <scope>provided</scope>
        </dependency>

        <!-- 使用SpringJDBC进行数据库配置 -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-jdbc</artifactId>
            <version>${spring.version}</version>
        </dependency>
        <!-- mysql数据库连接的驱动-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.30</version>
        </dependency>
        <!-- Spring-test配合junit使用 -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-test</artifactId>
            <version>${spring.version}</version>
            <scope>test</scope>
        </dependency>

2.3、项目的整体结构图

本例中的springmvc的整体结构图如下图所示：
springmvc项目1结构图

2.4、新增springmvc-servlet的配置文件

在resources目录下新增加一个myspringmvc-servelet.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"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">

    <!-- 处理器映射器，将处理器Handler的name作为URL进行查找 -->
    <bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping"></bean>
    <!-- 处理器适配器，适配处理器中handlerRequest方法的调用 -->
    <bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter"></bean>
    <!-- 配置视图解析器，把handler方法返回的逻辑视图解析为实际的物理视图 -->
    <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/views/"/>
        <property name="suffix" value=".jsp"/>
    </bean>
</beans>

2.5、web.xml核心配置

增加springmvc的核心配置DispatcherServlet，配置效果如下所示：

    <servlet>
        <!-- 配置核心控制 servlet的名字决定了核心配置文件的命名：springmvc-servlet.xml -->
        <servlet-name>myspringmvc</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!-- 指定spring配置文件的位置,如果不配置默认/WEB-INF/[servlet-name]-servlet -->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:myspringmvc-servlet.xml</param-value>
        </init-param>
        <!-- 项目启动时加载 -->
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>myspringmvc</servlet-name>
        <!-- 配置url-pattern，设置为"/"表示拦截到所有的URL请求并映射到myspringmvc，包括静态资源如html, js, jpg等-->
        <url-pattern>/</url-pattern>
    </servlet-mapping>

2.5、第一个HelloController

编写第一个SpringMVC的Controller，需要继承自org.springframework.web.servlet.mvc.Controller
示例代码如下：

public class HelloController implements Controller {
    @Override
    public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        System.out.println("hello controller 跳转到 success");
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.addObject("data", "恭喜您，测试成功了");
        modelAndView.setViewName("success");//跳转到/WEB-INF/views/success.jsp
        return modelAndView;
    }
}

上面的示例中需要在/WEB-INF/views/增加一个“success”的测试页面，测试页面的代码如下：

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<body>
<h2>你好，跳转到success了!!!</h2>
<h3>${data}</h3>
</body>
</html>

编写完HelloController后需要在myspringmvc-servlet.xml中增加这个controller的配置

    <!-- 第一个springMVC测试程序 -->
    <bean id="helloController" name="/hello" class="com.leo.controller.HelloController"></bean>

好了，第一个Controller到这里已经编写完毕了，现在开始启动测试一下了。

2.6、配置Tomcat服务并启动

springmvc配置tomcat
然后配置启动的tomcat的位置和参数，可以参考笔者配置
springmvc的tomcat配置2
部署项目的war包并且配置上下文路径，参考笔者如下图
springmvc的tomcat配置3
启动tomcat

访问地址：http://localhost:8080/springmvc/
第一个helloworld

2.7、增加数据库配置

新增加数据库的配置信息，在pom.xml中增加如下配置（如果已经添加的请忽略），本示例中没有引入第三方框架，使用的是spring内置的jdbc框架

        <!-- 使用SpringJDBC进行数据库配置 -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-jdbc</artifactId>
            <version>${spring.version}</version>
        </dependency>
        <!-- mysql数据库连接的驱动-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.30</version>
        </dependency>

在resources目录下新增applicationContext.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"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">

       <!-- Spring内置连接池 -->
       <bean id="driverManagerDataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource">
              <property name="driverClassName" value="com.mysql.jdbc.Driver"></property>
              <property name="url" value="jdbc:mysql://localhost:3306/springframework_learning"></property>
              <property name="username" value="root"></property>
              <property name="password" value="root"></property>
       </bean>

       <!--指定连接池-->
       <bean id="jdbcTemplate" class="org.springframework.jdbc.core.JdbcTemplate">
              <property name="dataSource" ref="driverManagerDataSource"></property>
       </bean>
       <!-- 将这个工具类实例化给spring容器管理，不然会报空指针异常 -->
       <bean id="beanUtil" class="com.leo.util.ApplicationContextUtil"></bean>
       <!-- 测试的bean -->
       <bean id="userInfoService" class="com.leo.service.impl.UserInfoServiceImpl"></bean>
</beans>

并且在web.xml中将配置文件applicationContext.xml添加进去

    <!-- 配置应用公共配置 -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:applicationContext.xml</param-value>
    </context-param>
    <!-- 定义Spring监听器，加载Spring -->
    <listener>
    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

这里要注意一下applicationContext.xml和myspringmvc-servlet.xml都可以注入bean那他们的区别是什么？答案参考3.2

2.8、访问数据库测试

需要新写一个Controller，代码参考如下

public class GetUserInfoController implements Controller {

    @Override
    public ModelAndView handleRequest(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse) throws Exception {
        UserInfoService userInfoService = (UserInfoService) ApplicationContextUtil.getBean("userInfoService");
        System.out.println("GetUserInfoController获取用户信息");
        ModelAndView modelAndView = new ModelAndView();
        //访问数据库
        List userInfoList = userInfoService.getUserInfoList();
        System.out.println(userInfoList);
        modelAndView.addObject("data", userInfoList);
        modelAndView.setViewName("success");//跳转到/WEB-INF/views/success.jsp
        return modelAndView;
    }
}

还需要将新的Controller注册到myspringmvc-servlet.xml配置文件中

    <!-- 获取用户信息 -->
    <bean id="getUserInfoController" name="/getUserInfo" class="com.leo.controller.GetUserInfoController"></bean>

然后启动tomcat访问：http://localhost:8080/springmvc/getUserInfo
springmvc数据库访问
具体的代码地址为：chapter-1-springmvc-quickstart
(https://gitee.com/leo825/spring-framework-learning-example.git)

3、框架搭建过程注意事项

3.1、创建maven项目特别缓慢？

如果遇到创建maven过程特别缓慢的情况，需要在Setting添加一些mirror配置。操作如下：
首先找到项目中maven的settings配置文件位置，File -> Settings -> Build,Execution,Deployment -> Build Tools -> Maven
Maven的Setting配置文件位置
其次，在maven的settings配置文件的“mirrors”节点下添加mirror配置，然后保存，重新创建一下webapp试试。

  <mirror> 
    <id>alimaven</id>  
    <name>aliyun maven</name>  
    <url>http://maven.aliyun.com/nexus/content/groups/public/</url>  
    <mirrorOf>central</mirrorOf> 
  </mirror>  
  <mirror> 
    <id>CN</id>  
    <name>OSChina Central</name>  
    <url>http://maven.oschina.net/content/groups/public/</url>  
    <mirrorOf>central</mirrorOf> 
  </mirror>  
  <mirror> 
    <id>repo2</id>  
    <mirrorOf>central</mirrorOf>  
    <name>Human Readable Name for this Mirror.</name>  
    <url>http://repo2.maven.org/maven2/</url> 
  </mirror>  
  <mirror> 
    <id>net-cn</id>  
    <mirrorOf>central</mirrorOf>  
    <name>Human Readable Name for this Mirror.</name>  
    <url>http://maven.net.cn/content/groups/public/</url> 
  </mirror>  
  <mirror> 
    <id>ui</id>  
    <mirrorOf>central</mirrorOf>  
    <name>Human Readable Name for this Mirror.</name>  
    <url>http://uk.maven.org/maven2/</url> 
  </mirror>  
  <mirror> 
    <id>ibiblio</id>  
    <mirrorOf>central</mirrorOf>  
    <name>Human Readable Name for this Mirror.</name>  
    <url>http://mirrors.ibiblio.org/pub/mirrors/maven2/</url> 
  </mirror>  
  <mirror> 
    <id>jboss-public-repository-group</id>  
    <mirrorOf>central</mirrorOf>  
    <name>JBoss Public Repository Group</name>  
    <url>http://repository.jboss.org/nexus/content/groups/public</url> 
  </mirror>  
  <mirror> 
    <id>JBossJBPM</id>  
    <mirrorOf>central</mirrorOf>  
    <name>JBossJBPM Repository</name>  
    <url>https://repository.jboss.org/nexus/content/repositories/releases/</url> 
  </mirror>  
  <mirror> 
    <id>antelink</id>  
    <mirrorOf>central</mirrorOf>  
    <name>antelink Repository</name>  
    <url>http://maven.antelink.com/content/repositories/central/</url> 
  </mirror>  
  <mirror> 
    <id>openkoala</id>  
    <mirrorOf>central</mirrorOf>  
    <name>openkoala Repository</name>  
    <url>http://nexus.openkoala.org/nexus/content/groups/Koala-release/</url> 
  </mirror>  
  <mirror> 
    <id>tmatesoft</id>  
    <mirrorOf>central</mirrorOf>  
    <name>tmatesoft Repository</name>  
    <url>http://maven.tmatesoft.com/content/groups/public/</url> 
  </mirror>  
  <mirror> 
    <id>mavensync</id>  
    <mirrorOf>central</mirrorOf>  
    <name>mavensync Repository</name>  
    <url>http://mavensync.zkoss.org/maven2/</url> 
  </mirror>

3.2、applicationContext.xml和springmvc-servlet.xml区别？

二者区别如下：
applicationContext.xml这个一般是采用非spring mvc架构，用来加载Application Context。应用于多个servlet，配合listener一起使用。

如果直接采用SpringMVC，只需要把所有相关配置放到xxx-servlet.xml中就OK了。如果直接使用SpringMVC是可以不添加applicationContext.xml文件的。也可以使用applicationContext.xml添加一些公共类的bean和配置。

3.3、ApplicationContext和WebApplicationContext的关系？

二者区别
ApplicationContext 是 Spring里面的根容器管理着service,dao这些提供服务的bean；
WebApplicationcontext（子容器继承ApplicationContext ）实际是对应的是前端控制器 DispatcherServlet，负责外部请求的路由和转发

附文：

《Servlet、ServletConfig、ServletContext、DispatcherServlet、ApplicationContext、WebApplicationContext区别？》

如有不妥，赶快评论区指出来吧，作者一定认真做好反思总结！！！

本文内容由网友自发贡献，版权归原作者所有，本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容，请联系:hwhale#tublm.com(使用前将#替换为@)