Spring、Spring MVC、MyBatis整合文件配置详解
本文内容纲要:
使用SSM框架做了几个小项目了,感觉还不错是时候总结一下了。先总结一下SSM整合的文件配置。其实具体的用法最好还是看官方文档。
Spring:http://spring.io/docs
MyBatis:http://mybatis.github.io/mybatis-3/
基本的组织结构和用法就不说了,前面的博客和官方文档上都非常的全面。jar包可以使用Maven来组织管理。来看配置文件。
web.xml的配置
web.xml应该是整个项目最重要的配置文件了,不过servlet3.0中已经支持注解配置方式了。在servlet3.0以前每个servlet必须要在web.xml中配置servlet及其映射关系。但是在spring框架中就不用了,因为Spring中是依赖注入(DependencyInjection)的也叫控制反转(InversionofControl)。但是也要配置一个重要的servlet,就是前端控制器(DispatcherServlet)。配置方式与普通的servlet基本相似。
配置内容如下:
<!--配置前端控制器-->
<servlet>
<servlet-name>spring</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<!--ContextconfigLocation配置springmvc加载的配置文件
适配器、处理映射器等
-->
<param-name>contextConfigLocation</param-name>
<param-value>WEB-INF/classes/spring/springmvc.xml</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>spring</servlet-name>
<!--1、.action访问以.action结尾的由DispatcherServlet进行解析
2、/,所有访问都由DispatcherServlet进行解析
-->
<url-pattern>/</url-pattern>
</servlet-mapping>
这里需要注意,springmvc.xml是spring配置文件,将在后面讨论。在
配置spring容器:
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>WEB-INF/classes/spring/applicationContext-*.xml</param-value>
</context-param>
其中applicationContext-*.xml包含3个配置文件,是springIoC容器的具体配置。后面会提到。
配置一个监听器:
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
web.xml的完整配置是这样的:
<?xmlversion="1.0"encoding="UTF-8"?>
<web-appversion="3.0"
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">
<display-name></display-name>
<!--404错误拦截-->
<error-page>
<error-code>404</error-code>
<location>/error404.jsp</location>
</error-page>
<!--500错误拦截-->
<error-page>
<error-code>500</error-code>
<location>/error500.jsp</location>
</error-page>
<!--加载spring容器-->
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>WEB-INF/classes/spring/applicationContext-*.xml</param-value>
</context-param>
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<!--配置前端控制器-->
<servlet>
<servlet-name>spring</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<!--ContextconfigLocation配置springmvc加载的配置文件
适配器、处理映射器等
-->
<param-name>contextConfigLocation</param-name>
<param-value>WEB-INF/classes/spring/springmvc.xml</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>spring</servlet-name>
<!--1、.action访问以.action结尾的由DispatcherServlet进行解析
2、/,所有访问都由DispatcherServlet进行解析
-->
<url-pattern>/</url-pattern>
</servlet-mapping>
<!--解决post乱码问题的过滤器-->
<filter>
<filter-name>CharacterEncodingFilter</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>CharacterEncodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
<welcome-file-list>
<welcome-file>welcome.jsp</welcome-file>
</welcome-file-list>
</web-app>
看到配置文件中多了两块内容,一个是errorpage是用来友好的处理错误的,可以使用错误代码来区别并跳转到相应的处理页面。这段配置代码最好放到最前面,在前端控制器拦截之前处理。
还有一块内容是一个解决post乱码问题的过滤器,拦截post请求并编码为utf8。
springmvc.xml的配置
视图解析器的配置:
<!--配置视图解析器-->
<beanclass="org.springframework.web.servlet.view.InternalResourceViewResolver">
<!--使用前缀和后缀-->
<propertyname="prefix"value="/"></property>
<propertyname="suffix"value=".jsp"></property>
</bean>
在Controller中设置视图名的时候会自动加上前缀和后缀。
Controller的配置
自动扫描方式,扫描包下面所有的Controller,可以使用注解来指定访问路径。
<!--使用组件扫描的方式可以一次扫描多个Controller-->
<context:component-scanbase-package="com.wxisme.ssm.controller">
也可以使用单个的配置方式,需要指定Controller的全限定名。
<beanname="/queryUser.action"class="com.wxisme.ssm.controller.Controller1"/>
配置注解的处理器适配器和处理器映射器:
<!--注解的处理器适配器-->
<beanclass="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"/>
<!--注解的处理器映射器-->
<beanclass="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping"/>
也可以使用下面的简化配置:
<!--配置注解的处理器映射器和处理器适配器-->
<mvc:annotation-drivenconversion-service="conversionService"></mvc:annotation-driven>
配置拦截器,可以直接定义拦截所有请求,也可以自定义拦截路径。
<mvc:interceptors>
<!--直接定义拦截所有请求-->
<beanclass="com.wxisme.ssm.interceptor.IdentityInterceptor"></bean>
<!--<mvc:interceptor>
拦截所有路径的请求包括子路径
<mvc:mappingpath="/**"/>
<beanclass="com.wxisme.ssm.interceptor.IdentityInterceptor"></bean>
</mvc:interceptor>-->
</mvc:interceptors>
配置全局异常处理器
<!--定义全局异常处理器-->
<!--只有一个全局异常处理器起作用-->
<beanid="exceptionResolver"class="com.wxisme.ssm.exception.OverallExceptionResolver"></bean>
配置文件上传数据解析器,在上传文件时需要配置。
<!--配置上传文件数据解析器-->
<beanid="multipartResolver"class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<propertyname="maxUploadSize">
<value>9242880</value>
</property>
</bean>
还可以配置一些自定义的参数类型,以日期类型绑定为例。
<!--自定义参数类型绑定-->
<beanid="conversionService"class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
<propertyname="converters">
<list>
<!--日期类型绑定-->
<beanclass="com.wxisme.ssm.controller.converter.DateConverter"/>
</list>
</property>
</bean>
上面提到过如果在配置前端控制器时拦截了所有的请求,不做特殊处理就会导致部分静态资源无法使用。如果是这种情况就可以使用下面的配置来访问静态资源文件。
<mvc:resourcesmapping="/images/**"location="/images/"/>
<mvc:resourcesmapping="/css/**"location="/css/"/>
<mvc:resourcesmapping="/js/**"location="/js/"/>
<mvc:resourcesmapping="/imgdata/**"location="/imgdata/"/>
也可以使用默认,但是需要在web.xml中配置。
<!--访问静态资源文件-->
<!--<mvc:default-servlet-handler/>需要在web.xml中配置-->
完全可以不拦截所有路径,大可避免这个问题的发生。
完整的配置大概是这样的,需要注意xml文件的命名空间,有时候会有影响的。
<?xmlversion="1.0"encoding="UTF-8"?>
<beansxmlns="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:jdbc="http://www.springframework.org/schema/jdbc"
xmlns:jee="http://www.springframework.org/schema/jee"
xmlns:aop="http://www.springframework.org/schema/aop"
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/mvc
http://www.springframework.org/schema/mvc/spring-mvc.xsd
http://www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx.xsd
http://www.springframework.org/schema/aop
http://www.springframework.org/schema/aop/spring-aop.xsd">
<!--配置视图解析器-->
<beanclass="org.springframework.web.servlet.view.InternalResourceViewResolver">
<!--使用前缀和后缀-->
<propertyname="prefix"value="/"></property>
<propertyname="suffix"value=".jsp"></property>
</bean>
<!--使用组件扫描的方式可以一次扫描多个Controller-->
<context:component-scanbase-package="com.wxisme.ssm.controller">
</context:component-scan>
<!--配置注解的处理器映射器和处理器适配器-->
<mvc:annotation-drivenconversion-service="conversionService"></mvc:annotation-driven>
<!--自定义参数类型绑定-->
<beanid="conversionService"class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
<propertyname="converters">
<list>
<!--日期类型绑定-->
<beanclass="com.wxisme.ssm.controller.converter.DateConverter"/>
</list>
</property>
</bean>
<!--访问静态资源文件-->
<!--<mvc:default-servlet-handler/>需要在web.xml中配置-->
<mvc:resourcesmapping="/images/**"location="/images/"/>
<mvc:resourcesmapping="/css/**"location="/css/"/>
<mvc:resourcesmapping="/js/**"location="/js/"/>
<mvc:resourcesmapping="/imgdata/**"location="/imgdata/"/>
<!--定义拦截器-->
<mvc:interceptors>
<!--直接定义拦截所有请求-->
<beanclass="com.wxisme.ssm.interceptor.IdentityInterceptor"></bean>
<!--<mvc:interceptor>
拦截所有路径的请求包括子路径
<mvc:mappingpath="/**"/>
<beanclass="com.wxisme.ssm.interceptor.IdentityInterceptor"></bean>
</mvc:interceptor>-->
</mvc:interceptors>
<!--配置上传文件数据解析器-->
<beanid="multipartResolver"class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<propertyname="maxUploadSize">
<value>9242880</value>
</property>
</bean>
<!--定义全局异常处理器-->
<!--只有一个全局异常处理器起作用-->
<beanid="exceptionResolver"class="com.wxisme.ssm.exception.OverallExceptionResolver"></bean>
</beans>
applicationContext-*.xml的配置
applicationContext-*.xml包括三个配置文件,分别对应数据层控制、业务逻辑service控制和事务的控制。
数据访问层的控制,applicationContext-dao.xml的配置:
配置加载数据连接资源文件的配置,把数据库连接数据抽取到一个properties资源文件中方便管理。
配置为:
<!--加载数据库连接的资源文件-->
<context:property-placeholderlocation="/WEB-INF/classes/jdbc.properties"/>
其中jdbc.properties文件的内容如下:
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/database
jdbc.username=root
jdbc.password=1234
配置数据库连接池,这里使用的是dbcp,别忘了添加jar包!
<!--配置数据源dbcp数据库连接池-->
<beanid="dataSource"class="org.apache.commons.dbcp2.BasicDataSource"destroy-method="close">
<propertyname="driverClassName"value="${jdbc.driver}"/>
<propertyname="url"value="${jdbc.url}"/>
<propertyname="username"value="${jdbc.username}"/>
<propertyname="password"value="${jdbc.password}"/>
</bean>
Spring和MyBatis整合配置,jar包由MyBatis提供。
配置sqlSessionFactory
<!--配置sqlSessionFactory-->
<beanid="sqlSessionFactory"class="org.mybatis.spring.SqlSessionFactoryBean">
<!--数据库连接池-->
<propertyname="dataSource"ref="dataSource"/>
<!--加载Mybatis全局配置文件-->
<propertyname="configLocation"value="/WEB-INF/classes/mybatis/SqlMapConfig.xml"/>
</bean>
SqlMapConfig.xml文件是MyBatis的配置文件,后面会提到。
配置Mapper扫描器,扫描mapper包下的所有mapper文件和类,要求mapper配置文件和类名需要一致。
<!--配置mapper扫描器-->
<beanclass="org.mybatis.spring.mapper.MapperScannerConfigurer">
<!--扫描包路径,如果需要扫描多个包中间用半角逗号隔开-->
<propertyname="basePackage"value="com.wxisme.ssm.mapper"></property>
<propertyname="sqlSessionFactoryBeanName"value="sqlSessionFactory"/>
</bean>
整个applicationContext-dao.xml配置文件应该是这样的:
<?xmlversion="1.0"encoding="UTF-8"?>
<beansxmlns="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:jdbc="http://www.springframework.org/schema/jdbc"
xmlns:jee="http://www.springframework.org/schema/jee"
xmlns:aop="http://www.springframework.org/schema/aop"
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/mvc
http://www.springframework.org/schema/mvc/spring-mvc.xsd
http://www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx.xsd
http://www.springframework.org/schema/aop
http://www.springframework.org/schema/aop/spring-aop.xsd">
<!--加载数据库连接的资源文件-->
<context:property-placeholderlocation="/WEB-INF/classes/jdbc.properties"/>
<!--配置数据源dbcp数据库连接池-->
<beanid="dataSource"class="org.apache.commons.dbcp2.BasicDataSource"destroy-method="close">
<propertyname="driverClassName"value="${jdbc.driver}"/>
<propertyname="url"value="${jdbc.url}"/>
<propertyname="username"value="${jdbc.username}"/>
<propertyname="password"value="${jdbc.password}"/>
</bean>
<!--配置sqlSessionFactory-->
<beanid="sqlSessionFactory"class="org.mybatis.spring.SqlSessionFactoryBean">
<!--数据库连接池-->
<propertyname="dataSource"ref="dataSource"/>
<!--加载Mybatis全局配置文件-->
<propertyname="configLocation"value="/WEB-INF/classes/mybatis/SqlMapConfig.xml"/>
</bean>
<!--配置mapper扫描器-->
<beanclass="org.mybatis.spring.mapper.MapperScannerConfigurer">
<!--扫描包路径,如果需要扫描多个包中间用半角逗号隔开-->
<propertyname="basePackage"value="com.wxisme.ssm.mapper"></property>
<propertyname="sqlSessionFactoryBeanName"value="sqlSessionFactory"/>
</bean>
</beans>
业务逻辑控制,applicationContext-service.xml的配置:
这个文件里暂时只需要定义service的实现类即可。
<!--定义service-->
<beanid="userService"class="com.wxisme.ssm.service.impl.UserServiceImpl"/>
事务控制,applicationContext-transaction.xml的配置
配置数据源,使用JDBC控制类。
<beanid="transactionManager"class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
<!--配置数据源-->
<propertyname="dataSource"ref="dataSource"/>
</bean>
配置通知,事务控制。
<!--通知-->
<tx:adviceid="txAdvice"transaction-manager="transactionManager">
<tx:attributes>
<!--传播行为-->
<tx:methodname="save*"propagation="REQUIRED"/>
<tx:methodname="insert*"propagation="REQUIRED"/>
<tx:methodname="update*"propagation="REQUIRED"/>
<tx:methodname="delete*"propagation="REQUIRED"/>
<tx:methodname="find*"propagation="SUPPORTS"read-only="true"/>
<tx:methodname="select*"propagation="SUPPORTS"read-only="true"/>
</tx:attributes>
</tx:advice>
配置AOP切面
<!--配置aop-->
<aop:config>
<aop:advisoradvice-ref="txAdvice"pointcut="execution(*com.wxisme.ssm.service.impl.*.*(..))"/>
</aop:config>
整个事务控制的配置是这样的:
<?xmlversion="1.0"encoding="UTF-8"?>
<beansxmlns="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:jdbc="http://www.springframework.org/schema/jdbc"
xmlns:jee="http://www.springframework.org/schema/jee"
xmlns:aop="http://www.springframework.org/schema/aop"
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/mvc
http://www.springframework.org/schema/mvc/spring-mvc.xsd
http://www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx.xsd
http://www.springframework.org/schema/aop
http://www.springframework.org/schema/aop/spring-aop.xsd">
<!--事务控制对MyBatis操作数据库spring使用JDBC事务控制类-->
<beanid="transactionManager"class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
<!--配置数据源-->
<propertyname="dataSource"ref="dataSource"/>
</bean>
<!--通知-->
<tx:adviceid="txAdvice"transaction-manager="transactionManager">
<tx:attributes>
<!--传播行为-->
<tx:methodname="save*"propagation="REQUIRED"/>
<tx:methodname="insert*"propagation="REQUIRED"/>
<tx:methodname="update*"propagation="REQUIRED"/>
<tx:methodname="delete*"propagation="REQUIRED"/>
<tx:methodname="find*"propagation="SUPPORTS"read-only="true"/>
<tx:methodname="select*"propagation="SUPPORTS"read-only="true"/>
</tx:attributes>
</tx:advice>
<!--配置aop-->
<aop:config>
<aop:advisoradvice-ref="txAdvice"pointcut="execution(*com.wxisme.ssm.service.impl.*.*(..))"/>
</aop:config>
</beans>
MyBatis的配置
SqlMapConfig.xml的配置全局setting配置这里省略,数据库连接池在spring整合文件中已经配置,具体setting配置参考官方文档。
别名的定义:
<typeAliases>
<!--批量定义别名,指定包名,自动扫描包中的类,别名即为类名,首字母大小写无所谓-->
<packagename="com.wxisme.ssm.po"/>
</typeAliases>
mapper映射文件的配置:
<mappers>
<!--加载映射文件-->
<!--这里也可以使用class来加载映射文件,前提是:使用mapper代理的方法,遵循规范,
并且两个文件必须同名且在同一目录
<mapperclass="com.wxisme.mybatis0100.mapper.UserMapper"/>
基于class加载,可以进行批量加载
-->
<!--通过扫描包的方式来进行批量加载映射文件-->
<packagename="com.wxisme.ssm.mapper"/>
</mappers>
整个文件的配置应该是这样的:
<?xmlversion="1.0"encoding="UTF-8"?>
<!DOCTYPEconfiguration
PUBLIC"-//mybatis.org//DTDConfig3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<!--将数据库连接数据抽取到属性文件中方便测试-->
<!--<propertiesresource="/WEB-INF/classes/jdbc.properties"></properties>-->
<!--别名的定义-->
<typeAliases>
<!--批量定义别名,指定包名,自动扫描包中的类,别名即为类名,首字母大小写无所谓-->
<packagename="com.wxisme.ssm.po"/>
</typeAliases>
<!--数据库连接用数据库连接池-->
<mappers>
<!--通过扫描包的方式来进行批量加载映射文件-->
<packagename="com.wxisme.ssm.mapper"/>
</mappers>
</configuration>
具体mapper文件的配置,在使用mapper代理的方法时,命名空间需要是对应的Mapper类。
<?xmlversion="1.0"encoding="UTF-8"?>
<!DOCTYPEmapperPUBLIC"-//mybatis.org//DTDMapper3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mappernamespace="com.wxisme.ssm.mapper.AlbumMapper">
</mapper>
以上只是对SSM框架简单使用时的配置文件,如果需要深入使用或者需要理解其内部机理需要参考官方文档和其源代码。
转载请指明来源。
如有错误,敬请指正。
本文内容总结:
原文链接:https://www.cnblogs.com/wxisme/p/4924561.html