匹配

本节描述在消费者端测试时可以使用的各种不同的请求/响应匹配技术。注意，以下演示的例子使用的是Ruby DSL，因为各种实现有所不同，请参考自己所使用的特定语言和框架。

注意

如果在消费者端编写测试时所使用的语言与提供者端不同，必须确保两者使用的是共同的Pact规范，否则就无法进行验证。

正则表达式

有时请求或响应中的某些键值是事先无法知道的——比如时间戳或者生成的ID。

你所需要的是能够以某种方式表达“我期望某些东西能够匹配这个正则表达式，但我不关心其实际值具体是多少”。

  1. animal_service.given("an alligator named Mary exists").
  2.   upon_receiving("a request for an alligator").
  3.   with(
  4.     method: "get",
  5.     path: "/alligators/Mary",
  6.     headers: {"Accept" => "application/json"}).
  7.   will_respond_with(
  8.     status: 200,
  9.     headers: {"Content-Type" => "application/json"},
  10.     body: {
  11.       name: "Mary",
  12.       dateOfBirth: Pact.term(
  13.         generate: "02/11/2013",
  14.         matcher: /\d{2}\/\d{2}\/\d{4}/)
  15.     })

注意Pact::Term的用法。当你跑消费者的测试的时候，模拟的服务将会返回你所指定“生成”的值，然后当你在提供者的代码库中验证契约的时候，它可以确保该键值与指定的正则表达式相匹配。

你也可以对请求使用Pact::Term进行匹配。

  1. animal_service.given("an alligator named Mary exists").
  2.   upon_receiving("a request for an alligator").
  3.   with(
  4.     method: "get",
  5.     path: "/alligators/Mary",
  6.     query: Pact.term(
  7.       generate: "transactionId=1234",
  8.       matcher: /transactionId=\d{4}/),
  9.   will_respond_with(
  10.     status: 200, ...)

matcher用于确保实际请求是正确的格式，在generate字段中所指定的值将会作为一个向提供者进行重放时所使用的真实值的例子。这意味着提供者状态中仍然可以使用已知的值来创建数据，但是消费者测试中可以不受影响地生成数据。

你可以将Pact::Term用于请求和响应头信息、请求查询以及请求和响应体内部。注意，正则表达式只能用于字符串。更进一步地，当请求查询被指定为字符串时，它只是被当做普通字符串来做匹配的——即不会考虑参数顺序的灵活匹配。要想实现顺序灵活匹配，需指定为哈希，哈希中轮流包含Pact::Terms。

类型匹配

通常，你并不关注特定路径下的某个具体值是多少，你所关注的只是有这个值并且该值是所期望的类型。这种场景下，可以使用Pact::SomethingLike（已在require 'pact/consumer/rspec'中引入）。

  1. animal_service.given("an alligator named Mary exists").
  2.   upon_receiving("a request for an alligator").
  3.   with(
  4.     method: "get",
  5.     path: "/alligators/Mary",
  6.     headers: {"Accept" => "application/json"}).
  7.   will_respond_with(
  8.     status: 200,
  9.     headers: {"Content-Type" => "application/json"},
  10.     body: {
  11.       Pact.like(
  12.         name: "Mary",
  13.         age: 73
  14.       )
  15.     })

消费者测试中的模拟服务将会返回{"name": "Mary", "age": 73} ，但是当在提供者端执行pact:verify时，只会检查name的值是否是字符串，以及age的值是否是整数。如果你想精确匹配“Mary”，但是又允许age为任何值，应该在 Pact::SomethingLike中只包含进73。例如：

  1. animal_service.given("an alligator named Mary exists").
  2.   upon_receiving("a request for an alligator").
  3.   with(
  4.     method: "get",
  5.     path: "/alligators/Mary", 
  6.     headers: {"Accept" => "application/json"}).
  7.   will_respond_with(
  8.     status: 200,
  9.     headers: {"Content-Type" => "application/json"},
  10.     body: {
  11.       name: "Mary",
  12.       age: Pact.like(73)
  13.     }
  14.   )

对于请求匹配，模拟服务允许在消费者测试中使用任何类型的请求值，只要是同一类型即可，但是在pact:verify中将使用给定值进行重放。

  1. animal_service.given("an alligator named Mary exists").
  2.   upon_receiving("a request to update an alligator").
  3.   with(
  4.     method: "put",
  5.     path: "/alligators/Mary",
  6.     headers: {"Accept" => "application/json"},
  7.     body: {
  8.       age: Pact.like(10)
  9.     }).
  10.   will_respond_with(
  11.     status: 200,
  12.     headers: {"Content-Type" => "application/json"},
  13.     body: {
  14.       age: 10
  15.     })

查询参数

查询参数可以指定为字符串或者哈希。当指定为字符串时，将会执行精确匹配。你可以使用Pact::Term，但是只能将查询字符串作为一个整体进行匹配。注意，查询参数在期望中应该是已被编码过的URL。（这一功能在v2版本的匹配中将会被修改。）

  2. animal_service.given("some alligators exist").
  3.   upon_receiving("a request to search for alligators").
  4.   with(
  5.     method: "get",
  6.     path: "/alligators",
  7.     query: "name=Mary+Jane&age=8")
  8.   ...

或者，如果查询参数的顺序并不重要，也可以将查询指定为哈希。你可以将Pact::Terms或Pact::SomethingLike嵌入到哈希内部去。请记住所有查询参数将会被解析为字符串，所以不要用SomethingLike去匹配数字类型。

  2. animal_service.given("some alligators exist").
  3.   upon_receiving("a request to search for alligators").
  4.   with(
  5.     method: "get",
  6.     path: "/alligators",
  7.     query: {
  8.       # No need to encode params in the hash
  9.       name: 'Mary Jane',
  10.       age: '8',
  11.       # Specify a param with multiple values using an
  12.       # array - order will be enforced
  13.       children: ['Betty', 'Sue']
  14.     })
  15.   ...

灵活匹配

注意： 仅对于Pact规范2.0及以上适用

长度灵活的数组：

  1. animal_service.given("an alligator named Mary exists").
  2.   upon_receiving("a request for an alligator").
  3.   with(
  4.     method: "get",
  5.     path: "/alligators/Mary",
  6.     headers: {"Accept" => "application/json"}).
  7.   will_respond_with(
  8.     status: 200,
  9.     headers: {"Content-Type" => "application/json"},
  10.     body: {
  11.       name: "Mary",
  12.       children: each_like(name: "Fred", age: 2)
  13.     })

当提供者端的校验运行时，将会确保children数组中的每个元素都有一个字符串类型的name、一个整数类型的age，以及数组中至少包含一个元素。

要打开v2版本Pact的序列化功能，你需要1.9.0版本的pact gem包，并且在消费者端的模拟服务配置中对pact_specification_version进行配置。提供者端将会自动获取到它。

  2. require 'pact/consumer/rspec'
  4. Pact.service_consumer "Zoo App" do
  5.   has_pact_with "Animal Service" do
  6.     mock_service :animal_service do
  7.       port 1234
  8.       pact_specification_version "2.0.0"
  9.     end
  10.   end
  11. end

在Pact模拟服务中使用v2.0的匹配

要以v2匹配模式启动独立的pact模拟服务，只需在启动项中指定--pact-specification-version 2.0.0。