3.x版本附件上传

提供统一的上传附件接口,支持单个/多个文件上传。

目前有9种上传方式:

  • 上传到本地(上传到本地文件夹)
  • 腾讯云对象存储
  • 阿里云对象存储
  • 又拍云对象存储
  • 七牛云对象存储
  • 华为云对象存储
  • ucloud对象存储
  • aws s3
  • 百度云对象存储

httpAccessPath必须可以访问到上传的地址,可以是映射等域名

3.4.0以上版本和3.x版本区别:

  • 3.4.0以上版本配置wueasy.file
  • 3.x版本配置wueasy.gateway.file

上传接口

  • 接口地址/upload/upload/image
  • 请求类型POST 表单提交
  • 请求参数file 文件对象

/upload/image接口只允许上传图片

设置允许上传的文件类型

  • allowedUploadSuffix: 设置允许上传的文件类型,多个逗号分隔
wueasy :
  gateway:
    file :
      upload : #上传配置
        allowedUploadSuffix: #设置允许上传的文件类型,多个逗号分隔

上传附件大小控制

配置servlet接收文件大小

spring:
  servlet:
    multipart:
      maxFileSize: 100MB
      maxRequestSize: 100MB

配置上传文件大小

  • maxSize:上传的文件最大大小限制,单位M,默认100M
  • imageMaxSize:上传的图片最大大小限制,单位M,默认50M,3.3.0新增
wueasy :
  gateway:
    file :
      upload : #上传配置
        maxSize: 100 #上传的文件最大大小限制,单位M,默认100M
        imageMaxSize: 50 #上传的图片最大大小限制,单位M,默认50M,

图片压缩

2.1.2版本开始支持

提供图片自动压缩处理,减少访问流量,支持以下几种图片压缩(jpg|jpeg|png)

wueasy:
  gateway:
    file:
      upload : #上传配置
        imageAutoZip: false #图片是否自动压缩,true是,默认false
        imageQuality: 0.2 #图片质量,默认0.5

上传到本地

把附件上传到本地文件夹中。

修改配置文件:

  • rootPath:本地文件夹的根目录,附件会上传到此文件夹
  • maxSize:上传的文件最大大小限制,单位M,默认100M
  • imageMaxSize:上传的图片最大大小限制,单位M,默认50M,
  • httpAccessPath:http访问的根路径,配置后,文件返回的地址,会自动加上此路径
wueasy :
  gateway:
    file :
      upload : #上传配置
        type: LOCAL
        rootPath: D:/file #文件上传根目录
        maxSize: 50 #文件最大大小,单位M
        httpAccessPath:   #http访问的路径

上传到腾讯云对象存储

修改配置文件:

  • maxSize:上传的文件最大大小,单位M
  • httpAccessPath:http访问的根路径,这里通常配置腾讯云对象存储访问的地址

  • secretId:APPID

  • secretKey:APP密钥
  • bucketName:bucket 的命名规则为{name}-{appid} ,此处填写的存储桶名称必须为此格式
  • region:设置bucket的区域, COS地域的简称请参照 https://cloud.tencent.com/document/product/436/6224
wueasy :
  gateway:
    file :
      upload : #上传配置
        type: COS
        maxSize: 50 #文件最大大小,单位M
        httpAccessPath: https://hao54.oss-cn-hangzhou.aliyuncs.com  #http访问的路径
        os : #对象存储配置
          secretId :
          secretKey :
          bucketName : test-1251238510 #bucket 的命名规则为{name}-{appid} ,此处填写的存储桶名称必须为此格式
          region : ap-shanghai #设置bucket的区域, COS地域的简称请参照 https://cloud.tencent.com/document/product/436/6224

上传到阿里云对象存储

修改配置文件:

wueasy :
  gateway:
    file :
      upload : #上传配置
        type: OSS
        maxSize: 50 #文件最大大小,单位M
        httpAccessPath: https://hao54.oss-cn-hangzhou.aliyuncs.com  #http访问的路径
      os : #对象存储配置
        secretId :
        secretKey :
        bucketName : hao54 #bucket 的命名规则为{name} ,此处填写的存储桶名称必须为此格式
        region :  https://oss-cn-hangzhou.aliyuncs.com #设置bucket的区域, COS地域的简称请参照 https://help.aliyun.com/document_detail/31837.html?spm=a2c4g.11186623.6.571.3ac87f5e7vtneC

上传到又拍云对象存储

修改配置文件:

  • maxSize:上传的文件最大大小,单位M
  • httpAccessPath:http访问的根路径,这里通常配置阿里云对象存储访问的地址

  • secretId:操作员名称

  • secretKey:密码
  • bucketName:空间名称
wueasy :
  gateway:
    file :
      upload : #上传配置
        type: USS
        maxSize: 50 #文件最大大小,单位M
        httpAccessPath: https://hao54.oss-cn-hangzhou.aliyuncs.com  #http访问的路径
      os : #对象存储配置
        secretId :
        secretKey :
        bucketName : hao54

上传到七牛云对象存储

修改配置文件:

  • maxSize:上传的文件最大大小,单位M
  • httpAccessPath:http访问的根路径,这里通常配置阿里云对象存储访问的地址

  • secretId:操作员名称

  • secretKey:密码
  • bucketName:空间名称
  • region:机房区域,zone0 华东,zone1 华北,zone2 华南,zoneNa0 北美,zoneAs0 东南亚

2.3.0版本后新配置

  • region:机房区域,huadong 华东,huabei 华北,huanan 华南,beimei 北美,xinjiapo 东南亚
wueasy :
  gateway:
    file :
      upload : #上传配置
        type: KODO
        maxSize: 50 #文件最大大小,单位M
        httpAccessPath: https://hao54.oss-cn-hangzhou.aliyuncs.com  #http访问的路径
      os : #对象存储配置
        secretId:
        secretKey:  
        bucketName: fallsea
        region: zone0

上传到华为云对象存储

修改配置文件:

  • maxSize:上传的文件最大大小,单位M
  • httpAccessPath:http访问的根路径,这里通常配置阿里云对象存储访问的地址

  • secretId:操作员名称

  • secretKey:密码
  • bucketName:空间名称
  • region:Endpoint配置, OBS为每个区域提供Endpoint,用于处理各自区域的访问请求。
wueasy :
  gateway:
    file :
      upload : #上传配置
        type: OBS
        maxSize: 50 #文件最大大小,单位M
        httpAccessPath: https://hao54.oss-cn-hangzhou.aliyuncs.com  #http访问的路径
      os : #对象存储配置
        secretId :
        secretKey :
        bucketName : wueasy #存储桶名称
        region: obs.cn-east-2.myhuaweicloud.com

上传到ucloud对象存储

修改配置文件:

  • maxSize:上传的文件最大大小,单位M
  • httpAccessPath:http访问的根路径,这里通常配置阿里云对象存储访问的地址

  • secretId:用户公钥

  • secretKey:用户私钥
  • bucketName:bucket名称
  • region:仓库地区 (eg: 'cn-bj')
wueasy :
  gateway:
    file :
      upload : #上传配置
        type: UFILE
        maxSize: 50 #文件最大大小,单位M
        httpAccessPath: https://hao54.oss-cn-hangzhou.aliyuncs.com  #http访问的路径
      os : #对象存储配置
        secretId :
        secretKey :
        bucketName : wueasy
        region: cn-sh2

上传到aws s3对象存储

修改配置文件:

wueasy :
  gateway:
    file :
      upload : #上传配置
        type: S3
        maxSize: 50 #文件最大大小,单位M
        httpAccessPath: https://wueasy.s3.eu-west-2.amazonaws.com  #http访问的路径
      os : #对象存储配置
        secretId :
        secretKey :
        bucketName : wueasy
        region: eu-west-2

上传到百度云对象存储

修改配置文件:

  • maxSize:上传的文件最大大小,单位M
  • httpAccessPath:http访问的根路径,这里通常配置阿里云对象存储访问的地址

  • secretId:用户的Access Key ID

  • secretKey:用户的Secret Access Key
  • bucketName:空间名称
  • region:机房区域,参考:https://cloud.baidu.com/doc/BOS/s/Ojwvyrpgd
wueasy :
  gateway:
    file :
      upload : #上传配置
        type: BOS
        maxSize: 50 #文件最大大小,单位M
        httpAccessPath: https://wueasy.cdn.bcebos.com  #http访问的路径
      os : #对象存储配置
        secretId:
        secretKey:  
        bucketName: fallsea
        region: bj.bcebos.com

接口返回结果

参数名 类型 说明
extName string 文件后缀
fileName string 文件名称
filePath string 文件地址
fileSize long 文件大小
{
  "errorNo": 0,
    "data": [
        {
            "extName": "jpg",
            "fileName": "architecture.jpg",
            "filePath": "https://www.wueasy.com/2019/05/07/10/d2f01651ac944fb7adef260f00a14287.jpg",
            "fileSize": 203130
        }
    ]
}
Copyright © wueasy.com 2017-2020 all right reserved,powered by Gitbook未经允许,禁止以任何形式传播 修订时间: 2020-06-24

results matching ""

    No results matching ""