Eclipse 数据空间组件-实现数据触发扩展功能-消费者-6

85 阅读16分钟

操作目标

在数据传输过程中,对数据进行加工编辑,用户触发其他事件,此次用于记录日志数据。

graph LR

A[数据] --> B{EDC 传输}
B --> C[数据] 
B --> D[Listener记录日志] 

在这个示例中,可以基于Eclipse 数据空间组件-实现简单的“Provider Push”Http传输流程-4Eclipse 数据空间组件-实现简单的“Consumer Pull”Http传输流程-5进行

此外,为了保持项目的条理性,此示例中的代码被分成2个 Java 模块:

  • consumer-with-listener:将由事件消费者扩展的消费者连接器
  • listener:包含TransferProcessListener将使用事件的实现

增加监听器

可以参考官方文档

TransferProcessListener接口定义了数据在传输状态后改变后调用的方法,例如,在生成数据后(即传输转移到完成状态)通知消费者端的外部应用程序。

// in TransferProcessStartedListenerExtension.java
    @Override
    public void initialize(ServiceExtensionContext context) {
        var transferProcessObservable = context.getService(TransferProcessObservable.class);
        var monitor = context.getMonitor();
        transferProcessObservable.registerListener(new TransferProcessStartedListener(monitor));
    }

实现TransferProcessListener接口类TransferProcessStartedListener。它将使用传输STARTED事件并写入日志消息。

public class TransferProcessStartedListener implements TransferProcessListener {

    private final Monitor monitor;

    public TransferProcessStartedListener(Monitor monitor) {
        this.monitor = monitor;
    }

    /**
     * Callback invoked by the EDC framework when a transfer is about to be completed.
     *
     * @param process the transfer process that is about to be completed.
     */
    @Override
    public void preStarted(final TransferProcess process) {
        monitor.debug("TransferProcessStartedListener received STARTED event");
        // do something meaningful before transfer start
    }
}

运行示例

假设您的提供商连接器和日志网络服务器仍在运行,我们可以重新使用提供商端存储的现有资产和合同定义。如果没有,请按照Eclipse 数据空间组件-EDCSample 操作样例 Transfer 合同谈判-3中的说明设置您的资产和合同定义。

1. 编译监听器扩展程序并启动消费者

参考官方文档

此消费者连接器基于不同的构建文件,因此将构建一个新的 JAR 文件。请确保从前面的章节中终止当前的消费者连接器。这样我们就可以解除端口阻塞并重用已知的配置文件和 API 调用。

运行此程序来构建并启动带有监听器扩展的消费者:

./gradlew transfer:transfer-04-event-consumer:consumer-with-listener:build
java -Dedc.fs.config=transfer/transfer-00-prerequisites/resources/configuration/consumer-configuration.properties -jar transfer/transfer-04-event-consumer/consumer-with-listener/build/libs/connector.jar

2. 协商新合同

参考官方文档

curl -d @transfer/transfer-01-negotiation/resources/negotiate-contract.json \
  -X POST -H 'content-type: application/json' http://localhost:29193/management/v3/contractnegotiations \
  -s | jq

3.获取合同协议id

参考官方文档

curl -X GET "http://localhost:29193/management/v3/contractnegotiations/{{contract-negotiation-id}}" \
    --header 'Content-Type: application/json' \
    -s | jq

4. 执行文件传输

参考官方文档

启动 http 服务器

参考官方文档

作为先决条件,您需要有一个在端口 4000 上运行并记录所有传入请求的日志网络服务器,数据将被发送到该服务器。

docker build -t http-request-logger util/http-request-logger
docker run -p 4000:4000 http-request-logger

将请求主体contractId内的属性替换 为上一次调用中的合同协议 ID。然后运行:

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

5.检查日志

参考官方文档

消费者应该输出类似如下的日志:

INFO 2025-04-08T13:57:57.3496024 TransferProcessStartedListener received STARTED event   <----------------------------

如果您看到TransferProcessStartedListener received STARTED event日志消息,则表示您的事件消费者已成功配置。

6.检查数据

docker logs http-request-logger

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