学习 on Howe's Blog

ZFile学习笔记——启动！

Sat, 07 Jun 2025 14:02:08 +0800

项目介绍

ZFile 是一个适用于个人或小团队的在线网盘程序，可以将多种存储类型统一管理，再也不用登录各种网站管理文件，现在你只需要在 ZFile 中畅快使用！——GitHub README

我第一次见到这个项目是在折腾LG手机刷机的时候发现的，有人用它托管刷机包。后来我自己把它部署到服务器上试了一下，发现可以很方便的挂载OneDrive，并且可以直接生成下载链接。

最近在学习Java项目，但是网上找到的学习项目都是玩具项目(黑马全家桶、各种知识星球项目)，他们很多都存在功能简陋、代码不规范、没有完善的配套前端等等问题……最重要的是项目的需求和功能都是虚拟的，根本没有实际意义。于是想到了之前用过的ZFile恰好就是用Java开发的，并且复杂程度貌似并不高🤨(我猜的)，用来学习实际的Java项目岂不是完美？

ZFile使用的技术

把项目从GitHub上克隆下来后我首先查看了maven的配置文件pom.xml，从中可以查看该项目所使用到的技术。

1. SpringBoot与Java版本

<parent>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-parent</artifactId>
  <version>3.3.2</version>
  <relativePath/> <!-- 不要去本地找父 POM，而是直接去仓库下载它 -->
</parent>
...
<java.version>21</java.version>
<maven.compiler.source>21</maven.compiler.source>
<maven.compiler.target>21</maven.compiler.target>

使用Spring Boot 3.3.2作为基础框架并使用Java 21，表明这个项目的技术是比较新的。

2.依赖

依赖分为几大类，反映了项目的功能模块和技术栈：

Spring Boot相关

spring-boot-starter-web: 提供Web开发支持，用于构建RESTful API或Web应用。
spring-boot-starter-aop: 支持面向切面编程（AOP），用于日志、事务等横切关注点。
spring-boot-configuration-processor: 生成配置元数据，支持Spring Boot的自动配置。
spring-boot-starter-data-redis: Redis支持，可能用于缓存或会话管理。
spring-boot-starter-cache: 提供缓存支持，可能与Redis结合使用。
spring-boot-starter-thymeleaf: Thymeleaf模板引擎，用于服务端渲染HTML页面。
spring-boot-starter-validation: Hibernate Validator，用于参数校验。

数据库相关

mysql-connector-j: MySQL数据库驱动（运行时依赖）。
sqlite-jdbc: SQLite数据库驱动，支持轻量级数据库。
flyway-core, flyway-mysql: Flyway数据库迁移工具（版本10.12.0），用于数据库版本管理和Schema迁移。
mybatis-plus-spring-boot3-starter: MyBatis-Plus（版本3.5.6），增强型ORM框架，简化数据库操作。

存储策略相关

upyun java-sdk: 又拍云存储SDK。
software.amazon.awssdk:s3: AWS S3存储支持。
qiniu-java-sdk: 七牛云存储SDK。
jsch: SSH/SFTP支持，可能用于文件传输。
sardine: WebDAV协议支持。
google-api-client: Google API客户端，可能用于Google Drive等存储服务。

认证/权限

sa-token-spring-boot3-starter: Sa-Token（版本1.38.0），轻量级认证授权框架，可能用于用户登录、权限管理和会话控制。

API文档

knife4j-openapi3-jakarta-spring-boot-starter: Knife4j（版本4.5.0），基于OpenAPI 3的API文档生成工具，提供交互式API文档。

工具类

hutool-all: Hutool工具库，提供丰富的Java工具方法。
poi-ooxml: Apache POI，用于处理Excel、Word等Office文档。
commons-compress: 文件压缩/解压支持。
lombok: 简化Java代码（如自动生成Getter/Setter）。
commons-net: 网络工具库，支持FTP、Telnet等协议。
okhttp: HTTP客户端，用于网络请求。
fastjson2: JSON处理库，性能优异。
guava: Google Guava工具库，提供集合、缓存等功能。
mapstruct: 对象映射工具，简化DTO与实体转换。
commons-chain: 责任链模式实现。
totp: 时间戳一次性密码（TOTP），可能用于双因素认证。
jcommander: 命令行参数解析。
json: JSON处理库。
httpclient5, httpmime: Apache HttpClient，支持HTTP请求和文件上传。
bcprov-jdk15on: Bouncy Castle加密库，支持加密操作。
spring-retry: Spring重试机制，处理失败重试逻辑。
commons-fileupload: 文件上传支持。
dns-cache-manipulator: DNS缓存操作，可能用于优化网络请求。
oshi-core: 系统监控库，用于获取系统资源信息。

GraalVM支持

graal-sdk: GraalVM SDK（版本24.1.0，provided scope），用于支持GraalVM原生镜像编译。

构建配置（）

插件
- spring-boot-maven-plugin: Spring Boot构建插件，支持打包可执行JAR。
- maven-compiler-plugin: 配置Java 21编译，启用MapStruct、Lombok等注解处理器。
- flyway-maven-plugin: Flyway数据库迁移插件，用于执行数据库迁移任务。
Profiles
- 使用 native-maven-plugin（GraalVM构建工具）。
- 配置了特定的JVM参数和构建参数（如-march=compatibility, AddAllCharsets等）。
- 启用了自定义的AOT（Ahead-of-Time）特性，包括Lambda、加密（Bouncy Castle）和SQLite支持。
- 项目支持GraalVM原生编译，以提高启动性能和降低内存占用。

ZFile的功能

在深入ZFile的源码之前我打算先把它的基本功能搞清楚，然后按照不同的功能模块分别去细致地学习代码实现。

计算机中的数字

Wed, 27 Jul 2022 00:00:00 +0000

计算机中的数字是如何表示的

由于计算机所使用的硬件特性，导致了在计算机的底层数字只能以二进制的形式进行表达。二进制和十进制一样，也是一种进位计数制，但是它的基数是 2。二进制表达式中 0 和 1 的位置不同，它所代表的数值也不同。例如，二进制数 0000 1010 表示十进制数 10。一个二进制数具有两个基本特点：两个不同的数字符号，即 0 和 1，逢二进一。

关于二进制的维基百科解释

无符号数

无符号数顾名思义就是单纯的数字，没有正负号也没有小数点，是非负整数。这一类型的数字表示起来最简单，只需用二进制的方式写出即可。

为了更加清楚的解释无符号数的表示方法CSAPP中介绍了一种图形化的表示方法来帮助读者理解无符号数的编码方式。

二进制数从右往左的第i位即表示为$2^{i-1}$，将不为0的项相加得到所表示的无符号数。

有符号数

在现实世界中，无符号数的局限性是相当大的，那么拥有正负号的数字该如何进行编码呢？

计算机中使用补码来表示有符号数，简单的来说就是在无符号数表示方法的基础上新增了一个符号位以表示正负。最高位若为0则表示正数，最高位若为1则表示负数。需要注意的是，符号位并不是单纯的表示数的正负性，它代表负权重的概念。

若一个有符号数的二进制形式如下：

那么它的十进制的计算方法为：

两个例子：

为了便于理解，补码也有对应的图形化表示方式：

其中蓝色代表正数，灰色代表负数，由图可知当最高位为1时得到的必定为负数。

数字的表示范围

无符号数的表示范围

对于无符号数，当字长为n时，其能表示的最大数为：$$1\times 2^{0} +1\times 2^{1} +\dots +1\times 2^{n-1} =2^{n} -1$$

字长为8到64的无符号数所能表示的范围图表：

有符号数的表示范围

有符号数与无符号数的区别在于其最高位充当符号位，所以只有n-1位能够表示数的大小。

所能表示的最大值为：$$1\times 2^{0} +1\times 2^{1} +\dots +1\times 2^{n-2} - 0\times 2^{n-1} =2^{n-1} -1$$

所能表示的最小值为：$$0\times 2^{0} +0\times 2^{1} +\dots +0\times 2^{n-2} - 1\times 2^{n-1} =-2^{n-1}$$

Git基础命令

Fri, 08 Apr 2022 00:00:00 +0000

获取 Git 仓库

通常有两种获取 Git 项目仓库的方式：

将尚未进行版本控制的本地目录转换为 Git 仓库；
从其它服务器克隆一个已存在的 Git 仓库。

两种方式都会在你的本地机器上得到一个工作就绪的 Git 仓库。

在已存在目录中初始化仓库

git init

该命令将创建一个名为 .git的子目录，这个子目录含有你初始化的 Git 仓库中所有的必须文件，这些文件是Git 仓库的骨干。但是，在这个时候，我们仅仅是做了一个初始化的操作，你的项目里的文件还没有被跟踪。

克隆现有的仓库

克隆仓库的命令是 git clone <url>。比如，要克隆 Git 的链接库libgit2，可以用下面的命令：

git clone https://github.com/libgit2/libgit2

这会在当前目录下创建一个名为libgit2的目录，并在这个目录下初始化一个 .git文件夹，从远程仓库拉取下所有数据放入 .git文件夹，然后从中读取最新版本的文件的拷贝。如果你进入到这个新建的 libgit2文件夹，你会发现所有的项目文件已经在里面了，准备就绪等待后续的开发和使用。

如果你想在克隆远程仓库的时候，自定义本地仓库的名字，你可以通过额外的参数指定新的目录名：

git clone https://github.com/libgit2/libgit2 mylibgit

这会执行与上一条命令相同的操作，但目标目录名变为了mylibgit。

记录每次更新到仓库

现在我们的机器上有了一个真实项目的 Git 仓库，并从这个仓库中检出了所有文件的工作副本。通常，你会对这些文件做些修改，每当完成了一个阶段的目标，想要将记录下它时，就将它提交到仓库。

请记住，你工作目录下的每一个文件都不外乎这两种状态：已跟踪(tracked)或未跟踪(untracked)。已跟踪的文件是指那些被纳入了版本控制的文件，在上一次快照中有它们的记录，在工作一段时间后，它们的状态可能是未修改，已修改或已放入暂存区。简而言之，已跟踪的文件就是 Git 已经知道的文件。

工作目录中除已跟踪文件外的其它所有文件都属于未跟踪文件，它们既不存在于上次快照的记录中，也没有被放入暂存区。初次克隆某个仓库的时候，工作目录中的所有文件都属于已跟踪文件，并处于未修改状态，因为 Git刚刚检出了它们，而你尚未编辑过它们。

编辑过某些文件之后，由于自上次提交后你对它们做了修改，Git 将它们标记为已修改文件。在工作时，你可以选择性地将这些修改过的文件放入暂存区，然后提交所有已暂存的修改，如此反复。

检查当前文件状态

可以用 git status命令查看哪些文件处于什么状态。如果在克隆仓库后立即使用此命令，会看到类似这样的输出：

$ git status 
On branch master
Your branch is up-to-date with 'origin/master'.
nothing to commit, working directory clean

跟踪新文件

使用命令git add开始跟踪一个文件。所以，要跟踪README文件，运行：

SQL语句笔记

Wed, 30 Mar 2022 00:00:00 +0000

本文所使用的数据库

//学生：学号S#, 姓名Sname, 性别Ssex, 年龄Sage, 所属系别D#，班级Sclass
Student (S# char(8),Sname char(10),Ssex char(2),Sage integer,D# char(2),Sclass char(6))

//院系：系别D#，系名Dname, 系主任Dean
Dept (D# char(2),Dname char(10),Dean char(10))

//课程：课号C#, 课名Cname, 教师编号T#,  学时Chours，学分Credit
Course (C# char(3),Cname char(12),Chours integer,Credit float(1),T# char(3))

//教师：教师编号T#，教师名Tname, 所属院系D#，工资Salary
Teacher (T# char(3),Tname char(10),D# char(2),Salary float(2))

//选课：学号S#, 课号C#, 成绩Score
SC (S# char(8),C# char(3),Score float(1))

建立数据库

定义数据库和表

创建Database

数据库(Database)是若干具有相互关联关系的Table/Relation的集合
数据库可以看作是一个集中存放若干Table的大型文件

创建数据库的简单语法形式：

create database 数据库名;

示例：创建课程学习数据库SCT

create database SCT;

创建Table

创建table简单语法形式：

Create table 表名(列名 数据类型[Primary key|Unique][Notnull][, 列名 数据类型[Primary key|Unique][Notnull] , ... ]) ;

“[ ] ”表示其括起的内容可以省略，“| ”表示其隔开的两项可取其一