Throw Exception

O EIP Throw Exception lança exceções durante o processamento das mensagens, oferecendo maior controle sobre o fluxo da integração. Com ele, é possível interromper a execução em cenários específicos, tratar falhas de forma personalizada e garantir o comportamento esperado dos processos.

Ao lançar uma exceção com o Throw Exception, o fluxo de integração é imediatamente interrompido, e os steps seguintes deixam de ser executados até que a exceção seja tratada ou capturada.

Todas as exceções geradas por esse componente são registradas nos logs do Analytics, permitindo que o usuário monitore facilmente erros e falhas ocorridas durante a execução do fluxo.

Configurando o EIP Throw Exception no Diagram

Para configurar um Throw Exception em uma integração na aba Diagram, siga estes passos:

  • Clique em +Add Step no canvas.

  • Selecione a aba EIPs.

  • Selecione o EIP Throw Exception. Você pode usar a ferramenta de buscas para localizá-lo.

  • Preencha os seguintes campos:

    • Message: mensagem customizada que será associada à exceção.

    • Exception Type: tipo específico da exceção a ser lançada.

      Confira exceções de uso frequente:

      Tipo de Exceção Descrição

      java.lang.IllegalArgumentException

      Parâmetro inválido

      java.lang.NullPointerException

      Valor nulo inesperado

      java.lang.RuntimeException

      Exceção genérica de tempo de execução

      java.io.IOException

      Problemas de IO, como falha em arquivo ou rede

      javax.validation.ValidationException

      Falha de validação de dados

      java.lang.UnsupportedOperationException

      Operação não suportada

Exemplo

Confira abaixo um exemplo de configuração do EIP Throw Exception:

throw exception example

- from:
    uri: rest:get:/demo
    steps:
      - log:
          message: "Starting the flow. An exception will be thrown now."
      - throwException:
          message: Exception intentionally thrown by the EIP throw-exception
          exceptionType: java.lang.IllegalArgumentException

  1. O fluxo é iniciado por uma requisição GET.

  2. O primeiro step no fluxo registra uma mensagem de log: "Starting the flow. An exception will be thrown now." Isso serve como um ponto de monitoramento para indicar que o fluxo foi iniciado e uma exceção será lançada a seguir.

  3. O EIP throw-exception é acionado, e uma exceção do tipo IllegalArgumentException é lançada, com a mensagem: "Exception intentionally thrown by the throw-exception EIP".

  4. Na prática, o cliente receberá um erro HTTP (provavelmente 500 Internal Server Error) com a mensagem da exceção, dependendo da configuração do seu runtime.

Thanks for your feedback!
EDIT

Share your suggestions with us!
Click here and then [+ Submit idea]