IDEA下创建Maven项目，并整合使用Spring、Spring MVC、Mybatis框架

时间：2024-01-17 18:39:56

项目创建

  • 本项目使用的是IDEA 2016创建。项目使用Spring 4.2.6，Mybatis3.4.0,Tomcat使用的是Tomcat8，数据库为MySQL。
  • 首先电脑安装Maven，接着打开IDEA新建一个project，选择Maven，选择图中所选项，下一步。

IDEA下创建Maven项目，并整合使用Spring、Spring MVC、Mybatis框架

  1. 填写好GroupId和ArtifactId，GroupId在公司中一般都是域名的逆序，ArtifactId用来标明该项目是用来做什么的，接着下一步。
  2. 添加一个archetypeCatalog，值为internal可以加速项目的创建，不然就需要等好久，接着设置好项目的名称，点击完成就可以创建好项目了。
  3. 创建好后，可以在main文件夹下新建一个java文件夹，用来保存java源文件，然后点击file，进入project structure，将java文件夹设置为源文件，resources设置为资源文件。这样项目创建不问基本就完成了。

    IDEA下创建Maven项目，并整合使用Spring、Spring MVC、Mybatis框架
  4. 修改pom.xml文件如下。
<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/maven-v4_0_0.xsd">

  <modelVersion>4.0.0</modelVersion>

  <groupId>fv</groupId>

  <artifactId>academicnetwork</artifactId>

  <packaging>war</packaging>

  <version>1.0-SNAPSHOT</version>

  <name>academicnetwork Maven Webapp</name>

  <url>http://maven.apache.org</url>

  <properties>

    <!-- spring版本号 -->

    <spring.version>4.2.6.RELEASE</spring.version>

    <!-- mybatis版本号 -->

    <mybatis.version>3.4.0</mybatis.version>

    <!-- log4j日志文件管理包版本 -->

    <slf4j.version>1.7.7</slf4j.version>

    <log4j.version>1.2.17</log4j.version>

    <!--jackson版本号-->

    <jackson.version>2.7.1</jackson.version>

  </properties>

  <dependencies>

    <dependency>

      <groupId>junit</groupId>

      <artifactId>junit</artifactId>

      <version>4.11</version>

      <!-- 表示开发的时候引入，发布的时候不会加载此包 -->

      <!--<scope>test</scope>-->

    </dependency>

    <!-- spring核心包 -->

    <dependency>

      <groupId>org.springframework</groupId>

      <artifactId>spring-core</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-oxm</artifactId>

      <version>${spring.version}</version>

    </dependency>

    <dependency>

      <groupId>org.springframework</groupId>

      <artifactId>spring-tx</artifactId>

      <version>${spring.version}</version>

    </dependency>

    <dependency>

      <groupId>org.springframework</groupId>

      <artifactId>spring-jdbc</artifactId>

      <version>${spring.version}</version>

    </dependency>

    <dependency>

      <groupId>org.springframework</groupId>

      <artifactId>spring-webmvc</artifactId>

      <version>${spring.version}</version>

    </dependency>

    <dependency>

      <groupId>org.springframework</groupId>

      <artifactId>spring-aop</artifactId>

      <version>${spring.version}</version>

    </dependency>

    <dependency>

      <groupId>org.springframework</groupId>

      <artifactId>spring-context-support</artifactId>

      <version>${spring.version}</version>

    </dependency>

    <dependency>

      <groupId>org.springframework</groupId>

      <artifactId>spring-test</artifactId>

      <version>${spring.version}</version>

    </dependency>

    <!-- mybatis核心包 -->

    <dependency>

      <groupId>org.mybatis</groupId>

      <artifactId>mybatis</artifactId>

      <version>${mybatis.version}</version>

    </dependency>

    <!-- mybatis/spring包 -->

    <dependency>

      <groupId>org.mybatis</groupId>

      <artifactId>mybatis-spring</artifactId>

      <version>1.3.0</version>

    </dependency>

    <dependency>

      <groupId>javax.mail</groupId>

      <artifactId>mail</artifactId>

      <version>1.4</version>

    </dependency>

    <!-- 导入Mysql数据库链接jar包 -->

    <dependency>

      <groupId>mysql</groupId>

      <artifactId>mysql-connector-java</artifactId>

      <version>5.1.30</version>

    </dependency>

    <!-- 导入dbcp的jar包，用来在applicationContext.xml中配置数据库 -->

    <dependency>

      <groupId>commons-dbcp</groupId>

      <artifactId>commons-dbcp</artifactId>

      <version>1.2.2</version>

    </dependency>

    <!-- JSTL标签类 -->

    <dependency>

      <groupId>jstl</groupId>

      <artifactId>jstl</artifactId>

      <version>1.2</version>

    </dependency>

    <!-- 日志文件管理包 -->

    <!-- log start -->

    <dependency>

      <groupId>log4j</groupId>

      <artifactId>log4j</artifactId>

      <version>${log4j.version}</version>

    </dependency>

    <!-- 格式化对象，方便输出日志 -->

    <dependency>

      <groupId>com.alibaba</groupId>

      <artifactId>fastjson</artifactId>

      <version>1.1.41</version>

    </dependency>

    <dependency>

      <groupId>org.slf4j</groupId>

      <artifactId>slf4j-api</artifactId>

      <version>${slf4j.version}</version>

    </dependency>

    <dependency>

      <groupId>org.slf4j</groupId>

      <artifactId>slf4j-log4j12</artifactId>

      <version>${slf4j.version}</version>

    </dependency>

    <!-- log end -->

    <!-- 映入JSON -->

    <dependency>

      <groupId>com.fasterxml.jackson.core</groupId>

      <artifactId>jackson-core</artifactId>

      <version>${jackson.version}</version>

    </dependency>

    <dependency>

      <groupId>com.fasterxml.jackson.core</groupId>

      <artifactId>jackson-databind</artifactId>

      <version>${jackson.version}</version>

    </dependency>

    <dependency>

      <groupId>com.fasterxml.jackson.core</groupId>

      <artifactId>jackson-annotations</artifactId>

      <version>${jackson.version}</version>

    </dependency>

  </dependencies>

  <build>

    <finalName>academicnetwork</finalName>

  </build>

</project>

整合使用SSM框架

  • SSM框架即为Spring、Spring MVC、Mybatis。创建后的项目结构图即为下图。

IDEA下创建Maven项目，并整合使用Spring、Spring MVC、Mybatis框架

1.首先可以resources文件夹下创建三个文件，spring-mybatis.xml、spring-mvc.xml、jdbc.propertis、log4j.properties，并修改web.xml内容。

- spring-mybatis.xml：整合spring与mybatis，并实现spring基本功能。

- spring-mvc.xml：配置使用spring-mvc。

- jdbc.propertis:资源文件，用来保存数据库相关信息。

- log4j.properties:配置日志文件。

spring-mybatis.xml

  • 第一句自动扫描是为了扫描包中的注解，然后进行依赖注入，这时所有扫描的注解对象都在Spring容器中。
  • 配置数据源，整合使用Mybatis。
<?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:tx="http://www.springframework.org/schema/tx"

       xsi:schemaLocation="http://www.springframework.org/schema/beans

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

                        http://www.springframework.org/schema/context

                        http://www.springframework.org/schema/context/spring-context-3.1.xsd

                        http://www.springframework.org/schema/tx

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

    <!-- 自动扫描 -->

    <context:component-scan base-package="fv">

        <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>

    </context:component-scan>

    <!-- 引入数据库配置文件 -->

    <bean id = "propertyConfigurer"

          class = "org.springframework.beans.factory.config.PreferencesPlaceholderConfigurer">

        <property name = "location" value="classpath:jdbc.properties" />

    </bean>

    <!-- 连接池 -->

    <bean id = "dataSource" class = "org.apache.commons.dbcp.BasicDataSource"

          destroy-method = "close">

        <property name="driverClassName" value="${jdbc.driver}" />

        <property name="url" value="${jdbc.url}" />

        <property name="username" value="${jdbc.username}" />

        <property name="password" value="${jdbc.password}" />

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

        <property name="initialSize" value="${jdbc.initialSize}" />

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

        <property name="maxActive" value="${jdbc.maxActive}"/>

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

        <property name="maxIdle" value="${jdbc.maxIdle}" />

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

        <property name="minIdle" value="${jdbc.minIdle}" />

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

        <property name="maxWait" value="${jdbc.maxWait}" />

    </bean>

    <!-- 结合Spring和Mybatis -->

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

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

        <!-- 自动扫描mapping.xml文件 -->

        <property name = "mapperLocations" value="classpath:fv/mapping/*.xml" />

    </bean>

    <!-- DAO接口所在包名，Spring会自动查找其下的类 -->

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

        <property name = "basePackage" value="fv.dao" />

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

    </bean>

    <!-- 定义事务 -->

    <bean id = "transactionManager"

          class = "org.springframework.jdbc.datasource.DataSourceTransactionManager">

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

    </bean>

    <!-- 使用注解定义事务 -->

    <tx:annotation-driven transaction-manager = "transactionManager" />

</beans>

spring-mvc.xml

  • 第一句扫描注解，扫描出的注解对象都依赖注入到了Spring MVC容器中，这时不可以再次扫描Service，不然事务就不能用了，所以扫描时将Service除去，这时必须要扫描Controller，不然服务就会出404错误。
<?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-3.1.xsd

                        http://www.springframework.org/schema/context

                        http://www.springframework.org/schema/context/spring-context-3.1.xsd

                        http://www.springframework.org/schema/mvc

                        http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd">

    <!-- 自动扫描该包，使用SpringMVC认为包下用了@Controller注解的类是控制器,避免扫描@Service导致事务不能使用 -->

    <context:component-scan base-package = "fv">

        <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>

        <context:exclude-filter type="annotation" expression="org.springframework.stereotype.Service"/>

    </context:component-scan>

    <!--避免IE执行AJAX时，返回JSON出现下载文件 -->

    <bean id = "mappingJacksonHttpMessageConverter"

          class = "org.springframework.http.converter.json.MappingJackson2HttpMessageConverter">

        <property name = "supportedMediaTypes">

            <list>

                <value>text/html;charset=UTF-8</value>

            </list>

        </property>

    </bean>

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

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

        <property name="order" value="1"/>

        <property name="defaultViews">

            <list>

                <!-- JSON View -->

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

                </bean>

            </list>

        </property>

    </bean>

    <!-- 定义跳转的文件的前后缀 ，视图模式配置-->

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

        <!-- 自动给后面action的方法return的字符串加上前缀和后缀，变成一个 可用的url地址 -->

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

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

    </bean>

    <!-- 添加后可以显示welcome-file界面 -->

    <mvc:default-servlet-handler/>

    <!-- 启动注解 -->

    <mvc:annotation-driven />

</beans>

jdbc.properties

  • 设置好一些基本属性，可以直接在spring-mybatis.xml中使用${属性名}访问。
jdbc.driver=com.mysql.jdbc.Driver

jdbc.url=jdbc:mysql://localhost:3306/academic?useSSL=false

jdbc.username=root

jdbc.password=abc123

#定义初始连接数

jdbc.initialSize=0

#定义最大连接数

jdbc.maxActive=20

#定义最大空闲

jdbc.maxIdle=20

#定义最小空闲

jdbc.minIdle=1

#定义最长等待时间

jdbc.maxWait=60000

log4j.properties

  • 日志。
#定义LOG输出级别

log4j.rootLogger=INFO,Console,File

#定义日志输出目的地为控制台

log4j.appender.Console=org.apache.log4j.ConsoleAppender

log4j.appender.Console.Target=System.out

#可以灵活地指定日志输出格式，下面一行是指定具体的格式

log4j.appender.Console.layout = org.apache.log4j.PatternLayout

log4j.appender.Console.layout.ConversionPattern=[%c] - %m%n

#文件大小到达指定尺寸的时候产生一个新的文件

log4j.appender.File = org.apache.log4j.RollingFileAppender

#指定输出目录

log4j.appender.File.File = logs/ssm.log

#定义文件最大大小

log4j.appender.File.MaxFileSize = 10MB

# 输出所以日志，如果换成DEBUG表示输出DEBUG以上级别日志

log4j.appender.File.Threshold = ALL

log4j.appender.File.layout = org.apache.log4j.PatternLayout

log4j.appender.File.layout.ConversionPattern =[%p] [%d{yyyy-MM-dd HH\:mm\:ss}][%c]%m%n

web.xml

  • 最前面设置初始化加载spring-mybatis.xml文件。
  • ContextLoaderListener监听器的作用就是启动Web容器时，自动装配ApplicationContext的配置信息。若没有该语句，就无法依赖注入注解标注产生的对象。
<?xml version="1.0" encoding="UTF-8"?>

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

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

          xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"

          version="3.0">

  <display-name>Archetype Created Web Application</display-name>

  <!-- Spring和Mybatis的配置文件 -->

  <context-param>

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

    <param-value>classpath:spring-mybatis.xml</param-value>

  </context-param>

  <!-- 编码过滤器 -->

  <filter>

    <filter-name>encodingFilter</filter-name>

    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>

    <async-supported>true</async-supported>

    <init-param>

      <param-name>encoding</param-name>

      <param-value>UTF-8</param-value>

    </init-param>

  </filter>

  <filter-mapping>

    <filter-name>encodingFilter</filter-name>

    <url-pattern>/*</url-pattern>

  </filter-mapping>

  <!-- Spring监听器 -->

  <listener>

    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>

  </listener>

  <!-- 防止Spring内存溢出监听器 -->

  <listener>

    <listener-class>org.springframework.web.util.IntrospectorCleanupListener</listener-class>

  </listener>

  <!-- Spring MVC servlet -->

  <servlet>

    <servlet-name>SpringMVC</servlet-name>

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

    <init-param>

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

      <param-value>classpath:spring-mvc.xml</param-value>

    </init-param>

    <!-- 容器在启动时就加载这个servlet -->

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

    <async-supported>true</async-supported>

  </servlet>

  <servlet-mapping>

    <servlet-name>SpringMVC</servlet-name>

    <url-pattern>/</url-pattern>

  </servlet-mapping>

  <!-- 设置默认首页 -->

  <welcome-file-list>

    <welcome-file>/index.jsp</welcome-file>

  </welcome-file-list>

</web-app>

2.创建java下的目录结构

  • controller：控制文件，所有请求都是传入到此文件夹中的类里。

TestController.java

  • 最前方加上Controller注解。
  • @Autowired @Qualifier("testService")：依赖注入Service服务对象，使用Qualifier注解是指定具体服务，不然会进行默认匹配。
  • @ResponseBody：让返回值为JSON，但是pojo对象必须实现了getter和setter方法，不然会出现转换失败的错误。
package fv.controller;

import fv.pojo.Test;

import fv.service.TestService;

import org.springframework.beans.factory.annotation.Autowired;

import org.springframework.beans.factory.annotation.Qualifier;

import org.springframework.stereotype.Controller;

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

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

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

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

/**

 * 测试

 */

@Controller

@RequestMapping("/test")

public class TestController {

    @Autowired

    @Qualifier("testService")

    private TestService testService;

    @RequestMapping(value = "/get", method = RequestMethod.GET)

    @ResponseBody

    public Test getTestById(@RequestParam("id") String id) {

        return testService.getById(Integer.parseInt(id));

    }

}
  • service:服务的接口。

TestService.java

package fv.service;

import fv.pojo.Test;

/**

 * 测试服务接口

 */

public interface TestService {

    Test getById(int id);

}
  • srv.imp:服务的实现

TestServiceImp.java

  • Service注解，扫描后就可以依赖注入对象到Controller。
package fv.srv.imp;

import fv.dao.TestMapper;

import fv.pojo.Test;

import fv.service.TestService;

import org.springframework.beans.factory.annotation.Autowired;

import org.springframework.stereotype.Service;

/**

 * 测试服务

 */

@Service("testService")

public class TestServiceImp implements TestService {

    @Autowired(required = false)

    private TestMapper testMapper = null;

    public Test getById(int id) {

        return testMapper.selectByPrimaryKey(id);

    }

}
  • pojo：简单java对象。

Test.java

package fv.pojo;

/**

 * 测试对象

 */

public class Test {

    private Integer id;

    private Integer test1;

    private String test2;

    public Integer getId() {

        return id;

    }

    public void setId(Integer id) {

        this.id = id;

    }

    public Integer getTest1() {

        return test1;

    }

    public void setTest1(Integer test1) {

        this.test1 = test1;

    }

    public String getTest2() {

        return test2;

    }

    public void setTest2(String test2) {

        this.test2 = test2;

    }

}
  • dao:持久层的访问接口。

TestMapper.java

  • 方法的名字就是xml文件中的id值。
package fv.dao;

import fv.pojo.Test;

/**

 * Test的Mapper

 */

public interface TestMapper {

    Test selectByPrimaryKey(Integer id);

}
  • mapping：mybatis的sql语句存储的xml文件存储在这里。

TestMapper.xml

  • mybatis的配置，更为具体的在mybatis官网中有详细介绍，需要手动配置sql语句，增加了灵活性，但是切换数据库就有一些麻烦。
<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >

<mapper namespace="fv.dao.TestMapper">

    <resultMap id="BaseResultMap" type="fv.pojo.Test">

        <id column="id" property="id" jdbcType="INTEGER" />

        <result column="test1" property="test1" jdbcType="INTEGER" />

        <result column="test2" property="test2" jdbcType="VARCHAR" />

    </resultMap>

    <sql id = "Base_Column_List">

      id, test1, test2

    </sql>

    <select id="selectByPrimaryKey" resultMap="BaseResultMap" parameterType="java.lang.Integer">

        SELECT

        <include refid="Base_Column_List" />

        FROM test

        WHERE id = #{id, jdbcType = INTEGER}

    </select>

</mapper>

3.以上基本目录就创建成功了，然后设置一个tomcat服务器，进行输出，就会将maven中依赖的包输出，以上配置中并没有配置servlet-api.jar，需要手动依赖进本项目。

4.在数据库中插入一条数据，进行查询，返回JSON，如下图。

IDEA下创建Maven项目，并整合使用Spring、Spring MVC、Mybatis框架

相关文章