Spring mvc+ maven + MyBatis + Oracle + IDEA 项目搭建 - framework 进阶中（一）
原文链接 http://blog.csdn.net/qq184377902/article/details/51493642 结合自身情况加以修改搭建的框架，记录以防备忘，方便日后学习参考。
Before building the project framework ...
项目环境
IntelliJ IDEA 2016.1.2、JDK 1.8.0_31、Apache-maven-3.5.0、Tomcat-9.0.0.M11
Maven项目搭建
自行百度 ..
Build project framework ...
- SSM框架即为Spring、Spring MVC、Mybatis。创建后的项目结构图即为下图。
- - spring-mybatis.xml：整合spring与mybatis，并实现spring基本功能。
- spring-mvc.xml：配置使用spring-mvc。
- jdbc.propertis:资源文件，用来保存数据库相关信息。
- log4j.properties:配置日志文件。(配置文件及资源文件可先自行新建，后续修改)
1.项目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>com.xiaonan.framework</groupId> <artifactId>maven-ssm-demo</artifactId> <packaging>war</packaging> <version>1.0-SNAPSHOT</version> <name>maven-ssm-demo Maven Webapp</name> <url>http://maven.apache.org</url> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <!-- 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> <!-- Oracle驱动包 --> <dependency> <groupId>com.oracle</groupId> <artifactId>ojdbc6</artifactId> <version>11.2.0.1.0</version> </dependency> <!-- dbcp，用来在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>maven-ssm-demo</finalName> </build> </project>
2.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 = "com.xiaonan.project"> <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>
3.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="com.xiaonan.project"> <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:properties/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:mapper/*Mapper.xml" /> </bean> <!-- DAO接口所在包名，Spring会自动查找其下的类 --> <bean class = "org.mybatis.spring.mapper.MapperScannerConfigurer"> <property name = "basePackage" value="com.xiaonan.project.mapper" /> <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>
4.jdbc.properties
(设置好一些基本属性，可以直接在spring-mybatis.xml中使用${属性名}访问)
## oracle 定义 jdbc.driver=oracle.jdbc.driver.OracleDriver jdbc.url=jdbc:oracle:thin:@127.0.0.1:1521:orcl jdbc.username=bms jdbc.password=bms #定义初始连接数 jdbc.initialSize=0 #定义最大连接数 jdbc.maxActive=100 #定义最大空闲 jdbc.maxIdle=20 #定义最小空闲 jdbc.minIdle=1 #定义最长等待时间 jdbc.maxWait=60000
5.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
6.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:application/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:application/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>
Project code ...
TestController.java
- 最前方加上Controller注解。
- controller：控制文件，所有请求都是传入到此文件夹中的类里。
- @Autowired @Qualifier("testService")：依赖注入Service服务对象，使用Qualifier注解是指定具体服务，不然会进行默认匹配。
- @ResponseBody：让返回值为JSON，但是pojo对象必须实现了getter和setter方法，不然会出现转换失败的错误。
package com.xiaonan.project.controller; import com.xiaonan.project.model.Test; import com.xiaonan.project.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)); } }
TestMapper.java
- 方法的名字就是xml文件中的id值。
package com.xiaonan.project.mapper; import com.xiaonan.project.model.Test; public interface TestMapper { Test selectByPrimaryKey(Integer id); }
Test.java package com.xiaonan.project.model; /** * 测试对象 */ 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; } }
TestService.java package com.xiaonan.project.service; import com.xiaonan.project.model.Test; /** * 测试服务接口 */ public interface TestService { Test getById(int id); }
TestServiceImp.java
- Service注解，扫描后就可以依赖注入对象到Controller。
package com.xiaonan.project.service.impl; import com.xiaonan.project.mapper.TestMapper; import com.xiaonan.project.model.Test; import com.xiaonan.project.service.TestService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; /** * 测试服务 */ @Service("testService") public class TestServiceImp implements TestService { //@Autowired(required = false) @Autowired private TestMapper testMapper; public Test getById(int id) { return testMapper.selectByPrimaryKey(id); } }
TestMapper.xml
- mapping：mybatis的sql语句存储的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="com.xiaonan.project.mapper.TestMapper"> <resultMap id="BaseResultMap" type="com.xiaonan.project.model.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>
-
以上基本目录就创建成功了，运行tomcat，以上配置中并没有配置servlet-api.jar，需要手动依赖进本项目。
-
在数据库中插入一条数据后，访问http://localhost:8080/myproject/test/get?id=1，返回JSON。
- git源码：https://github.com/ooxiaonanoo/maven-ssm-demo.git 亲们可参考...
