草庐IT

json - REST API - 文件(即图像)处理 - 最佳实践

coder 2023-04-29 原文

我们正在使用 REST API 开发服务器,它接受和响应 JSON。问题是,如果您需要将图像从客户端上传到服务器。

注意:我也在谈论一个用例,其中实体(用户)可以有多个文件(carPhoto、licensePhoto)并且还有其他属性(名称、电子邮件...),但是当您创建新用户时,您不发送这些图像,它们是在注册过程之后添加的。


我知道的解决方案,但每个都有一些缺陷

1.使用 multipart/form-data 代替 JSON

good : POST 和 PUT 请求尽可能 RESTful,它们可以包含文本输入和文件。

缺点:它不再是 JSON,与 multipart/form-data 相比,它更容易测试、调试等

<强>2。允许更新单独的文件

用于创建新用户的 POST 请求不允许添加图片(在我们的用例中我一开始说的那样可以),上传图片是通过 PUT 请求作为 multipart/form-data 完成的,例如/users/4/汽车照片

:一切(除了文件上传本身)都保留在 JSON 中,易于测试和调试(您可以记录完整的 JSON 请求而不必担心它们的长度)

缺点 : 这不直观,您不能一次 POST 或 PUT 实体的所有变量,而且这个地址 /users/4/carPhoto 可以被视为更多一个集合(REST API 的标准用例类似于 /users/4/shipments)。通常你不能(也不想)GET/PUT 实体的每个变量,例如 users/4/name 。您可以使用 GET 获取名称并在 users/4 使用 PUT 更改它。如果id后面有东西,一般是另外一个集合,比如users/4/reviews

3.使用 Base64

以 JSON 格式发送,但使用 Base64 编码文件。

good :和第一个解决方案一样,它尽可能是 RESTful 服务。

缺点:再一次,测试和调试更糟糕(主体可能有兆字节的数据),客户端和服务器的大小和处理时间都会增加 p>


我真的很想使用解决方案号。 2,但它有它的缺点......任何人都可以让我更好地了解“什么是最好的”解决方案?

我的目标是让 RESTful 服务包含尽可能多的标准,同时我想让它尽可能简单。

最佳答案

OP here(两年后我在回答这个问题,Daniel Cerecedo 的帖子一次还不错,但是网络服务发展很快)

经过三年的全职软件开发(同时专注于软件架构、项目管理和微服务架构)我肯定会选择第二种方式(但有一个通用端点)作为最佳方式.

如果您有一个特殊的图像端点,它会为您提供更多处理这些图像的权力。

我们为移动应用程序(iOS/android)和前端(使用 React)提供了相同的 REST API (Node.js)。这是 2017 年,因此您不想在本地存储图像,而是想将它们上传到某个云存储(Google 云、s3、cloudinary ......),因此您需要对它们进行一些常规处理。

我们的典型流程是,一旦您选择了一张图片,它就会开始在后台上传(通常是在/images 端点上发布),上传后返回您的 ID。这对用户来说非常友好,因为用户选择了一张图片,然后通常会继续处理其他一些字段(即地址、姓名等),因此当他点击“发送”按钮时,图片通常已经上传。他没有等待,而是看着屏幕说“正在上传……”。

获取图像也是如此。特别是由于手机和有限的移动数据,您不想发送原始图像,您想发送调整大小的图像,因此它们不会占用那么多带宽(并且为了使您的移动应用程序更快,您通常不希望要完全调整它的大小,您希望图像完全适合您的 View )。出于这个原因,优秀的应用程序会使用 cloudinary 之类的东西(或者我们确实有自己的图像服务器来调整大小)。

此外,如果数据不是私有(private)的,那么您只需将 URL 发送回应用程序/前端,然后它会直接从云存储下载,这可以为您的服务器节省大量带宽和处理时间。在我们更大的应用程序中,每个月都会下载大量 TB,您不想直接在每个专注于 CRUD 操作的 REST API 服务器上处理这些数据。您想在一个地方处理(我们的 Imageserver,它有缓存等),或者让云服务处理所有这些。


缺点:您应该想到的唯一“缺点”是“未分配图像”。用户选择图像并继续填写其他字段,但随后他说“不”并关闭应用程序或选项卡,但同时您成功上传了图像。这意味着您上传的图片没有分配到任何地方。

有几种处理方法。最简单的一个是“我不在乎”,这是一个相关的,如果这种情况不经常发生,或者您甚至希望存储用户发送给您的每个图像(出于任何原因)并且您不想要任何删除。

另一个也很简单 - 你有 CRON,即每周,你删除所有超过一周的未分配图像。

关于json - REST API - 文件(即图像)处理 - 最佳实践,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/33279153/

有关json - REST API - 文件(即图像)处理 - 最佳实践的更多相关文章

  1. ruby - 使用 RubyZip 生成 ZIP 文件时设置压缩级别 - 2

    我有一个Ruby程序,它使用rubyzip压缩XML文件的目录树。gem。我的问题是文件开始变得很重,我想提高压缩级别,因为压缩时间不是问题。我在rubyzipdocumentation中找不到一种为创建的ZIP文件指定压缩级别的方法。有人知道如何更改此设置吗?是否有另一个允许指定压缩级别的Ruby库? 最佳答案 这是我通过查看ruby​​zip内部创建的代码。level=Zlib::BEST_COMPRESSIONZip::ZipOutputStream.open(zip_file)do|zip|Dir.glob("**/*")d

  2. ruby-on-rails - 使用 Ruby on Rails 进行自动化测试 - 最佳实践 - 2

    很好奇,就使用ruby​​onrails自动化单元测试而言,你们正在做什么?您是否创建了一个脚本来在cron中运行rake作业并将结果邮寄给您?git中的预提交Hook?只是手动调用?我完全理解测试,但想知道在错误发生之前捕获错误的最佳实践是什么。让我们理所当然地认为测试本身是完美无缺的,并且可以正常工作。下一步是什么以确保他们在正确的时间将可能有害的结果传达给您? 最佳答案 不确定您到底想听什么,但是有几个级别的自动代码库控制:在处理某项功能时,您可以使用类似autotest的内容获得关于哪些有效,哪些无效的即时反馈。要确保您的提

  3. ruby - 其他文件中的 Rake 任务 - 2

    我试图在一个项目中使用rake,如果我把所有东西都放到Rakefile中,它会很大并且很难读取/找到东西,所以我试着将每个命名空间放在lib/rake中它自己的文件中,我添加了这个到我的rake文件的顶部:Dir['#{File.dirname(__FILE__)}/lib/rake/*.rake'].map{|f|requiref}它加载文件没问题,但没有任务。我现在只有一个.rake文件作为测试,名为“servers.rake”,它看起来像这样:namespace:serverdotask:testdoputs"test"endend所以当我运行rakeserver:testid时

  4. ruby-on-rails - 在 Rails 中将文件大小字符串转换为等效千字节 - 2

    我的目标是转换表单输入,例如“100兆字节”或“1GB”,并将其转换为我可以存储在数据库中的文件大小(以千字节为单位)。目前,我有这个:defquota_convert@regex=/([0-9]+)(.*)s/@sizes=%w{kilobytemegabytegigabyte}m=self.quota.match(@regex)if@sizes.include?m[2]eval("self.quota=#{m[1]}.#{m[2]}")endend这有效,但前提是输入是倍数(“gigabytes”,而不是“gigabyte”)并且由于使用了eval看起来疯狂不安全。所以,功能正常,

  5. ruby-on-rails - Rails 3 中的多个路由文件 - 2

    Rails2.3可以选择随时使用RouteSet#add_configuration_file添加更多路由。是否可以在Rails3项目中做同样的事情? 最佳答案 在config/application.rb中:config.paths.config.routes在Rails3.2(也可能是Rails3.1)中,使用:config.paths["config/routes"] 关于ruby-on-rails-Rails3中的多个路由文件,我们在StackOverflow上找到一个类似的问题

  6. ruby - 将差异补丁应用于字符串/文件 - 2

    对于具有离线功能的智能手机应用程序,我正在为Xml文件创建单向文本同步。我希望我的服务器将增量/差异(例如GNU差异补丁)发送到目标设备。这是计划:Time=0Server:hasversion_1ofXmlfile(~800kiB)Client:hasversion_1ofXmlfile(~800kiB)Time=1Server:hasversion_1andversion_2ofXmlfile(each~800kiB)computesdeltaoftheseversions(=patch)(~10kiB)sendspatchtoClient(~10kiBtransferred)Cl

  7. ruby - 如何将脚本文件的末尾读取为数据文件(Perl 或任何其他语言) - 2

    我正在寻找执行以下操作的正确语法(在Perl、Shell或Ruby中):#variabletoaccessthedatalinesappendedasafileEND_OF_SCRIPT_MARKERrawdatastartshereanditcontinues. 最佳答案 Perl用__DATA__做这个:#!/usr/bin/perlusestrict;usewarnings;while(){print;}__DATA__Texttoprintgoeshere 关于ruby-如何将脚

  8. ruby - 解析 RDFa、微数据等的最佳方式是什么,使用统一的模式/词汇(例如 schema.org)存储和显示信息 - 2

    我主要使用Ruby来执行此操作,但到目前为止我的攻击计划如下:使用gemsrdf、rdf-rdfa和rdf-microdata或mida来解析给定任何URI的数据。我认为最好映射到像schema.org这样的统一模式,例如使用这个yaml文件,它试图描述数据词汇表和opengraph到schema.org之间的转换:#SchemaXtoschema.orgconversion#data-vocabularyDV:name:namestreet-address:streetAddressregion:addressRegionlocality:addressLocalityphoto:i

  9. ruby - 如何指定 Rack 处理程序 - 2

    Rackup通过Rack的默认处理程序成功运行任何Rack应用程序。例如:classRackAppdefcall(environment)['200',{'Content-Type'=>'text/html'},["Helloworld"]]endendrunRackApp.new但是当最后一行更改为使用Rack的内置CGI处理程序时,rackup给出“NoMethodErrorat/undefinedmethod`call'fornil:NilClass”:Rack::Handler::CGI.runRackApp.newRack的其他内置处理程序也提出了同样的反对意见。例如Rack

  10. ruby - 使用 Vim Rails,您可以创建一个新的迁移文件并一次性打开它吗? - 2

    使用带有Rails插件的vim,您可以创建一个迁移文件,然后一次性打开该文件吗?textmate也可以这样吗? 最佳答案 你可以使用rails.vim然后做类似的事情::Rgeneratemigratonadd_foo_to_bar插件将打开迁移生成的文件,这正是您想要的。我不能代表textmate。 关于ruby-使用VimRails,您可以创建一个新的迁移文件并一次性打开它吗?,我们在StackOverflow上找到一个类似的问题: https://sta

随机推荐