# gomyck-fastdfs-spring-boot-starter

**Repository Path**: fork-gitee/gomyck-fastdfs-spring-boot-starter

## Basic Information

- **Project Name**: gomyck-fastdfs-spring-boot-starter
- **Description**: 完美集成fastDFS文件服务客户端, 支持断点续传, 分块上传, 文件秒传, 稳定的前后端组件(前端H5), 支持多用户并发上传文件校验(文件锁), 可以快速集成fastDFS文件服务, 免去繁琐的配置, 拿来即用, 目前暂时仅支持springboot开发环境
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://blog.gomyck.com
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 104
- **Created**: 2022-07-04
- **Last Updated**: 2022-07-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


## 开始使用 

### 当前MASTER为1.1.5-SNAPSHOT版本

如果使用 SNAPSHOT 版本 , 请勾选 develop-fastdfs


### 一.环境配置

#### 1.在pom文件中加入依赖:
```xml
<dependency>
    <groupId>com.gomyck</groupId>
    <artifactId>gomyck-fastdfs-spring-boot-starter</artifactId>
    <version>1.1.4-RELEASE</version>
</dependency>
```
#### 2.编辑yml文件(以下为全量配置):
```text
#单个文件上传大小限制
spring:
  servlet:
    multipart:
      max-file-size: 5000MB
#fastdfs客户端配置
fdfs:
  connect-timeout: 1601
  thumb-image:
    width: 150
    height: 150
  pool:
    jmx-name-prefix: 1
    jmx-name-base: 1
    max-wait-millis: 102
  tracker-list: 
    - 192.168.1.1:22122 #fastdfs服务地址
  so-timeout: 1501
pool:
  max-total: 153

gomyck:
  config:
    redis: true #是否使用redis存储文件上传信息以及上传锁
  redis:
    host: 127.0.0.1 
    password: xxxxx
    port: 6379
  fastdfs: #fastdfs上传配置
    chunk-size: 5 #分块大小, 上传文件分块的大小 单位: MB
    download-chunk-size: 100  #分块下载大小  单位: byte
    group-id: group1 #fastdfs的组, 文件会被存到这个组下
    file-server-protocol: http #远程文件服务连接协议
    file-server-url: 192.168.1.196 #远程文件服务连接地址
```

#### 3.在静态资源映射表中加入以下配置(可选, 重写resources.staticLocations时要根据实际配置决定是否加入下述代码)
#### 请注意, 如果你的项目中存在 WebMvcConfigurationSupport 子类, 那么必须添加静态资源配置, 否则将请求不到本项目资源
```java
@Configuration
public class Config extends WebMvcConfigurationSupport {

    @Override
    protected void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("ck-fastdfs/**").addResourceLocations("classpath:/META-INF/resources/ck-fastdfs/");
        registry.addResourceHandler("ck-util/**").addResourceLocations("classpath:/META-INF/resources/ck-util/");
        registry.addResourceHandler("ck-3pty/**").addResourceLocations("classpath:/META-INF/resources/ck-3pty/");
        super.addResourceHandlers(registry);
    }
}
```
#### 4.启动服务, 访问示例页面: host{:port}/{contextPath/}ck-fastdfs/view/ckFastDFS.html (可以渲染表示环境配置成功)

### 二.开发文档

本项目后端服务不在文档说明范围内, 高玩可以自行阅读修改, 只针对前端JS的使用做说明注释

#### 1.在需要开发文件上传的页面(你的业务页面), 引入js: 

> {schema://}host{:port}{/contextPath}/ck-3pty/jquery/jquery-core.min.js     
> {schema://}host{:port}{/contextPath}/ck-fastdfs/js/webuploader.nolog.js     
> {schema://}host{:port}{/contextPath}/ck-fastdfs/js/ckFastDFS.js     

#### 2.开发文档

##### 1.实例化前端上传实例: 
```javascript
const option = {
    //config something.....
};
const cfd = new CkFastDFS(option);
```
每个实例可以绑定多个上传按钮, 支持id选择器, 类选择器等jq插件支持的选择器类型

多实例存在的场景: 多个文件服务分组, 当不同的按钮上传文件到不同分组时, 可能需要页面多实例来处理

##### 2.option参数说明: 
```javascript
{ 
    baseURI: "../../",  //后端服务URI(包括上下文) (非必填)
    fastDFSGroup: "group1",  //文件上传至fastdfs的组名 (非必填)
    uploaderConfig: {},  //webUploader配置 (非必填)
    uploadButton: {   //按钮配置 (必填)
        buttonId: "#btn1", //选择器 (必填), 支持jq插件所支持的所有selector类型
        multiple: true  //是否允许多文件选择 (非必填, 默认false)
    },
    uploadProgressBar: {  //进度条 (非必填)
        changeBar: function (refer, file, progressVal) {  //文件上传中, 进度改变时会触发该方法 
            console.log("进度条改变: " + refer + "|||" + file.id + "|||" + progressVal);
        }
    },
    uploadListener: {  //上传监听(非必填)  
        
        // 参数说明: 
        // refer:点击上传的按钮jq对象   
        // file:上传的文件   
        // result:后端服务返回的结果
        // reason:错误类型, 通常为字符串: server
        
        //添加文件信息
        appendFileInfo: function (refer, file) {
            console.log("选择文件: " + refer + "|||" + file.id);
        },
        //添加到上传队列之前
        beforeAppendFileInQueued: function (refer, file) {
            console.log("添加到队列之前: " + refer + "|||" + file.id);
            return true;
        },
        //开始上传
        beginUpload: function (refer, file) {
            console.log("开始上传: " + refer + "|||" + file.id);
        },
        //分块上传成功
        chunkUploadSuccess: function (refer, file, result) {
            console.log("分块上传成功:" + refer + "|||" + file.id + "|||" + JSON.stringify(result))
        },
        //上传出错
        uploadError: function (refer, file, reason) {
            console.log("上传失败: " + refer + "|||" + file.id + "|||" + reason);
        },
        //上传成功
        uploadSuccess: function (refer, file, result) {
            console.log("上传成功: " + refer + "|||" + file.id + "|||" + JSON.stringify(result));
        },
        //上传完成(不管上传成功失败, 都会触发该方法)
        uploadComplete: function (refer, file) {
            console.log("上传完成: " + refer + "|||" + file.id);
        },
        //全局错误
        error: function (type, tips) {
            console.log("全局错误: " + type + "|||" + tips)
        }
    }
}
```
#### 3.实例函数说明:
```javascript
cfd.addButton(selector);  //向实例中添加按钮
cfd.pauseUpload(param);   //暂停上传  param 为布尔值时, 为暂停正在上传的文件, file类型时, 暂停指定file的上传, null|undefined时为全部暂停
cfd.cancleUpload(file);   //取消指定文件的上传
```
#### 4.其他说明
1. 如何在自己的项目中添加fastdfs客户端实例:

    使用@Autowired即可注入以下接口实例
    
    TrackerClient - TrackerServer接口
    
    GenerateStorageClient - 一般文件存储接口 (StorageServer接口)
    
    FastFileStorageClient - 为方便项目开发集成的简单接口(StorageServer接口)
    
    AppendFileStorageClient - 支持文件续传操作的接口 (StorageServer接口)

2. 如何扩展前端js: 

    请参考类:CkFastDFS.js
    
    请参考webUploader官网API
    
    当然, 你也可以fork master分支代码, 打包后供他人使用(修改后的分支代码, pom文件中的parent请删掉, 并手动指定依赖版本, 否则可能会出现版本不一致问题)

### 1.0.2-Release版本实现:
> 1. 分块下载(服务端分块写到客户端, 不必等所有文件都加载到服务端内存中在一次性写出)  
> 2. 断点续传前后端校验(历史上传的块与本次上传的块大小是否一致, 否则会导致修改块大小配置导致上传文件有问题)  

### 1.1.3-Release版本实现:
> 1. 调整了一些方法, 有些列表可以分页查询了
> 2. 调整了文件在 redis 中的存储方式
> 3. 增加了错误页面, 具体使用  看源代码
> 4. 修复了一个小 BUG, 该 BUG 可能导致 redis 连接得不到正确释放
> 5. 新增了略缩图, 具体使用方式看代码, 图片上传之后默认生成略缩图
> 6. 新增了文件过期时间, 默认不失效, 请看 js 代码配置(例子)
> 7. 打包下载优化
> 8. new version new life


### 下一版本实现:
> 1. 文件下载防盗链实现(基于当前服务访问文件)  
> 2. fastdfs token获取(直连文件服务访问文件)     
> ......   

## 提供科学查资料渠道, 查资料更便捷(小范围, 更稳定可靠 https://blog.gomyck.com/about/)