nodejs之multiparty插件使用简析

Posted 2020-10-14 木森焱

         Multiparty是用来解析FormData数据的一款插件，还有一款与之功能相同的插件，叫Formidable。没有使用过这款插件，这里就不多说了，只是简单的提一下。接下来继续说Multiparty。先提供下官方API链接：Click Here。英文版的，英语好的可以去看一下。

              使用Multiparty这款插件，首先需要安装：npm install multipary。然后引用该插件，并实例化插件:。插件的构造函数接收一个对象作为参数，参数是可选的，可以不不穿。参数的属性有：encoding：formdata的数据设置编码，默认是utf-8。 maxFieldsSize:限制字段，按字节分配的内存量，默认是2M，超出则会产生错误。 maxFields：限制被解析字段的数量，默认为1000。maxFilesSize：此属性只有在autoFiles为true的时候生效，设置上传文件接收字节的最大数量。也就是限制最大能上传多大的文件。autoFields：启用字段事件，并禁用字段的部分时间。如果监听字段事件，该属性自动为true。 autoFiles：启用文件事件，并禁用部分文件事件，如果监听文件事件，则默认为true。uploadDir：放置文件的目录，只有autoFiels为true是有用。

              实例化完构造函数后，开始正式解析FormData数据。利用parse()方法来解析。方法接收两个参数，无返回值。第一个参数为request对象，把创建服务时，回掉函数中的第一个参数传进去就可以。第二个参数是cb，一个回掉函数，通过该回掉函数，可以获取到解析后的数据。如果你是上传文件，使用这个回调函数的话。那我可以很荣幸的告诉你，你不需要在执行写入文件的工作了，因为插件已经完成了。你只需要设置好uploadDir属性，然后做些后续操作就可以了。因为回掉函数会默认开启autoFields和autoFlies。个人感觉应该是内部监听field和file事件。继续说回调函数，它有三个参数，第一个参数是err，第二个参数是fields，第三个参数是flies。err是发生错误时，返回的异常信息。fields是一个对象，存储着FormData里的字段信息。files存储的是文件信息。如果你把整个file对象直接放进formData内，则有值，否则为空对象。假如你想自己写文件的话，这个回调函数完全可以忽略掉。

              那自己写文件，如何写呢？众所周知，nodejs是靠事件驱动的，它通过事件来实现异步编程，来达到其它后台语言多线程的效果。作为基于nodejs实现的插件，事件肯定是必不可少的，而它提供的这些事件，提供了自己写文件的通道。

              part事件，之所以先说这个事件，因为它是实现自己写文件的关键。该事件会在请求中遇到文件数据时触发，它的回调函数是一个实现可读流的实例对象。对象提供的属性有headers：存储着请求的头部信息。name：字段名称。filename：文件名称。byteFffset:这部分数据，在主体数据中的字节偏移量。byteCount：数据总的字节长度。注意使用part事件时，不要再去监听fields和files事件。如果监听了的话，那在part事件中，你将得不到你想要的数据。

         这是一段写文件的代码仅供参考。

        aborted事件会在请求中止时触发。

        close事件会在请求结束之后触发。

        file事件，如果发送的是文件，则可以监听该事件。监听此事件，插件会把文件写到磁盘上，在利用回调返回相关信息。参数一name：字段名称。参数二file：存储着文件信息的对象。属性有：fieldName：字段名称。originalFilename：文件名称。path：写到磁盘上文件的具体路径。headers：存储着头部信息。size：文件具体大小。

        field事件，监听此事件，可以获取到请求中的具体数据。回调函数两个参数。name：字段名。value：字段值。

        这些就是multiparty插件的一些api的介绍，有写的不对的地方，还请大神指正。