Important: this project has been transfered from PayPal team to RESTEasy team.
All future versions are going to be managed and released from https://github.com/resteasy/resteasy-spring-boot.
This Git repo will be kept here for historical purposes only.
There was no RESTEasy Spring Boot starter out there, so PayPal team decided to create one and share it with the community.
This Spring Boot starter is fully functional, has ZERO PayPal specific code on it, and can be used normally 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.
- 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
Add the Maven dependency below to your Spring Boot application pom file.
<dependency>
<groupId>com.paypal.springboot</groupId>
<artifactId>resteasy-spring-boot-starter</artifactId>
<version>2.3.4-RELEASE</version>
<scope>runtime</scope>
</dependency>
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 {
}
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.
See How to use RESTEasy Spring Boot Starter.
See RESTEasy Spring Boot starter release notes.
- 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.
Please open an issue using our GitHub issues page.
You are very welcome to contribute to RESTEasy Spring Boot starter! Read our Contribution guidelines.
To contact us, please send an email to fabiocarvalho777@gmail.com.
This project is licensed under the Apache 2 License.