文章目录
前言
如何创建一个maven项目这里就不做赘述了,这篇博客主要是对搭建Spring+SpringMVC+Mybatis框架所需要的配置文件进行讲解。在此之前我也查找了很多资料,尝试了很多次,同样也失败了很多次,大都是配置文件错误所导致。所以在此将我成功搭建SSM框架所需要的各个配置文件列出来,并做详细注解。
我所创建的项目结构大致是这样的~
- src/main/java:java代码
- src/main/resources:项目所用到的资源文件,比如spring、mybatis、日志等配置文件
- src/main/resources/spring:spring相关的配置文件
- src/main/reources/mapper:dao中每个方法对应的sql,mybatis帮我们实现
- src/main/webapp:web应用的目录,包括WEB-INF,js,css等静态资源
- src/main/webapp/resources:前端的静态资源(js、css、图片)
- src/main/webapp/WEB-INF:web应用的安全目录(html)
- src/test/java:单元测试的java代码
- src/test/resources:单元测试所用到的资源文件
接下来,我们一一来看这些配置文件到底应该包括哪些内容~
一、引入jar包(pom.xml)
因为项目是通过maven管理的,它会通过pom.xml来下载我们项目所需要的jar包。
<?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/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<packaging>war</packaging>
<name>myo2o</name>
<groupId>com.yaya.demo</groupId>
<artifactId>myo2o</artifactId>
<version>1.0-SNAPSHOT</version>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.1</version>
<configuration>
<source>1.8</source>
<target>1.8</target>
<encoding>UTF-8</encoding>
</configuration>
</plugin>
</plugins>
</build>
<dependencies>
<!-- 单元测试 -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<scope>test</scope>
</dependency>
<!-- 日志 -->
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
<version>1.2.3</version>
</dependency>
<!-- spring相关的jar包已经在项目里下载好了 -->
<!-- Servlet web -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>3.1.0</version>
</dependency>
<!-- json解析 -->
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.9.5</version>
</dependency>
<!-- Map工具类 对标准java Collection的扩展 spring-core.jar需commons-collections.jar -->
<dependency>
<groupId>commons-collections</groupId>
<artifactId>commons-collections</artifactId>
<version>3.2.1</version>
</dependency>
<!-- DAO:MyBatis -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.4.6</version>
</dependency>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis-spring</artifactId>
<version>1.3.2</version>
</dependency>
<!-- 数据库 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.9</version>
</dependency>
<dependency>
<groupId>com.mchange</groupId>
<artifactId>c3p0</artifactId>
<version>0.9.5.2</version>
</dependency>
<!-- 图片处理 -->
<dependency>
<groupId>net.coobird</groupId>
<artifactId>thumbnailator</artifactId>
<version>0.4.8</version>
</dependency>
<!-- https://mvnrepository.com/artifact/com.github.penggle/kaptcha -->
<!-- 验证码 -->
<dependency>
<groupId>com.github.penggle</groupId>
<artifactId>kaptcha</artifactId>
<version>2.3.2</version>
</dependency>
<!-- 文件上传 -->
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.3.2</version>
</dependency>
</dependencies>
</project>
这里对几个重要的知识点做详细说明
-
在添加依赖的时候,我们可以通过scope来指定该依赖的作用范围,包括:编译、运行、测试和发布。scope的取值有6种,分别是compile、runtime、test、provided、system和import。常用的有以下四种:
- compile:表示默认作用范围,即当没有指定依赖项的scope时默认使用compile。compile范围内的依赖项在所有情况下都是有效的。
- runtime:表示该依赖项只有在运行时才是需要的,在编译的时候不需要。与compile相比,跳过了编译。
- test:表示该依赖项只对测试时有用,包括测试代码的编译和运行,对于正常的项目运行是没有影响的。
- provided:表示该依赖项将由JDK或者运行容器在运行时提供,也就是说由Maven提供的该依赖项我们只有在编译和测试时才会用到,而在运行时将由JDK或者运行容器提供。与compile等同,区别在于打包阶段进行了exclude操作。比如tomcat或者基础类库等等。
-
由于在IDEA里可以直接下载spring相关的jar包,就无需将依赖添加进来,这里主要讲解这些jar包的功能
- spring-core:包含spring框架的核心工具类,为spring各个组件提供基础类的支持
- spring-beans:所有应用都要用到的,包含访问配置文件、创建和管理bean以及进行IOC/DI相关操作的所有类。如果应用只需要基本的IOC/DI支持,引入spring-core以及spring-beans.jar就可以了
- spring-context:为spring核心提供了大量扩展
- spring-jdbc:包含spring对jdbc数据访问进行封装的所有类
- spring-tx:提供一致的声明式和编程式事务管理
- spring-web:包含web应用开发时用到spring框架时所需的核心类
- spring-webmvc:包含springmvc框架相关的所有类
- spring-test:对junit等测试框架进行简单封装
二、数据库的连接配置(jdbc.properties)
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://39.105.67.70:3306/o2o?useUnicode=true&characterEncoding=utf8
jdbc.username=Op6vhRMN1cA=
jdbc.password=Hg/GufEXQZo=
- 包括jdbc的驱动器、url、用户名、密码这四项。
- 我使用的是服务器的数据库,如果是本地数据库,只需将服务器ip改为localhost即可。
- 由于数据库会存储中文,所以useUnicode设置为true,并且设置字符集为utf-8。
- 这里的用户名和密码,我用的是密文来表示,为了让程序更加安全,防止外人通过该配置文件获取到我们的用户名和密码。关于如何使用在之后的博客中进行详解。
三、mybatis相关的配置(mybatis-config.xml)
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<!-- 配置全局属性 -->
<settings>
<!-- 使用jdbc的getGeneratedKeys获取数据库自增主键值 -->
<setting name="useGeneratedKeys" value="true"/>
<!-- 使用列标签替换列别名 默认:true -->
<setting name="useColumnLabel" value="true" />
<!-- 开启驼峰名转换:Table(create_time) -> Entity(createTime) -->
<setting name="mapUnderscoreToCamelCase" value="true" />
</settings>
</configuration>
四、整合spring和mybatis(spring-dao.xml)
将jdbc.properties和mybayies-config.xml加载进来,并创建dataSource数据库连接池,同时配置好了通过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"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd">
<!-- 配置整合mybatis过程 -->
<!-- 1.配置数据库相关参数properties的属性: ${url} -->
<bean class="com.yaya.o2o.util.jdbcpwddes.EncryptPropertyPlaceholderConfigurer">
<property name="locations">
<list>
<value>classpath:jdbc.properties</value>
</list>
</property>
<property name="fileEncoding" value="UTF-8"/>
</bean>
<!-- 2.数据库连接池 -->
<bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource">
<!-- 配置连接池属性 -->
<property name="driverClass" value="${jdbc.driver}" />
<property name="jdbcUrl" value="${jdbc.url}" />
<property name="user" value="${jdbc.username}" />
<property name="password" value="${jdbc.password}" />
<!-- c3p0连接池的私有属性 -->
<property name="maxPoolSize" value="30" />
<property name="minPoolSize" value="10" />
<!-- 关闭连接后不自动commit -->
<property name="autoCommitOnClose" value="false" />
<!-- 获取连接超时时间 -->
<property name="checkoutTimeout" value="10000" />
<!-- 当获取连接失败重试次数 -->
<property name="acquireRetryAttempts" value="2" />
</bean>
<!-- 3.配置SqlSessionFactory对象 -->
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean" >
<!-- 注入数据库连接池 -->
<property name="dataSource" ref="dataSource" />
<!-- 配置MyBatis全局配置文件:mybatis-config.xml -->
<property name="configLocation" value="classpath:mybatis-config.xml" />
<!-- 扫描entity包 使用别名 -->
<property name="typeAliasesPackage" value="com.yaya.o2o.entity" />
<!-- 扫描sql配置文件:mapper需要的xml文件 -->
<property name="mapperLocations" value="classpath:mapper/*.xml" />
</bean>
<!-- 4.配置扫描Dao接口包,动态实现Dao接口,注入到spring容器中 -->
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer" >
<!-- 注入sqlSessionFactory -->
<property name="sqlSessionFactoryBeanName" value="sqlSessionFactory" />
<!-- 给出需要扫描Dao接口包-->
<property name="basePackage" value="com.yaya.o2o.dao" />
</bean>
</beans>
为什么要使用数据库连接池?
在开发中,频繁的开关连接是一件非常消耗资源和时间的操作,会导致程序执行的效率低下,因此我们可以在程序中创建一个容器,也就是连接池,在程序启动时就初始化一批连接放在连接池中,当用户需要时,就从连接池中获取一个连接,用完连接之后再将连接还回连接池中,这样就可以实现连接的复用,减少连接开关的次数,提高程序执行的效率~
五、通过spring管理service层(spring-service.xml)
将配置好的dataSource注入到事务管理器,便于service层进行操作。
<?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.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd
http://www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx.xsd">
<!-- 扫描service包下所有使用注解的类型 -->
<context:component-scan base-package="com.yaya.o2o.service"/>
<!-- 配置事务管理器 -->
<bean id="transactionManager"
class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
<!-- 注入数据库连接池 -->
<property name="dataSource" ref="dataSource"/>
</bean>
<!-- 配置基于注解的声明式事务 -->
<tx:annotation-driven transaction-manager="transactionManager"/>
</beans>
六、配置SpringMVC(spring-web.xml)
定义Controller的一些行为。
<?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.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc-3.2.xsd">
<!-- 配置SpringMVC -->
<!-- 1.开启SpringMVC注解模式 -->
<!-- 简化配置:
(1)自动注册DefaultAnootationHandlerMapping,AnotationMethodHandlerAdapter
(2)提供一些列:数据绑定,数字和日期的format @NumberFormat, @DateTimeFormat, xml,json默认读写支持
-->
<mvc:annotation-driven/>
<!-- 2.静态资源默认servlet配置
(1)加入对静态资源的处理:js,gif,png
(2)允许使用"/"做整体映射
-->
<mvc:resources mapping="/resources/**" location="/resources/"/>
<mvc:default-servlet-handler/>
<!-- 3.定义视图解析器 -->
<bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/html/"/>
<property name="suffix" value=".html"/>
</bean>
<!-- 4.扫描web相关的bean -->
<context:component-scan base-package="com.yaya.o2o.web"/>
<!-- 文件上传解析器 -->
<!-- 权限拦截器-->
</beans>
七、初始化配置信息(web.xml)
当启动一个web项目时,容器首先会读取项目web.xml配置文件里的配置,当这一步骤没有出错并且完成之后,项目才能正常地被启动起来。将三个spring配置文件注入了进来。
<?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">
<display-name>Archetype Created Web Application</display-name>
<welcome-file-list>
<welcome-file>./WEB-INF/html/local/login.html</welcome-file>
</welcome-file-list>
<servlet>
<servlet-name>spring-dispatcher</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:spring/spring-*.xml</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>spring-dispatcher</servlet-name>
<!-- 默认匹配所有的请求 -->
<url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>
- <display-name>标签:定义了web应用的名字
- 欢迎页配置: 当用户访问Web应用时,如果只给出web应用的根访问URL,没有指定具体的文件名,容器会调用<weblcome-file- list> 标签里指定的文件。<welcome-file-list>里允许有多个元素,每个元素代表一个文件。容器会按顺序寻找,先找第一个文件是否存在,如果存在则会把这个文件显示出来,不再寻找其他文件。如果不存在则寻找第二个文件,依次类推。如果所有文件都不存在,则抛出404错误。
- <servlet>标签:用于指定此web应用的servlet相关配置
<servlet> <servlet-name>servlet名称</servlet-name> <servlet-class>servlet类全路径</servlet-class> <init-param> <param-name>参数名</param-name> <param-value>参数值</param-value> </init-param> <load-on-startup>指定当Web应用启动时,装载Servlet的次序</load-on-startup> </servlet> <servlet-mapping> <servlet-name>servlet名称</servlet-name> <url-pattern>映射路径</url-pattern> </servlet-mapping>