REST API设计分析及实证研究
CSTR:
作者:
作者单位:

作者简介:

周芯宇(1996-), 女, 硕士, 主要研究领域为软件工程;陈伟(1980-), 男, 博士, 副研究员, CCF专业会员, 主要研究领域为智能软件工程, 服务计算, 网络分布式计算;吴国全(1979-), 男, 博士, 研究员, 博士生导师, CCF专业会员, 主要研究领域为软件工程, 软件测试与维护, 面向服务的计算;魏峻(1970-), 男, 博士, 研究员, 博士生导师, CCF高级会员, 主要研究领域为软件工程, 分布式系统, 服务计算

通讯作者:

陈伟, E-mail: wchen@otcaix.iscas.ac.cn

中图分类号:

TP311

基金项目:

国家重点研发计划(2017YFB1400602); 国家自然科学基金重点项目(61732019); 并行与分布处理国防科技重点实验室基金一般项目(61421102000402)


REST API Design Analysis and Empirical Study
Author:
Affiliation:

Fund Project:

  • 摘要
  • |
  • 图/表
  • |
  • 访问统计
  • |
  • 参考文献
  • |
  • 相似文献
  • |
  • 引证文献
  • |
  • 资源附件
  • |
  • 文章评论
    摘要:

    REST API已成为访问和使用Web服务的重要途径, 为开发基于服务架构的应用系统提供了可复用接口. 但是, REST API的设计质量参差不齐, 因此有效、合理的设计指导规范对于规范和提高REST API设计质量具有现实意义和应用价值. 首先, 基于REST API的本质内涵, 建立了一个多维度、两层次的REST API设计指导规范分类体系RADRC (REST API design rule catalog), 并对当前主流的25条设计指导规范进行分类. 其次, 针对已有规范提出相应的检测方法, 并实现了REST API设计指导规范遵循情况的分析与检测工具RESTer. 最后, 使用RESTer开展REST API设计实证研究, 分析了APIs.guru收录的近2000个真实REST API的文档, 从中分析提取相应的REST API信息, 进一步检测并统计当前REST API的设计特征和设计指导规范遵循情况. 研究发现不同应用类别的REST API在资源和操作模式上存在差异, 使得不同类别REST API在设计规则和总体架构方面各有特点. 实证研究结果有助于深入了解当前REST API及其设计规则的特征、现状和不足, 对于提高REST API设计质量和改进设计指导规范具有实际意义.

    Abstract:

    As an important way to access and use web services, REST API provides a technical means for developing and implementing service-oriented architecture-based application systems. However, REST API's design quality varies, so practical and reasonable design guidelines are essential for standardizing and improving REST API design quality. First of all, based on the connotation of REST API, a multi-dimensional, two-layered REST API design guideline classification framework REST API design rule catalog (RADRC) is established. Twenty-five popular design guidelines are classified based on RADRC. Secondly, a REST API design guideline compliance inspection tool, namely RESTer, is implemented. Finally, RESTer is employed to conduct an empirical study on current REST API design by analyzing nearly 2 000 real-world REST API documents from APIs.guru. RESTer analyzes the documents and extracts REST API design information for characterizing REST API design and inspecting compliance with the design guidelines. The empirical study finds that REST APIs of different application categories vary in resources and operation modes, making different categories REST APIs have the characteristics in terms of design guidelines and overall architecture. The empirical study results help understand the characteristics, status quo, and shortcomings of current REST APIs and their adoptions of design guidelines, which is practically significant to improve REST API design quality and design guidelines.

    参考文献
    相似文献
    引证文献
引用本文

周芯宇,陈伟,吴国全,魏峻. REST API设计分析及实证研究.软件学报,2022,33(9):3271-3296

复制
分享
文章指标
  • 点击次数:
  • 下载次数:
  • HTML阅读次数:
  • 引用次数:
历史
  • 收稿日期:2021-01-22
  • 最后修改日期:2021-03-31
  • 录用日期:
  • 在线发布日期: 2021-08-02
  • 出版日期: 2022-09-06
文章二维码
您是第位访问者
版权所有:中国科学院软件研究所 京ICP备05046678号-3
地址:北京市海淀区中关村南四街4号,邮政编码:100190
电话:010-62562563 传真:010-62562533 Email:jos@iscas.ac.cn
技术支持:北京勤云科技发展有限公司

京公网安备 11040202500063号