简介面向Java Web开发人员的框架整合实践源代码包以J2EE、Struts、Hibernate、Spring四大主流技术为主线适合希望掌握SSH整合开发、理解MVC分层与ORM映射的中级以上学习者。压缩包共1145个文件包含218个Java源文件、243个class编译文件、138个jsp页面、93个xml配置、62个tld标签库以及properties、sql、db等辅助文件完整覆盖模型类、Action、Form Bean、Servlet/JSP和struts-config.xml、hibernate.cfg.xml、applicationContext.xml等关键配置包体约2.35MB。资源通过可运行示例展现各框架协作方式帮助读者从代码层面理解依赖注入、事务管理、持久化操作及前后端交互也可作为项目搭建和排错参考。已有394人学习下载适合自学研读或课堂配套使用。1. 为什么一份整合源代码比三十集视频更能帮你突击如果只看标题“Java Web主流框架整合开发源代码”你可能会以为它只是一堆能跑的demo堆在一起。但真正干过整合开发的人都知道坑全在配置文件里不在代码里。单独跑SpringMVC的示例很顺单独跑MyBatis的示例也很顺一旦把两者放进同一个工程容器谁先创建、Bean谁该注入谁、事务边界画在哪一层每一个环节都能让新手卡上一整天。整合这件事最值钱的不是“能跑”而是“每个文件为什么存在”。这套源码的价值就在这里依赖怎么配、配置怎么分、Controller到Mapper怎么串全部摊开给你看。我按“原理 → 工程 → 配置 → 业务 → 避坑 → 进阶”的顺序把它讲透。2. 为什么所有整合都绕不开Spring先看懂那层“胶水”2.1 IoC容器才是整合的基座不是框架互相调用而是统一交给Spring管辖整合的第一性原理是SpringMVC、MyBatis、业务代码之间并不直接互相调用它们全部作为Bean注册进Spring IoC容器由容器负责创建和注入。SpringMVC的DispatcherServlet从容器里取ControllerController注入ServiceService注入Mapper接口而Mapper接口本身是被MyBatis-Spring扫描后注册成的一个代理Bean。这个链条里没有一处是“new”出来的全部是容器给的关系。这套机制在Web工程里还有一个容易忽略的双容器模型。ContextLoaderListener负责创建根容器里面放数据源、Service、Dao、事务管理器DispatcherServlet启动时再创建一个SpringMVC子容器里面放Controller和视图解析器。子容器能看见父容器的Bean父容器看不见子容器的。所以配置放错了容器运行时的现象就是Controller里注入的Service为null或者启动时直接报NoSuchBeanDefinitionException。明白这个模型你再去看“配置文件怎么分”的问题答案已经出来一半了。2.2 AOP把事务和日志变成了配置项整合后的事务不再由你手动提交抛开AOP谈整合是学不透的。声明式事务本质上是Spring AOP在做代理你调用一个标注了Transactional的public方法代理会在方法进入前开启事务方法正常返回时提交抛出异常时回滚。MyBatis的SqlSession也由Spring统一管理你不再需要自己openSession、手动commit、finally里closeSqlSessionTemplate会跟着事务的生命周期自动开合。这也是整合方案与“硬编码使用MyBatis”最本质的区别。硬编码时你要写sessionFactory.openSession()和session.commit()整合之后这些都从代码里消失了。如果你在代码里看到有人还在手动调用SqlSession的commit那通常意味着他没有把SqlSession交给Spring事务管理十有八九是错位的。日志AOP同理你可以用切面统一打印Controller入参、Service耗时、异常堆栈而不是在每个业务方法里重复写日志调用。2.3 SSM与SSH两大流派新项目怎么选老工程怎么迁标题里的“主流框架”在Java Web领域最有代表性的是两组SSH和SSM。SSH指Struts2加Spring加HibernateSSM指SpringMVC加Spring加MyBatis。两组都用到了Spring作为整合底座区别主要在于前端控制器和持久层框架。对比项SSMSpringMVC Spring MyBatisSSHStruts2 Spring Hibernate控制器粒度方法级注解一个方法对应一个请求类级Action XML配置一个类对应一类动作持久层方式手写SQL半自动映射SQL完全可控HQL和ORM自动映射全自动但SQL难以精细化控制学习曲线中等偏下SQL熟练就能上手较陡Hibernate的映射、缓存、懒加载概念多适用场景新项目、SQL复杂的业务系统、报表类应用存量系统、领域模型复杂的传统业务平台维护现状新项目主流资料多招人容易存量老系统居多维护成本高迁移需求大我的建议很直接新工程一律走SSM这条线理由不是SSH技术差而是现在的新项目、团队协作、问题排查资料几乎都沉淀在SSM这一侧。真遇到SSH老系统的整合改造也不要急着推翻重写Spring的核心知识完全复用把Struts2的Action迁移成SpringMVC的Controller把Hibernate的实体映射迁到MyBatis的XML按模块灰度替换即可。下面所有具体操作我以SSM为例展开这也是这份整合源代码的默认主线路。3. 从零搭一个能跑的整合工程Maven依赖、web.xml与三份配置3.1 多模块Maven工程怎么拆依赖隔离是第一道防线整合工程不要做成单模块WAR包一坨到底。常见的做法是拆成四个模块demo-core放实体和公共工具demo-dao放Mapper接口与XMLdemo-service放业务逻辑和事务demo-web放Controller、配置文件和webapp目录。父工程demo-parent只做两件事声明子模块统一管理依赖版本。父工程pom.xml的关键部分长这样project modelVersion4.0.0/modelVersion groupIdcom.demo/groupId artifactIddemo-parent/artifactId version1.0.0/version packagingpom/packaging modules moduledemo-core/module moduledemo-dao/module moduledemo-service/module moduledemo-web/module /modules dependencyManagement dependencies dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version5.x/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId version3.5.x/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version2.x/version /dependency /dependencies /dependencyManagement /project这里的关键是dependencyManagement标签。它的作用不是引入依赖而是锁版本子模块里只需写groupId和artifactId版本号全部继承父工程。这样整个项目的Spring全家桶版本、MyBatis版本、Jackson版本只要在父工程里改一处全局生效从根上避免“子模块之间版本打架”的传递依赖冲突。各模块的依赖职责分配如下依赖所属模块用途spring-webmvcdemo-webMVC框架、DispatcherServletspring-jdbcdemo-dao数据源、事务管理器基础设施mybatisdemo-dao持久层核心mybatis-springdemo-daoMyBatis与Spring的装配桥接mysql-connector-javademo-daoMySQL JDBC驱动druiddemo-dao数据源与连接池监控jackson-databinddemo-webJSON序列化与反序列化javax.servlet-apidemo-webServlet编译期依赖scope置providedlog4j2 slf4j全部模块日志门面与实现我见过不少工程把这些依赖全部堆在web层dao层编译时找不到mybatis的类启动时才被Tomcat类加载救回来这是典型的模块边界失守。dao模块必须在自己的pom里直接引用mybatis和mysql驱动而不是依赖web模块传递过来。3.2 web.xml做了三件事编码、根容器、前端控制器SSM整合的web.xml只关心三件事CharacterEncodingFilter保证请求和响应编码ContextLoaderListener创建根容器DispatcherServlet创建MVC子容器。加载顺序由web.xml里的元素顺序决定这个顺序错一个字结果都不同。web-app filter filter-nameencodingFilter/filter-name filter-classorg.springframework.web.filter.CharacterEncodingFilter/filter-class init-param param-nameencoding/param-name param-valueUTF-8/param-value /init-param init-param param-nameforceEncoding/param-name param-valuetrue/param-value /init-param /filter filter-mapping filter-nameencodingFilter/filter-name url-pattern/*/url-pattern /filter-mapping context-param param-namecontextConfigLocation/param-name param-valueclasspath:applicationContext.xml/param-value /context-param listener listener-classorg.springframework.web.context.ContextLoaderListener/listener-class /listener servlet servlet-namedispatcher/servlet-name servlet-classorg.springframework.web.servlet.DispatcherServlet/servlet-class init-param param-namecontextConfigLocation/param-name param-valueclasspath:spring-mvc.xml/param-value /init-param load-on-startup1/load-on-startup /servlet servlet-mapping servlet-namedispatcher/servlet-name url-pattern//url-pattern /servlet-mapping /web-app这里最容易翻车的两个点。第一url-pattern要写“/”而不是“/”写“/”会把对JSP的转发请求也拦进DispatcherServlet导致页面直接404或变成一堆乱码写“/”则把.jsp的转发交给了容器默认Servlet。第二load-on-startup必须配1让DispatcherServlet在应用启动时就创建子容器否则第一次请求才初始化启动阶段的反常现象会推迟到运行期才暴露。CharacterEncodingFilter的forceEncoding设为true是为了让“请求和响应两侧都强制用UTF-8”而不是只改请求一侧。3.3 三份配置各自的边界根容器、MVC容器、MyBatis自身applicationContext.xml归属根容器职责是数据源、事务、Mapper扫描、Service扫描。context:property-placeholder locationclasspath:jdbc.properties/ bean iddataSource classcom.alibaba.druid.pool.DruidDataSource property namedriverClassName value${jdbc.driver}/ property nameurl value${jdbc.url}/ property nameusername value${jdbc.username}/ property namepassword value${jdbc.password}/ /bean bean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean property namedataSource refdataSource/ property nameconfigLocation valueclasspath:mybatis-config.xml/ property nametypeAliasesPackage valuecom.demo.core.entity/ property namemapperLocations valueclasspath:mapper/*.xml/ /bean bean classorg.mybatis.spring.mapper.MapperScannerConfigurer property namebasePackage valuecom.demo.dao/ /bean context:component-scan base-packagecom.demo.service/ bean idtransactionManager classorg.springframework.jdbc.datasource.DataSourceTransactionManager property namedataSource refdataSource/ /bean tx:annotation-driven transaction-managertransactionManager/逐一说关键参数。typeAliasesPackage把实体类的包名注册为别名XML里写parameterType和resultType时可以直接用User而不是全限定名少写一长串包路径。mapperLocations指向classpath:mapper/.xml注意开头的classpath:不带星表示在jar和classes目录下查找如果你有多个依赖模块含有mapper文件要把写法改成classpath:mapper/*.xml才能跨jar包匹配。MapperScannerConfigurer的basePackage只扫Mapper接口包不扫XML——XML由上面的mapperLocations负责加载很多整合工程启动后Mapper方法报“Invalid bound statement”就是这两处路径没对上。spring-mvc.xml归属MVC子容器职责是Controller扫描、注解驱动、静态资源放行、视图解析。context:component-scan base-packagecom.demo.web.controller/ mvc:annotation-driven/ mvc:default-servlet-handler/ bean idviewResolver classorg.springframework.web.servlet.view.InternalResourceViewResolver property nameprefix value/WEB-INF/views// property namesuffix value.jsp/ /beancomponent-scan这里有一个非常隐蔽的坑如果扫描的包范围过大比如直接扫com.demo会把根容器里的Service再实例化一遍Controller里注入的Service就会收到子容器这一份全新实例事务代理还会因此失效。规范做法是MVC容器只扫controller包根容器只扫service包两者严格错开。mvc:default-servlet-handler让静态资源比如CSS、JS、图片在DispatcherServlet拦截后能交给容器默认Servlet处理不配它前端页面样式全部白屏。mybatis-config.xml管MyBatis自身的行为不进任何容器只是被SqlSessionFactoryBean引用加载configuration settings setting namemapUnderscoreToCamelCase valuetrue/ setting namelogImpl valueSLF4J/ /settings /configurationmapUnderscoreToCamelCase开启后数据库的create_time列能自动映射到实体的createTime属性省去大部分resultMap的字段映射logImpl设为SLF4J是为了让MyBatis执行SQL时把日志交给你统一的日志框架调试时能看到每条SQL和参数。这里多说一句JDBC连接串如果直接写死在XML里符号要先转义成所以建议把jdbc的四个参数单独放到jdbc.properties里既绕开转义问题也方便后续做多环境切换。4. 走一遍用户模块的业务链路Controller、Service、Mapper怎么分工4.1 实体、Mapper接口与XML先定数据边界再写业务整合工程里最典型的一个完整闭环是用户模块的增删改查。先从数据边界开始。实体类很简单字段对齐数据库表结构public class User { private Integer id; private String username; private String email; private Date createTime; // getter / setter 省略 }Mapper接口只声明方法不写实现MyBatis会为它生成代理public interface UserMapper { ListUser selectList(Param(username) String username); User selectById(Integer id); int insert(User user); int update(User user); int deleteById(Integer id); }对应的UserMapper.xml放在资源目录的mapper文件夹下mapper namespacecom.demo.dao.UserMapper resultMap iduserMap typeUser id propertyid columnid/ result propertyusername columnusername/ result propertyemail columnemail/ result propertycreateTime columncreate_time/ /resultMap select idselectList resultMapuserMap SELECT id, username, email, create_time FROM t_user where if testusername ! null and username ! AND username LIKE CONCAT(%, #{username}, %) /if /where /select select idselectById resultMapuserMap SELECT id, username, email, create_time FROM t_user WHERE id #{id} /select insert idinsert useGeneratedKeystrue keyPropertyid INSERT INTO t_user (username, email, create_time) VALUES (#{username}, #{email}, NOW()) /insert update idupdate parameterTypeUser UPDATE t_user set if testusername ! nullusername #{username},/if if testemail ! nullemail #{email},/if /set WHERE id #{id} /update delete iddeleteById DELETE FROM t_user WHERE id #{id} /delete /mapper这里的几个细节都是踩过坑的。namespace必须和Mapper接口的全限定名一致不一致时MyBatis扫描报错告诉你找不到statement。insert里useGeneratedKeys和keyProperty配合数据库自增主键才会回填到传入的User对象的id属性上否则插入后你拿不到新主键后续关联逻辑没法写。动态SQL用 而不是手工WHERE 11 会自动剔除第一个多余的AND或OR老写法里那个11不仅丑数据量大时还会影响执行计划。同理自动处理UPDATE语句末尾多余的逗号。4.2 Service层事务的边界为什么必须画在这里Service层是事务的边界。Controller不做事务Mapper不做事务只有业务方法需要保证多步操作的原子性时事务注解才出现在Service实现类上Service public class UserServiceImpl implements UserService { Autowired private UserMapper userMapper; Override Transactional(rollbackFor Exception.class) public int createUser(User user) { userMapper.insert(user); // 其他关联业务动作 return user.getId(); } }Transactional必须加在public方法上加在private方法上注解被直接忽略这是Spring代理机制决定的。rollbackFor Exception.class这一行几乎不能省Spring默认只对RuntimeException回滚如果Service里抛出的是受检异常方法结束时事务照样提交数据库里就留下了一条你以为失败了的脏数据这是血泪经验。另一个容易被忽略的是同类自调用问题也就是在UserServiceImpl内部调用另一个标了Transactional的同类方法时调用发生在this实例上不会经过代理对象事务警告无效。解决方式是拆成不同的Bean互相调用或者自注入代理。你在走读一份整合源码时重点看的不是Service写了多少业务逻辑而是事务注解的摆放位置和调用链有没有绕过代理。4.3 Controller层页面与JSON两种返回方式怎么取舍Controller是整合工程面向请求的入口。纯接口项目从Spring 4开始推荐RestController它是Controller加ResponseBody的合成体方法返回值直接经过Jackson序列化成JSONRestController RequestMapping(/api/user) public class UserController { Autowired private UserService userService; GetMapping(/{id}) public ResultUser detail(PathVariable Integer id) { return Result.success(userService.getUserById(id)); } PostMapping public ResultInteger create(RequestBody User user) { return Result.success(userService.createUser(user)); } }这里为了接口响应的统一性我习惯定义Result 包装结构包含code、message、data三个字段成功返回code0失败返回非零错误码和提示信息。注意PathVariable用来绑定URL路径参数RequestBody用来把JSON请求体反序列化成User对象RequestParam则用于query string参数三者混用时参数命名和前端约定要对齐否则Spring解析失败直接报400。如果你的工程还需要返回页面比如管理后台的JSP那Controller上就不能用RestController而是用Controller配合返回字符串视图名由InternalResourceViewResolver拼出/WEB-INF/views/xxx.jsp。同一套工程里两种Controller可以共存接口归接口页面归页面只要记住接口路径统一带/api前缀方便在SpringMVC里针对性地做拦截器和异常处理。5. 整合避坑清单五类症状、原因和排查路径5.1 Bean装配与扫描路径类现象1启动时抛NoSuchBeanDefinitionException提示找不到UserService或UserMapper类型的Bean但你的类明明写了Service或Mapper。原因就三选一component-scan的basePackage包名拼错或作用域不对Service被放在MVC子容器而根容器没扫到根容器和子容器重复扫描导致Controller注入了错误实例。这里面第二种情况最常见——把Service放在了MVC配置文件的component-scan里面。解决根容器只扫service和dao相关包MVC容器只扫controller包。检查日志里Spring容器初始化时打印的Bean定义数量如果Service的Bean被定义了两次马上就能看到重复的bean name。还可以临时把日志级别调到DEBUG看扫描器实际扫了哪些包路径。现象2启动正常Controller里注入的Mapper接口为null运行到业务方法直接NPE控制台没有任何MyBatis相关日志。原因MapperScannerConfigurer的basePackage和Mapper接口所在包对不上一个Mapper都没扫到Spring注入时给了null或者mapperLocations路径配的不是classpath*:XML没加载接口代理建立后找不到statement运行时报Invalid bound statement。解决核对basePackage它必须精确指向Mapper接口包。mapperLocations改成classpath*:mapper/*.xml防止多模块场景下漏加载。如果你的Mapper接口上有Mapper注解且同时用了MapperScannerConfigurer注解是冗余但不冲突如果只用了独立XML的方式接口上一个注解都不需要。5.2 事务与页面路由类现象3Service方法里故意抛了异常数据库数据还是被写进去了事务像假的一样。原因有四个Transactional加在非public方法上被代理忽略同类内部自调用绕过了代理对象方法内异常被try/catch吞了事务根本不知道出了问题rollbackFor没配受检异常走了默认的提交路径。我见过最邪门的是有人在Controller方法上标了Transactional看起来万事大吉实际因为Controller的代理方式和事务管理器不匹配事务完全没生效。解决事务注解只写Service实现类的public方法上rollbackFor一律配Exception.class。代码里禁止用catch块“消化”业务异常要处理就记录日志后继续往外抛。验证方式是看Spring事务日志在log4j2配置里把org.springframework.jdbc.datasource.DataSourceTransactionManager设为DEBUG操作一次失败场景日志里没出现“Rolling back”就是没回滚。现象4部署到Tomcat后访问首页404但直接请求Controller的接口路径能返回JSON。原因DispatcherServlet的url-pattern配成了/*把JSP转发拦了或者IDE里部署的Artifact没有把webapp目录打包进WAR或者InternalResourceViewResolver的prefix配的是/views/实际页面放在/WEB-INF/views/下。解决url-pattern只写“/”。检查部署后的目录结构WAR里确定存在WEB-INF/views/以及对应JSP文件。视图解析器从“/”开头的路径都是从应用上下文根开始的写成相对路径会拼在你的请求URI后面越拼越长。5.3 中文编码与连接串类现象5插入中文后数据库变问号按中文条件查询查不到数据但英文和数字完全正常。原因CharacterEncodingFilter位置放得不对Tomcat默认的请求解码发生在Filter之前或者JDBC连接串缺了characterEncodingutf8参数或者MySQL驱动版本和数据库版本不匹配旧驱动类被新连接协议拒绝。解决编码Filter必须是filter-mapping里第一个执行的谁在前谁先解码。JDBC的URL标准写法是serverTimezoneAsia/ShanghaicharacterEncodingutf8useSSLfalse注意在XML里要转义成所以我建议写在jdbc.properties里避开转义。MySQL 8及以上必须用com.mysql.cj.jdbc.Driver这个类名旧类名只适用5.x驱动这一条在新环境里翻车率极高。6. 让整合工程长出专业感分页拦截器、Druid监控与五步验证习惯6.1 分页MyBatis拦截器把SQL改写成本地方言列表查询的分页不要手写LIMIT更不要在Java代码里把数据全查出来再切片。常见做法是引入PageHelper插件它的原理是拦截Executor的query方法在执行前自动把原SQL改写成一条count查询和一条带LIMIT的查询并且通过ThreadLocal记录分页参数。dependency groupIdcom.github.pagehelper/groupId artifactIdpagehelper/artifactId version5.x/version /dependency使用时在查询前一行代码开启分页后面紧跟的第一次MyBatis查询生效PageHelper.startPage(pageNum, pageSize); ListUser list userMapper.selectList(username); PageInfoUser page new PageInfo(list);注意PageHelper的方法调用和查询之间不要插入其他数据库操作否则分页参数可能被上一个查询消费掉。PageInfo里封装了total、pages、pageNum、pageSize、list这些完整信息直接把整个对象返回给前端就行。6.2 Druid监控与多环境配置数据源选了Druid它的监控页面是排查慢SQL和连接池泄漏的利器。在web.xml里注册一个StatViewServlet映射到/druid/*启动后访问contextPath/druid/index.html就能看到SQL执行次数、耗时分布、活跃连接数。上线前把慢SQL阈值调低比如执行超过500ms的SQL自动标红逐条优化。多环境配置的做法是准备三份jdbc.properties后缀文件或者用Spring的profile机制配多个property-placeholder。我习惯用占位符方案配置文件里写jdbc.url${DB_URL}部署时通过环境变量注入这样代码仓库里不存任何环境的真实密码切换环境时只需要改变量不用改工程重新打包。6.3 拿到一份整合源码的五步验证习惯我拿到任意一份整合工程源码第一件事永远不是点运行而是按下面顺序读文件先开web.xml按listener、filter、servlet的顺序读装配逻辑确认容器启动链路再开applicationContext.xml核对数据源、Mapper扫描、事务管理器三件事然后开spring-mvc.xml看Controller扫描范围和视图解析器接着选一条典型的业务请求从Controller一路走读到Mapper XML里的SQL最后配上Druid监控和日志框架跑一遍增删改查验证。这套顺序走完工程里有没有埋雷基本心里有数了。很多开发者的习惯是看到Tomcat启动成功就宣布“跑通了”然后业务一调就404又回到视频里找答案。整合开发和单个框架最大的不同是它的运行结果由配置文件之间的协作关系决定而这个协作关系只能通过“读配置的顺序感”建立起来。希望帮到你。本文还有配套的精品资源点击获取
简介面向Java Web开发人员的框架整合实践源代码包以J2EE、Struts、Hibernate、Spring四大主流技术为主线适合希望掌握SSH整合开发、理解MVC分层与ORM映射的中级以上学习者。压缩包共1145个文件包含218个Java源文件、243个class编译文件、138个jsp页面、93个xml配置、62个tld标签库以及properties、sql、db等辅助文件完整覆盖模型类、Action、Form Bean、Servlet/JSP和struts-config.xml、hibernate.cfg.xml、applicationContext.xml等关键配置包体约2.35MB。资源通过可运行示例展现各框架协作方式帮助读者从代码层面理解依赖注入、事务管理、持久化操作及前后端交互也可作为项目搭建和排错参考。已有394人学习下载适合自学研读或课堂配套使用。1. 为什么一份整合源代码比三十集视频更能帮你突击如果只看标题“Java Web主流框架整合开发源代码”你可能会以为它只是一堆能跑的demo堆在一起。但真正干过整合开发的人都知道坑全在配置文件里不在代码里。单独跑SpringMVC的示例很顺单独跑MyBatis的示例也很顺一旦把两者放进同一个工程容器谁先创建、Bean谁该注入谁、事务边界画在哪一层每一个环节都能让新手卡上一整天。整合这件事最值钱的不是“能跑”而是“每个文件为什么存在”。这套源码的价值就在这里依赖怎么配、配置怎么分、Controller到Mapper怎么串全部摊开给你看。我按“原理 → 工程 → 配置 → 业务 → 避坑 → 进阶”的顺序把它讲透。2. 为什么所有整合都绕不开Spring先看懂那层“胶水”2.1 IoC容器才是整合的基座不是框架互相调用而是统一交给Spring管辖整合的第一性原理是SpringMVC、MyBatis、业务代码之间并不直接互相调用它们全部作为Bean注册进Spring IoC容器由容器负责创建和注入。SpringMVC的DispatcherServlet从容器里取ControllerController注入ServiceService注入Mapper接口而Mapper接口本身是被MyBatis-Spring扫描后注册成的一个代理Bean。这个链条里没有一处是“new”出来的全部是容器给的关系。这套机制在Web工程里还有一个容易忽略的双容器模型。ContextLoaderListener负责创建根容器里面放数据源、Service、Dao、事务管理器DispatcherServlet启动时再创建一个SpringMVC子容器里面放Controller和视图解析器。子容器能看见父容器的Bean父容器看不见子容器的。所以配置放错了容器运行时的现象就是Controller里注入的Service为null或者启动时直接报NoSuchBeanDefinitionException。明白这个模型你再去看“配置文件怎么分”的问题答案已经出来一半了。2.2 AOP把事务和日志变成了配置项整合后的事务不再由你手动提交抛开AOP谈整合是学不透的。声明式事务本质上是Spring AOP在做代理你调用一个标注了Transactional的public方法代理会在方法进入前开启事务方法正常返回时提交抛出异常时回滚。MyBatis的SqlSession也由Spring统一管理你不再需要自己openSession、手动commit、finally里closeSqlSessionTemplate会跟着事务的生命周期自动开合。这也是整合方案与“硬编码使用MyBatis”最本质的区别。硬编码时你要写sessionFactory.openSession()和session.commit()整合之后这些都从代码里消失了。如果你在代码里看到有人还在手动调用SqlSession的commit那通常意味着他没有把SqlSession交给Spring事务管理十有八九是错位的。日志AOP同理你可以用切面统一打印Controller入参、Service耗时、异常堆栈而不是在每个业务方法里重复写日志调用。2.3 SSM与SSH两大流派新项目怎么选老工程怎么迁标题里的“主流框架”在Java Web领域最有代表性的是两组SSH和SSM。SSH指Struts2加Spring加HibernateSSM指SpringMVC加Spring加MyBatis。两组都用到了Spring作为整合底座区别主要在于前端控制器和持久层框架。对比项SSMSpringMVC Spring MyBatisSSHStruts2 Spring Hibernate控制器粒度方法级注解一个方法对应一个请求类级Action XML配置一个类对应一类动作持久层方式手写SQL半自动映射SQL完全可控HQL和ORM自动映射全自动但SQL难以精细化控制学习曲线中等偏下SQL熟练就能上手较陡Hibernate的映射、缓存、懒加载概念多适用场景新项目、SQL复杂的业务系统、报表类应用存量系统、领域模型复杂的传统业务平台维护现状新项目主流资料多招人容易存量老系统居多维护成本高迁移需求大我的建议很直接新工程一律走SSM这条线理由不是SSH技术差而是现在的新项目、团队协作、问题排查资料几乎都沉淀在SSM这一侧。真遇到SSH老系统的整合改造也不要急着推翻重写Spring的核心知识完全复用把Struts2的Action迁移成SpringMVC的Controller把Hibernate的实体映射迁到MyBatis的XML按模块灰度替换即可。下面所有具体操作我以SSM为例展开这也是这份整合源代码的默认主线路。3. 从零搭一个能跑的整合工程Maven依赖、web.xml与三份配置3.1 多模块Maven工程怎么拆依赖隔离是第一道防线整合工程不要做成单模块WAR包一坨到底。常见的做法是拆成四个模块demo-core放实体和公共工具demo-dao放Mapper接口与XMLdemo-service放业务逻辑和事务demo-web放Controller、配置文件和webapp目录。父工程demo-parent只做两件事声明子模块统一管理依赖版本。父工程pom.xml的关键部分长这样project modelVersion4.0.0/modelVersion groupIdcom.demo/groupId artifactIddemo-parent/artifactId version1.0.0/version packagingpom/packaging modules moduledemo-core/module moduledemo-dao/module moduledemo-service/module moduledemo-web/module /modules dependencyManagement dependencies dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version5.x/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId version3.5.x/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version2.x/version /dependency /dependencies /dependencyManagement /project这里的关键是dependencyManagement标签。它的作用不是引入依赖而是锁版本子模块里只需写groupId和artifactId版本号全部继承父工程。这样整个项目的Spring全家桶版本、MyBatis版本、Jackson版本只要在父工程里改一处全局生效从根上避免“子模块之间版本打架”的传递依赖冲突。各模块的依赖职责分配如下依赖所属模块用途spring-webmvcdemo-webMVC框架、DispatcherServletspring-jdbcdemo-dao数据源、事务管理器基础设施mybatisdemo-dao持久层核心mybatis-springdemo-daoMyBatis与Spring的装配桥接mysql-connector-javademo-daoMySQL JDBC驱动druiddemo-dao数据源与连接池监控jackson-databinddemo-webJSON序列化与反序列化javax.servlet-apidemo-webServlet编译期依赖scope置providedlog4j2 slf4j全部模块日志门面与实现我见过不少工程把这些依赖全部堆在web层dao层编译时找不到mybatis的类启动时才被Tomcat类加载救回来这是典型的模块边界失守。dao模块必须在自己的pom里直接引用mybatis和mysql驱动而不是依赖web模块传递过来。3.2 web.xml做了三件事编码、根容器、前端控制器SSM整合的web.xml只关心三件事CharacterEncodingFilter保证请求和响应编码ContextLoaderListener创建根容器DispatcherServlet创建MVC子容器。加载顺序由web.xml里的元素顺序决定这个顺序错一个字结果都不同。web-app filter filter-nameencodingFilter/filter-name filter-classorg.springframework.web.filter.CharacterEncodingFilter/filter-class init-param param-nameencoding/param-name param-valueUTF-8/param-value /init-param init-param param-nameforceEncoding/param-name param-valuetrue/param-value /init-param /filter filter-mapping filter-nameencodingFilter/filter-name url-pattern/*/url-pattern /filter-mapping context-param param-namecontextConfigLocation/param-name param-valueclasspath:applicationContext.xml/param-value /context-param listener listener-classorg.springframework.web.context.ContextLoaderListener/listener-class /listener servlet servlet-namedispatcher/servlet-name servlet-classorg.springframework.web.servlet.DispatcherServlet/servlet-class init-param param-namecontextConfigLocation/param-name param-valueclasspath:spring-mvc.xml/param-value /init-param load-on-startup1/load-on-startup /servlet servlet-mapping servlet-namedispatcher/servlet-name url-pattern//url-pattern /servlet-mapping /web-app这里最容易翻车的两个点。第一url-pattern要写“/”而不是“/”写“/”会把对JSP的转发请求也拦进DispatcherServlet导致页面直接404或变成一堆乱码写“/”则把.jsp的转发交给了容器默认Servlet。第二load-on-startup必须配1让DispatcherServlet在应用启动时就创建子容器否则第一次请求才初始化启动阶段的反常现象会推迟到运行期才暴露。CharacterEncodingFilter的forceEncoding设为true是为了让“请求和响应两侧都强制用UTF-8”而不是只改请求一侧。3.3 三份配置各自的边界根容器、MVC容器、MyBatis自身applicationContext.xml归属根容器职责是数据源、事务、Mapper扫描、Service扫描。context:property-placeholder locationclasspath:jdbc.properties/ bean iddataSource classcom.alibaba.druid.pool.DruidDataSource property namedriverClassName value${jdbc.driver}/ property nameurl value${jdbc.url}/ property nameusername value${jdbc.username}/ property namepassword value${jdbc.password}/ /bean bean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean property namedataSource refdataSource/ property nameconfigLocation valueclasspath:mybatis-config.xml/ property nametypeAliasesPackage valuecom.demo.core.entity/ property namemapperLocations valueclasspath:mapper/*.xml/ /bean bean classorg.mybatis.spring.mapper.MapperScannerConfigurer property namebasePackage valuecom.demo.dao/ /bean context:component-scan base-packagecom.demo.service/ bean idtransactionManager classorg.springframework.jdbc.datasource.DataSourceTransactionManager property namedataSource refdataSource/ /bean tx:annotation-driven transaction-managertransactionManager/逐一说关键参数。typeAliasesPackage把实体类的包名注册为别名XML里写parameterType和resultType时可以直接用User而不是全限定名少写一长串包路径。mapperLocations指向classpath:mapper/.xml注意开头的classpath:不带星表示在jar和classes目录下查找如果你有多个依赖模块含有mapper文件要把写法改成classpath:mapper/*.xml才能跨jar包匹配。MapperScannerConfigurer的basePackage只扫Mapper接口包不扫XML——XML由上面的mapperLocations负责加载很多整合工程启动后Mapper方法报“Invalid bound statement”就是这两处路径没对上。spring-mvc.xml归属MVC子容器职责是Controller扫描、注解驱动、静态资源放行、视图解析。context:component-scan base-packagecom.demo.web.controller/ mvc:annotation-driven/ mvc:default-servlet-handler/ bean idviewResolver classorg.springframework.web.servlet.view.InternalResourceViewResolver property nameprefix value/WEB-INF/views// property namesuffix value.jsp/ /beancomponent-scan这里有一个非常隐蔽的坑如果扫描的包范围过大比如直接扫com.demo会把根容器里的Service再实例化一遍Controller里注入的Service就会收到子容器这一份全新实例事务代理还会因此失效。规范做法是MVC容器只扫controller包根容器只扫service包两者严格错开。mvc:default-servlet-handler让静态资源比如CSS、JS、图片在DispatcherServlet拦截后能交给容器默认Servlet处理不配它前端页面样式全部白屏。mybatis-config.xml管MyBatis自身的行为不进任何容器只是被SqlSessionFactoryBean引用加载configuration settings setting namemapUnderscoreToCamelCase valuetrue/ setting namelogImpl valueSLF4J/ /settings /configurationmapUnderscoreToCamelCase开启后数据库的create_time列能自动映射到实体的createTime属性省去大部分resultMap的字段映射logImpl设为SLF4J是为了让MyBatis执行SQL时把日志交给你统一的日志框架调试时能看到每条SQL和参数。这里多说一句JDBC连接串如果直接写死在XML里符号要先转义成所以建议把jdbc的四个参数单独放到jdbc.properties里既绕开转义问题也方便后续做多环境切换。4. 走一遍用户模块的业务链路Controller、Service、Mapper怎么分工4.1 实体、Mapper接口与XML先定数据边界再写业务整合工程里最典型的一个完整闭环是用户模块的增删改查。先从数据边界开始。实体类很简单字段对齐数据库表结构public class User { private Integer id; private String username; private String email; private Date createTime; // getter / setter 省略 }Mapper接口只声明方法不写实现MyBatis会为它生成代理public interface UserMapper { ListUser selectList(Param(username) String username); User selectById(Integer id); int insert(User user); int update(User user); int deleteById(Integer id); }对应的UserMapper.xml放在资源目录的mapper文件夹下mapper namespacecom.demo.dao.UserMapper resultMap iduserMap typeUser id propertyid columnid/ result propertyusername columnusername/ result propertyemail columnemail/ result propertycreateTime columncreate_time/ /resultMap select idselectList resultMapuserMap SELECT id, username, email, create_time FROM t_user where if testusername ! null and username ! AND username LIKE CONCAT(%, #{username}, %) /if /where /select select idselectById resultMapuserMap SELECT id, username, email, create_time FROM t_user WHERE id #{id} /select insert idinsert useGeneratedKeystrue keyPropertyid INSERT INTO t_user (username, email, create_time) VALUES (#{username}, #{email}, NOW()) /insert update idupdate parameterTypeUser UPDATE t_user set if testusername ! nullusername #{username},/if if testemail ! nullemail #{email},/if /set WHERE id #{id} /update delete iddeleteById DELETE FROM t_user WHERE id #{id} /delete /mapper这里的几个细节都是踩过坑的。namespace必须和Mapper接口的全限定名一致不一致时MyBatis扫描报错告诉你找不到statement。insert里useGeneratedKeys和keyProperty配合数据库自增主键才会回填到传入的User对象的id属性上否则插入后你拿不到新主键后续关联逻辑没法写。动态SQL用 而不是手工WHERE 11 会自动剔除第一个多余的AND或OR老写法里那个11不仅丑数据量大时还会影响执行计划。同理自动处理UPDATE语句末尾多余的逗号。4.2 Service层事务的边界为什么必须画在这里Service层是事务的边界。Controller不做事务Mapper不做事务只有业务方法需要保证多步操作的原子性时事务注解才出现在Service实现类上Service public class UserServiceImpl implements UserService { Autowired private UserMapper userMapper; Override Transactional(rollbackFor Exception.class) public int createUser(User user) { userMapper.insert(user); // 其他关联业务动作 return user.getId(); } }Transactional必须加在public方法上加在private方法上注解被直接忽略这是Spring代理机制决定的。rollbackFor Exception.class这一行几乎不能省Spring默认只对RuntimeException回滚如果Service里抛出的是受检异常方法结束时事务照样提交数据库里就留下了一条你以为失败了的脏数据这是血泪经验。另一个容易被忽略的是同类自调用问题也就是在UserServiceImpl内部调用另一个标了Transactional的同类方法时调用发生在this实例上不会经过代理对象事务警告无效。解决方式是拆成不同的Bean互相调用或者自注入代理。你在走读一份整合源码时重点看的不是Service写了多少业务逻辑而是事务注解的摆放位置和调用链有没有绕过代理。4.3 Controller层页面与JSON两种返回方式怎么取舍Controller是整合工程面向请求的入口。纯接口项目从Spring 4开始推荐RestController它是Controller加ResponseBody的合成体方法返回值直接经过Jackson序列化成JSONRestController RequestMapping(/api/user) public class UserController { Autowired private UserService userService; GetMapping(/{id}) public ResultUser detail(PathVariable Integer id) { return Result.success(userService.getUserById(id)); } PostMapping public ResultInteger create(RequestBody User user) { return Result.success(userService.createUser(user)); } }这里为了接口响应的统一性我习惯定义Result 包装结构包含code、message、data三个字段成功返回code0失败返回非零错误码和提示信息。注意PathVariable用来绑定URL路径参数RequestBody用来把JSON请求体反序列化成User对象RequestParam则用于query string参数三者混用时参数命名和前端约定要对齐否则Spring解析失败直接报400。如果你的工程还需要返回页面比如管理后台的JSP那Controller上就不能用RestController而是用Controller配合返回字符串视图名由InternalResourceViewResolver拼出/WEB-INF/views/xxx.jsp。同一套工程里两种Controller可以共存接口归接口页面归页面只要记住接口路径统一带/api前缀方便在SpringMVC里针对性地做拦截器和异常处理。5. 整合避坑清单五类症状、原因和排查路径5.1 Bean装配与扫描路径类现象1启动时抛NoSuchBeanDefinitionException提示找不到UserService或UserMapper类型的Bean但你的类明明写了Service或Mapper。原因就三选一component-scan的basePackage包名拼错或作用域不对Service被放在MVC子容器而根容器没扫到根容器和子容器重复扫描导致Controller注入了错误实例。这里面第二种情况最常见——把Service放在了MVC配置文件的component-scan里面。解决根容器只扫service和dao相关包MVC容器只扫controller包。检查日志里Spring容器初始化时打印的Bean定义数量如果Service的Bean被定义了两次马上就能看到重复的bean name。还可以临时把日志级别调到DEBUG看扫描器实际扫了哪些包路径。现象2启动正常Controller里注入的Mapper接口为null运行到业务方法直接NPE控制台没有任何MyBatis相关日志。原因MapperScannerConfigurer的basePackage和Mapper接口所在包对不上一个Mapper都没扫到Spring注入时给了null或者mapperLocations路径配的不是classpath*:XML没加载接口代理建立后找不到statement运行时报Invalid bound statement。解决核对basePackage它必须精确指向Mapper接口包。mapperLocations改成classpath*:mapper/*.xml防止多模块场景下漏加载。如果你的Mapper接口上有Mapper注解且同时用了MapperScannerConfigurer注解是冗余但不冲突如果只用了独立XML的方式接口上一个注解都不需要。5.2 事务与页面路由类现象3Service方法里故意抛了异常数据库数据还是被写进去了事务像假的一样。原因有四个Transactional加在非public方法上被代理忽略同类内部自调用绕过了代理对象方法内异常被try/catch吞了事务根本不知道出了问题rollbackFor没配受检异常走了默认的提交路径。我见过最邪门的是有人在Controller方法上标了Transactional看起来万事大吉实际因为Controller的代理方式和事务管理器不匹配事务完全没生效。解决事务注解只写Service实现类的public方法上rollbackFor一律配Exception.class。代码里禁止用catch块“消化”业务异常要处理就记录日志后继续往外抛。验证方式是看Spring事务日志在log4j2配置里把org.springframework.jdbc.datasource.DataSourceTransactionManager设为DEBUG操作一次失败场景日志里没出现“Rolling back”就是没回滚。现象4部署到Tomcat后访问首页404但直接请求Controller的接口路径能返回JSON。原因DispatcherServlet的url-pattern配成了/*把JSP转发拦了或者IDE里部署的Artifact没有把webapp目录打包进WAR或者InternalResourceViewResolver的prefix配的是/views/实际页面放在/WEB-INF/views/下。解决url-pattern只写“/”。检查部署后的目录结构WAR里确定存在WEB-INF/views/以及对应JSP文件。视图解析器从“/”开头的路径都是从应用上下文根开始的写成相对路径会拼在你的请求URI后面越拼越长。5.3 中文编码与连接串类现象5插入中文后数据库变问号按中文条件查询查不到数据但英文和数字完全正常。原因CharacterEncodingFilter位置放得不对Tomcat默认的请求解码发生在Filter之前或者JDBC连接串缺了characterEncodingutf8参数或者MySQL驱动版本和数据库版本不匹配旧驱动类被新连接协议拒绝。解决编码Filter必须是filter-mapping里第一个执行的谁在前谁先解码。JDBC的URL标准写法是serverTimezoneAsia/ShanghaicharacterEncodingutf8useSSLfalse注意在XML里要转义成所以我建议写在jdbc.properties里避开转义。MySQL 8及以上必须用com.mysql.cj.jdbc.Driver这个类名旧类名只适用5.x驱动这一条在新环境里翻车率极高。6. 让整合工程长出专业感分页拦截器、Druid监控与五步验证习惯6.1 分页MyBatis拦截器把SQL改写成本地方言列表查询的分页不要手写LIMIT更不要在Java代码里把数据全查出来再切片。常见做法是引入PageHelper插件它的原理是拦截Executor的query方法在执行前自动把原SQL改写成一条count查询和一条带LIMIT的查询并且通过ThreadLocal记录分页参数。dependency groupIdcom.github.pagehelper/groupId artifactIdpagehelper/artifactId version5.x/version /dependency使用时在查询前一行代码开启分页后面紧跟的第一次MyBatis查询生效PageHelper.startPage(pageNum, pageSize); ListUser list userMapper.selectList(username); PageInfoUser page new PageInfo(list);注意PageHelper的方法调用和查询之间不要插入其他数据库操作否则分页参数可能被上一个查询消费掉。PageInfo里封装了total、pages、pageNum、pageSize、list这些完整信息直接把整个对象返回给前端就行。6.2 Druid监控与多环境配置数据源选了Druid它的监控页面是排查慢SQL和连接池泄漏的利器。在web.xml里注册一个StatViewServlet映射到/druid/*启动后访问contextPath/druid/index.html就能看到SQL执行次数、耗时分布、活跃连接数。上线前把慢SQL阈值调低比如执行超过500ms的SQL自动标红逐条优化。多环境配置的做法是准备三份jdbc.properties后缀文件或者用Spring的profile机制配多个property-placeholder。我习惯用占位符方案配置文件里写jdbc.url${DB_URL}部署时通过环境变量注入这样代码仓库里不存任何环境的真实密码切换环境时只需要改变量不用改工程重新打包。6.3 拿到一份整合源码的五步验证习惯我拿到任意一份整合工程源码第一件事永远不是点运行而是按下面顺序读文件先开web.xml按listener、filter、servlet的顺序读装配逻辑确认容器启动链路再开applicationContext.xml核对数据源、Mapper扫描、事务管理器三件事然后开spring-mvc.xml看Controller扫描范围和视图解析器接着选一条典型的业务请求从Controller一路走读到Mapper XML里的SQL最后配上Druid监控和日志框架跑一遍增删改查验证。这套顺序走完工程里有没有埋雷基本心里有数了。很多开发者的习惯是看到Tomcat启动成功就宣布“跑通了”然后业务一调就404又回到视频里找答案。整合开发和单个框架最大的不同是它的运行结果由配置文件之间的协作关系决定而这个协作关系只能通过“读配置的顺序感”建立起来。希望帮到你。本文还有配套的精品资源点击获取
