0. 总纲｜Java Web 自研框架 18 年Java架构决策复盘

优质文章学习记录

08 Apr 2026 — 7 min read

深耕政务信息化 20 年，自研 Java Web 框架支撑省级新农保、全国首例跨省医保结算等核心民生系统，稳定运行 18 年。
本系列不讲空泛理论，只复盘真实生产环境下的架构决策、踩坑经历、落地方案，不求优雅，但求能跑、能扛、能维护。

在长期维护政务系统的过程中，我逐渐形成一套轻量、稳定、无侵入、可长期演进的架构思路。
这套框架没有依赖流行全家桶，而是围绕业务痛点一点点打磨，最终支撑了海量高并发、高可靠的民生业务。

本系列将从以下 10 个核心决策展开：

1. 放弃 Spring，手写轻量 IOC 容器

2. 注解路由 + 参数路由，实现新老代码平滑迁移

3. 统一入参解析，前后端彻底解耦

4. CGLIB + 责任链实现轻量 AOP，搞定事务、日志、监控

5. ASM 字节码直读，100% 获取方法参数名

6. ThreadLocal 上下文管理，业务层彻底告别 Http

7. MongoDB 混合存储，零侵入提升查询性能

8. 修改 MyBatis 源码 1 行，搞定 Oracle 物理分页

9. Excel 模板驱动政务报表，业务人员直接改格式

10. Activiti 工作流任意跳转、回退，满足政务灵活审批

所有内容均来自生产环境真实落地，可直接复用、可直接用于面试、可直接写进简历。

本文为 Java 政务企业级实战系列总纲，全系列共 10 篇，拆解 IOC、AOP、MongoDB、MyBatis、Activiti 工作流等政务开发核心技术。
收藏追更不迷路，评论区聊聊你在政务/企业开发中最头疼的架构问题！

系列文目录

### 系列文1：为什么放弃成熟的Spring，我偏要手写轻量IOC容器？

核心看点：三个自定义注解 @bean、@property、@responseMapping + 一个 BeanFactory，搞定实例化、注入、路由注册
适用场景：部署环境受限、依赖要求极简的政务系统

系列文2：新老代码共存的终极解法——注解路由+参数路由平滑迁移

核心看点：route.java 的 service() 方法里一套判断逻辑，先走注解路由，找不到再走老的 Business/Action 参数路由
适用场景：系统迭代升级，不能停机迁移

### 系列文3：前后端彻底解耦！统一入参解析，前端只发JSON，后端随意

核心看点：praserInParameter() 方法根据方法签名自动转换参数类型——DataCenter、Dao、List、HttpServletRequest 都能自动识别
适用场景：前端统一POST JSON，后端方法签名随意定义

### 系列文4：轻量AOP落地！CGLIB代理+责任链，搞定事务日志监控

核心看点：doProxy + proxyFilter + 责任链模式，@Trans、@Logger、@monitoring 注解即用
适用场景：横切关注点不侵入业务代码

### 系列文5：解决Java编译痛点！ASM字节码直读，100%获取方法参数名

核心看点：getMethodParameterNamesByAsm4() 用ASM直接读class文件字节码，从LocalVariableTable获取参数名
适用场景：编译时不加 -parameters 也能拿到真实参数名

### 系列文6：ThreadLocal上下文管理，让业务层彻底告别HttpServletRequest

核心看点：AppContextContainer 继承 ThreadLocal，在Servlet层绑定用户、连接等信息，业务层随时取用
适用场景：业务代码不依赖Servlet API

### 系列文7：零侵入提升查询性能！MongoDB混合存储，不用Redis也能抗

核心看点：Dao上配置 level 属性（1=双写、2=纯MongoDB+异步同步、3=纯关系库），DBUtil 自动路由
适用场景：不能引入Redis/MQ但又需要缓存层的政务系统

### 系列文8：改MyBatis源码1行，搞定Oracle物理分页，避开硬解析大坑

核心看点：PaginationInterceptor 用绑定变量 ? 做分页而非拼接SQL，配合 OracleDialect/MsSqlDialect 方言
适用场景：Oracle环境下分页SQL硬解析导致性能问题

### 系列文9：政务报表自由！Excel模板驱动，业务人员改格式，开发零参与

核心看点：doPrintView.java 一个Servlet通吃所有报表，Excel文件即模板，jxl读数据转PDF预览
适用场景：报表格式频繁变动，开发人员不想反复改代码

### 系列文10：突破Activiti限制！政务工作流任意流转，支持跳退回退

核心看点：turnTransition() 运行时动态修改流程定义的连线，跳转到任意节点，完成后恢复原状
适用场景：政务审批需要自由跳转、回退、转办的场景

框架全景图

┌─────────────────────────────────────────────────────────┐ │ 前端层 │ │ browise RIA 框架（基于 Dojo 封装） │ │ DataCenter / DataStore / JSON 序列化 │ └──────────────────────────┬──────────────────────────────┘ │ POST JSON │ ┌──────────────────────────▼──────────────────────────────┐ │ route.java（唯一Servlet） │ │ ┌──────────────┬──────────────┬──────────────┐ │ │ │ 登录校验 │ 路由分发 │ 异常处理 │ │ │ └──────────────┴──────────────┴──────────────┘ │ └──────────────────────────┬──────────────────────────────┘ │ ┌──────────────────────────▼──────────────────────────────┐ │ BeanFactory（IOC 容器） │ │ @bean 实例化 @property 注入 @aoppoint 代理 │ │ │ │ CGLIB 代理 + 责任链模式 │ │ @Trans 事务 @Logger 日志 @monitoring 监控 │ └──────────────────────────┬──────────────────────────────┘ │ ┌──────────────────────────▼──────────────────────────────┐ │ 业务层（@responseMapping 路由） │ │ Control → Service → Mapper（MyBatis） │ └──────────────────────────┬──────────────────────────────┘ │ ┌──────────────────────────▼──────────────────────────────┐ │ DBUtil（ORM 层） │ │ ┌──────────────┬──────────────┬──────────────┐ │ │ │ MyBatis │ MongoDB缓存 │ 通用查询 │ │ │ │ CRUD │ level 1/2/3 │ JDBC方式写文件│ │ │ └──────────────┴──────────────┴──────────────┘ │ │ ┌──────────────┬──────────────┐ │ │ │ SM4加解密 │ AWR报告解读 │ │ │ │ @myCode │ JVM监控 │ │ │ └──────────────┴──────────────┘ │ └──────────────────────────┬──────────────────────────────┘ │ ┌──────────────────────────▼──────────────────────────────┐ │ 数据库（Oracle / MongoDB） │ └─────────────────────────────────────────────────────────┘

十个决策的统一原则

决策	原则
自研 IOC	只加需要的不加不需要的
注解路由 + 参数兼容	不破坏老系统
统一入参解析	前后端解耦
CGLIB + AOP	加注解的方式
ASM 参数读取	自己的问题自己解决
ThreadLocal 上下文	业务层不依赖Servlet
MongoDB 混合存储	零侵入，渐进式采用
改 MyBatis 源码分页	第一天解决的事用了十几年
Excel 模板报表	用业务人员熟悉的工具
Activiti 任意流转	不能改变框架时就找到"洞"绕过去