Support pagination for API endpoints

[IgorBalog-Eng]

It would be "nice to have" pagination, now when we have dynamic filtering for API endpoints, at least for getAll endpoint.

We should support pagination. There are 2 "imlementations":

• ResponseEntity<GenericApiResponse<Page<?>>>

{
    "success": true,
    "message": "Audit events - Page 0 of 1, Size: 20, Sort: timestamp: DESC, Filters: [details.contractNegotiation.state:FINALIZED]",
    "data": {
        "content": [
            {
                "timestamp": "2025-07-16T11:01:22.623",
                "eventType": "Protocol negotiation finalized",
                "description": "Contract negotiation finalized",
                "details": {
                    "consumerPid": "urn:uuid:38dfcbc5-d3ad-40d4-a8e7-c3e03f69e1e6",
                    "role": "consumer",
                    "contractNegotiation": {
                        "@context": "[https://w3id.org/dspace/2024/1/context.json"](https://w3id.org/dspace/2024/1/context.json%22),
                        "@type": "dspace:ContractNegotiation",
                        "dspace:consumerPid": "urn:uuid:38dfcbc5-d3ad-40d4-a8e7-c3e03f69e1e6",
                        "dspace:providerPid": "urn:uuid:ad6e0954-29cd-4c85-9540-19ddb69c7e8d",
                        "dspace:state": "dspace:FINALIZED"
                    },
                    "providerPid": "urn:uuid:ad6e0954-29cd-4c85-9540-19ddb69c7e8d"
                },
                "id": "68776a625524584de5c90082",
                "ipAddress": null,
                "source": null,
                "username": null
            },
            {
                "timestamp": "2025-07-16T10:47:29.249",
                "eventType": "Protocol negotiation finalized",
                "description": "Contract negotiation finalized",
                "details": {
                    "providerPid": "urn:uuid:3d6e7def-48f5-44b3-8400-c176393c5840",
                    "contractNegotiation": {
                        "@context": "[https://w3id.org/dspace/2024/1/context.json"](https://w3id.org/dspace/2024/1/context.json%22),
                        "@type": "dspace:ContractNegotiation",
                        "dspace:consumerPid": "urn:uuid:2a08228a-2ed8-4ff5-80f0-6a3d7e0fe07a",
                        "dspace:providerPid": "urn:uuid:3d6e7def-48f5-44b3-8400-c176393c5840",
                        "dspace:state": "dspace:FINALIZED"
                    },
                    "role": "consumer",
                    "consumerPid": "urn:uuid:2a08228a-2ed8-4ff5-80f0-6a3d7e0fe07a"
                },
                "id": "6877672174edc45b627aac7d",
                "ipAddress": null,
                "source": null,
                "username": null
            }
        ],
        "pageable": {
            "sort": {
                "empty": false,
                "sorted": true,
                "unsorted": false
            },
            "offset": 0,
            "pageSize": 20,
            "pageNumber": 0,
            "unpaged": false,
            "paged": true
        },
        "last": true,
        "totalPages": 1,
        "totalElements": 2,
        "size": 20,
        "number": 0,
        "sort": {
            "empty": false,
            "sorted": true,
            "unsorted": false
        },
        "first": true,
        "numberOfElements": 2,
        "empty": false
    },
    "timestamp": "2025-07-17T10:13:22+02:00"
}

• ResponseEntity<GenericApiResponse<PagedModel<EntityModel<?>>>> - HATEOAS

{
    "success": true,
    "message": "Audit events - Page 0 of 7, Size: 5, Sort: timestamp: DESC, Filters: []",
    "data": {
        "links": [
            {
                "rel": "first",
                "href": "[http://localhost:8080/api/v1/audit?page=0&size=5&sort=timestamp,desc"](http://localhost:8080/api/v1/audit?page=0&size=5&sort=timestamp,desc%22)
            },
            {
                "rel": "self",
                "href": "[http://localhost:8080/api/v1/audit?page=0&size=5&sort=timestamp,desc"](http://localhost:8080/api/v1/audit?page=0&size=5&sort=timestamp,desc%22)
            },
            {
                "rel": "next",
                "href": "[http://localhost:8080/api/v1/audit?page=1&size=5&sort=timestamp,desc"](http://localhost:8080/api/v1/audit?page=1&size=5&sort=timestamp,desc%22)
            },
            {
                "rel": "last",
                "href": "[http://localhost:8080/api/v1/audit?page=6&size=5&sort=timestamp,desc"](http://localhost:8080/api/v1/audit?page=6&size=5&sort=timestamp,desc%22)
            }
        ],
        "content": [
            {
                "timestamp": "2025-07-17T11:21:23.343",
                "eventType": "Application start",
                "description": "Application started",
                "details": null,
                "id": "6878c093b2a7764454249131",
                "ipAddress": null,
                "source": null,
                "username": null,
                "links": []
            },
            {
                "timestamp": "2025-07-17T11:01:47.808",
                "eventType": "Application stop",
                "description": "Application stopped",
                "details": null,
                "id": "6878bbfbb28372650baf1d69",
                "ipAddress": null,
                "source": null,
                "username": null,
                "links": []
            },
            {
                "timestamp": "2025-07-17T11:01:04.512",
                "eventType": "Application start",
                "description": "Application started",
                "details": null,
                "id": "6878bbd0b28372650baf1d68",
                "ipAddress": null,
                "source": null,
                "username": null,
                "links": []
            },
            {
                "timestamp": "2025-07-17T10:27:54.283",
                "eventType": "Application stop",
                "description": "Application stopped",
                "details": null,
                "id": "6878b40a8bae0218459b3470",
                "ipAddress": null,
                "source": null,
                "username": null,
                "links": []
            },
            {
                "timestamp": "2025-07-17T09:59:50.474",
                "eventType": "Application start",
                "description": "Application started",
                "details": null,
                "id": "6878ad768bae0218459b346f",
                "ipAddress": null,
                "source": null,
                "username": null,
                "links": []
            }
        ],
        "page": {
            "size": 5,
            "totalElements": 33,
            "totalPages": 7,
            "number": 0
        }
    },
    "timestamp": "2025-07-17T11:22:16+02:00"
}

Idea is to

• modify GenericDynamicFilterRepository
  Collection findWithDynamicFilters(Map<String, Object> filters, Class entityClass);
  to
  Page findWithDynamicFilters(Map<String, Object> filters, Class entityClass, Pageable pageable);

• extend existing controllers, that are of interes (ContractNegotiation, TransferProcess, AuditEvent) to have page, size and filter (consider adding default values if not provided)

• modify service to accept pagable (depends on concrete repository

   public Page<?> getXXX(Map<String, Object> filters, Pageable pageable) {
        return repository.findWithDynamicFilters(filters, <?>.class, pageable);
    }

• update tests
• Verify that GitHub Actions are still valid, since some requests are fetching ContractNegotiation and/or TransferProcess, LAST element, to get id for following requests.

[IgorBalog-Eng]

Implemented