RESTEasy Spring Boot Starter

This Spring Boot starter can be used by any regular Spring Boot application that wants to have REST endpoints and prefers RESTEasy as the JAX-RS implementation.

Also, this RESTEasy Spring Boot starter integrates with Spring as expected, which means every JAX-RS REST resource that is also a Spring bean will be automatically auto-scanned, integrated, and available.

Features

• Enables RESTEasy for Spring Boot applications
• Supports JAX-RS providers, resources and sub-resources as Spring beans
• Supports automatic discovery and registration of multiple JAX-RS Application classes as Spring beans
• Supports optional registration of JAX-RS Application classes via class-path scanning, or manually, via configuration properties (or YAML) file
• Leverages and supports RESTEasy configuration
• Supports RESTEasy Asynchronous Job Service

This project has been kindly donated by PayPal. Please refer to https://github.com/paypal/resteasy-spring-boot for old versions.

Quick start

Adding POM dependency

Add the Maven dependency below to your Spring Boot application pom file.

<dependency>
   <groupId>org.jboss.resteasy</groupId>
   <artifactId>resteasy-spring-boot-starter</artifactId>
   <version>2.0.0.Final-SNAPSHOT</version>
   <scope>runtime</scope>
</dependency>

Registering JAX-RS application classes

Just define your JAX-RS application class (a subclass of Application) as a Spring bean, and it will be automatically registered. See the example below. See section JAX-RS application registration methods in How to use RESTEasy Spring Boot Starter for further information.

package com.sample.app;

import org.springframework.stereotype.Component;
import javax.ws.rs.ApplicationPath;
import javax.ws.rs.core.Application;

@Component
@ApplicationPath("/sample-app/")
public class JaxrsApplication extends Application {
}

Registering JAX-RS resources and providers

Just define them as Spring beans, and they will be automatically registered. Notice that JAX-RS resources can be singleton or request scoped, while JAX-RS providers must be singletons.

Further information

See How to use RESTEasy Spring Boot Starter.

Projects

• sample-app: A simple Spring Boot application that exposes JAX-RS endpoints as Spring beans using RESTEasy via this RESTEasy Spring Boot starter.
• resteasy-spring-boot-starter: The RESTEasy Spring Boot Starter project.
• resteasy-spring-boot-starter-test: Integration tests for the RESTEasy Spring Boot Starter project.

Reporting an issue

Please open an issue using JIRA (be sure to set Spring / Spring Boot in the Component/s field).

Contacting us

To contact us, please use RESTEasy mailing lists.

License

This project is licensed under the Apache 2 License.