Rust让这种情况彻底改观。Rust本身在系统开发方面就有不错的表现,社区中又出现了不少优秀的开源框架提供Web编程支持。 这其中老牌的Actix和新秀Rocket是用的比较多的两个。个人其实用Actix多一些,毕竟出来时间长,性能评测得分又比较高,社区还有比较好的支持。比如解决MultiPart FormData上传已经有了好用的工具箱awmp。 但作为万年不变的乙方代表,很多时候对于开发环境的选择还是做不到完全自主。Rocket也是不时的会用一下,Rocket易用性更好,上手容易。对于文件上传,工具本身也提供了一些粗糙的支持,但跟awmp比还是差了很多。
在对网上各种资源仔细搜索寻找之后,决定还是自己来写一个,这就是今天的rocket_upload。
工具背后做了很多事情来解析MultiPart FormData, 但用起来还是非常容易。 要做的事情只有三个,首先,在Cargo.toml文件中加入rocket-upload依赖:
第二,是在程序一开始对rocket_upload做引用:
最后,则是在请求处理函数中使用了,来看代码:
就我当前找遍全网的经历来看,这算最简单的MultiPart处理工具了吧。 对应的,把网页表单的代码也贴出来对比来看一下:
简单来说,在请求处理函数中,原有Restful风格,在URL中嵌入的变量,仍然采用Rocket原有的方式来声明和处理。
随后是MultipartDatas类型的变量,在本例中是data
。
变量结构类型分为两个部分,成员texts
中包含表单中除上传文件之外的字段,字段名称保存在key成员变量中,值保存在value成员变量中。
files
则包含表单中上传的文件,如果只有一个文件上传,那就是files[0]。表单字段名称保存在name成员,单独的文件名,也就是来自于MultiPart数据中的,保存在成员filename,缓存文件的完整路径保存在path成员。
因为缓存的文件在请求处理函数完成后就超出了作用域,从而被自动删除。所以如果想把文件长久保存下来,可以自己建立一个文件夹比如upload,然后使用f.persist(Path::new("upload"));
把文件拷贝过去。
这是使用拷贝而不是移动,是因为在很多系统中,/tmp
文件夹往往是内存卷,跟硬盘并不是同一个存储设备,直接移动的话,在某些系统中可能会报错,也无法真正将文件保存起来。
源码仓库地址:https://github.com/formoon/rocket-upload
本工具编写的时候,参考了原有的一个rocket扩展:https://crates.io/crates/rocket-multipart-form-data