- 综合排序
- 最热优先
- 最新优先
- 来自专栏程序人生
再谈 API 的撰写 - 契约
现代社会是个契约社会，生活中大大小小的事情都在和契约打交道。去奥莱买件衣服，一纸小票，便是你跟商家的契约：你花钱买到了产品，产品的问题商家会承诺处理（退换货）。 有副作用的函数尽管有诸多含混不清的地方，任然不失为一种契约。 函数级别的契约的所有当事人都是程序员，契约更新的影响面有限，所以遇到问题，姐弟俩一商量，改！新的契约就出现了。 然而，新的契约出现并不意味着旧的契约的终止，只有当所有使用旧契约的地方都改用新契约时，我们才能安全地废除旧契约。 REST API（以下凡提到 API，都指 REST API）是什么？REST API 是服务器和客户端之间的契约。这就意味着一个中小规模的 API，其 CEI 起码在 0.1 以上。 然而，API 写得再好，没有一个与之对应的契约，是万万不行的 —— 没有文档描述的 API 就如同没有说明书的产品。文档和代码，如同泉水干涸之后相呴以湿，相濡以沫的鱼儿，谁也离不开谁。
1.8K80发布于 2018-03-28 - 来自专栏FunTester
契约测试
契约测试 契约测试（contract test）第一次出现在Martin Fowler的一篇文章中。 只需要在满足测试需求的范围内，对于被测系统来说，确保测试替身提供的API与依赖组件提供的一样即可，API具体怎么实现的并不重要。 契约测试从消费者的角度定义测试，通过给API提供方提供契约，实现功能。 契约测试的核心原则是由消费者提出接口契约，由服务提供方实现，并用测试用例对契约进行约束，所以服务提供方在满足测试用例的情况下可以自行更改接口或架构实现而不影响消费者。 然而，在以下场景下目前并不适合应用Pact这类契约测试实践： 在测试过程中，代码需要调用公共API或者OAuth授权服务； 提供者端和消费者端没有良好的沟通渠道； 对提供者端进行功能性测试；
63430编辑于 2023-08-04 - 来自专栏测试技术圈
契约测试
系统的可靠性等于各个依赖服务的可靠性的乘积 也就是说:A服务的可靠性是99%，B服务的可靠性是99%，C服务 的可靠性是99%，如果⼀一个系统需要A调⽤用B，B调⽤用C，那么这个 系统的可靠性=0.99*0.99*0.99=0.9702 契约是规定得到多 ⽅方承认、信守的内容 契约测试是验证服务的Provider是否按照期望的⽅方式与服 务的Consumer进⾏行行交互，简单的说是Consumer与Provider两者之间的集成。 契约测试是以消费者提出接⼝口契约，交由服务提供⽅方实现，并以测试⽤用例例对 契约进⾏行行产⽣生约束，所以服务提供⽅方在满⾜足测试⽤用例例的情况下可以⾃自⾏行行更更改 接⼝口或架构实现⽽而不不影响消费者。 契约测试是⼀一种针对外部服务的接⼝口进⾏行行的测试，它能够验证服务是否满⾜足 消费⽅方期待的契约。 它的本质是从利利益相关者的⽬目标和动机出发，最⼤大限 度地满⾜足需求⽅方的业务价值实现。
95440发布于 2019-08-02 - 来自专栏ThoughtWorks
浅谈契约测试
为了解决这类的问题，契约测试应运而生。契约测试不是一个新鲜东西，但在实际项目经历中发现用好契约测试真的会大大增强开发的效率，因此写下这篇文章来简单总结一下契约测试的一些内容。 首先什么是契约测试 契约测试是一个为确保两个独立的系统或者微服务能够兼容并可以相互通信的一个方法，契约测试分为两种，一种是服务提供者驱动的，另一种是消费者驱动的。 契约测试形式上类似于API级别的UT，但其本质上还是个集成测试，比API测试在金字塔的位置更靠顶端，所以容易导致契约测试的数量增加和不稳定性增加。 可以并行开发 由于mock的存在，使得服务的消费方和提供方可以根据事先定义好的契约进行并行开发3. 发现问题后可以快速定位到问题： 因为问题只会出现在当前测试的服务或者组件中，你甚至可以确切的知道是哪个api测试fail了 4.
1.3K10编辑于 2022-07-26 - 来自专栏测试技术圈
实战契约测试
“ 消费者驱动契约测试对于API或微服务开发非常重要，它解耦了API提供者和消费者间的开发与测试过程。” API或微服务间的集成测试不容易，且成本高昂。 基于以上痛点，契约测试应运而生，它解耦了API提供者和消费者间的开发与测试过程。双方只需要约定对API接口的期望（假设提供者收到怎样的请求会产生怎样的响应）并通过一份“契约”把它固化下来。 其大致过程为： API消费者与提供者约定契约； Spring Cloud Contract的Maven/Gradle Plugin会自动根据契约生成JUnit的测试程序，供API提供者来测试其行为是否满足契约的预期 ； API提供者完成开发，通过第2步的测试来验证； API提供者通过Spring Cloud Contract的Maven/Gradle Plugin根据契约生成Stub，它将模拟API提供者的行为供消费者调用来测试 验证Stub 当契约准备好后，我们可以在API服务者端通过mvn install -DskipTests来生成Stub。
1.1K30发布于 2019-08-02 - 来自专栏贾维斯Echo的博客
Go 接口-契约介绍
Go 接口-契约介绍 一、接口基本介绍 1.1 接口类型介绍 接口是一种抽象类型，它定义了一组方法的契约，它规定了需要实现的所有方法。 (int64) fmt.Printf("v3=%d, the type of v3 is %T\n", v3, v3) // v3=13, the type of v3 is int64 v4 := 和生活工作中的契约有繁有简，签署方式多样一样，代码间的契约也有多有少，有大有小，而且达成契约的方式也有所不同。 所以 Go 选择了使用“小契约”，表现在代码上就是尽量定义小接口，即方法个数在 1~3 个之间的接口。 显然，我们会选择那些新接口类型需要的契约职责，同时也要求不要引入我们不需要的契约职责。
48350编辑于 2023-11-07 - 来自专栏ThoughtWorks
使用契约测试得不偿失？试试契约先行开发
消费方回去写自己的契约测试，生成契约 (通常以 OpenApi doc 形式)，然后以契约测试驱动，开发自己的逻辑 服务方拿到生成的契约，进行测试驱动开发，验证契约是否被满足 契约测试有时修改代价高 更重要的是，随着测试的编写，生成的契约可能比当时商讨的更为简单，比如一些 400, 401 等情况，有时并不会为每一个 API 写足够细节足够详尽的测试；也可能生成的契约比商讨的更为详细，比如消费方在编写契约测试的过程中考虑到了更多的边缘场景 因而每当由以上情况导致修改契约时，我们都会重新沟通，再等待消费方重新写契约测试，再生成契约，然后服务提供方再开发。 契约先行模式下，团队的沟通闭环 这样以来，团队的合作流程如下： 消费方与提供方沟通，达成契约，并在契约代码库中一起提交契约代码，即 OpenAPI doc。然后触发流水线，生成各方代码 sdk。 契约先行的适用场景 契约先行开发并非银弹，它在解决特定场景下的问题时，才更“划得来”。 比如契约应简单直接。
50720编辑于 2023-04-28 - 来自专栏老齐教室
开源的社会契约
我们应该认识到，开源是一种社会契约。 法律契约 从什么是开源软件谈起，我认为： ★开源软件就是源代码，其许可方式是：用户可以免费使用。 ” 开源项目除了提供源代码之外，还有别的义务吗？
50840发布于 2021-05-20 - 来自专栏cnblogs
restful Api 风格契约设计器：Swagger-editor和swagger-ui的应用
swagger-ui的安装 展示swagger-editor生成的api文档，api文档格式可以是yaml或json。 ) { connect.server({ root: 'dist', livereload: true, port:8888 }); }); 可以增加打印功能，用于导出api
1.9K90发布于 2018-01-17 - 来自专栏大内老A
WCF技术剖析之十四：泛型数据契约和集合数据契约（下篇）
从下面的XML的结构和内容中，我们可以总结出下面3条规则： 根节点的名称以ArrayOf为前缀，后面紧跟集合元素类型对应的数据契约名称； 集合元素对象用数据契约的命名空间作为整个集合契约的命名空间 比如，在同一个服务契约中，我定义了如下3个操作，他们的参数类型分别为IEnumerable<Customer>、IList<Cusomter>和Customer[]。 当客户端通过添加服务引用导出服务契约后，3个操作的参数类型都变成Customer[]了。 会抛出如图3所示的InvalidDataContractException异常，表明没有Add方法的CustomerCollection是不合法的集合数据契约。 图3 缺少Add方法导致的序列化异常 3、简化自定义集合数据契约定义 为了演示默认构造函数和Add方法对于集合数据契约的必要性，再定义CustomerCollection的实现，仅仅是实现了IEnumerable
2K70发布于 2018-01-16 - 来自专栏网络收集
3、交互API
3、交互API1.全局echarts 对象全局 echarts 对象是引入 echarts.js 文件之后就可以直接使用的echarts.init初始化ECharts实例对象 使用主题echarts.registerTheme
72120编辑于 2022-06-18 - 来自专栏python爱好部落
实现接口的契约测试
解决方案 解决方式首先是依赖关系的解耦，去掉直接对外部API的依赖，而是内部和外部系统都依赖于一个双方共同认可的约定—“契约”，并且约定内容的变化会被及时感知；其次，将系统之间的集成测试，转换为由契约生成的单元测试 这样，同时契约替代外部API成为信息变更的载体 契约测试也叫消费者驱动测试。 两个角色：消费者（Consumer）和 生产者（Provider） 一个思想：需求驱动（消费者驱动） 契约文件：由Consumer端和Provider端共同定义的规范，包含API路径，输入，输出。 我们可以通过SCHEMA来实现接口的契约测试。 API测试：通过FAKER生成测试数据，通过SCHEMA检查返回结果 ? image 需求 假定有如主图相同的http请求。 addconfig" headers = {"Content-Type": "application/json", "authorization": "48a5eb61-914e-4b3a-a7a3
1.8K10发布于 2020-09-24 - 来自专栏walterlv - 吕毅的博客
C#.NET 中的契约
然而除非是专门提供 SDK 的团队，否则文档通常都会滞后于代码，那么对于这些契约的修改可能就不太准确。 于是，契约式编程就应运而生。 几种不同的契约方法 ReSharper Annotations ReSharper 并没有将其称之为“契约”，因为它真的只是“文档级别”的约束，只会在写代码的时候具备一定程度的静态分析能力以便给出提示， 只要是装了 ReSharper 插件并用它写过代码的，应该都见过 ReSharper Annotations 了，因为它会在我们试图添加契约代码时自动添加契约标记（Attribute）。 Roslyn Roslyn 相比于任何第三方契约的优势在于它甚至能在语法层面形成契约（比如 C#8.0 中的可空引用类型）。 在实际应用中，并没有严格的说哪一个更好哪一个一般，两者都可以用，只要我们有分析和提示此契约的工具，就可以在项目中推行开来。 但是，基于契约编写代码的模式却能帮助我们写出更加健壮的代码来。
1.4K10发布于 2018-09-18 - 来自专栏开始入门
契约优先与协作效率——消费者驱动契约思维带来的团队成本下降
传统的提供者驱动契约（Provider-Driven Contracts）模式下，API设计由服务提供方主导，消费者只能被动适应。这种模式存在几个关键问题：集成测试滞后导致问题发现晚、修复成本高。 提供者担心破坏现有消费者而不敢进行必要的API优化，导致接口日益臃肿且难以维护。一项调查显示，75%的团队因担心破坏集成而推迟API改进。文档与实现脱节增加沟通成本。 Cloud ContractSpring生态与Spring深度集成低（Spring开发者）Pactflow企业级多团队双向契约、高级治理高DreddOpenAPI优先API文档驱动验证低Pact是目前最流行的 5 实施CDC的渐进式路径5.1 四阶段成熟度模型CDC实施应遵循渐进式路径，避免一次性全面铺开带来的阻力：阶段一：试点探索（1-2个月）选择2-3个关键服务作为试点建立基础契约测试流程培训团队掌握CDC 基础概念阶段二：模式验证（2-3个月）在试点服务中验证CDC价值优化工具链和流程建立契约管理和版本策略阶段三推广扩展（3-6个月）将CDC推广到更多服务建立组织级契约仓库集成到CI/CD流水线阶段四：文化融合
15110编辑于 2026-01-15 - 来自专栏大内老A
WCF技术剖析之十二：数据契约（Data Contract）和数据契约序列化器（DataContractSerializer）
一、数据契约 一个正常的服务调用要求客户端和服务端对服务操作有一致的理解，WCF通过服务契约对服务操作进行抽象，以一种与平台无关的，能够被不同的厂商理解的方式对服务进行描述。 与数据契约的定义相匹配，WCF采用新的序列化器——数据契约序列化器（DataContractSerializer）进行基于数据契约的序列化于反序列化操作。 同服务契约类似，WCF采用了基于特性（Attribute）的数据契约定义方式。 与之类似，数据契约也采用这种显式声明的机制。 二、数据契约序列化器（DataContractSerializer） 在WCF中，数据契约的定义是为序列化和反序列化服务的。
2.1K90发布于 2018-01-16 - 来自专栏大内老A
WCF技术剖析之十四：泛型数据契约和集合数据契约（上篇）
> XML整体的结构正是我们希望的，关键是根节点名称，也就是数据契约的名称，“BillOfOrderBillHeaderOrderBillDetail6Of3LqKh”，会让有些人难以理解。 ）}+ {哈希值（6Of3LqKh）}。 通过 DataContractAttribute特性修改了数据契约的名称（OrderHeader和OrderDetail），最终的数据契约的名称将会变成：BillOfOrderHeaderOrderDetail6Of3LqKh 可以看出描述泛型数据契约的部分内容相应地改变了。可能仔细的读者已经发现了，哈希值部分却没有发生变化，依然是“6Of3LqKh”，这是因为这是泛型类型（含命名空间）的哈希值，而不是数据契约名称的哈希值。 , System.ComponentModel.INotifyPropertyChanged 2: { 3: //省略成员 4: } 三、如何显式指定契约名称 如果你能够确保命名不会发生冲突
1.6K90发布于 2018-01-16 - 来自专栏ThoughtWorks
聊一聊契约测试 | 洞见
---- 发展历程 接下来让我们把时间回溯到2011年初，回到老马的文章《集成契约测试》中来，回顾一下契约测试的起源和发展历程： 假设我们有这样一个场景：A团队负责开发API服务，B团队进行API调用消费服务 这样，依赖契约的测试效率优于集成测试，同时契约替代外部API成为信息变更的载体。 ? 然后按照图中步骤3运行，A-B.provider.1.1.jar和B-A.consumer.1.1.pact完美契合，最终又将B-A.consumer.1.1.pact提交到服务器。 将Consumer端API的调用指向Provider端的新API，并更新契约文件以约束新功能。 将Provider端旧API同步更新为新API，提交并通过测试。 至此，我们解决了API更新时如何保证契约测试的提交顺序，如果是删除API，则直接删除Consumer端的契约测试即可。
1.3K50发布于 2018-07-23 - 来自专栏啄木鸟软件测试
Spring Boot+cucumber+契约测试
在“依赖项”对话框中搜索并添加“web”依赖项，为了后面的契约文件，再加入“Config Client ”和“Contract Stub Runner依赖项。 > <project xmlns:xsi="http://www.w<em>3</em>.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0 artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins> </build> </project> <em>3</em> io.cucumber.java.zh_cn.那么; import io.cucumber.junit.platform.engine.Cucumber; import org.junit.jupiter.<em>api</em>.Assertions springframework/cloud/contract/verifier/tests/ContractVerifierTest.java中产生 import org.junit.jupiter.<em>api</em>.Test
40010编辑于 2024-09-10 - 来自专栏人生代码
Vue 3 选项 API
以 _ 或 开头的 property 不会被组件实例代理，因为它们可能和 Vue 内置的 property、API 方法冲突。你可以使用例如 vm.data. >', app) const vm = app.use(store).use(router).mount('#app') console.log(vm.aPlus) // 1 vm.aPlus = 3 >', app) const vm = app.use(store).use(router).mount('#app') console.log(vm.aPlus) // 1 vm.aPlus = 3 >', app) const vm = app.use(store).use(router).mount('#app') console.log(vm.aPlus) // 1 vm.aPlus = 3 >', app) const vm = app.use(store).use(router).mount('#app') console.log(vm.aPlus) // 1 vm.aPlus = 3
2.9K30发布于 2020-11-26 - 来自专栏一个会写诗的程序员的博客
《Kotlin Contract 契约》极简教程
= listOf('a', 'b', 'c') val b3 = collection.isNullOrEmpty() // false 另: fun f1(s: String?) Contract 契约就是来解决这个问题的. 使用ExperimentalContracts注解声明 由于Contract契约API (1.3中)还是Experimental，所以需要使用ExperimentalContracts注解声明. ? 合 //由于Contract契约API还是Experimental，所以需要使用ExperimentalContracts注解声明 @ExperimentalContracts fun isNotEmptyWithContract = "" } fun f3(s: String?)
1.7K20发布于 2019-08-09
腾讯云开发者
Copyright © 2013 - 2026 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有
深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 
粤公网安备44030502008569号
腾讯云计算（北京）有限责任公司 京ICP证150476号 | 京ICP备11018762号