架构视界
主页
企业架构
  • 方案总览
  • 业财一体
  • 企业中台
  • 组织与绩效
  • 流程治理
数据收集与分析
  • 转型总览
  • 信息化阶段
  • 数字化解决方案
  • 智数化解决方案
  • 智能化解决方案
  • 产品设计
  • 项目管理
全栈软件工程
AI 原生软件工程
方法论
博客
  • 资源导航
  • 效率工具
  • 展示专区
主页
企业架构
  • 方案总览
  • 业财一体
  • 企业中台
  • 组织与绩效
  • 流程治理
数据收集与分析
  • 转型总览
  • 信息化阶段
  • 数字化解决方案
  • 智数化解决方案
  • 智能化解决方案
  • 产品设计
  • 项目管理
全栈软件工程
AI 原生软件工程
方法论
博客
  • 资源导航
  • 效率工具
  • 展示专区
  • 标签索引
  • 2024年

    • 勇闯大A:美债与美元周期
    • 勇闯大A:交易纪律与自我管理
    • 勇闯大A:交易系统分层
    • 勇闯大A:买卖点与止损规则
    • 勇闯大A:债券与资金流向
    • 勇闯大A:微观、宏观与周期
    • Mac 开发环境:新机配置清单
    • 勇闯大A:内外盘与换手率
    • 会计管理:财报阅读与管理报表
    • 会计基础:记账原理与分录
    • 财务入门:财务体系全景
  • 2023年

    • 境外投资:泰国 BOI 申请实务
  • 2022年

    • 企业架构:故障管理与分级响应
    • 企业架构:技术债务的识别、度量与偿还
  • 2021年

    • Python 数据分析:员工分布可视化
    • Python 数据分析:IP 访问折线图
    • Python 数据分析:IP 词云图
    • Redis:RediSearch 全文检索
    • Rust 基础:第一个 CLI 程序
    • Rust 基础:所有权机制
    • Rust 基础:函数与控制流
    • Rust 基础:变量与数据类型
    • Rust 基础:入门与开发环境
    • 企业架构:分布式系统设计
    • 企业架构:编程式权限设计
    • JVM 调优:启动参数与 GC 日志
    • MyBatis 批量插入:三种写法对比
    • 测试:Spring Boot 分层 Mock
    • Redis:布隆过滤器判断元素存在
    • Jenkins:安装配置与应用部署
    • WebClient:非阻塞 HTTP 客户端
    • Drone:Docker 部署轻量 CI
    • Spring AOP:操作审计日志落库
    • Redisson:分布式锁与 RedLock
    • MyBatis 拦截器:雪花算法主键
    • Netty:线程模型与网络编程
    • Redis:SCAN 游标遍历大键空间
    • Jenkins:单机部署与升级脚本
    • Mac:Neo4j 与 Jupyter 安装
    • JavaFX:OpenJDK 11 环境配置
    • Mac:用 jenv 管理 JDK 版本
    • Redis:有序集合实现延时队列
    • Spring Boot 日志:MDC 串联链路
    • 定时任务:Spring 调度与 Cron
    • GoAccess:Nginx 日志分析
    • MyBatis 拦截器:慢 SQL 分析
    • Lucene:倒排索引与中文分词
    • 分布式锁:三种实现方案对比
    • 学习技巧:减少学习排斥心理
    • 动态数据源:多租户数据路由
    • Compose:Spring Boot 三件套
    • Java 阻塞队列:源码与用法
    • Redis:Docker Compose 哨兵
    • Redis:Docker Compose 主从
    • 网络通信:TCP/IP 与 HTTP 基础
  • 2020年

    • 延时队列:DelayQueue 与 Redis 实现
    • MySQL 基础:员工库导入实践
    • 雪花算法:分布式 ID 生成
    • Redis:地理位置查询
    • 抓包:Wireshark 与 Tcpdump
    • SPI:JDK 与 Spring 扩展机制
    • ZooKeeper:概念与集群搭建
    • Spring Boot:集成 JMH 基准测试
    • Wireshark:抓包工具入门
    • Compose:Redis 与 MySQL
    • CentOS 7:Docker 安装部署
    • Netty:源码阅读环境搭建
    • MySQL 基础:SQL 常见用法
    • CentOS 7:Selenium 运行环境
    • Nginx:HTTPS 证书配置
    • JMH:基准测试与 Spring Boot 集成
    • Spring Boot:指定 Tomcat 版本
    • Eureka:实例上下线告警
    • 钉钉告警:应用异常与实例上下线
    • JVM:内存布局、类加载与调优
    • Git:rebase 合并多次提交
    • CentOS 7:OpenResty 部署
  • 2019年

    • Redis CLI:macOS 安装与使用
    • Nginx:访问日志格式
    • 工程规范:可维护代码的写法
    • IntelliJ IDEA:常用插件
    • SkyWalking:源码阅读环境搭建
    • Spring Boot:Redis 超时配置
    • gRPC:ProtoBuf 定义与代码生成
    • Arthas:Java 线上问题诊断
    • Redis:缓存穿透与击穿防护
    • Docker 部署:Elasticsearch
    • Docker 部署:MySQL 5.7 单机
    • Spring Redis:字符串命令封装
    • Docker 部署:ZooKeeper 运行
    • Docker 部署:Redis 单机运行
    • Dubbo:Spring Boot 微服务集成
    • CentOS 7:CMake 源码编译安装
    • 性能度量:吞吐量与 QPS 指标
    • Java 递归:从笔试题到经典问题
    • CentOS 7:ELK 日志平台部署
    • CentOS 7:SonarQube 部署
    • Selenium:Chrome 浏览器自动化
    • JJWT:令牌生成与解析测试
    • Spring 源码:阅读环境搭建
    • JUnit 4:注解、断言与参数化
    • JWT:令牌结构与签名机制
    • FastDFS:架构与文件存取机制
    • XPath:XML 文档节点定位
    • Redis 基础:锁、队列与事务
    • Redis 基础:数据类型与命令
    • MyBatis:Slf4j 日志接入
    • MyBatis:H2 单元测试与 SQL 日志
    • 源码阅读:开源项目环境搭建
    • Git 配置:命令清单与作用域
    • Java 核心:面向对象与基础类型
    • Java 核心:关键字、异常与反射
    • Java 核心:多线程基础
    • Java 核心:同步关键字与线程池
    • Java 核心:锁与并发工具
    • Java 核心:语言基础与并发
    • Dubbo:远程调用与服务治理
    • Java 集合:框架总览与实现对比
    • Maven:生命周期与常用命令
    • MyBatis:执行流程与插件机制
    • Spring:IoC 容器与依赖注入
    • Spring:AOP 与自动装配
    • Spring:事务与启动流程
    • Spring:IoC、AOP 与事务
    • Spring MVC:请求分发与注解
    • MySQL:架构与索引
    • MySQL:事务、锁与 MVCC
    • MySQL:日志与 SQL 优化
    • MySQL:架构、事务与优化
    • Redis 基础:持久化与线程模型
  • 2018年

    • Java HashMap:扩容机制与哈希冲突
    • Java 集合:HashSet 去重原理
    • Java 基础:交换两个变量的值
    • Spring MVC:零 web.xml 改造
    • Mac 开发环境:新机配置清单
    • Log4j:日志分级与按业务拆分
    • Modbus:工业通信协议与 RTU 帧
    • MySQL 基础:子查询与连接查询
    • MySQL 基础:库与表操作
    • MySQL 基础:表操作与查询
    • MySQL 基础:约束、引擎与数据类型
    • MySQL 基础:库表、约束与类型
    • Java 集合:Vector 与 Stack
    • Java 集合:Vector 与 Stack
    • RabbitMQ:CentOS 7 单机部署
    • Redis:CentOS 7 单机部署
    • MongoDB:CentOS 7 单机部署
    • Linux:常用系统与运维命令
    • 注册中心:Eureka 与 ZooKeeper
    • MySQL:CentOS 7 单机部署
    • Git 分支:主分支与临时分支
    • CentOS 7:Java 开发环境部署
    • Java 集合:LinkedList 双向链表
    • Java 集合:ArrayList 动态数组
    • Spring AOP:注解方式实现切面
← 返回博客

源码阅读:开源项目环境搭建

2019年2月26日 #后端开发 #MyBatis

读源码前先搭好能编译、能断点的环境。这里记录 MyBatis、Spring、SkyWalking、Netty 四个项目的准备过程,步骤基本一致:选发行版 tag、克隆镜像、先构建一次、再看目录结构。

通用步骤

  1. 选一个稳定的发行版 tag,而不是默认分支。
  2. GitHub 拉取慢时,用 Gitee 镜像;保持 tag 一致。
  3. 先执行一次构建或预编译任务,让依赖下载完整,再导入 IDE。
  4. 从目录职责入手,先建立模块地图,再进入具体实现。

MyBatis 3.5.0

下载源代码

  • 代码仓库地址:https://github.com/mybatis/mybatis-3.git
  • 阅读版本号:mybatis-3.5.0
  • 官方仓库拉取:git clone -b mybatis-3.5.0 https://github.com/mybatis/mybatis-3.git
  • GitHub 下载较慢时,可用 Gitee 镜像:git clone -b mybatis-3.5.0 https://gitee.com/Z201/mybatis-3.git

查看源代码结构

项目主要目录:

tree -d -L 2
.
├── src
│   ├── main # 源代码
│   ├── site # 站点文档
│   └── test # 单元测试
└── travis   # 官方的 CI 集成

源码主目录:

tree -d src/main -L 5
src/main
└── java
    └── org
        └── apache
            └── ibatis
                ├── annotations # 注解
                ├── binding     # 代理
                ├── builder     # 构造
                ├── cache       # 缓存
                ├── cursor      # 返回值类型为游标的方法
                ├── datasource  # 数据源
                ├── exceptions  # 异常
                ├── executor    # 数据操作具体执行
                ├── io          # 文件流
                ├── jdbc        # jdbc 模块
                ├── lang        # 工具
                ├── logging     # 日志
                ├── mapping     # 映射、参数、结果集
                ├── parsing     # 解析器
                ├── plugin      # 插件
                ├── reflection  # 反射
                ├── scripting   # SQL 解析
                ├── session     # 接口层会话
                ├── transaction # 事务
                └── type        # 类型

导入 IDEA 后即可看到完整源码。

快速入门

  • 官方文档:http://www.mybatis.org/mybatis-3/zh/getting-started.html
  • 建议先照着文档跑通一个最小示例,再回头阅读 builder 解析与 executor 执行链路。

Spring 5.1.5.RELEASE

下载源代码

  • 代码仓库地址:https://gitee.com/Z201/spring-framework.git
  • 阅读版本号:v5.1.5.RELEASE
  • 官方仓库拉取:git clone -b v5.1.5.RELEASE https://github.com/spring-projects/spring-framework.git
  • 官方导入说明:import-into-idea

预编译

Spring 模块很多,导入 IDEA 前先单独编译 spring-oxm 的测试代码,触发 Gradle 下载与依赖准备:

➜  spring-framework git:(master) ./gradlew :spring-oxm:compileTestJava

Downloading https://services.gradle.org/distributions/gradle-4.10.3-bin.zip
..........................................................................

Welcome to Gradle 4.10.3!

Here are the highlights of this release:
 - Incremental Java compilation by default
 - Periodic Gradle caches cleanup
 - Gradle Kotlin DSL 1.0-RC6
 - Nested included builds
 - SNAPSHOT plugin versions in the `plugins {}` block

For more details see https://docs.gradle.org/4.10.3/release-notes.html

Starting a Gradle Daemon (subsequent builds will be faster)

> Task :spring-beans:compileTestJava
注: 某些输入文件使用或覆盖了已过时的 API。
注: 有关详细信息, 请使用 -Xlint:deprecation 重新编译。
注: 某些输入文件使用了未经检查或不安全的操作。
注: 有关详细信息, 请使用 -Xlint:unchecked 重新编译。

> Task :spring-context:compileTestJava
注: 某些输入文件使用或覆盖了已过时的 API。
注: 有关详细信息, 请使用 -Xlint:deprecation 重新编译。
注: 某些输入文件使用了未经检查或不安全的操作。
注: 有关详细信息, 请使用 -Xlint:unchecked 重新编译。

> Task :spring-oxm:genJaxb
[ant:javac] : warning: 'includeantruntime' was not set, defaulting to build.sysclasspath=last; set to false for repeatable builds

BUILD SUCCESSFUL in 9m 18s
58 actionable tasks: 58 executed
➜  spring-framework git:(master)

出现 BUILD SUCCESSFUL 说明构建通过。项目模块较多,这里不再逐个展开,导入 IDE 后按需阅读即可。

SkyWalking v6.0.0-GA

下载源代码

  • 代码仓库地址:https://gitee.com/Z201/skywalking.git
  • 阅读版本号:v6.0.0-GA
  • 官方仓库拉取:git clone -b v6.0.0-GA https://github.com/apache/skywalking.git
  • GitHub 下载较慢时,可用 Gitee 镜像:git clone -b v6.0.0-GA https://gitee.com/Z201/skywalking.git

查看源代码结构

源码子项目较多,先看两级目录:

➜  skywalking git:(8b638258b) tree -d -L 1
.
├── apm-application-toolkit
├── apm-checkstyle
├── apm-commons
├── apm-dist
├── apm-protocol # proto 文件
├── apm-sniffer # 插件
├── apm-webapp
├── docker
├── docs
├── licenses
├── oap-server # 与 5.x 相比改动较大
├── skywalking-ui
└── tools

子模块初始化

SkyWalking 用 submodule 管理协议与 UI,导入前必须先初始化,否则缺文件无法构建:

➜  skywalking git:(8b638258b) git submodule init
Submodule 'apm-protocol/apm-network/src/main/proto' (https://github.com/apache/incubator-skywalking-data-collect-protocol.git) registered for path 'apm-protocol/apm-network/src/main/proto'
Submodule 'oap-server/server-query-plugin/query-graphql-plugin/src/main/resources/query-protocol' (https://github.com/apache/incubator-skywalking-query-protocol.git) registered for path 'oap-server/server-query-plugin/query-graphql-plugin/src/main/resources/query-protocol'
Submodule 'skywalking-ui' (https://github.com/apache/incubator-skywalking-ui) registered for path 'skywalking-ui'
➜  skywalking git:(8b638258b) git submodule update
Cloning into '/Users/qingfeng/word/source-code/skywalking/apm-protocol/apm-network/src/main/proto'...
Cloning into '/Users/qingfeng/word/source-code/skywalking/oap-server/server-query-plugin/query-graphql-plugin/src/main/resources/query-protocol'...
Cloning into '/Users/qingfeng/word/source-code/skywalking/skywalking-ui'...
Submodule path 'apm-protocol/apm-network/src/main/proto': checked out 'b66fa070fd647662f06497e4ed3657eb258cb6e9'
Submodule path 'oap-server/server-query-plugin/query-graphql-plugin/src/main/resources/query-protocol': checked out 'c65a23bd6b9bba8d1df30d4de261624952df2b7b'
Submodule path 'skywalking-ui': checked out 'c44642f73b9f73a54b0d716cade5094304e1a67b'

构建时跳过测试:

mvn clean package -DskipTests

v6.0.0-GA 约有 120 个子项目,首次构建耗时较长,完成后导入 IDEA 即可。

Netty 4.1.33.Final

下载源代码

  • 阅读版本号:netty-4.1.33.Final
  • GitHub 下载较慢时,可用 Gitee 镜像:git clone -b netty-4.1.33.Final git@gitee.com:Z201/netty.git

构建准备

macOS 上需要先补编译依赖:

brew install autoconf automake libtool
# 如果安装了国内镜像出现 Error opening archive: Failed to open
# export HOMEBREW_BOTTLE_DOMAIN=''
# 如果是 macOS,需要手动把 pom 中的 tcnative.classifier 改成对应系统
mvn install -Dmaven.test.skip=true

查看源代码结构

tree -d -L 1
├── all
├── bom
├── buffer (Core,Netty 定制的 buffer)
├── codec (Protocol Support)
├── codec-dns (Protocol Support)
├── codec-haproxy (Protocol Support)
├── codec-http (Protocol Support)
├── codec-http2 (Protocol Support)
├── codec-memcache (Protocol Support)
├── codec-mqtt (Protocol Support,物联网)
├── codec-redis (Protocol Support)
├── codec-smtp (Protocol Support,邮件)
├── codec-socks (Protocol Support)
├── codec-stomp (Protocol Support,WebSocket)
├── codec-xml (Protocol Support)
├── common (Core)
├── dev-tools
├── docker
├── example (抄代码的地方)
├── handler (Protocol Support)
├── handler-proxy (Protocol Support)
├── license
├── microbench (测试用)
├── resolver (Core)
├── resolver-dns (Core)
├── tarball
├── target
├── testsuite
├── testsuite-autobahn
├── testsuite-http2
├── testsuite-osgi
├── testsuite-shading
├── transport (Transport Services)
├── transport-native-epoll (Transport Services,native 省略,Java 保留字)
├── transport-native-kqueue (Transport Services,native 省略,Java 保留字)
├── transport-native-unix-common (Transport Services,native 省略,Java 保留字)
├── transport-native-unix-common-tests
├── transport-rxtx (Transport Services,串口编程,已作废)
├── transport-sctp (Transport Services)
└── transport-udt (Transport Services,已作废)

官方文档与模块职责

  • 官方文档:https://netty.io/wiki/index.html

Core:

  • netty-common 是核心基础包,其他模块都依赖它,包含通用工具类与自定义并发包。
  • netty-buffer 提供 Netty 自己实现的 ByteBuf,作为网络通信的数据载体。
  • netty-resolver 提供 IP 地址、主机名、DNS 等基础设施解析工具。

Protocol Support:

  • netty-codec 负责编解码,覆盖主流协议,并提供 ByteToMessageDecoder 与 MessageToByteEncoder 两个抽象类,继承它们即可实现自定义编解码。

Transport Service:

  • netty-transport 是数据处理与传输的核心模块,包含 Bootstrap、Channel、ChannelHandler、EventLoop、EventLoopGroup、ChannelPipeline 等。
  • Bootstrap 负责客户端或服务端启动,包括创建与初始化 Channel;EventLoop 向注册的 Channel 发起 I/O 读写;ChannelPipeline 负责 ChannelHandler 的有序编排。

小结

四个项目都按「选发行版 tag、克隆镜像、先构建再导入」的顺序准备:MyBatis 从 builder 到 executor 读执行链路,Spring 先跑 spring-oxm 的 Gradle 任务,SkyWalking 必须先初始化 submodule,Netty 装好 autoconf 与 libtool 后从 common、buffer、transport 切入。

最近更新: 2026/11/20 22:30
Contributors: 庆峰
Prev
MyBatis:H2 单元测试与 SQL 日志
Next
Git 配置:命令清单与作用域