Documentation for a newer release is available. View Latest

How Do I Use the Pre-Built HTM Error Handler for Flo-Lang?

The HTM Error handler can be used by simply importing the standard HTM floclient dependency, and then registering the error handler with your domain. For example:

@Bean
public HtmexampleDomain htmexampleDomain(ActorSystem actorSystem, Dispatcher floDispatcher,
                                         HtmErrorHandlerExtensions<Aggregate> htmErrorHandlerExtension) {
    // All adapters should be added to the domain model
    return new HtmexampleDomain.Builder(actorSystem)
            .withDispatcher(floDispatcher)
            .withFallbackExtensionProvider(ExtensionProvider.builder().flowErrorExtensions(htmErrorHandlerExtension).build()) (1)
            .build();
}
1 Here we can see that we’ve told our domain configuration to use the "HtmErrorHandlerExtension" as the flow error extension for the whole model domain. That’s everything you need to do! Now, any unexpected error that occurs during flow processing will activate error handling and process the error accordingly. For example, if we were to resume the flow, and that fixed the problem, we’d see something like this in our graphs:
errors 1

Here we can see the routing of the flow to the error state and the resumption and eventual completion of the flow. Alternatively, you may choose to force complete the flow instead:

errors 2