@nsrd/file-storage-sdk v1.1.0-alpha.5

文件存储file-storage-sdk

• vite 打包

• typescript 语法

• 支持多入口打包 详见 vite.build.mjs - entryList

• 对接文件存储服务

使用

说明

该组件库依赖于 axios spark-md5, 安装依赖时会自动安装，异常情况请确认依赖已安装

安装

npm npm install @nsrd/file-storage-sdk -S

yarn yarn add @nsrd/file-storage-sdk

pnpm pnpm install @nsrd/file-storage-sdk -S

引入

• 第一种import FileStorage from "@nsrd/file-storage-sdk" 【推荐】

• 第二种 const FileStorage = require("@nsrd/file-storage-sdk")

使用示例

import FileStorage from "@nsrd/file-storage-sdk";

const FS = new FileStorage({
  base: 'http://172.30.3.152/file-storage/rest/v2'
})

const voucherId = "asdad213qdwasd123" // 业务系统提供的操作凭证

FS.upload({
    chunk: true,
    voucherId: voucherId,
    file: file.value,
    onProgress: (res) => {
        console.log(res);
    }
}).then(res => {
    console.log('upload result', res);
})

API

构造函数

const FS = new FileStorage(options)

• options(constructor): object构造函数参数

方法

1.upload 上传

FS.upload(options)

• options: object上传函数参数

• options.onProgress#返回值 : object

• 返回值 FS.upload : Promise<object>

  • fulfilled

  属性名	类型	是否必填	默认值	说明
  code	string	是	-	状态码：'00000'：正常；其他异常
  message	string	是	-	接口说明
  uniqueId	string	是	-	文件标识
  publicUniqueName	string	否	-	文件公开访问标识用于文件url访问

  • rejected

  属性名	类型	是否必填	默认值	说明
  code	string	是	-	状态码：非 "00000"
  message	string	是	-	接口说明

2.download 下载

FS.download(options)

• options: object下载函数参数

• 返回值 FS.download: Promise<object>

  • fulfilled

    属性名	类型	是否必填	默认值	说明
    code	string	是	-	状态码：'00000'：正常；其他异常
    message	string	是	-	接口说明
    url	string	否	-	下载地址
    file	File	否	-	下载的文件

  • rejected

    属性名	类型	是否必填	默认值	说明
    code	string	是	-	状态码：非 '00000'
    message	string	是	-	接口说明

3.getDownloadUri 获取下载地址

FS.getDownloadUri(options)

• options: object获取下载地址函数参数

• 返回值 FS.getDownloadUri: Promise<object>

  • fulfilled

    属性名	类型	是否必填	默认值	说明
    code	string	是	-	状态码：'00000'：正常；其他异常
    message	string	是	-	接口说明
    url	string	是	-	下载地址

  • rejected

    属性名	类型	是否必填	默认值	说明
    code	string	是	-	状态码：非 '00000'
    message	string	是	-	接口说明

develop

1. scripts命令

   {
       "alpha": "打签：alpha 版本",
       "build": "仓库打包",
       "commit": "提交代码",
       "dev": "启动项目",
       "eslint": "eslint格式化代码",
       "postinstallmac": "苹果环境配置",
       "pre-commit": "预提交",
       "prepare": "环境配置",
       "release": "打签：release 版本",
       "sort": "package.json排序"
   }

2. 安装依赖

   yarn install
   # npm install
   # pnpm install

3. 本地启动

   npm run dev

4. 代码提交

   预提交检查代码

   npm run pre-commit

   提交代码

   npm run commit

5. 发布

• tag

  alpha版本

  npm run alpha

  release版本

  npm run release

• publish

  npm publish