如何在Quarkus初始化阶段以编程方式定义REST端点？

方案一：自定义JAX-RS Application类 #

通过继承javax.ws.rs.core.Application，在应用启动时显式注册资源类，这是JAX-RS标准方式，Quarkus完全支持。

import javax.ws.rs.ApplicationPath;
import javax.ws.rs.core.Application;
import java.util.HashSet;
import java.util.Set;

@ApplicationPath("/api")
public class CustomApp extends Application {
    @Override
    public Set<Class<?>> getClasses() {
        Set<Class<?>> resources = new HashSet<>();
        // 添加静态或动态生成的资源类
        resources.add(DynamicEndpoint.class);
        return resources;
    }
}

// 示例动态端点类
@Path("/dynamic")
public class DynamicEndpoint {
    @GET
    @Path("/greet")
    public String greet() {
        return "Hello from dynamic endpoint!";
    }
}

如果需要完全动态生成资源类，可以结合ASM、ByteBuddy等字节码工具，在应用初始化阶段生成符合JAX-RS注解规范的类，再加入到getClasses()集合中。

方案二：利用RESTEasy DynamicFeature #

RESTEasy（Quarkus默认的JAX-RS实现）的DynamicFeature允许在部署阶段（初始化阶段）配置资源和端点，适合对现有资源扩展或注册新的单例资源。

import javax.ws.rs.container.DynamicFeature;
import javax.ws.rs.container.ResourceInfo;
import javax.ws.rs.core.FeatureContext;
import javax.ws.rs.ext.Provider;

@Provider
public class DynamicEndpointFeature implements DynamicFeature {
    @Override
    public void configure(ResourceInfo resourceInfo, FeatureContext context) {
        // 注册自定义动态资源单例
        context.register(DynamicSingletonEndpoint.class);
    }
}

@Path("/singleton-dynamic")
public class DynamicSingletonEndpoint {
    @GET
    public String get() {
        return "Hello from singleton dynamic endpoint!";
    }
}

方案三：Quarkus Arc CDI Bean注册 #

Quarkus基于Arc作为CDI容器，通过BeanRegistrar可以在初始化阶段手动注册资源Bean，适合需要CDI特性的动态端点。

import io.quarkus.arc.BeanRegistrar;
import io.quarkus.arc.InstanceHandle;
import io.quarkus.arc.impl.UnsafeBeanBuilder;
import javax.enterprise.context.ApplicationScoped;
import javax.enterprise.inject.spi.BeanManager;
import javax.ws.rs.GET;
import javax.ws.rs.Path;

public class DynamicResourceRegistrar implements BeanRegistrar {
    @Override
    public void register(BeanManager beanManager, InstanceHandle<BeanManager> beanManagerHandle) {
        // 构建并注册动态资源Bean
        UnsafeBeanBuilder<Object> beanBuilder = UnsafeBeanBuilder.create(beanManager, ArcDynamicEndpoint.class)
                .scope(ApplicationScoped.class)
                .addType(ArcDynamicEndpoint.class);
        beanManager.registerBean(beanBuilder.build());
    }

    @Path("/arc-dynamic")
    public static class ArcDynamicEndpoint {
        @GET
        public String getResponse() {
            return "Hello from Arc-managed dynamic endpoint!";
        }
    }
}

关于临时方案的问题 #

你之前用ServerExceptionMapper的方式存在明显缺陷：

• 并非真正的REST端点，不会被Quarkus的REST元数据收集（比如OpenAPI文档不会包含这些“端点”）
• 无法利用JAX-RS的参数绑定、媒体类型协商、异常处理等原生特性
• 逻辑耦合在异常捕获中，代码可读性和维护性差

内容的提问来源于stack exchange，提问作者Christian