# Java Web自研框架18年架构决策复盘（系列文）
Java Web自研框架18年架构决策复盘（系列文总纲）
非科班野生程序员，深耕政务信息化20年，这套自研Java Web框架支撑过省级新农保、全国首例跨省医保结算等核心民生系统，18年稳定运行至今。本系列拆解10个核心架构决策，全是政务场景踩坑后的实用解法，不求优雅但求落地，愿同赛道朋友少走弯路，也欢迎懂行大佬轻拍指正。最后感谢豆包、智谱、OpenCode，决策是我做的，代码是我搓的，文字是他们总结的。
作者：许彰午（xuzhangwu）
我不是科班出身的专门搞架构的，2001年从VC开始写代码，2003年转PB/SQL，2007年开始接触Java，从那之后开始自己从零搭一套 Java Web 框架，从Servlet到数据库，每一层都是自己写的。这个框架跑了十几年，还在用。
我的不是教程，是我对自己这套框架的架构决策的复盘。每一个决策背后都有一个真实的业务问题。
系列文目录
### 系列文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 任意流转 | 不能改变框架时就找到"洞"绕过去 |
一句话：做到实时有据，修改即刻可查。
不追求架构漂亮，不追求技术先进，只追求——出了问题我能从代码快速定位到业务，业务人员能快速进入查到数据。
这个框架没有 Spring 的依赖注入，没有 MyBatis-Plus 的包装，但这是它的一个优点：每一行代码我都能说清来龙去脉，任何问题我都能从入口一步步追踪到数据库。
如果这些文章对你有启发，欢迎点赞收藏评论。如果写得不对，也请指正。毕竟是自己的框架，难免有个人偏见，欢迎在评论区讨论。
系列导航：
- [系列文1：为什么放弃成熟的Spring，我偏要手写轻量IOC容器？]
- [系列文2：新老代码共存的终极解法——注解路由+参数路由平滑迁移]
- [系列文3：前后端彻底解耦！统一入参解析，前端只发JSON，后端随意]
- [系列文4：轻量AOP落地！CGLIB代理+责任链，搞定事务日志监控]
- [系列文5：解决Java编译痛点！ASM字节码直读，100%获取方法参数名]
- [系列文6：ThreadLocal上下文管理，让业务层彻底告别HttpServletRequest]
- [系列文7：零侵入提升查询性能！MongoDB混合存储，不用Redis也能抗]
- [系列文8：改MyBatis源码1行，搞定Oracle物理分页，避开硬解析大坑]
- [系列文9：政务报表自由！Excel模板驱动，业务人员改格式，开发零参与]
- [系列文10：突破Activiti限制！政务工作流任意流转，支持跳退回退]
作者：许彰午| 非科班野生程序员，深耕政务信息化20年
标签：#Java #自研框架 #IOC #AOP #MyBatis #MongoDB #Activiti #政务信息化 #架构设计 #技术复盘