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

1、开发环境准备
- 1.1、首先电脑需要安装JDK环境（略）
- 1.2、准备一个以供开发的tomcat
- 1.3、准备Maven工具
- 1.4、准备IDE编译器
- 1.5、准备一个本地的数据库，
2、搭建SpringMVC开发环境
- 2.1、创建web工程
- 2.2、使用maven引入相关的依赖
- 2.3、项目的整体结构图
- 2.4、新增springmvc-servlet的配置文件
- 2.5、web.xml核心配置
- 2.5、第一个HelloController
- 2.6、配置Tomcat服务并启动
- 2.7、增加数据库配置
- 2.8、访问数据库测试
3、框架搭建过程注意事项
- 3.1、创建maven项目特别缓慢？
- 3.2、applicationContext.xml和springmvc-servlet.xml区别？
- 3.3、ApplicationContext和WebApplicationContext的关系？

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

然后选择“下一步”填入相应的字段知道完成项目创建，如果此处创建过程非常慢，请参考注意事项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的整体结构图如下图所示：

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 {@Overridepublic 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.jspreturn 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服务并启动

然后配置启动的tomcat的位置和参数，可以参考笔者配置

部署项目的war包并且配置上下文路径，参考笔者如下图

启动tomcat

访问地址：http://localhost:8080/springmvc/

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 {@Overridepublic 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.jspreturn modelAndView;}
}

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

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

然后启动tomcat访问：http://localhost:8080/springmvc/getUserInfo

具体的代码地址为：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的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容器上下文，WebApplicationContext是Web容器上下文，WebApplicationContext继承自ApplicationContext，因此只要是ApplicationContext中注册的Bean都能在WebApplicationContext中获取到，反之则不然。