aplus use ali-oss
Rebuild ali-oss javascript sdk that provie private sts server methods
``javascript`
//add -w in you root folder
pnpm install aplus-oss -S -w
`javascript
//register client instance
import { client } from 'aplus-oss'
//some code in you project
import { you_STS_server } from '@/api/sts'
//init oss access token
const ossIntsance = client.initOssClient({
you_STS_server,
onFailure: err => {
console.warn('get oss accessSerct fail', err)
}
})
//after init
//you can use ossIntsance do something
ossIntsance.put(..)
ossIntsance.getSignatureUrl(..)
ossIntsance.downloadFile(..)
ossIntsance.deleteFile(..)
ossIntsance.pauseUpload(...)
// upload image or vedio with oss
// your can use put method to upload
const result = await client.put({
fileName: file.name,
dirName: 'Vedio',
data: file,
progressCallBack: (p: number) => {
percentVeido.value = p
},
//the number of parts to be uploaded in parallel
parallel: 6,
//the suggested size for each part, defalut 1024 1024(1MB), minimum 100 1024(100KB)
partSize: 1024 * 1024
})
if (result.status === 200) {
const { status, previewUrl, saveUrl } = result
console.log('status---', status)
console.log('previewUrl---', previewUrl)
console.log('saveUrl---', saveUrl)
} else {
//failure
console.log(result.message)
}
//you can use download method to download
let res = client.downloadFile(fileName)
console.log(res.message)
console.log(res.status)
//you can get signature url to perview with getSignatureUrl method
let signatureUrl = client.getSignatureUrl(pathName)
//get signature url
//after expires seconds, the url will become invalid, default is 3600s
console.log(signatureUrl)
//delete file
let res = await client.deleteFile(pathName)
console.log(res)
//pauseUpload
let res = = await client.pauseUpload()
console.log(res)
`
type: initOssClient(options: ResquestOssOptions): Promise
tips: register client instance with you sts server
ResquestOssOptions
| props | type | default | directions |
| --- | --- | --- | --- |
| getOssAccess | () => Promise | - | init oss access token |(err: any) => void
| onFailure | | - | get oss accessSerct fail |
type: put({ fileName, dirName, data, progressCallBack, parallel, partSize }: uploadParams): Promise
tips: you can put image vedio with put core method
options
| Props | Type | default | explanation |
| --- | --- | --- | --- |
| fileName | string | - | file Name |string
| dirName | | - | upload folder name |File
| data | | - | upload data |(p:number) => void
| progressCallBack | | - | upload progress |number
| parallel | | 6 | the number of parts to be uploaded in parallel |number
| partSize | | 1024\*1024(1M) | the suggested size for each part, defalut 1024 _ 1024(1MB), minimum 100 _ 1024(100KB) |
actionResponse
| Props | Type | default | explanation |
| --- | --- | --- | --- |
| status | number | - | status code(success 200 ,other will be fail) | string
| previewUrl | | - | preview file url,you can preview image or vedio after uploaded| string
| saveUrl | | - |your backend server wille be save this path| string
| message | | - |success message or fail message|
type: downloadFile(savePathName: Array
tips: dowload file with downloadFile method (support multiple download files)
options
| Props | Type | default | explanation |
| --- | --- | --- | --- |
| savePathName | Array | - | if mutipart download will be arrary,single file download wille be string |
actionResponse
| Props | Type | default | explanation |
| --- | --- | --- | --- |
| status | number | - | status code(success 200 ,other will be fail) | string
| previewUrl | | - | preview file url,you can preview image or vedio after uploaded| string
| saveUrl | | - |your backend server wille be save this path| string
| message | | - |success message or fail message|
type: getSignatureUrl(name: string, expires?: number): Promise
tips: get signature url to perview
options
| Props | Type | default | explanation |
| ------- | -------- | ------- | -------------- |
| name | string | - | file path name |number
| expires | | 3600(s) | expires time |
type: deleteFile(savePathName: string): Promise<{status: any;message: string;} | undefined>;
tips: delete oss file options
| Props | Type | default | explanation |
| ------------ | -------- | ------- | -------------- |
| savePathName | string | - | file path name |
type: pauseUpload(): Promise<{status: number;message: globMessage;}>`
tips: pause upload