本文主題解釋模塊為什么能互相使用以及 Maven、Spring 和公共接口分別承擔(dān)什么職責(zé)適合讀者剛接觸 Maven 多模塊、Spring 依賴注入和模塊化單體架構(gòu)的 Java 開發(fā)者代碼基線當(dāng)前學(xué)習(xí)分支源碼快照上一篇從零讀懂 AI 智能客服后端架構(gòu)模塊職責(zé)與 SSE 聊天鏈路下一篇AI 智能客服為什么不能照搬傳統(tǒng)三層架構(gòu)CRUD 與 AI 編排分層對(duì)比這里是yurenpai27屆開發(fā)者主要學(xué)習(xí) Java 后端與 AI 應(yīng)用開發(fā)。這里記錄真實(shí)項(xiàng)目中的代碼調(diào)用鏈、Agent/RAG 工程化、問(wèn)題排查和開發(fā)復(fù)盤。個(gè)人理念模塊之間能否協(xié)作不能只看目錄位置必須同時(shí)追蹤構(gòu)建依賴和運(yùn)行時(shí)裝配。寫在前面先說(shuō)結(jié)論兩個(gè)模塊放在同一個(gè)倉(cāng)庫(kù)里并不代表它們可以直接互相調(diào)用。真正決定模塊協(xié)作的是三層機(jī)制Maven 負(fù)責(zé)建立編譯依賴Spring 負(fù)責(zé)發(fā)現(xiàn)并注入運(yùn)行時(shí) Bean公共接口負(fù)責(zé)控制依賴方向、避免業(yè)務(wù)模塊形成循環(huán)依賴。本文會(huì)以“聊天模塊調(diào)用工作流、工作流反向使用聊天能力”為貫穿案例重點(diǎn)講清父子關(guān)系、聚合關(guān)系和依賴關(guān)系有什么區(qū)別admin為什么能夠把多個(gè)業(yè)務(wù)模塊裝進(jìn)同一個(gè)應(yīng)用接口放在公共模塊中為什么能避免chat ? aiflow的循環(huán)依賴如何用 POM、import、接口實(shí)現(xiàn)和啟動(dòng)模塊反向驗(yàn)證一次跨模塊調(diào)用。說(shuō)明本文以當(dāng)前項(xiàng)目源碼為例重點(diǎn)解釋模塊協(xié)作方法不同項(xiàng)目的模塊名稱可能不同但分析步驟可以復(fù)用。代碼說(shuō)明除明確標(biāo)注為完整源碼外文中的 POM、Java 代碼和目錄片段均為根據(jù)當(dāng)前源碼整理的簡(jiǎn)化示意文中的“已核對(duì)”表示完成靜態(tài)源碼核對(duì)不等同于啟動(dòng)或接口測(cè)試通過(guò)。一、為什么要拆成這么多模塊假設(shè)不拆模塊把所有代碼都放在一個(gè)項(xiàng)目中src/main/java/com/tst/pharma/ ├─ 用戶管理 ├─ 權(quán)限管理 ├─ 聊天 ├─ 知識(shí)庫(kù) ├─ 工作流 ├─ AI 流程 ├─ Redis ├─ SSE ├─ 短信 ├─ 文件上傳 ├─ Excel └─ 定時(shí)任務(wù)時(shí)間長(zhǎng)了會(huì)出現(xiàn)幾個(gè)問(wèn)題1. 所有代碼混在一起不知道屬于哪個(gè)業(yè)務(wù) 2. 一個(gè)聊天模塊也能隨便依賴用戶、短信、工作流內(nèi)部實(shí)現(xiàn) 3. 公共工具被復(fù)制多份 4. 修改一個(gè)模塊容易影響其他模塊 5. Maven 依賴越來(lái)越混亂 6. 新人很難判斷代碼應(yīng)該放在哪里 7. 無(wú)法控制模塊之間的依賴方向。所以項(xiàng)目進(jìn)行了兩次拆分。第一次按大職責(zé)拆分tst-pharma-admin ├─ 應(yīng)用啟動(dòng)和組裝 tst-pharma-common ├─ 公共基礎(chǔ)能力 tst-pharma-modules ├─ 具體業(yè)務(wù)模塊 tst-pharma-extend └─ 獨(dú)立擴(kuò)展服務(wù)第二次在每個(gè)大模塊內(nèi)部繼續(xù)拆分例如公共能力拆成tst-pharma-common-core tst-pharma-common-web tst-pharma-common-redis tst-pharma-common-sse tst-pharma-common-mybatis tst-pharma-common-satoken業(yè)務(wù)能力拆成tst-pharma-system tst-pharma-chat tst-pharma-workflow tst-pharma-aiflow tst-pharma-generator這樣就可以做到聊天模塊需要 SSE → 只依賴 common-sse 聊天模塊需要 Web 能力 → 只依賴 common-web 聊天模塊不需要短信 → 就不必直接依賴 common-sms這就是“模塊化”的主要意義不是為了把目錄弄多而是為了劃分職責(zé)、復(fù)用能力并控制依賴。二、先區(qū)分三個(gè)容易混淆的概念項(xiàng)目中有三種關(guān)系一定要區(qū)分。1. 父子關(guān)系例如子模塊的pom.xml中parentgroupIdcom.tst.pharma/groupIdartifactIdtst-pharma-main-backend/artifactIdversion${revision}/version/parent它表示子模塊繼承父工程的版本號(hào) 依賴版本管理 Maven 插件 Java 版本 構(gòu)建配置但是繼承父 POM不代表父模塊能夠直接使用子模塊的 Java 類。2. 聚合關(guān)系根pom.xml中modulesmoduletst-pharma-admin/modulemoduletst-pharma-common/modulemoduletst-pharma-extend/modulemoduletst-pharma-modules/module/modules它表示在根目錄執(zhí)行 Maven 構(gòu)建時(shí) → Maven 會(huì)一起構(gòu)建這些模塊但是被根 POM 聚合也不等于模塊之間能夠互相調(diào)用。例如tst-pharma-chat tst-pharma-workflow雖然都被根項(xiàng)目聚合但如果chat/pom.xml沒(méi)有依賴workflow那么chat不能直接隨意導(dǎo)入workflow的類。3. 依賴關(guān)系真正決定一個(gè)模塊能否使用另一個(gè)模塊 Java 類的是dependencygroupIdcom.tst.pharma/groupIdartifactId被依賴模塊/artifactId/dependency例如tst-pharma-chat/pom.xml中有dependencygroupIdcom.tst.pharma/groupIdartifactIdtst-pharma-common-chat/artifactId/dependencydependencygroupIdcom.tst.pharma/groupIdartifactIdtst-pharma-common-sse/artifactId/dependency所以聊天模塊才能使用importcom.tst.pharma.common.chat.domain.dto.request.ChatRequest;importcom.tst.pharma.common.sse.core.SseEmitterManager;可以記成聚合關(guān)系 └─ 決定一起構(gòu)建 父子關(guān)系 └─ 決定繼承統(tǒng)一配置 依賴關(guān)系 └─ 決定是否能使用另一個(gè)模塊的代碼小魚點(diǎn)睛父子關(guān)系統(tǒng)一配置聚合關(guān)系決定一起構(gòu)建依賴關(guān)系決定能否使用對(duì)方的 Java 類。兩個(gè)目錄即使緊挨在一起也不會(huì)自動(dòng)產(chǎn)生代碼依賴。三、項(xiàng)目真實(shí)的模塊依賴方向整個(gè)項(xiàng)目可以簡(jiǎn)化成tst-pharma-admin 主應(yīng)用啟動(dòng)和組裝 │ ┌───────────────────┼────────────────────┐ │ │ │ ▼ ▼ ▼ tst-pharma-system tst-pharma-chat tst-pharma-workflow 系統(tǒng)管理業(yè)務(wù) AI聊天與知識(shí)庫(kù) 傳統(tǒng)業(yè)務(wù)流程 │ ▼ tst-pharma-aiflow AI流程編排 上述業(yè)務(wù)模塊繼續(xù)依賴 tst-pharma-common-* 公共基礎(chǔ)組件更準(zhǔn)確地說(shuō)admin直接依賴tst-pharma-system tst-pharma-generator tst-pharma-chat tst-pharma-workflow tst-pharma-aiflow因此最終啟動(dòng)admin時(shí)這些業(yè)務(wù)模塊都會(huì)進(jìn)入主應(yīng)用。四、admin是怎么把所有業(yè)務(wù)模塊裝進(jìn)來(lái)的文件D:\Tools\java\aiwork\tst-pharma-main-backend\tst-pharma-admin\pom.xml它聲明了admin ├─ 依賴 system ├─ 依賴 generator ├─ 依賴 chat ├─ 依賴 workflow └─ 依賴 aiflow構(gòu)建主應(yīng)用時(shí)Maven 會(huì)把這些模塊的編譯產(chǎn)物和依賴一起放進(jìn)最終應(yīng)用?？梢詫⒆罱K運(yùn)行的應(yīng)用理解成tst-pharma-admin.jar ├─ admin 自己的類 ├─ system 模塊的類 ├─ chat 模塊的類 ├─ workflow 模塊的類 ├─ aiflow 模塊的類 ├─ generator 模塊的類 └─ 它們所依賴的 common 類因此運(yùn)行時(shí)主要是一個(gè) JVM 進(jìn)程 一個(gè) Spring 容器 一個(gè)后端端口 6039而不是system 啟一個(gè)端口 chat 啟一個(gè)端口 workflow 啟一個(gè)端口 aiflow 再啟一個(gè)端口所以當(dāng)前主體架構(gòu)屬于模塊化單體應(yīng)用不是微服務(wù)架構(gòu)。五、公共模塊是怎么被業(yè)務(wù)模塊使用的例子一聊天模塊使用 SSEChatServiceFacade中privatefinalSseEmitterManagersseEmitterManager;SseEmitterManager不在聊天模塊而在tst-pharma-common-sse聊天模塊的pom.xml聲明了dependencygroupIdcom.tst.pharma/groupIdartifactIdtst-pharma-common-sse/artifactId/dependency完整關(guān)系是tst-pharma-chat │ │ Maven 依賴 ▼ tst-pharma-common-sse │ ├─ SseEmitterManager ├─ SseMessageUtils ├─ SseEventDto └─ SSE 自動(dòng)配置于是聊天模塊才能建立 SSE 發(fā)送 content 發(fā)送 done 發(fā)送 error 關(guān)閉 SSE例子二聊天模塊使用登錄認(rèn)證聊天代碼中使用LoginHelper.getUserId(); StpUtil.getTokenValue();這涉及common-satoken common-redis Sa-Token依賴鏈不一定都由聊天模塊直接聲明也可以通過(guò)依賴傳遞獲得。簡(jiǎn)化理解tst-pharma-chat ↓ common-chat / common-sse / common-web ↓ common-satoken ↓ common-redis ↓ Redis所以一個(gè)模塊不一定需要把所有底層依賴都重新聲明一遍。例子三系統(tǒng)模塊使用 MyBatisSysConfigMapperpublicinterfaceSysConfigMapperextendsBaseMapperPlusSysConfig,SysConfigVo{}其中BaseMapperPlus位于tst-pharma-common-mybatis關(guān)系為tst-pharma-system │ ▼ tst-pharma-common-mybatis │ ▼ MyBatis-Plus │ ▼ MySQL因此system模塊不需要自己再實(shí)現(xiàn)一套分頁(yè)、Mapper 基類和數(shù)據(jù)庫(kù)配置。六、模塊之間不僅靠 Maven還靠 Spring 連接Maven 解決的是編譯時(shí)能不能看到另一個(gè)模塊的類Spring 解決的是程序啟動(dòng)后具體使用哪個(gè)實(shí)現(xiàn)對(duì)象啟動(dòng)類D:\Tools\java\aiwork\tst-pharma-main-backend\tst-pharma-admin\src\main\java\com\tst\pharma\TstPharmaApplication.java位于根包packagecom.tst.pharma;并且有SpringBootApplicationSpring 默認(rèn)會(huì)從啟動(dòng)類所在包向下掃描com.tst.pharma ├─ controller ├─ service ├─ config ├─ factory ├─ workflow └─ ...即使類分別位于不同 Maven 模塊中只要最后都被admin引入并且包名屬于com.tst.pharma...Spring 就能發(fā)現(xiàn)它們。例如chat 模塊 └─ ChatController └─ Controller chat 模塊 └─ ChatServiceFacade └─ Service aiflow 模塊 └─ WorkflowStarter └─ Spring Bean common-sse 模塊 └─ SSE 自動(dòng)配置 └─ 注冊(cè) SseEmitterManager它們最后都在同一個(gè) Spring 容器中。七、Spring 依賴注入是怎么跨模塊工作的例如ChatController中privatefinalChatServiceFacadechatService;因?yàn)轭惿嫌蠷equiredArgsConstructorLombok 會(huì)生成類似構(gòu)造器publicChatController(ChatServiceFacadechatService){this.chatServicechatService;}Spring 啟動(dòng)時(shí)發(fā)現(xiàn)ChatController 需要 ChatServiceFacade然后又發(fā)現(xiàn)ServicepublicclassChatServiceFacade{}于是完成注入Spring 容器 ├─ 創(chuàng)建 ChatServiceFacade ├─ 創(chuàng)建 ChatController └─ 把 ChatServiceFacade 放進(jìn) ChatController雖然它們處在不同目錄甚至不同 Maven 模塊也不影響運(yùn)行時(shí)注入只要滿足1. admin 的 Maven 依賴把兩個(gè)模塊裝進(jìn)來(lái)了 2. Spring 掃描到了對(duì)應(yīng)類 3. 類注冊(cè)成了 Bean 4. 依賴類型能夠匹配。小魚點(diǎn)睛Maven 只解決“編譯時(shí)能不能看見接口和類”真正把接口字段連接到實(shí)現(xiàn)對(duì)象的是 Spring 容器。只有編譯依賴、Bean 掃描和類型匹配同時(shí)成立跨模塊注入才會(huì)成功。八、項(xiàng)目中最典型的跨模塊設(shè)計(jì)common-chat接口橋梁這一部分很重要因?yàn)樗忉屃薱hat和aiflow為什么可以互相協(xié)作但沒(méi)有在 POM 中直接互相依賴。先看結(jié)構(gòu)tst-pharma-common-chat ├─ IChatService ├─ IChatModelService └─ IWorkFlowStarterService它們只是接口和公共協(xié)議不包含具體業(yè)務(wù)實(shí)現(xiàn)。聊天服務(wù)接口位于tst-pharma-common-chat └─ IChatService具體實(shí)現(xiàn)位于聊天模塊ServicepublicclassChatServiceFacadeimplementsIChatService{}關(guān)系common-chat └─ 定義 IChatService chat └─ ChatServiceFacade 實(shí)現(xiàn) IChatService工作流啟動(dòng)接口位于tst-pharma-common-chat └─ IWorkFlowStarterService具體實(shí)現(xiàn)位于 AI 流程模塊publicclassWorkflowStarterimplementsIWorkFlowStarterService{}關(guān)系common-chat └─ 定義 IWorkFlowStarterService aiflow └─ WorkflowStarter 實(shí)現(xiàn) IWorkFlowStarterServicechat 調(diào)用 aiflowChatServiceFacade中不是直接依賴某個(gè)aiflow內(nèi)部類而是privatefinalIWorkFlowStarterServiceworkFlowStarterService;流程是ChatServiceFacade │ │ 只認(rèn)識(shí)公共接口 ▼ IWorkFlowStarterService ▲ │ 由 Spring 在運(yùn)行時(shí)尋找實(shí)現(xiàn) │ WorkflowStarter這樣chat模塊在編譯時(shí)不需要直接依賴aiflow。aiflow 調(diào)用 chataiflow的WorkflowUtil中使用privateIChatServicechatService;privateIChatModelServicechatModelService;流程WorkflowUtil │ │ 只依賴公共接口 ▼ IChatService ▲ │ Spring 注入實(shí)現(xiàn) │ ChatServiceFacade所以整體是common-chat 公共接口和公共請(qǐng)求對(duì)象 ▲ ▲ │ │ chat aiflow 實(shí)現(xiàn)聊天接口 實(shí)現(xiàn)流程接口這叫通過(guò)公共契約解耦業(yè)務(wù)模塊。小魚點(diǎn)睛把接口下沉到雙方都能依賴的公共模塊目的不只是“集中存放公共類”而是反轉(zhuǎn)依賴方向業(yè)務(wù)模塊面向穩(wěn)定契約協(xié)作避免chat和aiflow在 POM 中相互咬住。九、為什么接口要放在common-chat而不是直接放在chat如果IChatService放在tst-pharma-chat那么aiflow為了調(diào)用它就必須aiflow → 依賴 chat同時(shí)聊天模塊為了啟動(dòng) AI 工作流可能又需要chat → 依賴 aiflow最后形成chat → aiflow ↑ ↓ └───────┘這就是 Maven 循環(huán)依賴。Maven 無(wú)法正常處理這樣的模塊關(guān)系。當(dāng)前項(xiàng)目把接口放進(jìn)公共模塊后變成chat ──────→ common-chat aiflow ────→ common-chat然后由admin同時(shí)引入admin ├─ chat └─ aiflow運(yùn)行時(shí)再由 Spring 把實(shí)現(xiàn)連接起來(lái)。這個(gè)設(shè)計(jì)可以理解為插座common-chat └─ 規(guī)定插座形狀 chat └─ 提供一種插頭 aiflow └─ 提供或使用另一種插頭 Spring └─ 啟動(dòng)時(shí)把兼容的插頭插到插座上十、admin是最終的組裝者這個(gè)項(xiàng)目中真正知道“我要同時(shí)加載哪些業(yè)務(wù)模塊”的是tst-pharma-admin它的pom.xml相當(dāng)于組裝清單主應(yīng)用需要 ├─ system ├─ generator ├─ chat ├─ workflow └─ aiflow因此可以這樣理解common └─ 制造公共零件 modules ├─ 制造用戶系統(tǒng) ├─ 制造聊天系統(tǒng) ├─ 制造業(yè)務(wù)工作流 └─ 制造 AI 工作流 admin └─ 把所有零件和業(yè)務(wù)模塊裝成完整應(yīng)用十一、數(shù)據(jù)庫(kù) Mapper 又是怎么跨模塊加載的配置位于D:\Tools\java\aiwork\tst-pharma-main-backend\tst-pharma-admin\src\main\resources\application.yml其中配置了mybatis-plus:mapperPackage:com.tst.pharma.**.mappermapperLocations:classpath*:mapper/**/*Mapper.xmltypeAliasesPackage:com.tst.pharma.**.domainMyBatis 配置類使用MapperScan(${mybatis-plus.mapperPackage})意思是掃描所有模塊中符合下面規(guī)則的 Mappercom.tst.pharma.任意內(nèi)容.mapper例如system 模塊 └─ com.tst.pharma.system.mapper.SysConfigMapper chat 模塊 └─ com.tst.pharma.mapper.ChatMessageMapper workflow 模塊 └─ 對(duì)應(yīng)的 mapperclasspath*:也表示不只查當(dāng)前模塊還會(huì)查依賴 JAR 中的 Mapper XML。所以啟動(dòng)一個(gè)admin能夠把多個(gè)業(yè)務(wù)模塊中的 Mapper 全部注冊(cè)到同一個(gè) MyBatis/Spring 容器。十二、配置文件如何影響所有模塊主要運(yùn)行配置集中在tst-pharma-admin\src\main\resources\application.yml tst-pharma-admin\src\main\resources\application-dev.yml這里配置端口 數(shù)據(jù)庫(kù) Redis MyBatis Sa-Token 多租戶 日志 SSE 上傳目錄雖然配置文件在admin但 Spring 啟動(dòng)后創(chuàng)建的是一個(gè)統(tǒng)一環(huán)境。因此system 模塊可以使用數(shù)據(jù)源 chat 模塊可以使用數(shù)據(jù)源 workflow 模塊可以使用 Redis common-sse 可以讀取 SSE 配置 common-satoken 可以讀取認(rèn)證配置它們不需要各自維護(hù)一套application.yml。可以理解成admin application.yml │ ▼ Spring Environment ├─ system 使用 ├─ chat 使用 ├─ workflow 使用 ├─ aiflow 使用 └─ common 組件使用十三、數(shù)據(jù)庫(kù)和 Redis 也是模塊之間的公共基礎(chǔ)設(shè)施當(dāng)前主要業(yè)務(wù)模塊運(yùn)行在同一個(gè)應(yīng)用中并共享MySQL Redis 登錄狀態(tài) 租戶上下文 事務(wù)管理器 SSE 連接管理例如一次聊天請(qǐng)求可能發(fā)生chat 模塊 ├─ 從 chat_model 表查詢模型配置 ├─ 從 chat_message 表查詢歷史消息 ├─ 從 knowledge_info 表查詢知識(shí)庫(kù)配置 ├─ 使用 Redis/登錄上下文獲取認(rèn)證信息 └─ 使用 SSE 向當(dāng)前用戶發(fā)送結(jié)果但要注意共享同一個(gè)數(shù)據(jù)庫(kù)不代表模塊應(yīng)該隨意直接修改其他模塊的表。正常情況下應(yīng)優(yōu)先模塊 A → 調(diào)用公共接口 → 模塊 B 的 Service → 模塊 B 的 Mapper → 模塊 B 負(fù)責(zé)自己的表而不是模塊 A → 直接拿模塊 B 的 Mapper → 隨意修改模塊 B 的表否則模塊邊界會(huì)再次被破壞。十四、用聊天請(qǐng)求看模塊之間如何真正協(xié)作一次POST /chat/send背后會(huì)經(jīng)過(guò)很多模塊?？蛻舳苏?qǐng)求 │ ▼ common-web / common-satoken ├─ Web 請(qǐng)求處理 ├─ 登錄認(rèn)證 └─ 用戶上下文 │ ▼ tst-pharma-chat ├─ ChatController ├─ ChatServiceFacade ├─ 場(chǎng)景分類 └─ 模型調(diào)用 │ ├──────────────┐ ▼ ▼ common-sse common-chat SSE連接和事件 公共請(qǐng)求對(duì)象和接口 │ │ │ ├─────────────┐ │ ▼ ▼ │ aiflow chat實(shí)現(xiàn) │ AI流程啟動(dòng) 模型聊天實(shí)現(xiàn) │ ▼ 瀏覽器逐段接收回復(fù)如果是普通聊天ChatController → ChatServiceFacade → ChatModelService → ChatServiceFactory → 模型供應(yīng)商實(shí)現(xiàn) → LangChain4j → 外部模型接口 → common-sse → 前端如果是 AI 工作流ChatController → ChatServiceFacade → IWorkFlowStarterService → aiflow 中的 WorkflowStarter → AI 工作流節(jié)點(diǎn)執(zhí)行 → 需要模型時(shí)調(diào)用 IChatService → chat 中的 ChatServiceFacade → 模型這就是多個(gè)模塊之間的真實(shí)協(xié)作。十五、extend為什么沒(méi)有被直接裝進(jìn)admin根 POM 聚合了tst-pharma-extend所以執(zhí)行根 Maven 構(gòu)建時(shí)會(huì)一起構(gòu)建monitor-admin snailjob-server但是admin/pom.xml沒(méi)有把它們作為主業(yè)務(wù)依賴引入。這說(shuō)明根 POM 聚合它們 ≠ admin 運(yùn)行時(shí)包含它們它們更可能是獨(dú)立啟動(dòng)的擴(kuò)展服務(wù)主后端 └─ tst-pharma-admin 監(jiān)控服務(wù) └─ tst-pharma-monitor-admin 任務(wù)調(diào)度服務(wù) └─ tst-pharma-snailjob-server所以再次強(qiáng)調(diào)聚合 └─ 一起構(gòu)建 依賴 └─ 編譯和運(yùn)行時(shí)使用十六、當(dāng)前項(xiàng)目的核心模塊關(guān)系圖可以先保存這張圖tst-pharma-main-backend │ ├─ tst-pharma-common │ ├─ common-core │ │ └─ 最底層公共對(duì)象、異常、工具 │ │ │ ├─ common-redis │ │ └─ 依賴 common-core │ │ │ ├─ common-satoken │ │ └─ 依賴 common-core、common-redis │ │ │ ├─ common-mybatis │ │ └─ 依賴 common-core、common-satoken │ │ │ ├─ common-sse │ │ └─ 依賴 core、redis、satoken、json │ │ │ ├─ common-web │ │ └─ Web 公共能力 │ │ │ └─ common-chat │ ├─ 依賴 core │ ├─ 依賴 sse │ ├─ 依賴 mybatis │ └─ 定義聊天、模型、工作流公共接口 │ ├─ tst-pharma-modules │ ├─ system │ │ └─ 依賴 MyBatis、Web、認(rèn)證、租戶等公共模塊 │ │ │ ├─ chat │ │ ├─ 依賴 common-chat │ │ ├─ 依賴 common-sse │ │ ├─ 依賴 common-web │ │ └─ 實(shí)現(xiàn) IChatService、IChatModelService │ │ │ ├─ aiflow │ │ ├─ 依賴 common-chat │ │ ├─ 使用 IChatService │ │ └─ 實(shí)現(xiàn) IWorkFlowStarterService │ │ │ ├─ workflow │ │ └─ 依賴 MyBatis、Web、租戶、認(rèn)證等公共模塊 │ │ │ └─ generator │ └─ 依賴 MyBatis、Web、文檔、日志等公共模塊 │ ├─ tst-pharma-admin │ ├─ 引入 system │ ├─ 引入 chat │ ├─ 引入 workflow │ ├─ 引入 aiflow │ ├─ 引入 generator │ └─ 啟動(dòng)一個(gè)完整 Spring Boot 應(yīng)用 │ └─ tst-pharma-extend ├─ monitor-admin └─ snailjob-server十七、判斷“兩個(gè)模塊怎么關(guān)聯(lián)”的固定方法以后看到兩個(gè)模塊不要憑目錄名猜可以按下面五步確認(rèn)。第一步看調(diào)用模塊的pom.xml例如想知道chat能不能使用common-sse打開 tst-pharma-chat/pom.xml 搜索 tst-pharma-common-sse如果有依賴說(shuō)明編譯時(shí)可見。第二步看 Javaimport例如importcom.tst.pharma.common.sse.core.SseEmitterManager;說(shuō)明代碼確實(shí)使用了該模塊的類。第三步看字段注入類型例如privatefinalIWorkFlowStarterServiceworkFlowStarterService;說(shuō)明當(dāng)前類依賴的是接口。第四步查誰(shuí)實(shí)現(xiàn)接口搜索implements IWorkFlowStarterService找到aiflow → WorkflowStarter第五步確認(rèn)最終啟動(dòng)模塊是否同時(shí)引入雙方查看tst-pharma-admin/pom.xml確認(rèn)同時(shí)依賴chat aiflow這樣 Spring 運(yùn)行時(shí)才有機(jī)會(huì)把它們連接起來(lái)。十八、核心結(jié)論結(jié)論一目錄相鄰 ≠ 有依賴關(guān)系真正的編譯依賴看pom.xml 中的 dependency結(jié)論二根 POM 中有 module ≠ 該模塊被裝進(jìn)主應(yīng)用它可能只是一起構(gòu)建。結(jié)論三admin 是主應(yīng)用組裝者它把system、chat、workflow、aiflow、generator放進(jìn)同一個(gè) Spring Boot 應(yīng)用。結(jié)論四common 提供公共能力和公共接口 modules 提供具體業(yè)務(wù)實(shí)現(xiàn)結(jié)論五模塊之間推薦通過(guò)公共接口 Spring 依賴注入進(jìn)行協(xié)作而不是互相直接依賴內(nèi)部實(shí)現(xiàn)。結(jié)論六當(dāng)前主體不是微服務(wù)而是模塊化單體 ├─ 編譯時(shí)分模塊 ├─ 代碼職責(zé)分模塊 └─ 運(yùn)行時(shí)主要在同一個(gè) Spring Boot 進(jìn)程最典型的真實(shí)關(guān)系就是ChatServiceFacade │ │ 實(shí)現(xiàn) ▼ IChatServicecommon-chat ▲ │ 使用 │ WorkflowUtilaiflow以及反方向WorkflowStarteraiflow │ │ 實(shí)現(xiàn) ▼ IWorkFlowStarterServicecommon-chat ▲ │ 使用 │ ChatServiceFacadechat它們由admin同時(shí)組裝再由 Spring 在運(yùn)行時(shí)連接。這個(gè)例子基本涵蓋了整個(gè)項(xiàng)目模塊化設(shè)計(jì)的核心。總結(jié)本文圍繞“解釋模塊為什么能互相使用以及 Maven、Spring 和公共接口分別承擔(dān)什么職責(zé)”主要分析了父子、聚合和依賴三種 Maven 關(guān)系的邊界啟動(dòng)模塊如何完成業(yè)務(wù)模塊的最終組裝Spring 如何跨 JAR 掃描 Bean 并按接口注入實(shí)現(xiàn)公共接口橋梁如何控制依賴方向并避免循環(huán)依賴整個(gè)過(guò)程可以概括為根 POM 聚合 → 子模塊聲明依賴 → Java 使用公共接口 → Spring 掃描實(shí)現(xiàn)類 → admin 統(tǒng)一裝配 → 運(yùn)行時(shí)完成調(diào)用Maven 解決“編譯時(shí)能不能看見”Spring 解決“運(yùn)行時(shí)由誰(shuí)來(lái)實(shí)現(xiàn)”公共接口解決“依賴應(yīng)該朝哪個(gè)方向”。三者缺一不可。當(dāng)前進(jìn)度[OK] 已經(jīng)完成已完成主要模塊 POM 依賴方向的靜態(tài)核對(duì)已通過(guò)接口定義、實(shí)現(xiàn)類和啟動(dòng)模塊還原聊天模塊與工作流模塊的協(xié)作關(guān)系[TODO] 后續(xù)繼續(xù)下一篇對(duì)比普通 CRUD 分層與 AI 對(duì)話編排分層繼續(xù)結(jié)合真實(shí)請(qǐng)求理解模塊協(xié)作在運(yùn)行時(shí)如何落到方法調(diào)用小魚點(diǎn)睛Maven 解決“編譯時(shí)能不能看見”Spring 解決“運(yùn)行時(shí)由誰(shuí)來(lái)實(shí)現(xiàn)”公共接口解決“依賴應(yīng)該朝哪個(gè)方向”。三者缺一不可。下一篇下一篇將繼續(xù)分析“AI 智能客服為什么不能照搬傳統(tǒng)三層架構(gòu)CRUD 與 AI 編排分層對(duì)比”把本文建立的結(jié)構(gòu)認(rèn)知繼續(xù)落到具體代碼和對(duì)象流上。這篇文章是我在真實(shí)項(xiàng)目學(xué)習(xí)過(guò)程中的階段性記錄。不同項(xiàng)目的命名和目錄可能不同但判斷職責(zé)邊界、依賴方向和數(shù)據(jù)生命周期的方法可以復(fù)用。如果內(nèi)容中還有遺漏歡迎一起交流。