Spring Boot + Jersey

Jersey是一个非常好的Java REST API库。当你用Jersey实现REST的时候，是非常自然的。同时Spring Boot是Java世界中另一个很好的工具，它减少了程序的应用配置（《初识Spring Boot》）。这篇博客就介绍下如何将Jersey和Spring Boot结合起来使用。

需要注意的是Jersey本身自带了hk2这样一个DI库，所以，在结合Spring Boot使用的时候，是比较容易搞混淆的。简单的讲，你应该分清楚，哪一部分是由Spring来管理，哪一部分是由Jersey的hk2来管理。

创建一个JerseyConfig类，用来配置Jersey：

public class JerseyConfig extends ResourceConfig {
    public JerseyConfig() {
        register(JacksonFeature.class);
        
        register(ProductsResource.class);
        register(ProductRepository.class);
    }
}

其中，ProductsResource是我们的REST API：

@Path("/products")
public class ProductsResource {
    @Inject
    private ProductRepository productRepository;

    //... ...

    @GET
    @Path("{id}")
    @Produces(MediaType.APPLICATION_JSON)
    public ProductRefJson getProductById(@PathParam("id") int id) {
        final Product product = productRepository.findByProductId(id);
        if (product == null) {
            throw new ResourceNotFoundException();
        }
        return new ProductRefJson(product);
    }
}

ProductRespository就是我们查找Product的类，这里需要注意的一点是我们看到ProductsResource并不含有类似@Component这样的annotation，这是因为这个类是REST API，它应该由Jersey中的hk2来管理，所以，不要加@Component。

这样，我们已经完成了Jersey REST API所需要的最简配置。下面就是让Spring Boot怎么知道Jersey的存在：

@EnableAutoConfiguration
public class Application{
    public static void main(String[] args) {
        new SpringApplicationBuilder(Application.class)
                .showBanner(false)
                .run(args);
    }

    @Bean
    public ServletRegistrationBean jerseyServlet() {
        ServletRegistrationBean registration = new ServletRegistrationBean(new ServletContainer(), "/*");
        registration.addInitParameter(ServletProperties.JAXRS_APPLICATION_CLASS, JerseyConfig.class.getName());
        return registration;
    }
}

启动Application就能运行这个REST Webservie了：

curl -X GET http://localhost:8080/products/1

返回结果： 

{"id":1,"name":"apple juice","uri":"/products/1","pricings_uri":"/products/1/pricings","current_price":{"uri":"/products/1/current","price":0},"description":"good"}

博客完成的比较仓促，如果有描述错误或者不准确的地方，欢迎指出来。