Maven 搭建SpringMvc+Spring+Mybatis详细记录

2022-08-10 16:45:47

总觉得，看比人写的总是那么好，每次搭建框架时都会找博客，找教程来跟着一步一步走，虽然很快搭建成功了，但是经常情况是我并不知道我干了什么，也不记得具体步骤，到底为什么要这么做，今天我详细记录了一下自己搭建的过程，并且尽量理解每一步干什么。

SSM框架当下比较流行，我也是用这个框架来作为记录，尝试详细地记录下每一个步骤，学习，不要怕开头难。

一、创建一个新的Maven项目

　　1、 new -> Maven -> Maven Project

选择webapp工程。

2、maven项目建好以后，工程目录如图。可以看到index.jsp文件报错了，那是因为我们工程还没有引入web项目相关包。我们需要项目默认的source folder只有/src/main/resources。我们需要手动建立另外三个source folder。右键工程名->new->source folder,输入文件名（src/main/java src/test/java src/test/resources）

3、建立好source folder后，我们需要将文件与项目发布目录关联起来。

右键工程名->build path ->source ,双击对每个文件夹下的output folder。src/main/java和src/main/resources添加到target/classes，另外两个添加到target/teas-class

添加完毕后如图：

4、将maven引用包关联到项目发布目录里，在不用maven管理项目时，项目导入的包需要放在WEB-INFO/lib下，所以，我们需要将maven引用包也要关联到这个目录下。

build Path -> deployment Assembly

5、在工程最下面，打开pom.xml文件，添加依赖。

保存pom文件

添加成功后项目没有报错，一个maven创建的javaweb项目基本完成。
src/main/java 下放项目工程源码文件
src/main/resources 下放项目的一些配置文件
src/test/* 这里是测试相关目录。
视图文件一般放在webapp目录下。

到目前为止是一个基本的web项目，需要用到框架，就打入相关包，设置好配置文件就ok。
下面我就开始搭建SpringMvc + Spring + Mybatis

二、配置SpringMvc

1、首先需要导入SpringMvc的一些系列包，用maven导入，在pom配置文件里添加如下依赖就行。

我用的springmvc版本是4.1.6。我所有需要依赖的包都是在：http://mvnrepository.com/
上搜索，找到版本，然后把依赖添加到pom文件里，然后让maven自动去下载jar包到本地maven
库，如果有下载失败，也可手动下载jar包，然后通过mvn命令手动添加jar包到本地maven仓库。

我并不知道项目会用哪些jar，我大概知道一些，先添加进来，出错了，根据错误再导入相关jar包。

以下是我在pom文件中添加的依赖：

<dependency>

        <groupId>org.springframework</groupId>

        <artifactId>spring-context</artifactId>

        <version>4.1.6.RELEASE</version>

    </dependency>

    <dependency>

        <groupId>org.springframework</groupId>

        <artifactId>spring-core</artifactId>

        <version>4.1.6.RELEASE</version>

    </dependency>

    <dependency>

        <groupId>org.springframework</groupId>

        <artifactId>spring-beans</artifactId>

        <version>4.1.6.RELEASE</version>

    </dependency>

    <dependency>

        <groupId>org.springframework</groupId>

        <artifactId>spring-web</artifactId>

        <version>4.1.6.RELEASE</version>

    </dependency>

    <dependency>

        <groupId>org.springframework</groupId>

        <artifactId>spring-webmvc</artifactId>

        <version>4.1.6.RELEASE</version>

    </dependency>

    <dependency>

        <groupId>org.springframework</groupId>

        <artifactId>spring-aop</artifactId>

        <version>4.1.6.RELEASE</version>

    </dependency>

    <dependency>

        <groupId>org.springframework</groupId>

        <artifactId>spring-expression</artifactId>

        <version>4.1.6.RELEASE</version>

    </dependency>

    <dependency>

        <groupId>org.springframework</groupId>

        <artifactId>spring-jdbc</artifactId>

        <version>4.1.6.RELEASE</version>

    </dependency>

2、所有包引入后，配置web.xml，使其具有springmvc特性，主要配置两处，一个是ContextLoaderListener，一个是DispatcherServlet.

web.xml

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

<web-app version="2.4"

    xmlns="http://java.sun.com/xml/ns/j2ee"

    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

    xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee

    http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">

    <context-param>

            <param-name>contextConfigLocation</param-name>

            <param-value>

                classpath:spring-*.xml

            </param-value>

    </context-param>

  <!--配置spring监听器，配置ContextLoaderListener表示，该工程要以spring的方式启动。启动时会默认在/WEB-INF目录下查找spring-*.xml作为spring容器的配置文件，
该文件里可以初始化一些bean -->

    <listener>

        <listener-class>

            org.springframework.web.context.ContextLoaderListener

        </listener-class>

    </listener>

    <!-- Spring MVC Servlet 的配置， 配置DispatcherServlet表示，该工程将采用springmvc的方式。启动时也会默认在/WEB-INF目录下查找XXX-servlet.xml作为配置文件，
XXX就是DispatcherServlet的名字，该文件中将配置两项重要的mvc特性：HandlerMapping,负责为DispatcherServlet这个前端控制器的请求查找Controller；

        ViewResolver,负责为DispatcherServlet查找ModelAndView的视图解析器。也可以配置参数，指定加载的配置文件

        此处使用指定的配置文件spring-*.xml -->

    <servlet>

        <servlet-name>Spring-Servlet</servlet-name>

        <servlet-class> org.springframework.web.servlet.DispatcherServlet</servlet-class>

        <init-param>

            <param-name>contextConfigLocation</param-name>

            <param-value>

                classpath:spring-*.xml

            </param-value>

        </init-param>

        <load-on-startup>1</load-on-startup>

    </servlet>

    <servlet-mapping>

        <servlet-name>Spring-Servlet</servlet-name>

        <url-pattern>/</url-pattern>  <!--拦截所有请求-->

    </servlet-mapping>

</web-app>

3、接下来添加springmvc的配置文件

在src/main/resources目录下新建spring-servlet.xml文件（满足spring-*.xml格式，可以被扫描到）。

spring-servlet.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/mvc http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd

        http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd

        http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd" default-autowire="byName">

    <!-- 扫描包下的所有类，该包路径下的类可以不需要配置bean了 -->

    <context:component-scan base-package="cquzrj.vipserver.controller" />

    <!-- 启动Spring MVC的注解功能，完成请求和注解POJO的映射 -->

    <bean class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter" />

</beans>

4、我们可以简单测试一下。看是否报错，看到报错，认真看错误信息，找到错误源头，先不百度，尝试自己解决。

在src/main/java下新建包，并建一个类。

package cquzrj.vipserver.controller;

import org.springframework.stereotype.Controller;

import org.springframework.web.bind.annotation.RequestMapping;

@Controller

public class TestVip {

    /**

     * 1. 使用RequestMapping注解来映射请求的URL

     * 2. 返回值会通过视图解析器解析为实际的物理视图, 对于InternalResourceViewResolver视图解析器，会做如下解析

     * 通过prefix+returnVal+suffix 这样的方式得到实际的物理视图，然后会转发操作

     * "/WEB-INF/views/success.jsp"

     * @return

     */

    @RequestMapping("/helloworld")

    public String hello(){

        System.out.println("hello world");

        return “index”;

    }

}

若pom文件里添加的依赖全部成功，运行可以看到已经成功访问。报异常是因为我们还没有配置视图解析器。

5、配置视图解析器

在spring-servlet.xml中加入：

  <!--配置视图解析器-->

    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">

        <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>

        <property name="prefix" value="/"/>

        <property name="suffix" value=".jsp"/>

    </bean>

在这里，由于我配置的是JstlView，需要引入jstl包，在pom文件加入依赖：

<dependency>

        <groupId>jstl</groupId>

        <artifactId>jstl</artifactId>

        <version>1.2</version>

    </dependency>

如果下载包失败，在java resource处会有红色感叹号，这就需要手动在下载并引入了，最后检查一下上面第一节的第4步，看maven包有没有引用到发布目录。
当然，也可以配置其他的视图解析器例如org.springframework.web.servlet.view.InternalResourceView

重新启动项目，访问helloworld，会发现页面成功跳转到了index页面。说明视图解析成功。

三、配置Mybatis

1、 Mybatis整合spring，其实就是需要spring的IOC容器来管理mybatis的SqlSessionFactory，而不需要mybatis自己去管理。

依然在src/main/resources下新建配置文件spring-mybatis.xml

spring-mybatis.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"

    xmlns:aop="http://www.springframework.org/schema/aop"

    xmlns:tx="http://www.springframework.org/schema/tx"

    xsi:schemaLocation="http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd

        http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd

        http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-3.0.xsd

        http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.0.xsd

        http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd" default-autowire="byType">

         <!--数据库连接，用阿里的druid连接池-->

        <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource"

        init-method="init" destroy-method="close">

        <property name="driverClassName" value="com.mysql.jdbc.Driver" />

        <property name="url" value="jdbc:mysql://10.10.102.6:3306/jeecgmybatis?useUnicode=true&amp;charaterEncoding=utf-8" />

        <!--

            打开预编译，并缓存预编译，在执行prepareStatement时，或mybaits中的参数填充时，提高效率。

        jdbc:mysql://10.10.102.6:3306/jeecgmybatis?useServerPrepStmts=true&cachePrepStmts=true&useUnicode=true&amp;charaterEncoding=utf-8 -->

        <property name="username" value="root" />

        <property name="password" value="root" />

        <!-- 初始化连接大小 -->

        <property name="initialSize" value="0"></property>

        <!-- 连接池最大数量 -->

        <property name="maxActive" value="20"></property>

        <!-- 连接池最大空闲 -->

        <property name="maxIdle" value="15"></property>

        <!-- 连接池最小空闲 -->

        <property name="minIdle" value="10"></property>

        <!-- 获取连接最大等待时间 -->

        <property name="maxWait" value="60000"></property>

    </bean>

  <!-- sqlSessionFactory会被org.mybatis.spring.mapper.MapperFactoryBean使用 -->

    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">

        <property name="configLocation" value="classpath:MyBatis-Config.xml"/>

        <property name="mapperLocations">

            <list>

                <!-- mapper文件的放置位置 -->

                <value>classpath:cquzrj/vipserver/model/xml/*Mapper.xml</value>

             </list>

        </property>

        <property name="dataSource" ref="dataSource" />

    </bean>

    <!-- mybatis的Mapper的扫描器 MapperScannerConfigure  会自动扫描

         包下的所有接口自动生成代理对象: 对象名字为Mapper接口类名(首字母小写)

     -->

     <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">

        <property name="basePackage" value="cquzrj.vipserver.dao" />

        <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"></property>

    </bean> 

</beans>

2、加入mybatis相关包，pom文件添加：

    <dependency>

        <groupId>com.alibaba</groupId>

        <artifactId>druid</artifactId>

        <version>1.0.13</version>

    </dependency>

     <dependency>

           <groupId>org.mybatis</groupId>

           <artifactId>mybatis</artifactId>

           <version>3.2.7</version>

     </dependency>

     <dependency>

           <groupId>org.mybatis</groupId>

           <artifactId>mybatis-spring</artifactId>

           <version>1.3.0</version>

     </dependency>

同样，导入包失败，请手动下载后导入，在导入完成后，检查第一节第4步。

到目前为止，整个框架整合完毕，需要的就是测试了，我在本机测试通过，并在此记录一下，这里关于如何进行SpringMVC整合Mybatis进行开发，我这里先不写了，留作下次我整理清楚再详细绍介绍，本文是个人学习记录，其中难免有讲述不清和个人理解有误的地方，请谅解并欢迎指正，共同学习。还有，需要说明的一点是，前面工程的名字是ZRJCash，后面是ZRJCashVip，这是因为我后边儿手动改了名字，可以略过。

码农公寓

相关文章