Eclipse 数据空间组件-实现简单的“Consumer Pull”Http传输流程-5

此示例的目的是展示两个连接器之间的数据交换，一个连接器代表数据提供者，另一个代表消费者。您可以在消费者拉取和提供者推送传输文档中找到更多详细信息。

运行此示例包含多个步骤，请按步骤顺序逐一执行。

重新编译提供商连接器

在Samples目录下执行

arduino 复制代码

./gradlew transfer:transfer-03-consumer-pull:provider-proxy-data-plane:build

运行连接器

在Samples目录下执行两个不同的命令窗口

要运行提供程序，只需运行以下命令

启动提供者

arduino 复制代码

java -Dedc.fs.config=transfer/transfer-03-consumer-pull/resources/configuration/provider.properties -jar transfer/transfer-03-consumer-pull/provider-proxy-data-plane/build/libs/connector.jar

启动消费者

arduino 复制代码

java -Dedc.fs.config=transfer/transfer-00-prerequisites/resources/configuration/consumer-configuration.properties   -jar transfer/transfer-00-prerequisites/connector/build/libs/connector.jar

谈判合同

参考Eclipse 数据空间组件-EDCSample 操作样例 Transfer 合同谈判-3

数据传输

修改请求json数据，我们需要指定要转移的资产、合约协议的 ID、提供商连接器的地址以及要将文件传输到的位置。在执行请求之前，替换{{contract-agreement-id}}为谈判合同中的contractAgreementId然后运行：

arduino 复制代码

curl -X POST "http://localhost:29193/management/v3/transferprocesses" \
  -H "Content-Type: application/json" \
  -d @transfer/transfer-03-consumer-pull/resources/start-transfer.json \
  -s  jq

json中的 "HttpData-PULL"传输类型用于消费者拉取方法，这意味着消费者将向提供者请求数据，并且该请求将是数据源的代理

然后，我们会在响应中得到一个 UUID。这次，这是TransferProcess消费者端创建的（进程 ID）的 ID，因为与契约协商一样，数据传输是在状态机中处理的，并且是异步执行的。

示例输出：

perl 复制代码

{
  ...
  "@id": "591bb609-1edb-4a6b-babe-50f1eca3e1e9",
  "createdAt": 1674078357807,
  ...
}

检查传输状态

由于传输的性质，它会非常快，并且很可能在您读取 UUID 时已经完成。

bash 复制代码

curl http://localhost:29193/management/v3/transferprocesses/<transfer process id>

您应该看到传输过程处于STARTED以下状态：

perl 复制代码

{
  ...
  "@id": "591bb609-1edb-4a6b-babe-50f1eca3e1e9",
  "state": "STARTED",
  ...
}

请注意，对于消费者拉取场景，TP 在数据成功传输后将保持 STARTED 状态。它最终可能会被其他组件转换为 TERMINATED 或 DEPROVISIONED，但这不在本示例的讨论范围内。

检查数据

你也可以查看官方详细说明文档在这一步，提供者会生成一个 EndpointDataReference 并发送给消费者。后者将其存储在缓存中，因此我们可以使用传输进程 ID 获取它：

bash 复制代码

curl http://localhost:29193/management/v3/edrs/<transfer process id>/dataaddress

scss 复制代码

{
  "@type": "DataAddress",
  "type": "https://w3id.org/idsa/v4.1/HTTP",
  "endpoint": "http://localhost:19291/public",
  "authType": "bearer",
  "endpointType": "https://w3id.org/idsa/v4.1/HTTP",
  "authorization": "eyJraWQiOiJwdWJsaWMta2V5IiwiYWxnIjoiUlMyNTYifQ.eyJpc3MiOiJwcm92aWRlciIsImF1ZCI6ImNvbnN1bWVyIiwic3ViIjoicHJvdmlkZXIiLCJpYXQiOjE3MTc3NjkyMzEyOTYsImp0aSI6IjM2M2RhMGU4LWZmOGItNDY1My05YjQwLWY4MjdlMWMzOGMzYyJ9.WOVPz6m7XzIrbiMTfLqOXacGYz8Xk_-iQu7gmxoIgDFYsgo0da2Iv51EsugIpqbodPsmB0kK7zkyrmsFOfAASAq7fjsy4gQF-u5egYwoGpcxjYaJJdQa5lkwjC0fRxdVFVwZwrOaT5Mg-vGA9HssTEnlA64q-O0ae_aTH5ToflmPDM3FhAgL55I3odM5ysM2POEJY6pgOxIV9XjuhZFl_i_iTiUCZy__oQUZiYk58wKoqfK758Sy1WzpH-eyZCDUi_Z3n6cJB80_0ZThoPhtiFH7Tl9DfStnjsCoaeqMLFnTXp0s8h4ZGFmjfBc-72aAdRQqqLDT8WXNg3Csv5B56Q",
  "@context": {
    "@vocab": "https://w3id.org/edc/v0.0.1/ns/",
    "edc": "https://w3id.org/edc/v0.0.1/ns/",
    "odrl": "http://www.w3.org/ns/odrl/2/"
  }
}

scss 复制代码

 curl http://localhost:29193/management/v3/edrs/c508b54a-3004-4877-b403-74145aeccd50/dataaddress

{
	"@type": "DataAddress",
	"type": "https://w3id.org/idsa/v4.1/HTTP",
	"endpoint": "http://localhost:19291/public",
	"authType": "bearer",
	"endpointType": "https://w3id.org/idsa/v4.1/HTTP",
	"authorization": "eyJraWQiOiJwdWJsaWMta2V5IiwiYWxnIjoiUlMyNTYifQ.eyJpc3MiOiJwcm92aWRlciIsImF1ZCI6ImNvbnN1bWVyIiwic3ViIjoicHJvdmlkZXIiLCJpYXQiOjE3NDQwODE3MDI4MDcsImp0aSI6Ijk5NjQxMWE2LTgwM2EtNDYzYy05NmQ4LWUzZTA2Nzc3Y2JkOSJ9.IW870H4btnxiHunjdyjtyHUX0E_ZKcgkHzbncdj0EcgZGZ1zo4GVJwxCDlmDIMbHvX2uTYGNEumYPbtISFV_zAZqjvsdAJ8hYt9JGQj7-XYxZdpO6g6FHVpoBY-0glXixj1Su7v4LjDySS6GZz221VbES8kjNVji8VHBI7GBPc4uZEck2Rzx4fAKqgR7PjS6fWjLND5YwtrPirlBnrYDGstxhqZ22e_f3YnxFdeyparOQ5PMseIBsvC3nh7fgmtQlnzBeJblubGO1fjIGx28e32gU_tl-7KEBdsgLKrRaZ_b5PXo4WxqBKg0u7JqIg6G3qiaO_lBschBkq4fWoFYIg",
	"@context": {
		"@vocab": "https://w3id.org/edc/v0.0.1/ns/",
		"edc": "https://w3id.org/edc/v0.0.1/ns/",
		"odrl": "http://www.w3.org/ns/odrl/2/"
	}
}

读取此 json 后，使用 postman 或 curl 等工具执行以下查询，以读取数据

css 复制代码

curl --location --request GET 'http://localhost:19291/public/' --header 'Authorization: <edr authorization attribute>'

示例

perl 复制代码

 curl --location --request GET 'http://localhost:19291/public/' --header 'Authorization:eyJraWQiOiJwdWJsaWMta2V5IiwiYWxnIjoiUlMyNTYifQ.eyJpc3MiOiJwcm92aWRlciIsImF1ZCI6ImNvbnN1bWVyIiwic3ViIjoicHJvdmlkZXIiLCJpYXQiOjE3NDQwODE3MDI4MDcsImp0aSI6Ijk5NjQxMWE2LTgwM2EtNDYzYy05NmQ4LWUzZTA2Nzc3Y2JkOSJ9.IW870H4btnxiHunjdyjtyHUX0E_ZKcgkHzbncdj0EcgZGZ1zo4GVJwxCDlmDIMbHvX2uTYGNEumYPbtISFV_zAZqjvsdAJ8hYt9JGQj7-XYxZdpO6g6FHVpoBY-0glXixj1Su7v4LjDySS6GZz221VbES8kjNVji8VHBI7GBPc4uZEck2Rzx4fAKqgR7PjS6fWjLND5YwtrPirlBnrYDGstxhqZ22e_f3YnxFdeyparOQ5PMseIBsvC3nh7fgmtQlnzBeJblubGO1fjIGx28e32gU_tl-7KEBdsgLKrRaZ_b5PXo4WxqBKg0u7JqIg6G3qiaO_lBschBkq4fWoFYIg'
[
  {
    "id": 1,
    "name": "Leanne Graham",
    "username": "Bret",
    "email": "Sincere@april.biz",
    "address": {
      "street": "Kulas Light",
      "suite": "Apt. 556",
      "city": "Gwenborough",
      "zipcode": "92998-3874",
      "geo": {
        "lat": "-37.3159",
        "lng": "81.1496"
      }
    },
    "phone": "1-770-736-8031 x56442",
    "website": "hildegard.org",
    "company": {
      "name": "Romaguera-Crona",
      "catchPhrase": "Multi-layered client-server neural-net",
      "bs": "harness real-time e-markets"
    }
  },
  {
    "id": 2,
    "name": "Ervin Howell",
    "username": "Antonette",
    "email": "Shanna@melissa.tv",
    "address": {
      "street": "Victor Plains",
      "suite": "Suite 879",
      "city": "Wisokyburgh",
      "zipcode": "90566-7771",
      "geo": {
        "lat": "-43.9509",
        "lng": "-34.4618"
      }
    },
    "phone": "010-692-6593 x09125",
    "website": "anastasia.net",
    "company": {
      "name": "Deckow-Crist",
      "catchPhrase": "Proactive didactic contingency",
      "bs": "synergize scalable supply-chains"
    }
  },
  {
    "id": 3,
    "name": "Clementine Bauch",
    "username": "Samantha",
    "email": "Nathan@yesenia.net",
    "address": {
      "street": "Douglas Extension",
      "suite": "Suite 847",
      "city": "McKenziehaven",
      "zipcode": "59590-4157",
      "geo": {
        "lat": "-68.6102",
        "lng": "-47.0653"
      }
    },
    "phone": "1-463-123-4447",
    "website": "ramiro.info",
    "company": {
      "name": "Romaguera-Jacobson",
      "catchPhrase": "Face to face bifurcated interface",
      "bs": "e-enable strategic applications"
    }
  },
  {
    "id": 4,
    "name": "Patricia Lebsack",
    "username": "Karianne",
    "email": "Julianne.OConner@kory.org",
    "address": {
      "street": "Hoeger Mall",
      "suite": "Apt. 692",
      "city": "South Elvis",
      "zipcode": "53919-4257",
      "geo": {
        "lat": "29.4572",
        "lng": "-164.2990"
      }
    },
    "phone": "493-170-9623 x156",
    "website": "kale.biz",
    "company": {
      "name": "Robel-Corkery",
      "catchPhrase": "Multi-tiered zero tolerance productivity",
      "bs": "transition cutting-edge web services"
    }
  },
  {
    "id": 5,
    "name": "Chelsey Dietrich",
    "username": "Kamren",
    "email": "Lucio_Hettinger@annie.ca",
    "address": {
      "street": "Skiles Walks",
      "suite": "Suite 351",
      "city": "Roscoeview",
      "zipcode": "33263",
      "geo": {
        "lat": "-31.8129",
        "lng": "62.5342"
      }
    },
    "phone": "(254)954-1289",
    "website": "demarco.info",
    "company": {
      "name": "Keebler LLC",
      "catchPhrase": "User-centric fault-tolerant solution",
      "bs": "revolutionize end-to-end systems"
    }
  },
  {
    "id": 6,
    "name": "Mrs. Dennis Schulist",
    "username": "Leopoldo_Corkery",
    "email": "Karley_Dach@jasper.info",
    "address": {
      "street": "Norberto Crossing",
      "suite": "Apt. 950",
      "city": "South Christy",
      "zipcode": "23505-1337",
      "geo": {
        "lat": "-71.4197",
        "lng": "71.7478"
      }
    },
    "phone": "1-477-935-8478 x6430",
    "website": "ola.org",
    "company": {
      "name": "Considine-Lockman",
      "catchPhrase": "Synchronised bottom-line interface",
      "bs": "e-enable innovative applications"
    }
  },
  {
    "id": 7,
    "name": "Kurtis Weissnat",
    "username": "Elwyn.Skiles",
    "email": "Telly.Hoeger@billy.biz",
    "address": {
      "street": "Rex Trail",
      "suite": "Suite 280",
      "city": "Howemouth",
      "zipcode": "58804-1099",
      "geo": {
        "lat": "24.8918",
        "lng": "21.8984"
      }
    },
    "phone": "210.067.6132",
    "website": "elvis.io",
    "company": {
      "name": "Johns Group",
      "catchPhrase": "Configurable multimedia task-force",
      "bs": "generate enterprise e-tailers"
    }
  },
  {
    "id": 8,
    "name": "Nicholas Runolfsdottir V",
    "username": "Maxime_Nienow",
    "email": "Sherwood@rosamond.me",
    "address": {
      "street": "Ellsworth Summit",
      "suite": "Suite 729",
      "city": "Aliyaview",
      "zipcode": "45169",
      "geo": {
        "lat": "-14.3990",
        "lng": "-120.7677"
      }
    },
    "phone": "586.493.6943 x140",
    "website": "jacynthe.com",
    "company": {
      "name": "Abernathy Group",
      "catchPhrase": "Implemented secondary concept",
      "bs": "e-enable extensible e-tailers"
    }
  },
  {
    "id": 9,
    "name": "Glenna Reichert",
    "username": "Delphine",
    "email": "Chaim_McDermott@dana.io",
    "address": {
      "street": "Dayna Park",
      "suite": "Suite 449",
      "city": "Bartholomebury",
      "zipcode": "76495-3109",
      "geo": {
        "lat": "24.6463",
        "lng": "-168.8889"
      }
    },
    "phone": "(775)976-6794 x41206",
    "website": "conrad.com",
    "company": {
      "name": "Yost and Sons",
      "catchPhrase": "Switchable contextually-based project",
      "bs": "aggregate real-time technologies"
    }
  },
  {
    "id": 10,
    "name": "Clementina DuBuque",
    "username": "Moriah.Stanton",
    "email": "Rey.Padberg@karina.biz",
    "address": {
      "street": "Kattie Turnpike",
      "suite": "Suite 198",
      "city": "Lebsackbury",
      "zipcode": "31428-2261",
      "geo": {
        "lat": "-38.2386",
        "lng": "57.2232"
      }
    },
    "phone": "024-648-3804",
    "website": "ambrose.net",
    "company": {
      "name": "Hoeger LLC",
      "catchPhrase": "Centralized empowering task-force",
      "bs": "target end-to-end models"
    }
  }
]

最后，为了确保正确完成拉取，你可以检查获取的数据是否与在https://jsonplaceholder.typicode.com/users获取的数据相同

由于我们配置了HttpDatawith proxyPath，我们还可以向特定用户请求：

css 复制代码

curl --location --request GET 'http://localhost:19291/public/1' --header 'Authorization: <auth code>'

示例

perl 复制代码

$ curl --location --request GET 'http://localhost:19291/public/1' --header 'Authorization:eyJraWQiOiJwdWJsaWMta2V5IiwiYWxnIjoiUlMyNTYifQ.eyJpc3MiOiJwcm92aWRlciIsImF1ZCI6ImNvbnN1bWVyIiwic3ViIjoicHJvdmlkZXIiLCJpYXQiOjE3NDQwODE3MDI4MDcsImp0aSI6Ijk5NjQxMWE2LTgwM2EtNDYzYy05NmQ4LWUzZTA2Nzc3Y2JkOSJ9.IW870H4btnxiHunjdyjtyHUX0E_ZKcgkHzbncdj0EcgZGZ1zo4GVJwxCDlmDIMbHvX2uTYGNEumYPbtISFV_zAZqjvsdAJ8hYt9JGQj7-XYxZdpO6g6FHVpoBY-0glXixj1Su7v4LjDySS6GZz221VbES8kjNVji8VHBI7GBPc4uZEck2Rzx4fAKqgR7PjS6fWjLND5YwtrPirlBnrYDGstxhqZ22e_f3YnxFdeyparOQ5PMseIBsvC3nh7fgmtQlnzBeJblubGO1fjIGx28e32gU_tl-7KEBdsgLKrRaZ_b5PXo4WxqBKg0u7JqIg6G3qiaO_lBschBkq4fWoFYIg'
{
  "id": 1,
  "name": "Leanne Graham",
  "username": "Bret",
  "email": "Sincere@april.biz",
  "address": {
    "street": "Kulas Light",
    "suite": "Apt. 556",
    "city": "Gwenborough",
    "zipcode": "92998-3874",
    "geo": {
      "lat": "-37.3159",
      "lng": "81.1496"
    }
  },
  "phone": "1-770-736-8031 x56442",
  "website": "hildegard.org",
  "company": {
    "name": "Romaguera-Crona",
    "catchPhrase": "Multi-layered client-server neural-net",
    "bs": "harness real-time e-markets"
  }
}

返回的数据将与https://jsonplaceholder.typicode.com/users/1中的数据相同

数据传输已成功完成。

注意消费者拉取模式是可以反复操作的。