《大胖 • 小课》- 写一个文件上传接口

简介: 这是《大胖小课》栏目的专题一《说说文件上传那些事儿》的第二节-《写一个文件上传接口》上一节 《大胖 • 小课》- 我是这样理解文件上传原理的,我们说到了文件上传的原理,服务端的文件保存我们使用koa-body来完成。

这是《大胖小课》栏目的专题一《说说文件上传那些事儿》的第二节-《写一个文件上传接口》

上一节 《大胖 • 小课》- 我是这样理解文件上传原理的,我们说到了文件上传的原理,服务端的文件保存我们使用koa-body来完成。

上传接口实现过程


在项目开发中,文件上传本身和业务无关,代码基本上都可通用。

服务端文件的保存基于现有的库koa-body结合 koa2实现服务端文件的保存和数据的返回。

koa-body 会自动保存文件到系统临时目录下os.tmpdir(),也可以指定保存的文件路径。

dc84f8f8f5b4eb629e4bf3f84350548e_640_wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1.png

然后在后续中间件内得到已保存的文件的信息,再做二次处理。

  • ctx.request.files.f1 得到文件信息,f1input file 标签的 name
  • 获得文件的扩展名,重命名文件

接口定义


接口地址:http://localhost:8100/upfile

接口返回格式

{
    code:0,
    msg:'',
    data:'图片可访问地址'
}

代码实现参考


NODE

/**
 * 服务入口
 */
var http = require('http');
var koaStatic = require('koa-static');
var path = require('path');
var koaBody = require('koa-body');//解析 form-data消息体
var fs = require('fs');//文件模块
var Koa = require('koa2');
var app = new Koa();
var port = process.env.PORT || '8100';//默认端口8100
var uploadHost = `http://localhost:${port}/uploads/`;//图片可访问地址
app.use(koaBody({
    formidable: {
        //设置文件的默认保存目录,不设置则保存在系统临时目录下  os
        uploadDir: path.resolve(__dirname, '../static/uploads')
    },
    multipart: true // 支持文件上传,默认不不支持
}));
//开启静态文件访问
app.use(koaStatic(
    path.resolve(__dirname, '../static')
));
//二次处理文件,修改名称
app.use((ctx) => {
    if (ctx.path === '/upfile') {
        var file = ctx.request.files ? ctx.request.files.f1 : null; //得到文件对象
        if (file) {
            var path = file.path.replace(/\\/g, '/');
            var fname = file.name; //原文件名称
            var nextPath = '';
            if (file.size > 0 && path) {
                //得到扩展名
                var extArr = fname.split('.');
                var ext = extArr[extArr.length - 1];
                nextPath = path + '.' + ext;
                //重命名文件
                fs.renameSync(path, nextPath);
            }
            //以 json 形式输出上传文件地址
            ctx.body = getRenderData({
                data: `${uploadHost}${nextPath.slice(nextPath.lastIndexOf('/') + 1)}`
            });
        }else {
            ctx.body = getRenderData({
                code:1,
                msg:'file is null'
            });
        }
    }
});
/**
 *
 * @param {设置返回结果} opt
 */
function getRenderData(opt) {
    return Object.assign({
        code:0,
        msg:'',
        data:null
    },opt);
}
/**
 * http server
 */
var server = http.createServer(app.callback());
server.listen(port);
console.log('upload file server start ......   ');

接口测试

//启动服务
$ node ./src/upfiles-demo/api-upfile/server/app.js
//访问静态 html 页面
http://localhost:8100/html/upfile.html
//选择文件后上传

92a4ec38be3d327847211c95493f3551_640_wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1.png

目录
相关文章
|
5月前
|
数据可视化 Java API
API 参考与帮助内容:一站式开发与使用者支援
API 文档是旨在了解 API 详细信息的综合指南。通常,它们包括端点、请求示例、响应类别和示例以及错误代码等信息。API 文档可帮助开发人员了解 API 端点的具体细节,并了解如何将 API 成功集成到他们的软件中。
74 0
|
JavaScript 前端开发 API
python对接API二次开发高级实战案例解析:百度地图Web服务API封装函数(行政区划区域检索、地理编码、国内天气查询、IP定位、坐标转换)
python对接API二次开发高级实战案例解析:百度地图Web服务API封装函数(行政区划区域检索、地理编码、国内天气查询、IP定位、坐标转换)
423 0
|
5月前
|
前端开发 API Docker
web前端开发项目走proxy代理后端接口,构建发布到生产等环境后,如何修改api接口
web前端开发项目走proxy代理后端接口,构建发布到生产等环境后,如何修改api接口
83 0
|
5月前
|
JavaScript Java 测试技术
基于Java的校内信息服务发布系统的设计与实现(源码+lw+部署文档+讲解等)
基于Java的校内信息服务发布系统的设计与实现(源码+lw+部署文档+讲解等)
35 1
|
5月前
|
前端开发
基于若依的ruoyi-nbcio流程管理系统增加流程设计器支持自定义表单的选择与处理
基于若依的ruoyi-nbcio流程管理系统增加流程设计器支持自定义表单的选择与处理
83 0
|
5月前
|
小程序 IDE 程序员
【社区每周】my.openDocument接口增加更多预览文件类型(10月第二期)
【社区每周】my.openDocument接口增加更多预览文件类型(10月第二期)
73 11
|
5月前
|
数据可视化 API uml
【有奖调研】开发文档功能升级:接口分组更清晰;增加参数中文名
【有奖调研】开发文档功能升级:接口分组更清晰;增加参数中文名
58 0
|
网络协议 开发工具 Android开发
​​Android平台GB28181历史视音频文件下载规范探讨及技术实现
​​Android平台GB28181历史视音频文件下载规范探讨及技术实现
166 1
|
JSON 监控 API
php对接小鹅通API开发高级实战案例解析:获取指定资源学习记录信息(单人单学习记录、单人多学习记录累计、返回数据格式确认)
php对接小鹅通API开发高级实战案例解析:获取指定资源学习记录信息(单人单学习记录、单人多学习记录累计、返回数据格式确认)
297 0
|
存储 文字识别 API
梦的解析 —— 周公版,包括【周公解梦】在内的超多免费可用 API 推荐(二)
梦是人们日常生活中经常出现的现象,人们对梦的解析一直是一个重要的研究领域。周公解梦是中国古代传统文化中的一部分,它对于梦的解析提供了很多有价值的参考,成为了梦解释的重要参考工具之一。
269 0
梦的解析 —— 周公版,包括【周公解梦】在内的超多免费可用 API  推荐(二)