Awesome
欢迎访问kiftd源代码资源库！
Welcome to visit source of kiftd!
当前版本：v1.2.3-SNAPSHOT
简介
kiftd——一款便捷、开源、功能完善的个人&团队&小型团队网盘服务器系统。
kiftd能够帮助您快速搭建起一个面向家庭、团队或组织的网盘系统，它操作简单、高效且功能多样。这里是kiftd的源代码资源库，您可以在这里获得kiftd的源代码，并对其进行下载、阅读与重构。
注：如果您仅仅希望得到一份拿来即用的软件，kiftd也提供了一个完整的、解压即用的编译版。您可以根据其说明在3分钟内快速安装并开始使用。如果您需要该版本，请转到以下位置进行浏览和下载： kiftd-官方主页
构建说明
下列条目为kiftd开发环境的基本信息，如需对源代码进行查看及编译，推荐使用所列配置。
- JDK版本：1.8.0
- 项目管理框架：Maven（m2e 1.8.0 for Eclipse）,Archetype：mavem-archetype-quickstart 1.1。
- 编码格式：UTF-8
- 项目资源及配置：Spring Boot+MyBatis+H2 DB，详见pom.xml文档。
快速开始
- 使用Eclipse(javaEE)以项目方式导入本资源文件夹，并设置构建路径中的JDK版本。
- 使用Maven选项更新项目，并确保pom文件中引入的所有外部资源能够正确引入至本地。
- 打开kohgylw.kiftd.mc.MC类，进行测试运行。
- 右键项目，执行Run with选项中的Maven install操作以在target文件夹内编译生成jar程序。
- 将生成的jar程序拷贝到项目主目录下（即与libs等文件夹同级）并开始使用。
提示：源代码路径下包含了一些程序运行所需的非源代码资源（例如程序图标等），某些集成式开发环境（例如IDEA）在编译过程中可能会自动忽略非源代码资源。您需要设置并保证这些资源也能够被正确打包至最终的jar程序内，否则将会导致编译出的程序无法顺利运行。
程序基本结构说明
- 源代码资源文件夹：/src/main/java/
- 入口类：kohgylw.kiftd.mc.MC
- web界面请求处理包：kohgylw.kiftd.server.controller、kohgylw.kiftd.server.filter
- web界面操作逻辑包：kohgylw.kiftd.server.service
- 核心功能及文件系统实现包：kohgylw.server.util、kohgylw.kiftd.server.listener、kohgylw.kiftd.server.mapper、kohgylw.kiftd.server.model
- 服务器行为控制类：kohgylw.server.ctl.KiftdCtl
- 服务器界面相关包：kohgylw.kiftd.ui、kohgylw.kiftd.printer
- 独立文件管理模块相关包：kohgylw.kiftd.util.file_system_manager
- 第三方工具使用许可证包：kohgylw.kiftd.util.licenses
- web页面静态资源文件夹：/webContext/
- mybatis映射表文件夹：/mybatisResource/
- 外部引用资源（编译后生成）文件夹：/libs/
- 引用字体文件夹：/fonts/
- 设置文件（程序第一次运行后生成）文件夹：/conf/
- 日志文件夹：/logs/
- 编译输出文件夹：/target/
- maven配置文件：/pom.xml
常见问题&解决方案
- 使用IDEA导入项目后无法以图形界面方式运行
在默认情况下，IDEA可能会自动忽略位于项目源代码路径内的所有非源代码文件，从而导致图形界面需要的某些图标文件（例如png文件）无法被识别和打包。如遇此问题，请修改IDEA设置，确保项目源代码路径下的所有文件均会被识别和打包。
- 启动源代码项目时出现“Error creating bean with name org.mybatis.spring.mapper.MapperScannerConfigurer”
如遇该问题，请尝试将pom.xml文件中引入的
mybatis资源和mybatis-spring资源移除并重新添加mybatis-spring-boot-starter资源，从而避免默认整合方式可能导致的Spring Boot框架插件兼容性问题（特别鸣谢：用户 michael）。
使用许可（下载该源代码资源即视为接受以下许可）
当前版本的kiftd使用自带的许可文件进行分发。您应该先阅读该文件（获取方式：前往kiftd发行版主页下载一份kiftd发行版并在其中获得，详见 https://github.com/KOHGYLW/kiftd ），并在同意其中的所有条款后再下载该源代码。其大致内容如下：
- 您可以免费获得该源代码的原版拷贝。
- 您可以自由地对该源代码进行分发、重构并运用于任何领域。
- 作者对于使用该源代码造成的任何后果均无需负责。
- 作者对该源代码具有版权。
关于该源代码...
该源代码为目前发布的kiftd解压即用版的原始编译来源，二者保持一致性（有时源码版本可能会略微超前），作者将在今后对其逐步进行整理以便于用户阅读，由此带来的不便敬请谅解。
联系作者？
如有任何需要（例如对该资源有疑问、意见或建议），请发件联系作者： kohgylw@163.com （青阳龙野），随时恭候您的来信！
青阳龙野@kohgylw by 2024年07月20日