簡介一套基于 Idea 2021 從零整合 Spring、SpringMVC 與 MyBatis 三大框架的源碼工程配套 Tomcat 9.0 與 MySQL 8.0.25 環(huán)境面向初學(xué) JavaWeb 的讀者以及需要快速搭建項目骨架的開發(fā)者重點解決框架整合、依賴沖突和基礎(chǔ)配置等常見問題。資源包共包含 105 個文件以 52 個 jar 依賴庫、28 個 xml 配置、10 個編譯后的 class 文件、5 個 Java 源碼和 4 個 JSP 頁面為主同時保留 properties、gitignore 等輔助文件整體大小約 22.34MB目錄按控制層、業(yè)務(wù)層、持久層劃分結(jié)構(gòu)清晰便于逐模塊閱讀和復(fù)用。累計已有三千一百三十五人學(xué)習(xí)使用是較常見的 SSM 入門參考。整個示例以圖書管理為業(yè)務(wù)場景實體類、數(shù)據(jù)訪問接口、業(yè)務(wù)服務(wù)與控制器的職責(zé)劃分清晰數(shù)據(jù)庫訪問映射、業(yè)務(wù)邏輯封裝與頁面交互均有體現(xiàn)關(guān)鍵配置文件也一并給出可幫助讀者繞開版本兼容問題快速獲得一套可運行、可擴展的 SSM 項目雛形。無論是課程設(shè)計、畢業(yè)設(shè)計還是日常練習(xí)都能從中獲得可直接參考的項目結(jié)構(gòu)。1. 從零搭SSM框架不是背配置是理解三個容器怎么協(xié)同很多人拿到一套SSM源碼第一反應(yīng)是打開百度搜“IDEA 2021 SSM搭建教程”然后跟著教程把applicationContext.xml、spring-mvc.xml、web.xml三個文件復(fù)制粘貼一遍項目跑起來就覺得自己會了。結(jié)果一旦遇到包名改動、Mapper找不到、Controller 404立刻傻眼因為不知道這三個配置文件之間到底是什么關(guān)系。這套源碼拆解筆記就是圍繞“根容器、子容器、Mapper代理”三條線來寫的先搞清楚Spring和SpringMVC各自管哪些Bean再理解MyBatis是怎么被掛進Spring的最后用一份完整可跑通的工程源碼作為對照。適合剛過JavaWeb、準備做畢設(shè)或第一次接觸企業(yè)級項目結(jié)構(gòu)的人也適合想快速搭一套可復(fù)用骨架的從業(yè)者。2. IDEA 2021里初始化工程版本選型與Maven Web骨架的落地細節(jié)2.1 JDK、Maven、Tomcat版本怎么選定SSM不是新技術(shù)但它對版本組合非常敏感。我見過有人用JDK 17去跑Spring 5的工程結(jié)果CGLIB代理直接報錯也見過用Tomcat 10搭配javax.servlet寫的代碼啟動就報ClassNotFound。搭建前先把版本邊界劃清楚能少踩一半坑。這套源碼基于的是經(jīng)典組合JDK 1.8、Maven 3.6.x、Tomcat 8.5或9.0、Spring 5.x、MyBatis 3.5.x。這個組合經(jīng)過大量項目驗證兼容性最穩(wěn)。組件推薦版本關(guān)鍵說明JDK1.8SSM經(jīng)典組合CGLIB代理和JSP編譯都最穩(wěn)Maven3.6.xIDEA 2021內(nèi)置Maven 3建議用自帶的減少配置干擾Tomcat8.5 / 9.08.5以下不支持Servlet 4.09.0和javax.servlet命名兼容Spring5.2.x / 5.3.x5.3以下更穩(wěn)避免Lombok和JDK編譯器的邊際問題MyBatis3.5.x3.5以上才支持mapperLocations通配符的規(guī)范寫法MySQL驅(qū)動8.0.xdriverClassName和URL都要換成cj前綴后面細說為什么不推薦JDK 11以上因為IDEA 2021里Tomcat 8.5默認的運行參數(shù)還是基于JDK 8的高版本JDK會有模塊化限制比如java.xml.bind模塊缺失這類問題對新手來說排查成本太高。JDK 1.8 Tomcat 8.5這套組合雖然“老”但企業(yè)里存量項目大量還在用學(xué)它不吃虧。2.2 新建Maven Web工程的兩種姿勢IDEA 2021里新建Maven Web工程有兩條路。一條是用archetype-webapp骨架IDEA會自動生成一個標準的Web目錄結(jié)構(gòu)另一條是建立一個普通Maven工程然后手動在src/main下補出webapp目錄和WEB-INF/web.xml。我一般推薦第二條因為archetype-webapp生成的web.xml是2.3版本的DOCTYPE還是Sun的舊寫法要么手動替換要么得改servlet版本怎么看都繞路。直接建普通Maven工程再補目錄反而每一步都看得見。手動補目錄之后web.xml需要手動改成Servlet 4.0的規(guī)范寫法?xml version1.0 encodingUTF-8? web-app xmlnshttp://xmlns.jcp.org/xml/ns/javaee xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd version4.0 display-nameSSM Demo/display-name /web-app這里的重點是namespace從java.sun.com換成了xmlns.jcp.org這是Servlet 4.0之后的新規(guī)范。如果你用archetype-webapp骨架IDEA生成的是web-app_2_3.xsd的舊版頭啟動時Tomcat雖然能兼容但部分注解掃描行為會有差異。我一般會直接刪掉舊文件重新寫省得后面排查時懷疑人生。2.3 pom.xml依賴清單與scope邊界依賴配置是整個工程的基石。SSM的依賴不算多但每個依賴的scope和傳遞關(guān)系都有講究。下面這一組是能跑通的最小集合properties spring.version5.3.9/spring.version mybatis.version3.5.7/mybatis.version mysql.version8.0.26/mysql.version /properties dependencies !-- Spring核心 -- dependency groupIdorg.springframework/groupId artifactIdspring-context/artifactId version${spring.version}/version /dependency !-- SpringMVC -- dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version${spring.version}/version /dependency !-- Spring JDBC - 事務(wù)管理依賴 -- dependency groupIdorg.springframework/groupId artifactIdspring-jdbc/artifactId version${spring.version}/version /dependency !-- MyBatis核心 -- dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId version${mybatis.version}/version /dependency !-- MyBatis與Spring橋接 -- dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version2.0.6/version /dependency !-- MySQL 8驅(qū)動 -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version${mysql.version}/version scoperuntime/scope /dependency !-- Servlet API編譯期需要運行時容器提供 -- dependency groupIdjavax.servlet/groupId artifactIdjavax.servlet-api/artifactId version4.0.1/version scopeprovided/scope /dependency !-- JSTLJSP頁面里用c:forEach時依賴 -- dependency groupIdjavax.servlet/groupId artifactIdjstl/artifactId version1.2/version /dependency /dependencies這里有一個新手最容易犯的錯誤javax.servlet-api的scope必須寫成provided意思是編譯和測試時用最終打包不進去因為Tomcat自己帶了Servlet容器實現(xiàn)。如果寫成默認的compile打包出的war會把servlet-api也塞進去和Tomcat自帶的沖突輕則報警告重則啟動時方法簽名對不上。mysql-connector-java用runtime就夠因為代碼里不直接引用驅(qū)動類只在運行期通過DriverManager加載。另外spring-jdbc這個依賴很多人會漏掉。搭建SSM時事務(wù)管理器用的是DataSourceTransactionManager這個類在spring-jdbc里只引spring-context和spring-webmvc是不夠的。我第一次搭的時候就是漏了這個Spring容器啟動報BeanDefinitionStoreException找了半天才想起來事務(wù)相關(guān)類不歸spring-context管。3. Spring與SpringMVC容器分工請求是從哪一步真正進到Controller的3.1 web.xml里配置兩個容器SSM體系里有兩個Spring容器這是理解整套配置文件的關(guān)鍵。一個是ContextLoaderListener創(chuàng)建的根容器負責(zé)加載Service、Dao這些業(yè)務(wù)組件另一個是DispatcherServlet創(chuàng)建的SpringMVC子容器只負責(zé)Controller和Web層組件。兩個容器是父子關(guān)系子容器能看見父容器里的Bean但父容器看不見子容器的Bean。!-- 根容器加載applicationContext.xml -- context-param param-namecontextConfigLocation/param-name param-valueclasspath:applicationContext.xml/param-value /context-param listener listener-classorg.springframework.web.context.ContextLoaderListener/listener-class /listener !-- SpringMVC子容器 -- 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-mappingdispatcher的url-pattern這里是單個斜杠表示除了JSP之外的所有請求都交給SpringMVC處理。load-on-startup設(shè)為1意思是Tomcat啟動時立即初始化這個Servlet而不是等第一個請求進來再初始化。如果不寫這一行第一次訪問頁面會明顯卡頓因為DispatcherServlet的初始化動作被推遲到了運行時。邏輯說明ApplicationContext.xml是根容器spring-mvc.xml是子容器。DispatcherServlet啟動時先檢查有沒有已存在的根容器有就把它設(shè)為自己的父容器。這樣Controller里注入Service時Spring會先在子容器找找不到再從父容器里取。3.2 根容器配置只掃Service和Dao?xml version1.0 encodingUTF-8? beans xmlnshttp://www.springframework.org/schema/beans xmlns:contexthttp://www.springframework.org/schema/context xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://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 !-- 根容器掃描Service和Dao排除Controller -- context:component-scan base-packagecom.demo.ssm context:exclude-filter typeannotation expressionorg.springframework.stereotype.Controller/ /context:component-scan /beans這段配置的核心是exclude-filter。根容器把整個業(yè)務(wù)包都掃了但明確排除了標注Controller的類。為什么要排除如果根容器把Controller也注冊了SpringMVC子容器再掃一遍就會出現(xiàn)同一類型兩個Bean定義的情況某些AOP代理邏輯會變得非常詭異。另外如果根容器掃描了Controller而事務(wù)AOP切在Service上有時候會出現(xiàn)代理對象可見性異常。所以這個排除動作不是可有可無而是必須寫。3.3 子容器配置注解驅(qū)動、Controller掃描與靜態(tài)資源放行spring-mvc.xml是SpringMVC的核心也是這個框架里配置項最多的地方?xml version1.0 encodingUTF-8? beans xmlnshttp://www.springframework.org/schema/beans xmlns:contexthttp://www.springframework.org/schema/context xmlns:mvchttp://www.springframework.org/schema/mvc xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://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 !-- 子容器只掃描Controller -- context:component-scan base-packagecom.demo.ssm.controller/ !-- 開啟注解驅(qū)動ResponseBody、RequestBody等 -- mvc:annotation-driven/ !-- 靜態(tài)資源放行 -- mvc:default-servlet-handler/ !-- 視圖解析器 -- bean classorg.springframework.web.servlet.view.InternalResourceViewResolver property nameprefix value/WEB-INF/views// property namesuffix value.jsp/ /bean /beansmvc:annotation-driven/ 是這一節(jié)里最值錢的一行配置。它默認注冊了RequestMappingHandlerAdapter和RequestMappingHandlerMapping沒有它RequestMapping注解是不生效的。很多從舊教程抄代碼的人會漏掉這一行然后Controller無論如何都進不去。mvc:default-servlet-handler/ 的作用是把那些沒匹配到Controller的請求交給Tomcat默認的Servlet處理。因為DispatcherServlet攔截了/如果請求的是一個圖片或者靜態(tài)CSS文件而你沒有這個配置就會404。加了它SpringMVC在自身Handler映射找不到時自動放行給容器默認Servlet。視圖解析器里的prefix指向/WEB-INF/views/把JSP頁面放在WEB-INF下這是安全習(xí)慣。WEB-INF下的文件不能通過瀏覽器直接URL訪問必須由Controller轉(zhuǎn)發(fā)打開這樣可以防止有人繞過權(quán)限直接看JSP源碼。這里有一個經(jīng)典坑很多人把視圖解析器配成/和.jsp但如果請求路徑里有目錄層級比如/user/list視圖解析器會拼出/WEB-INF/views//user/list.jsp。路徑雙斜杠在Windows上沒問題Linux上Tomcat的某些版本會報404。我習(xí)慣在prefix末尾加/同時保證跳轉(zhuǎn)代碼里不要手寫前導(dǎo)斜杠的視圖名。4. 把MyBatis掛進Spring數(shù)據(jù)源、Mapper代理與事務(wù)三條線的拼裝順序4.1 數(shù)據(jù)源與連接池參數(shù)MyBatis本身不管數(shù)據(jù)庫連接它需要一個DataSource提供物理連接。SSM里最常見的搭配是Alibaba Druid連接池因為它帶監(jiān)控頁面參數(shù)語義也清楚。先把數(shù)據(jù)庫連接信息抽到外部properties文件里# jdbc.properties jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/ssm_demo?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalseallowPublicKeyRetrievaltrue jdbc.usernameroot jdbc.password123456jdbc.url這段有兩個參數(shù)值得展開說。serverTimezoneAsia/Shanghai是因為MySQL 8的時區(qū)默認是UTC不加這個Java里的日期和數(shù)據(jù)庫里的日期對不上差8個小時。allowPublicKeyRetrievaltrue是MySQL 8.0.4之后的驅(qū)動行為變化不使用SSL連接時如果沒有這個參數(shù)首次連接會報Public Key Retrieval is not allowed。這兩個參數(shù)是MySQL 8連接特有的坑用MySQL 5.x驅(qū)動根本不會遇到所以網(wǎng)上舊教程里沒有。在applicationContext.xml里加載這個properties并配置Druid數(shù)據(jù)源context:property-placeholder locationclasspath:jdbc.properties/ bean iddataSource classcom.alibaba.druid.pool.DruidDataSource init-methodinit destroy-methodclose property namedriverClassName value${jdbc.driver}/ property nameurl value${jdbc.url}/ property nameusername value${jdbc.username}/ property namepassword value${jdbc.password}/ /beancontext:property-placeholder負責(zé)把jdbc.properties里的鍵值對加載進Spring上下文之后用${}占位符引用。init-method和destroy-method分別指定連接池初始化和關(guān)閉時調(diào)用的方法。Druid自己維護了一組連接在Spring容器啟動時預(yù)創(chuàng)建部分連接銷毀時主動關(guān)閉避免連接泄漏。4.2 SqlSessionFactory與Mapper代理掃描MyBatis要接入Spring關(guān)鍵人物是SqlSessionFactoryBean。它替代了原生MyBatis里SqlSessionFactoryBuilder的工作把數(shù)據(jù)源和Mapper映射文件揉進同一個工廠里bean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean property namedataSource refdataSource/ property nametypeAliasesPackage valuecom.demo.ssm.pojo/ property namemapperLocations valueclasspath:mapper/*.xml/ /bean bean classorg.mybatis.spring.mapper.MapperScannerConfigurer property namebasePackage valuecom.demo.ssm.dao/ property namesqlSessionFactoryBeanName valuesqlSessionFactory/ /beantypeAliasesPackage配置了一個包路徑MyBatis會自動把這個包下的POJO類注冊為別名默認別名是類名的首字母小寫形式。這樣在Mapper XML文件里寫resultTypeUser就夠了不用寫全限定名。mapperLocations指向了classpath:mapper/目錄所有Mapper XML文件放這個目錄下。MapperScannerConfigurer是MyBatis-Spring橋接包里最精巧的設(shè)計。它掃描basePackage包下所有接口然后為每個接口生成一個動態(tài)代理對象注冊進Spring容器。這意味著你不需要自己寫Dao實現(xiàn)類。它還有一個細節(jié)就是用sqlSessionFactoryBeanName屬性而不是sqlSessionFactory的ref引用。如果用refSpring會因為Bean創(chuàng)建順序問題在某些場景下提前初始化sqlSessionFactory導(dǎo)致property-placeholder引用失效。用BeanName字符串延遲查找是官方推薦的做法也能避開啟動時序的玄學(xué)問題。4.3 事務(wù)管理的兩種落地方式SSM里事務(wù)管理的標準做法是聲明式事務(wù)把事務(wù)邊界和業(yè)務(wù)代碼解耦。有兩種配置路徑一種是tx:advice aop:config切面織入一種是直接在Service類或方法上打Transactional注解。我傾向于用aop:config切面方式因為事務(wù)規(guī)則集中在一處業(yè)務(wù)代碼里不需要滿屏注解bean idtransactionManager classorg.springframework.jdbc.datasource.DataSourceTransactionManager property namedataSource refdataSource/ /bean tx:advice idtxAdvice transaction-managertransactionManager tx:attributes tx:method nameget* read-onlytrue propagationSUPPORTS/ tx:method nameselect* read-onlytrue propagationSUPPORTS/ tx:method nameinsert* propagationREQUIRED/ tx:method nameupdate* propagationREQUIRED/ tx:method namedelete* propagationREQUIRED/ tx:method name* propagationREQUIRED/ /tx:attributes /tx:advice aop:config aop:pointcut idservicePointcut expressionexecution(* com.demo.ssm.service..*.*(..))/ aop:advisor advice-reftxAdvice pointcut-refservicePointcut/ /aop:configDataSourceTransactionManager需要注入同一個dataSource對象因為事務(wù)的核心是Connection綁定如果事務(wù)管理器和SessionFactory用的數(shù)據(jù)源不是同一個事務(wù)會靜默失效數(shù)據(jù)照常寫入但回滾不生效。這也是SSM里一個很隱蔽的坑。tx:method的配置規(guī)則是按方法名匹配。get和select開頭的方法設(shè)為read-onlytruepropagationSUPPORTS意思是已有事務(wù)就加入沒有就不開新事務(wù)。insert、update、delete用REQUIRED當前沒有事務(wù)就新建一個。aop:pointcut的expression表達式里com.demo.ssm.service...前兩個點代表service包下所有子包后一個*是方法名通配括號里的兩個點代表任意參數(shù)。這套表達式是AspectJ切點語法的基礎(chǔ)換包名時必須同步修改這里。5. 踩坑排查搭建SSM時最容易翻車的五個典型故障5.1 Controller配了注解還是404DispatcherServlet攔截路徑寫錯了現(xiàn)象Controller類加了Controller和RequestMapping啟動日志里能看到SpringMVC的RequestMappingHandlerMapping注冊了路徑但瀏覽器訪問時Tomcat返回404而且控制臺沒有任何報錯。原因看web.xml里的servlet-mapping十有八九寫成了/*。/*和/的區(qū)別在于/會交給SpringMVC處理但不會攔截JSP/*會攔截所有請求包括JSP的請求。當視圖解析器返回一個JSP路徑時請求會被DispatcherServlet再次攔截它找不到這個JSP對應(yīng)的Handler直接404。解決把servlet-mapping的url-pattern改回/。改完后請求流程變成Controller返回邏輯視圖名視圖解析器拼出物理路徑Tomcat直接處理JSP資源不再經(jīng)過DispatcherServlet。5.2 注解掃描范圍重疊導(dǎo)致MVC失效現(xiàn)象Controller里的ResponseBody返回JSON數(shù)據(jù)瀏覽器拿到的是中文亂碼或者干脆報406錯誤。還有一種表現(xiàn)是Controller方法正常執(zhí)行但所有RequestMapping都失效。原因有的教程會在applicationContext.xml里不加排除兩個容器都掃了Controller。根容器注冊的Controller使用的是根容器里的消息轉(zhuǎn)換器它沒有加載SpringMVC的注解驅(qū)動配置所以ResponseBody的工作不正常。這種“雙重注冊”問題特別難查因為系統(tǒng)不報錯只是行為不對。解決嚴格遵循第3章的配置邊界。根容器排除Controller子容器只掃Controller包。如果你發(fā)現(xiàn)項目里已經(jīng)有重疊掃描把applicationContext.xml里的component-scan補上exclude-filter重啟后重新測試。從那以后我每次新起工程都會檢查一遍兩個文件的掃描路徑這個習(xí)慣救過我好幾次。5.3 Mapper接口報綁定異常類型不匹配的經(jīng)典報錯現(xiàn)象項目啟動正常但第一次調(diào)用某個Mapper方法時拋出org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)提示某個接口找不到對應(yīng)的SQL語句。原因三層原因按頻率排序。第一Mapper接口和Mapper XML文件的namespace不匹配接口的全限定名和namespace必須完全一致少一個點都不行。第二Mapper XML文件沒有放在mapperLocations指定目錄下很多新手把UserMapper.xml放在java源碼目錄里打包后目標目錄下根本沒有這個文件。第三Mapper接口里的方法名和XML里statement的id對不上。解決先確認applicationContext.xml里mapperLocations的路徑是classpath:mapper/*.xml然后檢查target/classes/mapper目錄下有沒有對應(yīng)的xml文件。如果文件不在去pom.xml里的build配置里看是否排除了resources目錄下的xml。IDEA里Maven默認不打包src/main/java下的xml所以一個穩(wěn)妥做法是把Mapper XML放在src/main/resources/mapper目錄下而不是和接口放一起。namespace、id、接口名三項逐一比對這個檢查習(xí)慣我從那以后一直保留著。5.4 本地啟動正常部署后報ClassNotFound現(xiàn)象IDEA里跑Tomcat一切正常但把war包丟到獨立部署目錄里啟動報NoClassDefFoundError或者某個類找不到。原因IDEA里運行項目時它用的是自己合成Artifacts會把編譯輸出目錄和依賴jar包都加入classpath。但如果你打包war時IDEA的Artifacts輸出布局里沒有正確包含所有l(wèi)ib那么部署后就會缺依賴。我自己遇到過Druid和mybatis-spring兩個jar包莫名缺失的情況因為Artifacts的Output Layout里lib目錄只手動加了一部分依賴。解決在Project Structure里找到Artifacts選中war exploded打開Output Layout查看WEB-INF/lib下是否所有依賴都在。通常做法是選中Available Elements里的所有jar包右鍵Put into /WEB-INF/lib。避免這個問題的方法是不要手動管理lib而是讓IDEA自動把所有依賴都打包進去盡量別在pom里使用system scope的本地jar這類依賴IDEA有時不會自動加入war。5.5 MySQL 8.0連接失敗驅(qū)動類名與URL參數(shù)換了現(xiàn)象啟動時Druid連接池報錯Caused by: java.sql.SQLException: Unable to load authentication plugin caching_sha2_password或者Access denied for user。原因MySQL 8.0的默認認證插件是caching_sha2_password而MySQL 5.x時代的驅(qū)動和連接方式都不認。很多人還在用5.1.46版本的驅(qū)動類com.mysql.jdbc.Driver這款驅(qū)動和8.0服務(wù)端握手時會崩。另外就是之前提到的serverTimezone參數(shù)缺失會報時區(qū)異常。解決把驅(qū)動類換成com.mysql.cj.jdbc.DriverMySQL Connector版本升到8.0.x。URL里加上serverTimezoneAsia/Shanghai和useSSLfalse。如果認證還報錯檢查allowPublicKeyRetrievaltrue是否加上這是客戶端首次連接時獲取RSA公鑰的開關(guān)。這五個參數(shù)是MySQL 8連接的標準配置組合少了任何一個都會在特定環(huán)境下翻車。6. 把SSM骨架沉淀成腳手架改包名、抽參數(shù)、留文檔三件套搭建完一次SSM工程之后最有價值的產(chǎn)出不是跑通的Demo而是一套能反復(fù)使用的骨架。我一般的做法是把這套源碼整理成腳手架目錄下次開新項目時直接復(fù)制過去然后做三件事改包名、抽參數(shù)、補充項目說明。改包名這一步很多人用IDE的重構(gòu)功能但IDEA對全包名替換有時會漏resources目錄下的配置。我習(xí)慣寫一個簡單的bash腳本把java目錄、resources目錄里所有出現(xiàn)舊包名的地方一次性替換#!/bin/bash # 用法: ./replace-package.sh 舊包名.路徑 新包名.路徑 項目根目錄 OLD_PKG$1 NEW_PKG$2 ROOT$3 # 把包名中的點轉(zhuǎn)換為路徑斜杠 OLD_PATH$(echo $OLD_PKG | tr . /) NEW_PATH$(echo $NEW_PKG | tr . /) # 遍歷java與resources目錄下所有文件 find $ROOT/src -type f \( -name *.java -o -name *.xml -o -name *.properties \) | while read FILE; do # 先替換文本內(nèi)容 sed -i s/$OLD_PKG/$NEW_PKG/g $FILE # 再處理目錄結(jié)構(gòu) DIR$(dirname $FILE) if echo $DIR | grep -q $OLD_PATH; then NEW_DIR$(echo $DIR | sed s|$OLD_PATH|$NEW_PATH|g) mkdir -p $NEW_DIR mv $FILE $NEW_DIR/ fi done echo 包名替換完成請檢查git diff確認改動范圍邏輯說明這個腳本先處理文件內(nèi)容里的全限定名再把文件移動到新路徑對應(yīng)的目錄里。關(guān)鍵點是內(nèi)容替換和目錄移動必須順序執(zhí)行如果先移動目錄find的路徑會失效。參數(shù)說明第一個參數(shù)是舊包名第二個是新包名第三個是項目根目錄。如果包名出現(xiàn)在JSP頁面的page import標簽里這個腳本覆蓋不到需要手動補一遍。抽參數(shù)這件事更有價值。把多個配置文件里反復(fù)出現(xiàn)的值統(tǒng)一抽到properties里比如數(shù)據(jù)庫地址、上傳路徑、日志級別。下次切換環(huán)境時只需要改一個文件。預(yù)留一份參數(shù)對照表在項目根目錄寫清楚每個配置項在哪個文件里生效這是我被環(huán)境切換折磨過幾次后形成的習(xí)慣。比如Druid的initialSize、maxActive這些參數(shù)不同環(huán)境有不同的最優(yōu)值沒有對照表就等于黑匣子。從那以后我每次開新工程都強制走一遍“復(fù)制骨架、替換包名、跑通冒煙接口”這三步不跑通不許往下寫業(yè)務(wù)。某個同事曾經(jīng)跳過第一步直接改包名結(jié)果配置文件里的Mapper掃描路徑全部失效花了整整一個下午排查。這個過程讓我養(yǎng)成了凡事先把地基打牢的習(xí)慣希望幫到你。本文還有配套的精品資源點擊獲取