Skip to content

Provided a better solution for reading dead outbox entries #1940

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
71 changes: 53 additions & 18 deletions java/outbox.md
Original file line number Diff line number Diff line change
Expand Up @@ -355,29 +355,65 @@ It is crucial to make the service `OutboxDeadLetterQueueService` accessible for

:::

### Filter for Dead Entries
### Reading Dead Entries

This filtering can't be done on the database since the maximum number of attempts is only available from the CDS properties.

To ensure that only dead outbox entries are returned when reading `DeadOutboxMessages`, the following code provides the handler for the `DeadLetterQueueService` and the `@After-READ` handler that filters for the dead outbox entries:
This filtering of dead entries is done on the database by adding `where` clauses for each outbox and their maximum number of retries. The following code provides the handler for the `DeadLetterQueueService` that modifies the where clause by adding
additional conditions for filtering the outbox entries:

```java
@Component
@ServiceName(OutboxDeadLetterQueueService_.CDS_NAME)
public class DeadOutboxMessagesHandler implements EventHandler {

@After(entity = DeadOutboxMessages_.CDS_NAME)
public void filterDeadEntries(CdsReadEventContext context) {
CdsProperties.Outbox outboxConfigs = context.getCdsRuntime().getEnvironment().getCdsProperties().getOutbox();
List<DeadOutboxMessages> deadEntries = context
.getResult()
.listOf(DeadOutboxMessages.class)
.stream()
.filter(entry -> entry.getAttempts() >= outboxConfigs.getService(entry.getTarget()).getMaxAttempts())
.toList();

context.setResult(deadEntries);
}
private final PersistenceService db;

public DeadOutboxMessagesHandler(@Qualifier(PersistenceService.DEFAULT_NAME) PersistenceService db) {
this.db = db;
}

@Before(entity = DeadOutboxMessages_.CDS_NAME)
public void modifyWhereClause(CdsReadEventContext context) {
CqnSelect cqn = context.getCqn();
Optional<Predicate> outboxFilters = this.createOutboxFilters(context.getCdsRuntime());
CqnSelect modifiedCqn = copy(
cqn,
new Modifier() {
@Override
public CqnPredicate where(Predicate where) {
if (where != null && outboxFilters.isPresent()) {
return where.and(outboxFilters.get());
} else if (where == null && outboxFilters.isPresent()) {
return outboxFilters.get();
} else if (where != null && !outboxFilters.isPresent()) {
return where;
} else {
return null;
}
}
});

context.setCqn(modifiedCqn);
}

private Optional<Predicate> createOutboxFilters(CdsRuntime runtime) {
List<OutboxService> outboxServices = runtime.getServiceCatalog().getServices(OutboxService.class)
.filter(s -> !s.getName().equals(OutboxService.INMEMORY_NAME)).toList();
CdsProperties.Outbox outboxConfigs = runtime.getEnvironment().getCdsProperties().getOutbox();

Predicate where = null;
for(OutboxService service : outboxServices) {
OutboxServiceConfig config = outboxConfigs.getService(service.getName());
Predicate targetPredicate = CQL.get(Messages.TARGET).eq(service.getName()).and(CQL.get(Messages.ATTEMPTS).ge(config.getMaxAttempts()));

if (where == null) {
where = targetPredicate;
} else {
where = where.or(targetPredicate);
}
}

return Optional.ofNullable(where);
}
}
```

Expand Down Expand Up @@ -419,8 +455,7 @@ The injected `PersistenceService` instance is used to perform the operations on
[Learn more about CQL statement inspection.](./working-with-cql/query-introspection#cqnanalyzer){.learn-more}

::: tip Use paging logic
Avoid to read all entries of the `cds.outbox.Messages` or `OutboxDeadLetterQueueService.DeadOutboxMessages` table at once, as the size of an entry is unpredictable
and depends on the size of the payload. Prefer paging logic instead.
Avoid to read all entries of the `cds.outbox.Messages` or `OutboxDeadLetterQueueService.DeadOutboxMessages` table at once, as the size of an entry is unpredictable and depends on the size of the payload. Prefer paging logic instead.
:::

## Observability using Open Telemetry
Expand Down
Loading