本文适合有 Java 基础知识的人群,跟着本文可学习和运行
Java
网盘项目。
本文作者:HelloGitHub-秦人
HelloGitHub 推出的《讲解开源项目》系列。
今天给大家带来一款开源 Java 版网盘项目—— kiftd-source,本文将用 3 分钟带大家搭建一个个人网盘,技术便利生活,你值得拥有~
kiftd 是一款开源、使用简单、功能完整的 Java 网盘/云盘系统。支持在线视频播放、文档在线预览、音乐播放、图片查看等功能的文件云存储平台。
技术栈
- JDK 版本:1.8.0_131
- 项目管理框架:Maven(m2e 1.8.0 for Eclipse)
- Archetype:mavem-archetype-quickstart 1.1
- Spring Boot:SpringBoot 基于 Spring 开发,旨在提高微服务的开发效率。
- MyBatis:一款优秀的持久层框架,它支持自定义 SQL、存储过程以及高级映射。
- H2 DB:一款开源的嵌入式数据库引擎,采用 Java 语言编写,不受平台的限制。
2.1.1 下载安装包
直接从官网下载最新的安装包,安装地址:https://kohgylw.gitee.io/
项目比较温馨,支持三种下载方式:Github、阿里云、Gitee 下载。如下图:
2.1.2 检查配置
这里主要检查一下本地 JDK
是否已安装,在命令行窗口执行 java -version
查看 Java
版本。如下所示表示已安装,就可以进行下一步操作。
java version "1.8.0_181"
Java(TM) SE Runtime Environment (build 1.8.0_181-b13)
Java HotSpot(TM) 64-Bit Server VM (build 25.181-b13, mixed mode)
2.1.3 运行 jar
双击 kiftd-1.0.29-RELEASE.jar
,或者在命令行执行 java -jar kiftd-1.0.29-RELEASE.jar
命令都运行可以jar
文件,会弹出安装的界面,如下图:
这个界面的这几个按钮说明一下:
- 开启(Start):运行网盘服务,初次启动的端口默认是
8080
。 - 文件(Files):这个按钮菜单中主要有网盘文件导入,导出,删除,刷新功能。
- 设置(Setting):设置功能主要可以设置网盘的服务端口,网盘的物理存储路径等信息。
- 退出(Exit):关闭网盘系统。
点击 开启(Start)
按钮即可运行网盘,这里我设置的端口是 8090
,在浏览器访问: localhost:8090
,运行效果如下图:
项目是运行了,发现一个问题无法上传文件?因为我们忘了登录这个操作。点击系统 登录按钮
,填入账号和密码即可登录。那么登录密码在哪里呢?这里我直接告诉大家,用户信息在 conf/account.properties
,文件内容如下:
#<This is the default kiftd account setting file. >
#Sun May 10 21:56:28 CST 2020
admin.pwd=000000 #用户名.密码=000000
authOverall=l
admin.auth=cudrm
- 用户名:admin
- 密码:000000
这样登录之后就可以使用网盘的所有功能了。
2.2.1 安装 Screen 工具
Screen 工具能够虚拟出一个终端并执行相应的操作。因为本篇所讲的网盘需要一个终端。执行如下命令安装 Screen
:
yum install screen
2.2.2 Screen
常用命令
screen -S myScreen #创建虚拟终端
java -jar kiftd-1.0.29-RELEASE.jar -console #在虚拟终端中以命令模式启动 kiftd
screen -r myScreen #返回之前的虚拟终端并继续操作 kiftd。
2.2.3 命令行操作
在 Linux
环境上使用 console
模式启动的效果是这样的:
命令行输入 -start
即可运行项目。例如输入 -files
控制台显示是这样的:
其实和 Windows
上一样,包括文件导入,导出,删除功能,多了几个命令是查看文件,切换目录等功能。
两种方式下载项目,使用 GitBash
下载项目:
git clone https://github.com/KOHGYLW/kiftd-source.git
另外一种方式直接下载 zip
压缩包,如下图:
打开 kohgylw.kiftd.mc.MC
类,进行测试运行。注意:本文使用 Eclipse
工具打开。
3.3.1 前台请求
就以创建目录这个功能为例。我们先看前端功能。点击“操作”->“新建文件夹”,填写文件夹名称,点击保存如下图:
我们知道前台 新建文件夹
功能调用的后台接口是 newFolder.ajax
3.3.2 后端接口
通过前台请求可知调用的后台接口为 homeController/newFolder.ajax
。打开代码实现,我们会看到下面这个方法。
public String newFolder(final HttpServletRequest request) {
...
//参数校验的部分代码已省略
Folder f = new Folder();
f.setFolderId(UUID.randomUUID().toString());
f.setFolderName(folderName);
f.setFolderCreationDate(ServerTimeUtil.accurateToDay());
if (account != null) {
f.setFolderCreator(account);
} else {
f.setFolderCreator("匿名用户");
}
f.setFolderParent(parentId);
int i = 0;
while (true) {
try {
// 数据库插入新建文件夹的数据
final int r = this.fm.insertNewFolder(f);
if (r > 0) {
if (fu.isValidFolder(f)) {
this.lu.writeCreateFolderEvent(request, f);
return "createFolderSuccess";
} else {
return "cannotCreateFolder";
}
}
break;
} catch (Exception e) {
f.setFolderId(UUID.randomUUID().toString());
i++;
}
if (i >= 10) {
break;
}
}
return "cannotCreateFolder";
}
网盘还对一些常用功能添加了快捷键。功能和快捷键参照如下:
功能 | 快捷键 |
---|---|
上传文件夹 | Shift +U |
上传文件 | Shift +F |
新建文件 | Shift +N |
复制 | Shift +C |
剪切 | Shift +X |
删除 | Shift +D |
配置文件在项目 conf
目录,包括两个配置文件:
account.properties
:配置账号信息,权限信息server.properties
:服务器的配置文件,可配置服务器端口,缓冲文件大小等
网盘支持文档 txt
、pdf
、docx
、ppt
在线预览功能,支持图片的在线预览。图片预览效果如下:
pdf
文件预览效果如下:
网盘也考虑文件的分享,它可以生成下载链接,浏览器访问下载链接就可以直接下载文件。选择需要下载的文件,点击 下载
按钮,选择 下载链接+
,既可以生成文件下载链接。如下图:
教程至此已经结束,你自己的网盘跑起来了吗?网盘是不是还不错?而且搭建也特别简单。一些重要的东西就可以存放到自己的网盘啦!说到底,编程语言只是工具,我们只要很好的使用工具,再加上自己天马行空的思想,我想会创造出更多不可思议的项目。
Java
语言为什么经久不衰,因为它能做的事情太多了,而且生态也特别丰富。如果你也有兴趣那就加入 Javaer
开发者的大家庭吧!开源分享让我们彼此认识,有了开源项目让我们看到编程语言的绚丽多彩。
教程至此,你应该也能快速运行个人网盘了。编程是不是也特别有意思呢?先下载安装包给自己部署一套网盘系统吧。对源码感兴趣的朋友可以开始学习项目源码了~