今天要总结一下ssm(spring ,springmvc ,mybatis)框架的一个大的基本结构的搭建,在刚刚学习这个的时候,经常会晕头转向,归根到底还是不能静下心去琢磨琢磨。废话不多说了。
工程创建
首先我们要创建一个工程,
按照图上就行记得✔,然后
第一个项目组的唯一识别,第二个是项目的名称,继续next,
这里会让你配置maven的信息,如果没装的自己去装一下,然后第一行需要的是你的maven的安装的路径,第二个需要你的maven中的setting的配置文件,如果不了解
maven,可以看下这篇文章https://www.cnblogs.com/whgk/p/7112560.html,第三个就是需要你的本机上的仓储位置,随后在点击图上的+号,
输入archetypeCatalog=internal,这个参数的意义是让该 Maven 项目的骨架不要到远程下载而是从本地获取,以提高加载速度。ok,接下来继续next会让你确认保存
路径,接下来finish就好了。
pom.xml配置
创建好后,应该都是自动弹出了pom.xml,这个配置文件中我们需要将本工程的使用的包导入。我们这个需要用到以下的包:
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<maven.compiler.source>1.7</maven.compiler.source>
<maven.compiler.target>1.7</maven.compiler.target>
<!-- spring版本号 -->
<spring.version>4.2.5.RELEASE</spring.version>
<!-- mybatis版本号 -->
<mybatis.version>3.2.8</mybatis.version>
<!-- mysql驱动版本号 -->
<mysql-driver.version>8.0.12</mysql-driver.version>
<!-- log4j日志包版本号 -->
<slf4j.version>1.7.18</slf4j.version>
<log4j.version>1.2.17</log4j.version>
</properties>
<dependencies>
<!-- 添加jstl依赖 -->
<dependency>
<groupId>jstl</groupId>
<artifactId>jstl</artifactId>
<version>1.2</version>
</dependency>
<dependency>
<groupId>javax</groupId>
<artifactId>javaee-api</artifactId>
<version>7.0</version>
</dependency>
<!-- 添加junit4依赖 -->
<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-context</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-aop</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.2.2</version>
</dependency>
<!-- 添加mysql驱动依赖 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>${mysql-driver.version}</version>
</dependency>
<!-- 添加数据库连接池依赖 -->
<dependency>
<groupId>commons-dbcp</groupId>
<artifactId>commons-dbcp</artifactId>
<version>1.2.2</version>
</dependency>
<!-- 添加fastjson -->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>1.1.41</version>
</dependency>
<!-- 添加日志相关jar包 -->
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>${log4j.version}</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 -->
<!-- 通用mapper -->
<dependency>
<groupId>tk.mybatis</groupId>
<artifactId>mapper</artifactId>
<version>3.1.2</version>
</dependency>
<!-- 映入JSON -->
<dependency>
<groupId>org.codehaus.jackson</groupId>
<artifactId>jackson-mapper-asl</artifactId>
<version>1.9.13</version>
</dependency>
<!-- https://mvnrepository.com/artifact/com.fasterxml.jackson.core/jackson-core -->
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-core</artifactId>
<version>2.8.0</version>
</dependency>
<!-- https://mvnrepository.com/artifact/com.fasterxml.jackson.core/jackson-databind -->
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.8.0</version>
</dependency>
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.3.1</version>
</dependency>
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>2.4</version>
</dependency>
<dependency>
<groupId>commons-codec</groupId>
<artifactId>commons-codec</artifactId>
<version>1.9</version>
</dependency>
</dependencies>
具体的包的引入,上面都有解释,如果实际项目需要别的包都在这里导入。接下来我们工程里是什么都没有的,我们需要创建几个目录如下图:
将java,resource设为
,
我们在java中创建如下的几个包
里面的意思就不多说。好了接下了就是我们的重头戏了,在resource中去写我们的配置文件。
首先我们配置的是spring和mybatis的整合,这个整合有两个配置文件,一个是mybatis的核心配置文件,一个是两者的整合配置文件。
spring、mybatis整合
mybatis的核心配置文件:代码如下:
<?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>
<setting name="mapUnderscoreToCamelCase" value="true"/>
</settings>
<!-- 别名 -->
<typeAliases>
<!--默认别名为:javabean 的首字母小写的非限定类名来作为它的别名-->
<package name="com.zah.ssm.entity" />
</typeAliases>
<plugins>
<plugin interceptor="tk.mybatis.mapper.mapperhelper.MapperInterceptor">
<!--主键自增回写方法,默认值MYSQL,详细说明请看文档HSQLDB-->
<property name="IDENTITY" value="MYSQL"/>
<!--可选参数一共3个,对应0,1,2,分别为SequenceName,ColumnName,PropertyName-->
<property name="seqFormat" value="{0}.nextval"/>
<!--通用Mapper接口,多个通用接口用逗号隔开-->
<property name="mappers" value="tk.mybatis.mapper.common.Mapper"/>
</plugin>
</plugins>
</configuration>
这个配置文件中省去了很多原有的配置方法,因为这些事,可以交给spring去做,下面再来配置spring和mybatis的整合(spring-mybaitis.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: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="com.zah.ssm"/> <!--第二种方式:加载多个properties文件--> <bean id="configProperties" class="org.springframework.beans.factory.config.PropertiesFactoryBean"> <property name="locations"> <list> <value>classpath:jdbc.properties</value> </list> </property> <property name="fileEncoding" value="UTF-8"/> </bean> <bean id="propertyConfigurer" class="org.springframework.beans.factory.config.PreferencesPlaceholderConfigurer"> <property name="properties" ref="configProperties"/> </bean> <!-- 配置数据源 --> <bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close"> <property name="driverClassName" value="${driverClasss}"/> <property name="url" value="${jdbcUrl}"/> <property name="username" value="${username}"/> <property name="password" value="${password}"/> <!-- 初始化连接大小 --> <property name="initialSize" value="${initialSize}"></property> <!-- 连接池最大数量 --> <property name="maxActive" value="${maxActive}"></property> <!-- 连接池最大空闲 --> <property name="maxIdle" value="${maxIdle}"></property> <!-- 连接池最小空闲 --> <property name="minIdle" value="${minIdle}"></property> <!-- 获取连接最大等待时间 --> <property name="maxWait" value="${maxWait}"></property> </bean> <!-- mybatis和spring完美整合,不需要mybatis的配置映射文件 --> <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> <property name="dataSource" ref="dataSource"/> <!-- 配置Mybati的核心配置文件 --> <property name="configLocation" value="classpath:mybatis-config.xml" /> <!-- 自动扫描mapping.xml文件 --> <property name="mapperLocations" value="classpath:mapping/*.xml"></property> </bean> <!-- DAO接口所在包名,Spring会自动查找其下的类 --> <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"> <property name="basePackage" value="com.zah.ssm.Dao"/> <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"></property> </bean> <!-- 事务管理 --> <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager"> <property name="dataSource" ref="dataSource"/> </bean> <tx:annotation-driven transaction-manager="transactionManager"/> </beans>
这里我引用了一个properties文件,这样做的理由就是抽取嘛,为了便捷,可以看下properties里具体有什么:
driverClasss=com.mysql.cj.jdbc.Driver jdbcUrl=jdbc:mysql://localhost:3306/dream_db?userSSL=false&useUnicode=true&characterEncoding=UTF8&serverTimezone=GMT username=你的数据的用户名 password=数据库密码 #定义初始连接数 initialSize=0 #定义最大连接数 maxActive=20 #定义最大空闲 maxIdle=20 #定义最小空闲 minIdle=1 #定义最长等待时间 maxWait=60000
注意途中的驱动类,我的mysql是8的版本,这里需要改动,如果你不是的,驱动类com.mysql.cj.jdbc.Driver就这样写,到时候数据库连接的时候会报错。附上链接小伙伴可以看一下:https://blog.csdn.net/woshixlhm/article/details/80540881;
数据库创建
到此之后我们可以来测试一下,我们spring 和mybatis是否整合成功。这里我在数据库中建立了一张用户表(user),创建了一下信息:
spring-mybatis整合测试
我们要做的就是从数据库中取出这个对象。首先我们先在Dao包下建一个接口叫UserMap:
package com.zah.ssm.Dao; import com.zah.ssm.Entity.User; import tk.mybatis.mapper.common.Mapper; //我们让他继承Mapper通用类 public interface UserMap extends Mapper<User> { }
有人不知道Mapper是什么,我们可以到它的包下去看看,发现它是我们在maven中引入的一个包,
<!-- 通用mapper --> <dependency> <groupId>tk.mybatis</groupId> <artifactId>mapper</artifactId> <version>3.1.2</version> </dependency>
这个里面mybatis帮我们封装好了很多常用的方法(CRUD),有兴趣自己可以去看看。然后我们再在service中写一个接口UserService:
package com.zah.ssm.Service; import com.zah.ssm.Entity.User; public interface UserService { User findUserById(int id); }
我们在在Impl包下创建一个实现它的方法UserServiceImpl:
package com.zah.ssm.Service.Impl; import com.zah.ssm.Dao.UserMap; import com.zah.ssm.Entity.User; import com.zah.ssm.Service.UserService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; @Service public class UserServiceImpl implements UserService { @Autowired private UserMap userMap; @Override public User findUserById(int id) { User user=new User(); user.setId(id); return userMap.selectOne(user); } }
然后我们创建一个测试类来实现它:
import com.zah.ssm.Entity.User; import com.zah.ssm.Service.UserService; import org.junit.Test; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.test.context.ContextConfiguration; import org.springframework.test.context.junit4.AbstractJUnit4SpringContextTests; @ContextConfiguration(locations = {"classpath:spring-mybatis.xml"}) public class testssm extends AbstractJUnit4SpringContextTests { @Autowired private UserService userService; @Test public void test01(){ User user=userService.findUserById(1); System.out.println(user.toString()); } }
进行测试之后,可以渠道结果:
到此说明我们spring和mybatis是成功的。
配置springmvc
SpringMVC的配置文件(spring-mvc.xml)单独放,然后在web.xml中配置整合。下面是spring-mvc.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:p="http://www.springframework.org/schema/p" 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-4.0.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd"> <mvc:default-servlet-handler /> <!-- 自动扫描 --> <context:component-scan base-package="com.zah.ssm.Controller"/> <!--避免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> <!-- 默认的注解映射的支持,自动注册DefaultAnnotationHandlerMapping和AnnotationMethodHandlerAdapter --> <mvc:annotation-driven /> <!-- 定义跳转的文件的前后缀 ,视图模式配置 --> <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name="prefix" value="/WEB-INF/" /> <property name="suffix" value=".jsp"/> </bean> <!-- 文件上传配置 --> <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"> <!-- 默认编码 --> <property name="defaultEncoding" value="UTF-8"/> <!-- 上传文件大小限制为31M,31*1024*1024 --> <property name="maxUploadSize" value="32505856"/> <!-- 内存中的最大值 --> <property name="maxInMemorySize" value="4096"/> </bean> <!--<!– 对静态资源文件的访问–>--> <!--<mvc:resources mapping="/images/**" location="/images/" cache-period="31556926"/>--> <!--<mvc:resources mapping="/lib/**" location="/js/" cache-period="31556926"/>--> <!--<mvc:resources mapping="/css/**" location="/css/" cache-period="31556926"/>--> </beans>
web.xml配置
我们别忘了我们web.xml这个配置文件:
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd" > <web-app xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 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>ssm</display-name> <context-param> <param-name>contextConfigLocation</param-name> <param-value> classpath*:spring-mybatis.xml </param-value> </context-param> <context-param> <param-name>log4jConfigLocation</param-name> <param-value>classpath:log4j.properties</param-value> </context-param> <!-- 编码过滤器 解决POST乱码问题--> <filter> <filter-name>encodingFilter</filter-name> <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class> <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内存溢出监听器,比如quartz --> <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> <load-on-startup>1</load-on-startup> <async-supported>true</async-supported> </servlet> <!-- servlet-mapping --> <servlet-mapping> <servlet-name>SpringMVC</servlet-name> <!-- 此处也可以配置成 *.do 形式 --> <url-pattern>/</url-pattern> </servlet-mapping> <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list> </web-app>
在这里我们引入了log4j的配置,不了解这个的可以去自行学习一下,下面给出我简单的使用的配置代码,新建log4j.properties:
log4j.rootLogger=DEBUG,Console,File #日志输出到控制台 og4j.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=[%p][%t][%d{yyyy-MM-dd HH:mm:ss}][%C] - %m%n #日志输出到文件 log4j.appender.File=org.apache.log4j.RollingFileAppender #日志存放位置 log4j.appender.File.File=/root/dreamland/logs/run.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][%t][%d{yyyy-MM-dd HH:mm:ss}][%C] - %m%n
ssm框架搭建测试
好了,到现在我们可以测试整个ssm是不是配置成功。在这里我创建了一个userIndex.jsp页面:
<%-- Created by IntelliJ IDEA. User: ZAH Date: 2018/9/29 Time: 17:28 To change this template use File | Settings | File Templates. --%> <%@ page contentType="text/html;charset=UTF-8" language="java" %> <html> <head> <title>ssm从无到有</title> </head> <body> <p>${user.username}</p> </body> </html>
再来看我们的controller中的代码:
package com.zah.ssm.Controller; import com.zah.ssm.Entity.User; import com.zah.ssm.Service.UserService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Controller; import org.springframework.ui.Model; import org.springframework.web.bind.annotation.RequestMapping; @Controller public class UserController { @Autowired private UserService userService; @RequestMapping("/user") public String backUser(Model model){ User user=userService.findUserById(1); model.addAttribute("user",user); return "../userIndex"; } }
这里的返回时一个页面,因为在这之前我们在配置文件spring-mvc.xml中:
<!-- 定义跳转的文件的前后缀 ,视图模式配置 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/" />
<property name="suffix" value=".jsp"/>
</bean>
已经省略了前缀和后缀了,需要注意一下。最后我们测试下
,
和我们预期的结果是一致的,说明我们的整合时有效的。至此我们ssm的框架搭建已经完成了。
项目结构一览
下面配上整个项目的结构图供小伙伴参考,因为路径的书写在整个配置中还算是蛮重要的;