该图片由Roshan Bhatia在Pixabay上发布
你好，我是看山。
本文收录在Java 进阶系列中。
工具的发明能够节省体力，同时也可以减少重复劳动，软件也是工具的一种。今天要说的是，引用 IT 技术，减少大量文件重命名这种重复的劳动。
一直在用的存储云盘是百度网盘，里面收集了大量文件。各种资料、电子书，使用空间达到了 2500G。之前还清理过一些低质的书籍，结果使用工具导出发现，在待整理目录中，居然有 1942 条电子书的记录。所以想要整理一番，这么多的文件，一个一个点实在难用。
提出需求
书归正传，这么多的文件，命名格式千奇百怪，因为有一些资料是从别人的分享中保存的，有的还会带网址的，可见网站运营也是无所不用其极了。从网上找到一些批量改名的工具，大多是 Windows 版本的，而且是加前缀或者后缀之类的，不太适用。
我想要的是，自己指定文件名，然后批量执行。就相当于有一双手，帮我在百度网盘中执行官方提供的重命名。之所以不用官方的重命名，是因为太难用，而且浪费时间（后面会具体说一下百度网盘的这个设计，也是可以借鉴的）。
想要实现自己的想法，需要有两步：
以 Excel 格式导出所有文件名在导出的 Excel 文件中，定义目标名称，不需要改名的可以不用修改导入整理后的文件，检查是否重命名成功
设计方案
根据需求，我们来设计方案。
找到关键接口
首先，我们需要能够导出所有的文件名。
百度网盘提供了网页版、客户端版，为了省时省事，我们使用网页版检查逻辑。打开控制台，发现进入目录时会有一个/api/list的请求，如下图：
根据响应内容，我们可以看出来，这个接口可以获取指定目录的文件列表。这个请求是 Get 请求，包含了好几个参数，还不太请求参数的作用，先放过。
通常来说，简单的网络请求是通过 Cookie 鉴权，所以我们就无脑使用 Cookie 了。
接下来需要找到重命名的请求，同样的，执行百度网盘提供的重命名即可，新增了哪些请求。如下图：
可以看到，这里的重命名分为了两步：
提交重命名任务，返回任务 id使用任务 id 查询任务执行情况
这就是前面说的可借鉴的地方。对于百度网盘这种应用，虽然下载限速被各种诟病，还有阿里云盘的强势追击，但是不得不说，百度网盘还是现在用的比较多的云存储工具。必须有针对性的优化，将某些二级功能异步任务化，比如重命名。
先通过一个请求创建重命名任务，任务创建成功返回任务 ID。这个时候，百度网盘后端服务监听新任务，如果后端压力大，任务可以缓慢执行或不执行；既然是异步任务化，客户端（包括网页或客户端）需要检查任务执行情况。任务执行情况根据约定可以有进行中或者完成，还可以有拒绝、失败、过期等其他情况。
导出导入文件
我们可以借助阿里开源的 EasyExcel 导出 Excel 文件（具体操作，可以查看 写文件、写的好看、填充文件 三篇）。
这个时候需要定义导出文件的内容，根据重命名的请求我们可以知道，我们需要文件路径、文件的新名字，为了操作简单，我们可以直接把原名也导出来。为了检查网盘文件是否有重复的，最好把文件的摘要码也导出来。
至此，我们的需求和方案都设计好了，下面就开始编码。
开始编码
开始编码前，我们需要定义一下鉴权参数：cookie、bdstoken，再定义一个扩展参数 path，我们只导出指定目录的文件列表。
定义基础类
根据设计方案中的定义，我们先创建导出文件的基础类：
@Datapublic class FileName {@ExcelProperty("路径")private String path;@ExcelProperty("MD5")private String md5;@ExcelProperty("原名称")private String originName;@ExcelProperty("新名称")private String newName;}
因为涉及到网络请求，我们需要定义请求参数。请求有一些共同参数：
@Datapublic abstract class BaseRequest {protected String channel = "chunlei";protected String web = "1";protected String appId = "250528";protected String bdstoken = "";protected String logid = "";protected String clienttype = "0";}
文件列表参数为：
@EqualsAndHashCode(callSuper = true)@Datapublic class FileListRequest extends BaseRequest {private String order = "name";private String desc = "0";private String showempty = "0";private int page = 1;private int num = 100;private String dir = "/";private String t = "";}
重命名参数为：
@EqualsAndHashCode(callSuper = true)@Datapublic class FileRenameRequest extends BaseRequest {private String opera = "rename";private String async = "2";private String onnest = "fail";}
我们还需要一个查询任务状态的参数：
@EqualsAndHashCode(callSuper = true)@Datapublic class TaskStatusRequest extends BaseRequest {private Long taskid;}
定义请求类
前面有了基础类和请求类，接下来我们定义请求接口，这些类就是模板化的方法了，我们简单看一下。如果想要获取源码，关注公号「看山的小屋」回复“java”获取源码。
先定义文件列表请求方法：
private List<FileListItem> listFileCurrentPath(FileListRequest fileListRequest) {final String body = HttpRequest.get("/api/list").form(fileListRequest.paramMap()).header(this.headers).cookie(this.cookie).execute().body();final FileListResponse response = JSONUtil.toBean(body, FileListResponse.class);if (response.getErrno() == 0) {return response.getList();}return Collections.emptyList();}
在定义文件重命名请求方法：
private Long rename(FileRenameRequest fileRenameRequest, String params) {final String queryParam = HttpUtil.toParams(fileRenameRequest.paramMap());final HttpRequest httpRequest = HttpRequest.post("/api/filemanager?" + queryParam).header(this.headers).cookie(this.cookie).body(params);final String body = httpRequest.execute().body();final FileRenameResponse response = JSONUtil.toBean(body, FileRenameResponse.class);if (response.getErrno() == 0) {return response.getTaskid();}return -1L;}
最后定义检查任务状态请求方法：
private TaskStatusResponse queryTaskStatus(TaskStatusRequest taskStatusRequest, String params) {TaskStatusResponse response;final String queryParam = HttpUtil.toParams(taskStatusRequest.paramMap());do {final String body = HttpRequest.post("/share/taskquery?" + queryParam).header(this.headers).cookie(this.cookie).body(params).execute().body();response = JSONUtil.toBean(body, TaskStatusResponse.class);} while (response.getErrno() != 0 || StringUtils.equalsAny(response.getStatus(), "running", "pending"));return response;}
体验升级
全部类定义完成后，我们可以直接在 IDE 中运行。但是，既然是工具，每次使用还得打开 IDE，是不是有些 low 了。为了升级体验，我们可以打成 jar 包，使用的时候直接运行 jar 包就行了。可以借助 maven 插件maven-assembly-plugin实现，这个插件能够把我们的源码和三方库都打在一个 jar 包中，这样就是一个 FatJar 走天下了。
<plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-assembly-plugin</artifactId><version>2.3</version><configuration><appendAssemblyId>false</appendAssemblyId><descriptorRefs><descriptorRef>jar-with-dependencies</descriptorRef></descriptorRefs><archive><manifest><addClasspath>true</addClasspath><classpathPrefix>lib/</classpathPrefix><mainClass>cn.howardliu.effectjava.rename.TaskRunner</mainClass></manifest></archive></configuration><executions><execution><id>make-assembly</id><phase>package</phase><goals><goal>assembly</goal></goals></execution></executions></plugin>
干完，手工。
文末总结
本文从零开始实现制作一个网络小工具，实现百度网盘文件的批量重命名。这个工具是这类工具的一个代表，只要是网络应用，存在 http 请求，我们都可以通过这类方式实现网络小工具。
如果想要获取源码，关注公号「看山的小屋」回复“java”获取源码。
你好，我是看山。游于码界，戏享人生。如果文章对您有帮助，请点赞、收藏、关注。我还整理了一些精品学习资料，关注公众号「看山的小屋」，回复“资料”即可获得。
个人主页：
个人博文：看山聊 Java：从零实现“百度网盘批量重命名”工具
CSDN 主页：https://kanshan./
CSDN 博文：看山聊 Java：从零实现“百度网盘批量重命名”工具
👇🏻欢迎关注我的公众号「看山的小屋」，领取精选资料👇🏻
