Comecei a mexer em um projeto com quarkus hj, na empresa, logo de primeira, fui dar uma olhada nos "controllers" e notei que no nosso caso ali, ao invés de ser uma interface, é só uma class mesmo e a única anotação é @Path. Qual seria a diferença dessa abordagem, na prática?
Olá Rodrigo! Tudo bem?
Que legal que você está começando a trabalhar com Quarkus!
No Quarkus, assim como em outros frameworks Java, a anotação @Path é usada para definir o caminho de um recurso REST. Quando você vê @Path em uma classe, essa classe está sendo usada como um recurso REST, ou seja, ela define endpoints que podem ser acessados via HTTP.
Classe com @Path: Quando você usa uma classe com @Path, você está criando uma implementação direta do recurso REST. Isso significa que a classe conterá métodos que respondem a requisições HTTP, como @GET, @POST, etc. Essa abordagem é mais direta e pode ser mais fácil de entender para quem está começando, pois você vê imediatamente a implementação do serviço.
Interface com @Path: Usar uma interface com @Path, geralmente em conjunto com anotações como @RegisterRestClient, é uma prática comum quando você está criando clientes REST para consumir APIs externas. Nesse caso, o Quarkus (ou outro framework) gera a implementação da interface para você, o que pode ser útil para separar a definição do serviço da sua implementação. Essa abordagem é muito útil em arquiteturas de microserviços, onde você pode ter várias implementações para uma mesma interface.
Na prática, a escolha entre usar uma classe ou uma interface pode depender do contexto e da arquitetura do seu projeto. Se você está definindo um serviço que será consumido por outros, uma classe pode ser mais direta. Se você está consumindo um serviço externo, uma interface pode oferecer mais flexibilidade e desacoplamento.
Espero ter ajudado e bons estudos!