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,默认100MimageMaxSize
:上传的图片最大大小限制,单位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,默认100MimageMaxSize
:上传的图片最大大小限制,单位M,默认50M,httpAccessPath
:http访问的根路径,配置后,文件返回的地址,会自动加上此路径
wueasy :
gateway:
file :
upload : #上传配置
type: LOCAL
rootPath: D:/file #文件上传根目录
maxSize: 50 #文件最大大小,单位M
httpAccessPath: #http访问的路径
上传到腾讯云对象存储
修改配置文件:
maxSize
:上传的文件最大大小,单位MhttpAccessPath
:http访问的根路径,这里通常配置腾讯云对象存储访问的地址secretId
:APPIDsecretKey
: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
上传到阿里云对象存储
修改配置文件:
maxSize
:上传的文件最大大小,单位MhttpAccessPath
:http访问的根路径,这里通常配置阿里云对象存储访问的地址secretId
:APPIDsecretKey
:APP密钥bucketName
:bucket 的命名规则为{name} ,此处填写的存储桶名称必须为此格式region
:设置bucket的区域, COS地域的简称请参照 https://help.aliyun.com/document_detail/31837.html?spm=a2c4g.11186623.6.571.3ac87f5e7vtneC
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
:上传的文件最大大小,单位MhttpAccessPath
: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
:上传的文件最大大小,单位MhttpAccessPath
: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
:上传的文件最大大小,单位MhttpAccessPath
: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
:上传的文件最大大小,单位MhttpAccessPath
: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对象存储
修改配置文件:
maxSize
:上传的文件最大大小,单位MhttpAccessPath
:http访问的根路径,这里通常配置阿里云对象存储访问的地址secretId
:用户公钥secretKey
:用户私钥bucketName
:bucket名称region
:地域配置,参考地址:https://docs.aws.amazon.com/lightsail/2016-11-28/api-reference/API_Region.html
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
:上传的文件最大大小,单位MhttpAccessPath
:http访问的根路径,这里通常配置阿里云对象存储访问的地址secretId
:用户的Access Key IDsecretKey
:用户的Secret Access KeybucketName
:空间名称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
}
]
}