最近公司的一个前端同事和一个后端同事吵了一架,事情大概是这样的。后端说要联调接口,前端说你的数据尽量按我的要求来,后端不干,说你这个没用。前端就讲道理呀,传统的前后端分离返回的格式要尽量规范,这样才好处理……后端同意了。

很快,啪的一下,前端这边请求刚发出去,立马就返回了。谁知大意了没有闪,一个Code码,一个字符串,一个数组,全部接受转换成了模型,再正常处理业务逻辑和页面展示,前端笑了笑提交测试,很快,一上正式环境程序就崩溃了。原来是字符串没有判空,前端说后端你不讲码德,后端说对不起,是我不懂规矩,我是乱打的代码。好家伙,一个训练有素的练家子会乱打?这明明是来糊弄咱老前端,不讲码德!

朋友只能劝他耗子尾汁,好好反思,以后不要再耍这种小聪明,毕竟程序员要以和为贵,搞窝里斗是万万不可的,求求不要再把空值异常抛给前端了!
其实在开发过程中,前后端还会存在其他分歧,比如前端希望根据 UI 来划分接口,这样用户体验好,前端实现也容易。后端则更希望根据业务模块划分接口,这样有利于服务下沉和解耦。
于是前后端间可能会出现如下对话:
后端:你多调几个接口不就行了么~
前端:多好几个 HTTP 请求呢。包成一个接口有这么难么?
前端和后端各有各的道理,还都不肯退让,互相扯皮,互相看不顺眼,所以今天来分析分析后端开发者的痛点。
对于后端工程师来说,写接口文档是很枯燥乏味的工作。往往写好一个规范的接口文档也不会让后端工程师有特别的成就感,但写好一个接口文档需要填写各个琐碎的字段。所以大家都更加愿意把时间花在编码上,仅草草的应付接口文档的编写工作。但在研发团队协作中接口文档编写是否规范,将影响到其他调用方对该接口的理解,文档是否详实一定程度上决定了对接联调的时间。
后端工程师在接口开发过程中,需要频繁的进行接口文档调整,自测接口是否能输出想要的结果。这时候就会遇到一个问题,传统接口工具的测试比较单一,且测试数据编写麻烦,返回错误不容易定位。接口开发过程中,这样的调试过程需要循环多次,极不方便。
一般swagger文档是以某个服务为整体管理该服务下的API接口文档。在联调过程中,后端工程师需要把新增的或需要联调的多个接口分享给对接人时,只能把整个服务文档地址分享出去。然后截图告知是哪几个接口是本次有变更的,或者本次需要对接的。对于对接联调来说,十分不便。
在日常的软件团队中,经常会遇到需要借调或接手一个新项目。但令前后端工程师抓狂的是,很多时候会遇到新接手的项目没有任何接口文档,或者文档并不规范。而“前人”已无法联系了,这座代码*山变成了不可攀越的高峰。
针对上述痛点,今天给大家推荐一款专业级的一站式API协作平台Eolink。下面带大家看看Eolink是如何解决后端开发者的痛点。

体验地址:https://www.eolink.com/?utm_source=w3806
Eolink提供IDEA插件,可以基于代码一键生成API文档并同步到Eolink对应的项目中。接口文章除了提供展示标准的基础信息、请求参数、响应参数等字段后。还可以增加例如字段额外说明,标签,接口状态等信息。若需要更加规范的文档内容,那么Eolink提供API文档模板和数据结构的功能,可以按各公司的需要生成对应的模板,开发者直接复用减少重复工作的同时,使得文档更加规范可读。
Eolink 的API文档中文档编辑和测试是两个相邻的功能按钮,符合后端工程师日常的工作场景。编辑完文档后,可快速切换到测试界面进行调试。并且系统会自动根据文档参数类型和约束条件,自动填入测试数据,后端工程师仅需点击测试按钮即可完成接口调试,省时省心更省力。
Eolink 支持多种场景的API文档分享。可和swagger一样把全项目接口文档进行快速分享,也可以设置分享文档的可见范围,仅分享本次对接相关的接口。也可以对文档设置分享密码,提高资产安全性。更可以把测试用例等信息同步分享,调用方可快速使用测试用例了解接口返回情况。
Eolink是一个一站式智能协作的API管理平台,能把企业内所有的项目按自定义的标准规范模板,沉淀在统一的API接口仓库中。无论前后端工程师去到哪个项目,即可获得一份熟悉又标准的接口文档供你使用。
以上功能,给后端后端联调提供了很好的帮助。后端再也不用为了写接口文档而烦躁,更不用担心接口文档规范的问题。前端也不用再担心多接口时没有分类菜单、JSON 参数不能格式化、返回结果不能折叠、参数出错的时候查找麻烦等一系列的问题。
体验地址:https://www.eolink.com/?utm_source=w3806
除了上述特点以外我还发现 Eolink 几个隐藏的亮点功能,用起来特别香!
API变更智能通知
API文档评论功能
API历史版本比对
定时测试任务
支持数据驱动
项目分析报表
我直接上图,大家一看就懂。

当 API 发生变化时通过邮件和站内信自动通知相关成员,并且已与QQ和飞书打通

直接在 API 文档上发布评论,沟通内容会跟随 API 文档不同版本存档

回滚查看API文档历史版本,智能查找不同版本文档差异

Eolink支持定时测试任务,或者将 API 自动化测试平台集成到Jenkins上,实现代码提交即触发测试,实现项目在无人值守的情况下自动测试,解放劳动力

通过数据驱动模拟多种场景,以此来看场景用例执行情况,避免测试流程空跑,使测试案例更接近真实

强大的项目数据统计分析功能和醒目的可视化呈现,团队开发工作一目了然
运用这些小亮点可以使团队合作更加融洽,项目管理更加方便。在测试方面实现了项目在无人值守的情况下自动测试,解放劳动力。在文档方面实现当API发生变化时可以立刻通知相关成员,并且API文档下还可以评论,使沟通更加方便。如果文档出现问题也可以通过历史版本回滚来比对找出问题。
体验地址:https://www.eolink.com/?utm_source=w3806
至此,Eolink 常用的核心功能已经介绍完了,但Eolink 的强大并不限于此,在团队管理、协同管理、项目管理的多个方面都表现的很优秀,目前 SaaS 产品完全免费,你可使用 web 版,也可下载桌面端,Windows、Mac、Linux 平台均支持!如果你还没有用过,建议尝试一下,相信用过之后,一定会爱上!
体验地址:https://www.eolink.com/?utm_source=w3806
我正在编写一个包含C扩展的gem。通常当我写一个gem时,我会遵循TDD的过程,我会写一个失败的规范,然后处理代码直到它通过,等等......在“ext/mygem/mygem.c”中我的C扩展和在gemspec的“扩展”中配置的有效extconf.rb,如何运行我的规范并仍然加载我的C扩展?当我更改C代码时,我需要采取哪些步骤来重新编译代码?这可能是个愚蠢的问题,但是从我的gem的开发源代码树中输入“bundleinstall”不会构建任何native扩展。当我手动运行rubyext/mygem/extconf.rb时,我确实得到了一个Makefile(在整个项目的根目录中),然后当
我已经在Sinatra上创建了应用程序,它代表了一个简单的API。我想在生产和开发上进行部署。我想在部署时选择,是开发还是生产,一些方法的逻辑应该改变,这取决于部署类型。是否有任何想法,如何完成以及解决此问题的一些示例。例子:我有代码get'/api/test'doreturn"Itisdev"end但是在部署到生产环境之后我想在运行/api/test之后看到ItisPROD如何实现? 最佳答案 根据SinatraDocumentation:EnvironmentscanbesetthroughtheRACK_ENVenvironm
我们的git存储库中目前有一个Gemfile。但是,有一个gem我只在我的环境中本地使用(我的团队不使用它)。为了使用它,我必须将它添加到我们的Gemfile中,但每次我checkout到我们的master/dev主分支时,由于与跟踪的gemfile冲突,我必须删除它。我想要的是类似Gemfile.local的东西,它将继承从Gemfile导入的gems,但也允许在那里导入新的gems以供使用只有我的机器。此文件将在.gitignore中被忽略。这可能吗? 最佳答案 设置BUNDLE_GEMFILE环境变量:BUNDLE_GEMFI
这似乎非常适得其反,因为太多的gem会在window上破裂。我一直在处理很多mysql和ruby-mysqlgem问题(gem本身发生段错误,一个名为UnixSocket的类显然在Windows机器上不能正常工作,等等)。我只是在浪费时间吗?我应该转向不同的脚本语言吗? 最佳答案 我在Windows上使用Ruby的经验很少,但是当我开始使用Ruby时,我是在Windows上,我的总体印象是它不是Windows原生系统。因此,在主要使用Windows多年之后,开始使用Ruby促使我切换回原来的系统Unix,这次是Linux。Rub
我正在玩HTML5视频并且在ERB中有以下片段:mp4视频从在我的开发环境中运行的服务器很好地流式传输到chrome。然而firefox显示带有海报图像的视频播放器,但带有一个大X。问题似乎是mongrel不确定ogv扩展的mime类型,并且只返回text/plain,如curl所示:$curl-Ihttp://0.0.0.0:3000/pr6.ogvHTTP/1.1200OKConnection:closeDate:Mon,19Apr201012:33:50GMTLast-Modified:Sun,18Apr201012:46:07GMTContent-Type:text/plain
无论您是想搭建桌面端、WEB端或者移动端APP应用,HOOPSPlatform组件都可以为您提供弹性的3D集成架构,同时,由工业领域3D技术专家组成的HOOPS技术团队也能为您提供技术支持服务。如果您的客户期望有一种在多个平台(桌面/WEB/APP,而且某些客户端是“瘦”客户端)快速、方便地将数据接入到3D应用系统的解决方案,并且当访问数据时,在各个平台上的性能和用户体验保持一致,HOOPSPlatform将帮助您完成。利用HOOPSPlatform,您可以开发在任何环境下的3D基础应用架构。HOOPSPlatform可以帮您打造3D创新型产品,HOOPSSDK包含的技术有:快速且准确的CAD
在应用开发中,有时候我们需要获取系统的设备信息,用于数据上报和行为分析。那在鸿蒙系统中,我们应该怎么去获取设备的系统信息呢,比如说获取手机的系统版本号、手机的制造商、手机型号等数据。1、获取方式这里分为两种情况,一种是设备信息的获取,一种是系统信息的获取。1.1、获取设备信息获取设备信息,鸿蒙的SDK包为我们提供了DeviceInfo类,通过该类的一些静态方法,可以获取设备信息,DeviceInfo类的包路径为:ohos.system.DeviceInfo.具体的方法如下:ModifierandTypeMethodDescriptionstatic StringgetAbiList()Obt
@作者:SYFStrive @博客首页:HomePage📜:微信小程序📌:个人社区(欢迎大佬们加入)👉:社区链接🔗📌:觉得文章不错可以点点关注👉:专栏连接🔗💃:感谢支持,学累了可以先看小段由小胖给大家带来的街舞👉微信小程序(🔥)目录自定义组件-behaviors 1、什么是behaviors 2、behaviors的工作方式 3、创建behavior 4、导入并使用behavior 5、behavior中所有可用的节点 6、同名字段的覆盖和组合规则总结最后自定义组件-behaviors 1、什么是behaviorsbehaviors是小程序中,用于实现
了解Rails缓存如何工作的人可以真正帮助我。这是嵌套在Rails::Initializer.runblock中的代码:config.after_initializedoSomeClass.const_set'SOME_CONST','SOME_VAL'end现在,如果我运行script/server并发出请求,一切都很好。然而,在我的Rails应用程序的第二个请求中,一切都因单元化常量错误而变得糟糕。在生产模式下,我可以成功发出第二个请求,这意味着常量仍然存在。我已通过将以上内容更改为以下内容来解决问题:config.after_initializedorequire'some_cl
我有一个使用PDFKit呈现网页的pdf版本的Rails应用程序。我使用Thin作为开发服务器。问题是当我处于开发模式时。当我使用“bundleexecrailss”启动我的服务器并尝试呈现任何PDF时,整个过程会陷入僵局,因为当您呈现PDF时,会向服务器请求一些额外的资源,如图像和css,看起来只有一个线程.如何配置Rails开发服务器以运行多个工作线程?非常感谢。 最佳答案 我找到的最简单的解决方案是unicorn.geminstallunicorn创建一个unicorn.conf:worker_processes3然后使用它: