cassiomolin/jersey-springboot

Example of REST API using Spring Boot, Jersey and Jackson.

REST API using Spring Boot and Jersey

This example application demonstrates how to create a REST API using:

• Spring Boot: Framework for creating standalone Java applications.
• Jersey: JAX-RS reference implementation for creating RESTful web services in Java.
• Jackson: JSON parser for Java.

Building and running this application

To build and run this application, follow these steps:

1. Open a command line window or terminal.
2. Navigate to the root directory of the project, where the pom.xml resides.
3. Compile the project: mvn clean compile.
4. Package the application: mvn package.
5. Change into the target directory: cd target
6. You should see a file with the following or a similar name: jersey-springboot-1.0.jar.
7. Execute the JAR: java -jar jersey-springboot-1.0.jar.
8. The application should be available at http://localhost:8080/api.

REST API overview

See the curl scripts below with the REST API supported operations:

Get a greeting

curl -X GET \
  'http://localhost:8080/api/greetings' \
  -H 'Accept: text/plain'

Get the current date

curl -X GET \
  'http://localhost:8080/api/current-date' \
  -H 'Accept: application/json'

Targeting the REST API with Postman

Alternatively to curl, you can use Postman to target the REST API. The Postman collection files are available in the src/main/postman directory.