使用 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 中是依赖注入(Dependency Injection)的也叫控制反转(Inversion of Control)。但是也要配置一个重要的 servlet,就是前端控制器(DispatcherServlet)。配置方式与普通的 servlet 基本相似。
配置内容如下:
spring org.springframework.web.servlet.DispatcherServlet contextConfigLocation WEB-INF/classes/spring/springmvc.xml spring /
这里需要注意,springmvc.xml 是 spring 配置文件,将在后面讨论。在中 url 如果是.action,前端控制器就只会拦截以.action 结尾的请求,并不会理会静态的文件。对静态页面的控制就要通过其他的手段。以/作为 url 的话就会拦截所有的请求,包括静态页面的请求。这样的话就可以拦截任何想要处理的请求,但是有一个问题。如果拦截了所有的请求,如果不在拦截器中做出相应的处理那么所有静态的 js、css 以及页面中用到的图片就会访问不到造成页面无法正常显示。但这可以通过静态资源的配置来解决这个问题。后面会提到。
配置 spring 容器:
contextConfigLocation WEB-INF/classes/spring/applicationContext-*.xml
其中 applicationContext-*.xml 包含 3 个配置文件,是 springIoC 容器的具体配置。后面会提到。
配置一个监听器:
org.springframework.web.context.ContextLoaderListener
web.xml 的完整配置是这样的:
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">
404 /error404.jsp 500 /error500.jsp contextConfigLocation WEB-INF/classes/spring/applicationContext-*.xml org.springframework.web.context.ContextLoaderListener spring org.springframework.web.servlet.DispatcherServlet contextConfigLocation WEB-INF/classes/spring/springmvc.xml spring / CharacterEncodingFilter org.springframework.web.filter.CharacterEncodingFilter encoding utf-8 CharacterEncodingFilter /* welcome.jsp
看到配置文件中多了两块内容,一个是 error page 是用来友好的处理错误的,可以使用错误代码来区别并跳转到相应的处理页面。这段配置代码最好放到最前面,在前端控制器拦截之前处理。
还有一块内容是一个解决 post 乱码问题的过滤器,拦截 post 请求并编码为 utf8。
springmvc.xml 的配置
视图解析器的配置:
在 Controller 中设置视图名的时候会自动加上前缀和后缀。
Controller 的配置
自动扫描方式,扫描包下面所有的 Controller,可以使用注解来指定访问路径。
也可以使用单个的配置方式,需要指定 Controller 的全限定名。
配置注解的处理器适配器和处理器映射器:
也可以使用下面的简化配置:
配置拦截器,可以直接定义拦截所有请求,也可以自定义拦截路径。
配置全局异常处理器
配置文件上传数据解析器,在上传文件时需要配置。
9242880
还可以配置一些自定义的参数类型,以日期类型绑定为例。
上面提到过如果在配置前端控制器时拦截了所有的请求,不做特殊处理就会导致部分静态资源无法使用。如果是这种情况就可以使用下面的配置来访问静态资源文件。
也可以使用默认,但是需要在 web.xml 中配置。
完全可以不拦截所有路径,大可避免这个问题的发生。
完整的配置大概是这样的,需要注意 xml 文件的命名空间,有时候会有影响的。
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/spring-context.xsd
http://www.springframework.org/schema/mvc/spring-mvc.xsd
http://www.springframework.org/schema/tx/spring-tx.xsd
http://www.springframework.org/schema/aop/spring-aop.xsd">
9242880
applicationContext-*.xml 的配置
applicationContext-*.xml 包括三个配置文件,分别对应数据层控制、业务逻辑 service 控制和事务的控制。
数据访问层的控制,applicationContext-dao.xml 的配置:
配置加载数据连接资源文件的配置,把数据库连接数据抽取到一个 properties 资源文件中方便管理。
配置为:
其中 jdbc.properties 文件的内容如下:
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:
jdbc.username=root
jdbc.password=1234
配置数据库连接池,这里使用的是 dbcp,别忘了添加 jar 包!
Spring 和 MyBatis 整合配置,jar 包由 MyBatis 提供。
配置 sqlSessionFactory
SqlMapConfig.xml 文件是 MyBatis 的配置文件,后面会提到。
配置 Mapper 扫描器,扫描 mapper 包下的所有 mapper 文件和类,要求 mapper 配置文件和类名需要一致。
整个 applicationContext-dao.xml 配置文件应该是这样的:
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/spring-context.xsd
http://www.springframework.org/schema/mvc/spring-mvc.xsd
业务逻辑控制,applicationContext-service.xml 的配置:
这个文件里暂时只需要定义 service 的实现类即可。
事务控制,applicationContext-transaction.xml 的配置
配置数据源,使用 JDBC 控制类。
配置通知,事务控制。
配置 AOP 切面
整个事务控制的配置是这样的:
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/spring-context.xsd
http://www.springframework.org/schema/mvc/spring-mvc.xsd
MyBatis 的配置
SqlMapConfig.xml 的配置 全局 setting 配置这里省略,数据库连接池在 spring 整合文件中已经配置,具体 setting 配置参考官方文档。
别名的定义:
mapper 映射文件的配置:
整个文件的配置应该是这样的:
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
具体 mapper 文件的配置,在使用 mapper 代理的方法时,命名空间需要是对应的 Mapper 类。
以上只是对 SSM 框架简单使用时的配置文件,如果需要深入使用或者需要理解其内部机理需要参考官方文档和其源代码。
欢迎来到这里!
我们正在构建一个小众社区,大家在这里相互信任,以平等 • 自由 • 奔放的价值观进行分享交流。最终,希望大家能够找到与自己志同道合的伙伴,共同成长。
注册 关于