Module io.jooby.trpc
Package io.jooby.trpc

Class TrpcErrorHandler

java.lang.Object
io.jooby.trpc.TrpcErrorHandler
All Implemented Interfaces:
io.jooby.ErrorHandler
public class TrpcErrorHandler extends Object implements io.jooby.ErrorHandler
A specialized error handler that formats exceptions into tRPC-compliant JSON responses.

This handler strictly listens for requests where the path begins with /trpc/. When an exception occurs during a tRPC procedure, this handler ensures the response matches the exact JSON envelope expected by the frontend @trpc/client, preventing the client from crashing due to unexpected HTML or plain-text error pages.

Custom Exception Mapping:

By default, this handler translates standard Jooby StatusCodes into their corresponding TrpcErrorCode. However, you can register a custom Map<Class<?>, TrpcErrorCode> in the Jooby registry to map your own domain-specific exceptions directly to tRPC codes.

If the thrown exception is already a TrpcException, it is rendered directly without modification.

  • Constructor Summary

    Constructors
    Constructor
    Description
    TrpcErrorHandler()
     

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    apply(io.jooby.Context ctx, Throwable cause, io.jooby.StatusCode code)
    Applies the tRPC error formatting if the request is a tRPC call.

    Methods inherited from class java.lang.Object

    equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    Methods inherited from interface io.jooby.ErrorHandler

    then

  • Constructor Details

    • TrpcErrorHandler

      public TrpcErrorHandler()

  • Method Details

    • apply

      public void apply(@NonNull io.jooby.Context ctx, @NonNull Throwable cause, @NonNull io.jooby.StatusCode code)
      Applies the tRPC error formatting if the request is a tRPC call.
      Specified by:
      apply in interface io.jooby.ErrorHandler
      Parameters:
      ctx - The current routing context.
      cause - The exception that was thrown during the request lifecycle.
      code - The default HTTP status code resolved by Jooby.