Spring WebFlux - Pet Clinic

This is a simple Java project using Spring WebFlux that provides a reactive web application and uses R2DBC for relational database integration. The project secures its endpoints with JWT tokens through integration with an OAuth2 Authorization Server and uses Spring Cloud Gateway to handle and route requests securely.

Note: This project requires two additional repositories (Spring Cloud Gateway and OAuth2 Authorization Server Repository) to be set up and running.

---

Features

• Reactive web application using Spring WebFlux
• R2DBC integration for reactive relational database access
• Secured endpoints using OAuth2 and JWT tokens
• Integration with a separate OAuth2 Authorization Server
• API Gateway using Spring Cloud Gateway

---

Technologies Used

• Java 21
• Spring Boot 3.3.0
• Spring WebFlux
• Spring Security
• Spring Data R2DBC
• H2 Database
• OAuth2 Authorization Server with JWT

---

Getting Started

Prerequisites

Make sure you have the following installed on your system:

• Java 21
• Maven
• Postman (or preferred HTTP client)

---

Installation

• 1. Clone and Set Up the OAuth2 Authorization Server Project

This WebFlux project relies on a separate OAuth2 Authorization Server project for authentication and authorization.

Clone and set up the OAuth2 project first:

git clone https://github.com/CarinaPorumb/spring-oauth2

Build the project using Maven:

mvn clean install

You can run the application using your IDE or from the command line:

 mvn spring-boot:run

Once the application is running, it will be available at http://localhost:9000.

• 2. Clone and Set Up the Spring Cloud Gateway Project

After setting up the OAuth2 Authorization Server, clone and set up the Spring Cloud Gateway project:

git clone https://github.com/CarinaPorumb/spring-cloud-gateway

Build the project using Maven:

mvn clean install

You can run the application using your IDE or from the command line:

 mvn spring-boot:run

Once the application is running, it will be available at http://localhost:8080.

• 3. Clone and Set up the WebFlux Pet Clinic Project

After setting up the OAuth2 Authorization Server and Spring Cloud Gateway, clone and set up the WebFlux Pet Clinic project:

git clone https://github.com/CarinaPorumb/pet-clinic-webflux
cd webflux-petclinic

Build the project using Maven:

mvn clean install

You can run the application using your IDE or from the command line:

 mvn spring-boot:run

Once the application is running, it will be available at http://localhost:8082.

---

Startup Order

1. Start the OAuth2 Authorization Server: http://localhost:9000
2. Start the WebFlux Pet Clinic: http://localhost:8082
3. Start the Spring Cloud Gateway: http://localhost:8080

---

Testing with Postman

To test the WebFlux Pet Clinic API endpoints secured by OAuth2, I used Postman to request an access token and make authenticated requests. Here are the steps:

1. Configure Postman for OAuth2 Authentication

• Open Postman and create a new request.
• Set the Request URL to your desired endpoint, e.g., http://localhost:8080/api/v2/pet.
• Go to the Authorization tab and select OAuth 2.0 as the type.

2. Configure a New Token

• Token Name: Choose a name for your token, e.g., newToken.
• Grant Type: Select Client Credentials.
• Access Token URL: http://localhost:9000/oauth2/token
• Client ID: messaging-client
• Client Secret: secret
• Scope: message.read message.write
• Client Authentication: Select Send as Basic Auth header

3. Request Token

• Click on Get New Access Token.
• Postman will request the token from the OAuth2 server.
• If successful, the token will be displayed. Click on Use Token to set it for your request.

4. Send the Request

• Ensure the token is added to the request headers.
• Send the request to the API endpoint.

---