PoCAT Documentation Get Started

Where a filter is not the service

Service steps are Servits on channels. A gateway filter is not the handler that runs business logic.

Last updated: 2026-05-27 Section: Configuration

A deployed service does not run an auth, rate-limit, and transform chain before Servit.handle. The message arrives on the inbound channel named in service.xml.

What belongs in the Servit

  1. Read routing parameters and the byte[] payload from ServitMessage.
  2. Apply the business rule for this step only.
  3. Publish the next message, or a rejection message, on an outbound channel.
  4. Throw ServitException when the step cannot finish. The deploy dead-letter channel receives it.
Separate extension io.pocat.sdk.filter.AbstractRouteFilter is a gateway filter. Implementing it does not create a Servit, and it is not packaged as the service jar.