HTTP接口RPC接口都是生产上常用的接口,顾名思义,HTTP接口使用基于HTTP协议的URL传参调用,而RPC接口则基于远程过程调用。RPC(即Remote Procedure Call,远程过程调用)和HTTP(HyperText Transfer Protocol,超文本传输协议),两者前者是一种方法,后者则是一种协议。两者都常用于实现服务,在这个层面最本质的区别是RPC服务主要工作在TC
转载 2024-04-09 08:57:11
53阅读
--- title: Java后端接口设计规范 --- ## 概述 本文旨在教会刚入行的小白如何实现Java后端接口设计规范。首先,我们将介绍整个流程的步骤,然后详细说明每一步需要做什么,并提供相应的代码示例。 ## 流程图 ```mermaid flowchart TD A[定义接口] --> B[实现接口] B --> C[添加请求参数] C --> D[处理请
原创 2023-08-27 04:35:39
109阅读
RPC(Remote Procedure Call):远程过程调用,它是一种通过网络从远程计算机程序上请求服务,而不需要了解底层网络技术的思想。RPC 是一种技术思想而非一种规范或协议,常见 RPC 技术和框架有:应用级的服务框架:阿里的 Dubbo/Dubbox、Google gRPC、Spring Boot/Spring Cloud。远程通信协议:RMI、Socket、SOAP(HTTP XM
转载 2024-03-24 10:18:05
90阅读
基本原则单一职责:一个接口只做一个行为,避免大而全的接口,避免出现根据入参控制接口行为的情况,这种情 接口的java
接口规范 查询类接口使用GET,修改类接口(新增,修改,删除)使用POST 接口设计 http://{domain}/{end}/{resource}/{subresource} domain:服务域名; end:客户端;如:mp(卖家中心)、platform(erp后台)、publics(开放ap ...
转载 2021-10-21 09:52:00
322阅读
2评论
设计接口时,有很多因素要考虑:接口的业务定位接口的安全性接口的可扩展性接口的稳定性接口的跨域性接口的协议规则接口的路径规则接口单一原则接口过滤及接口组合本篇文章将简要分析这些因素。 一 规范性建议1.职责原则在设计接口时,必须明确接口的职责,即接口类型,接口应解决什么业务问题等2.单一性原则在明确接口职责的条件下,尽量做到接口单一,即一个接口只做一件事,而非两件以上。很多非资深接口设计
命名风格类名使用UpperCamelCase风格,必须遵从驼峰形式,但以下情形例外:DO/BO/DTO/VO/AO正例:MarcoPolo/UserDO/XmlService/TcpUdpDeal/TaPromotion反例:marcoPolo/userDo/XMLService/TCPUDPDeal/TAPromotion方法名、参数名、成员变量、局部变量都统一使用lowerCamelCase风
转载 2024-02-02 08:40:37
93阅读
概述 这篇文章分享 API 接口设计规范,目的是提供给研发人员做参考。 规范是死的,人是活的,希望自己定的规范
转载 2020-09-25 15:32:00
255阅读
2评论
...
转载 2020-03-23 07:35:00
293阅读
2评论
# Java 接口设计规范 ## 1. 引言 Java 接口是一种定义类之间交互的契约,它规定了类要实现的方法和属性。良好的接口设计能够提高代码的可读性和可维护性,减少代码耦合度。本文旨在向刚入行的开发者介绍如何实现 Java 接口设计规范。 ## 2. 实现步骤 下表展示了实现 Java 接口设计规范的步骤: | 步骤 | 描述 | |---|---| | 步骤 1 | 确定接口的目的
原创 2024-01-26 10:28:39
171阅读
那么接口在开始之前,你觉得需要有哪些规范呢?下面我就介绍一下以前我在公司开展接口项目时,制定的一些针对接口项目的约定规范。(当然不同公司可以根据公司文化、项目差异自行制定,不一定我们的就是最好的,找到一套适合自己的才是关键)
原创 2021-07-08 14:25:34
287阅读
优秀的设计是产品变得卓越的原因。设计API意味着提供有效的接口,可以帮助API使用者更好地了解、使用和集成,同时帮助人们有效地维护它。每个产品都需要使用手册,API也不例外。
推荐 原创 2021-07-05 10:15:30
4316阅读
3点赞
接口(API)设计规范一、接口(API)设计规范1.1 基本规范1.1.1 公共参数1.1.2 响应数据1.1.3 字段类型规范1.1.4 上传/下载1.1.5 避免精度丢失
Controller接口设计规范1. 签名接口请求方将请求参数 + 时间戳 + 密钥拼接成一个字符串,然后通过md5等hash算法,生成一个前面sign签名中为什么要加时间戳?答:为了安全性考虑,防止同一次请求被反复利用,增加了密钥没破解的可能性,我们必须要对每次请求都设置一个合理的过期时间,比如:15分钟。2. 加密需要对数据进行非对称加密。3. ip白名单需求限制请求ip,增加ip白名单。4.
原创 9月前
0阅读
概述这篇文章分享 API 接口设计规范,目的是提供给研发人员做参考。规范是死的,人是活的,希望自己定的规范,不要被打脸。路由命名规范动作前缀备注获取getget{XXX}获取getget{XXX}List新增addadd{XXX}修改updateupdate{XXX}保存savesave{XXX}删除deletedelete{XXX}上传uploadupload{XXX}发送sendsend{XX
原创 2021-04-27 16:37:28
1604阅读
1. 前言 继前面一章《RobotFramework环境搭建》介绍了在本地如何将接口自动化实施过程所需要的基础环境搭建好,在这里假设大家都已经知道环境如何搭建了,如果不清楚的可直接查看上一章节 RobotFrameWork环境搭建(基于HTTP协议的接口自动化),那么环境一切ready了,是不是代表
转载 2021-04-23 21:06:18
273阅读
    1前言    继前面一章《RobotFramework环境搭建》介绍了在本地如何将接口自动化实施过程所需要的基础环境搭建好,在这里假设大家都已经知道环境如何搭建了,如果不清楚的可直接查看上一章节 RobotFrameWork环境搭建(基于HTTP协议的接口自动化),那么环境一切ready了,是不是代表就可以开干了呢?    不急,对于一个team在开展这类大工程的时候,要考虑到团队多人协作
原创 2021-04-25 15:16:11
280阅读
1.RESTful接口设计规范是什么? RESTful 接口设计规范是一种设计和构建网络服务的标准方式,它依赖于 HTTP 协议,注重简洁和可扩展性。 2.为什么要使用RESTful接口设计规范? 使用 RESTful 接口设计规范有助于创建高效、易于理解和扩展的网络服务。它基于 HTTP 协议,利用标准动词(如 GET、POST)进行资源操作,使接口设计简洁一致,便于开发和维护。RESTful
原创 2024-09-13 15:32:35
72阅读
说明:在实际的业务中,难免会跟第三方系统进行数据的交互与传递,那么如何保证数据在传输过程中的安全呢(防窃取)?除了https的协议之外,能不能加上通用的一套算法以及规范来保证传输的安全性呢?下面我们就来讨论下常用的一些API设计的安全方法,可能不一定是最好的,有更牛逼的实现方式,但是这篇是我自己的经验分享.一、token 简介Token:访问令牌access token, 用于接口中, 用于标识接
原创 2023-07-28 14:31:06
117阅读
概述这篇文章分享 API 接口设计规范,目的是提供给研发人员做参考。规范是死的,人是活的,希望自己定的规范,不要被打脸。路由命名规范动作前缀备注获取getget{XXX}获取getget{XXX}List新增addadd{XXX}修改updateupdate{XXX}保存savesave{XXX}删除deletedelete{XXX}上传uploadupload{XXX}发送sendsend{XX
原创 2023-08-10 14:40:18
150阅读
  • 1
  • 2
  • 3
  • 4
  • 5