前端头像上传功能实现之普通图片/头像上传 详细解析1【扩展知识FormData对象】

上传的图片/头像有两种方案上传
第一种我们不对图片做处理直接上传到服务器端,把图片上传到服务器的img文件夹当中,然后我们把图片的地址信息存储在数据库当中,用图片的时候我们直接调用地址
第二种方案是我们在客户端(因为我们写出来的产品是客户肉眼可见,所以前端又称客户端)把图片转换为base64的格式,然后把图片的base64的内容直接存储在数据库当中,需要用到图片的时候我们直接把数据库内部的图片的base64信息,调用到前端的img标签的src属性当中.方案二我会在头像上传功能的详细解析2当中细细给大家分解实现过程.今天先讲解分析方案1的实现过程.

实现头像上传功能,我们需要用到上传的模块multer模块

实现图片上传知识储备:前端方面知识储备:第一我们需要懂FormData对象(之前没接触过图片上传的百分之七八十的人都应该不懂,所以我会在本文章的最后面去讲解FormData对象的相关知识.),第二我们要会用jQuery,第三我们要用到ajax请求。后端方面(也就是node.js方面的东西):第一我们要懂multer模块,第二我们要懂fs模块
,第三我们最基础的静态资源服务器至少需要懂。
(不管是方案二还是方案一)上传头像我们都离不开对multer模块的使用
俗话说:“工欲善其事,必先利其器。”我们第一步当然是先下载安装multer模块
使用的指令如下↓
npm install multer
安装完成后会看到package.json文件下面有相关依赖,如下图片显示的multer:^1.4.2
在这里插入图片描述

在这里插入图片描述

以下是后端代码node.js的详解以及注释

//我引入multer模块
var express=require("express")
var bodyParse=require("body-parser")
var path=require("path")
var fs=require("fs")
var multer  = require('multer')
// 创建一个multer中间件对象,注意一定别忘了要创建multer中间件对象
var upload = multer({})
var app=express()
// 开启静态资源服务器,访问图片的地址就是http://localhost:3000/img/hh0.5530300908602812.jpeg
app.use(express.static("./public"))
// 注意:上传图片我们在前端发请求的时候必须要用post请求方式
// 如下我 们使用upload这个中间件,我们使用.single("xixi")方法去定义上传图片字段的属性名为xixi,single方法定义只能单文件上传图片
// 如果想多文件上传(图片)我们就得使用.array('photos', 12)第一个参数表示字段名,第二个参数表示限制上传多少个文件,填数字
// 单文件上传我们接受文件信息用req.file,多文件上传我们用req.files去接收
app.post("/file",upload.single("xixi"),(req,res)=>{
    // req.file表示上传文件信息,默认是不存在的,只有被multer中间件处理过之后才有,如下我们打印
    //上面这句话的意思简而言之,就是你发起post上传图片的请求了,有图片上传了才能打印出req.file的信息来
    console.log(req.file);
    var {buffer,mimetype,encoding,originalname,fieldname,size}=req.file
    //req.file是一个对象,它里面的buffer属性就是我们要写入文件夹的图片
    // 将buffer写入到文件内部,为了防止后面的图片文件覆盖前面的图片文件,所以我们要使用时间戳让文件名无法重复
    // 判断尺寸size表示图片的大小
    console.log(size);
    if(size>=5000000){
        return res.send({err:-1,mgs:"图片尺寸过大"})
    }
    // 限制图片文件格式类型 1.前端判断  2.后端判断
    var typs=["jpg","gif","png","jpeg"]
    var extName=mimetype.split("/")[1]
    if(typs.indexOf(extName)===-1){
    return res.send({err:-2,mgs:"图片类型错误!"})
    }

    var t=Math.random()
    var ext=req.file.mimetype.split("/")[1]
   // 然后用fs模块写入图片到img文件夹下
    fs.writeFile(path.join(__dirname,"./public/img/"+t+"."+ext),buffer,(err)=>{
        if(err){
            console.log(err);
            res.send({jg:"图片上传失败!"})
        }else{
            res.send({jg:"图片上传成功!",path:`/img/${t}.${extName}`})
        }
    })
})
app.listen(3000,()=>{
    console.log("服务器端口3000启动成功!");
})

下面是前端的html代码

<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>文件上传小案例</title>
</head>
<body>
    <input type="file" id="file" multiple="multiple">
    <div><button id="cs">请选择上传一张图片</button></div>
    <p>缩略图:</p>
    <img src="" alt="" class="slt">
</body>
<script src="https://cdn.bootcdn.net/ajax/libs/jquery/3.5.1/jquery.js"></script>
<script>
    // 1.用户选择图片
    // 2.通过ajax上传图片
    cs.onclick = function () {
        // document.querySelector("#file").files是一个对象,表示列表清单
        var file1 = document.querySelector("#file").files
        console.log(file1);
        //我们用对象的中括号语法获取图片信息
        var file = document.querySelector("#file").files[0]
        // console.log(Object.prototype.toString.call(file));
        console.log(file);
        // 图片上传的格式不是表单x-www-form-urlencoded
        // 也不是json格式
        // 而是formdata格式  
        // 所以我们要将图片信息转化成到formdata对象当中
        // 如下我们new创建一个FormData对象
        // 使用内置构造函数创建的对象,new出来的 FormData对象跟普通的对象不同。
        // 如果 想在FormData对象内部添加字段就要用到append()方法
        // append()方法有两个参数第一个是字段属性名,参数二为字段属性值
        var data = new FormData()
        // key值跟接口统一注意了,这一点很重要,为什么我给大家先分析node.js的后端代码也是这个原因,
        //因为我们append方法的参数一需要与在后端用single("xixi")方法设置好的xixi字段名统一
        //后台给你写的是xixi你就不能用别的字段去传否则就会上传失败【重点重点重点重要的事情说三遍】
        data.append("xixi", file)
        // FormData对象 默认打印不是我们想要的列表信息 通过get方法获取才可以获取到比如下面的
        data.get("xixi")		
        console.log("没有使用get方法打印为FormData→", data);
        console.log("通过get方法获取后→", data.get("xixi"));
        $.ajax({
            // 请求路径url
            url: "http://localhost:3000/file",
            // 请求类型type
            type: "POST",
            // 请求信息中携带的字段数据data,也就是FormData对象
            data: data,
            // 发起ajax请求默认不是表单就是json格式,上传图片时我们都不需要,所以就取消格式
            contentType:false,
            // 设置processData:false是因为jQuery会默认将数据进行格式化处理,我们图片上传不需要就取消默认
            processData:false,
            // 回调函数:
            // 回调函数中也有分类:
            // 1.请求成功的时候;→success
            // 参数不用记:1.responseText 2.状态 3.xhr对象;
            success: function (res, state, arguments) {
                console.log(arguments)
                console.log(state)
                console.log("成功", res)
            var body=document.querySelector("body")
            var h1=document.createElement("h1")
            h1.innerHTML=res
            body.appendChild(h1)
            var {jg,path}=res
            console.log(jg,path);
            if(jg=="图片上传成功!"){
                $(".slt").attr("src",path)
                alert(jg)
            }
            },
            // 2.请求完成的时候;→complete
            complete:function(xhr,state){
                console.log(1)
                console.log("完成",xhr,state)
            },
            // 3.请求失败的时候;→error
            error:function(xhr,state,errmsg){
            console.log("失败:error",xhr,state,errmsg,arguments)
            },
            // 根据状态码处理异常情况
            // 传参的形式比较特别:以一个对象的形式出现
            // statusCode:{状态码:状态码下执行的函数}
            statusCode:{
                // 404状态码说明:服务器找不到你请求的URL,地址错误.
                404:function(){
                    alert("抱歉,您的页面丢失了")
                },
                // 500状态码说明:服务器内部错误,后端代码写错了.
                500:function(){
                    alert("抱歉,我们的服务器爆炸了")
                },
                // 403状态码:说明服务器拒绝了你的请求.
                403:function(){
                    alert("抱歉,服务器拒绝访问")
                },
            }
        })
    }
</script>
</html>

结合上面的html文档以及node.js当中的js文件我们就可以完美的实现,图片上传了。

有些小伙伴可能不了解FormData对象的那么我下面给大家分析一下给大家扩展一些FormData对象的小知识

利用FormData对象,你可以使用一系列的键值对来模拟一个完整的表单,然后使用XMLHttpRequest发送这个"表单".

创建一个FormData对象
你可以先创建一个空的FormData对象,然后使用append()方法向该对象里添加字段,如下:

var oMyForm = new FormData();
 
oMyForm.append("username", "Groucho");
oMyForm.append("accountnum", 123456);
 // 数字123456被立即转换成字符串"123456"
// fileInputElement中已经包含了用户所选择的文件
oMyForm.append("userfile", fileInputElement.files[0]);
 
var oFileBody = "<a id="a"><b id="b">hey!</b></a>";
 // Blob对象包含的文件内容
var oBlob = new Blob([oFileBody], { type: "text/xml"});
 
oMyForm.append("webmasterfile", oBlob);
 
var oReq = new XMLHttpRequest();
oReq.open("POST", "http://foo.com/submitform.php");
oReq.send(oMyForm);: 字段"userfile""webmasterfile"的值都包含了一个文件.通过 FormData.append()方法赋给字段"accountnum"的数字被自动转换为字符(字段的值可以是一个Blob对象,一个File对象,或者一个字符串,剩下其他类型的值都会被自动转换成字符串).
在该例子中,我们创建了一个名为oMyForm的FormData对象,该对象中包含了名为"username", "accountnum", "userfile" 以及 "webmasterfile"的字段名,然后使用XMLHttpRequest的send()方法把这些数据发送了出去."webmasterfile"字段的值不是一个字符串,还是一个Blob对象.

使用HTML表单来初始化一个FormData对象
可以用一个已有的<form>元素来初始化FormData对象,只需要把这个form元素作为参数传入FormData构造函数即可:

var newFormData = new FormData(someFormElement);
例如:

var formElement = document.getElementById("myFormElement");
var oReq = new XMLHttpRequest();
oReq.open("POST", "submitform.php");
oReq.send(new FormData(formElement));
你还可以在已有表单数据的基础上,继续添加新的键值对,如下:

var formElement = document.getElementById("myFormElement");
formData = new FormData(formElement);
formData.append("serialnumber", serialNumber++);
oReq.send(formData);
你可以通过这种方式添加一些不想让用户编辑的固定字段,然后再发送.

使用FormData对象发送文件
你还可以使用FormData来发送二进制文件.首先在HTML中要有一个包含了文件输入框的form元素:

<form enctype="multipart/form-data" method="post" name="fileinfo">
  <label>Your email address:</label>
  <input type="email" autocomplete="on" autofocus name="userid" placeholder="email" required size="32" maxlength="64" /><br />
  <label>Custom file label:</label>
  <input type="text" name="filelabel" size="12" maxlength="32" /><br />
  <label>File to stash:</label>
  <input type="file" name="file" required />
</form>
<div id="output"></div>
<a href="javascript:sendForm()">Stash the file!</a>
然后你就可以使用下面的代码来异步的上传用户所选择的文件:

function sendForm() {
  var oOutput = document.getElementById("output");
  var oData = new FormData(document.forms.namedItem("fileinfo"));
 
  oData.append("CustomField", "This is some extra data");
 
  var oReq = new XMLHttpRequest();
  oReq.open("POST", "stash.php", true);
  oReq.onload = function(oEvent) {
    if (oReq.status == 200) {
      oOutput.innerHTML = "Uploaded!";
    } else {
      oOutput.innerHTML = "Error " + oReq.status + " occurred uploading your file.<br \/>";
    }
  };
 
  oReq.send(oData);
}
你还可以不借助HTML表单,直接向FormData对象中添加一个File对象或者一个Blob对象:

data.append("myfile", myBlob);
如果FormData对象中的某个字段值是一个Blob对象,则在发送http请求时,代表该Blob对象所包含文件的文件名的"Content-Disposition"请求头的值在不同的浏览器下有所不同,Firefox使用了固定的字符串"blob,"而Chrome使用了一个随机字符串.

你还可以使用jQuery来发送FormData,但必须要正确的设置相关选项:

var fd = new FormData(document.getElementById("fileinfo"));
fd.append("CustomField", "This is some extra data");
$.ajax({
  url: "stash.php",
  type: "POST",
  data: fd,
  processData: false, 
 // 告诉jQuery不要去处理发送的数据
  contentType: false  
 // 告诉jQuery不要去设置Content-Type请求头
.创建一个formData对象实例的方式
1、创建一个空对象

var formData = new FormData();//通过append方法添加数据
1
2、使用已有表单来初始化对象

//表单示例
<form id="myForm" action="" method="post">
    <input type="text" name="name">名字
    <input type="password" name="psw">密码
    <input type="submit" value="提交">
</form>

//方法示例
// 获取页面已有的一个form表单
var form = document.getElementById("myForm");
// 用表单来初始化
var formData = new FormData(form);
// 我们可以根据name来访问表单中的字段
var name = formData.get("name"); // 获取名字
var psw = formData.get("psw"); // 获取密码
// 当然也可以在此基础上,添加其他数据
formData.append("token","kshdfiwi3rh");. 操作方法
formData里面存储的数据是以健值对的形式存在的,key是唯一的,一个key可能对应多个value。 
如果是使用表单初始化,每一个表单字段对应一条数据,它们的HTML name属性即为key值,它们value属性对应value值。 
1.获取值

//通过get(key)/getAll(key)来获取对应的value
formData.get("name"); // 获取key为name的第一个值
formData.get("name"); // 返回一个数组,获取key为name的所有值

2 添加数据

//通过append(key, value)来添加数据,如果指定的key不存在则会新增一条数据,如果key存在,则添加到数据的末尾
formData.append("k1", "v1");
formData.append("k1", "v2");
formData.append("k1", "v3");

获取值时方式及结果如下

formData.get("k1"); // "v1"
formData.getAll("k1"); // ["v1","v2","v3"]
3.设置修改数据

//set(key, value)来设置修改数据,如果指定的key不存在则会新增一条,如果存在,则会修改对应的value值
formData.append("k1", "v1");
formData.set("k1", "1");
formData.getAll("k1"); // ["1"]
4.判断是否存在对应数据

//has(key)来判断是否对应的key值
formData.append("k1", "v1");
formData.append("k2",null);

formData.has("k1"); // true
formData.has("k2"); // true
formData.has("k3"); // false
5.删除数据

//delete(key)删除数据
formData.append("k1", "v1");
formData.append("k1", "v2");
formData.append("k1", "v1");
formData.delete("k1");

formData.getAll("k1"); // [].JQuery实例
//添加数据方式见上二。
//processData: false, contentType: false,多用来处理异步上传二进制文件。
 $.ajax({
    url: 'xxx',
    type: 'POST',
    data: formData,                    // 上传formdata封装的数据
    dataType: 'JSON',
    cache: false,                      // 不缓存
    processData: false,                // jQuery不要去处理发送的数据
    contentType: false,                // jQuery不要去设置Content-Type请求头
    success:function (data) {           //成功回调
        console.log(data);
    }
});
/**
 * 将以base64的图片url数据转换为Blob文件格式
 * @param urlData 用url方式表示的base64图片
 */
function convertBase64UrlToBlob(urlData) {
    var bytes = window.atob(urlData.split(',')[1]); //去掉url的头,并转换为byte
    //处理异常,将ascii码小于0的转换为大于0
    var ab = new ArrayBuffer(bytes.length);
    var ia = new Uint8Array(ab);
    for(var i = 0; i < bytes.length; i++) {
        ia[i] = bytes.charCodeAt(i);
    }
    return new Blob([ab], {
        type: 'image/png'
    });
}
  • 3
    点赞
  • 23
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值