https://github.com/davidgfolch/spring-mongo-reactive

https://github.com/davidgfolch/spring-mongo-reactive

functional-programming reactor rest-api spring-reactive-mongodb spring-webflux

Last synced: about 1 month ago
JSON representation

• Host: GitHub
• URL: https://github.com/davidgfolch/spring-mongo-reactive
• Owner: davidgfolch
• Created: 2019-09-24T13:18:15.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2020-03-28T06:42:25.000Z (almost 5 years ago)
• Last Synced: 2024-04-17T14:29:27.361Z (9 months ago)
• Topics: functional-programming, reactor, rest-api, spring-reactive-mongodb, spring-webflux
• Language: Java
• Size: 93.8 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Getting Started

## Description

Fully reactive Rental film REST API.

Also see Kotlin version (in Kotlin branch).

### Prerequisites

- Enable annotation processors (in your IDE for lombok)

### Architecture

- Reactive Layers architecture (spring-framework reactor).

- Java non-blocking functional programming: reactor+streams.

- REST API's with Spring-WebFlux.

    - Using [Functional Programming Model](https://docs.spring.io/spring-framework/docs/5.0.0.BUILD-SNAPSHOT/spring-framework-reference/html/web-reactive.html#_functional_programming_model)

- Persistence with reactive MongoDb.

Notes:

- No security implementation at all.

- No persistence transaction implementation (https://spring.io/blog/2019/05/16/reactive-transactions-with-spring).

- You'll find some reactive junit tests.

- Sonar gradle plugin (you can run sonarqube gradle task if you have sonar installed on localhost:9000)

  

### Business logic

I've changed the requirement "renting for x days".

In my implementation, when renting, you are always paying for 1 day.

When you return films you pay for surcharges if applies.

#### Details

Rent & Return films:

- In both cases:

    - Non-existent `userId` throws UserNotFoundException.

    - duplicated `filmId`'s are ignored, just processing one.

      

- Rent films

    - Non-existent `filmId`'s or not available stock, are ignored and not returned in result list.

    - With all available films found:

        - decreases stock

        - calculates rent for 1 day.

        - get saved in `Customer.films` (including date in each film).

- Return films

    - Non-existent films in `Customer.films` are ignored and not returned in result list.

    - From all matching films in `Customer.films`, gets the older one (a filmId could be repeated with different rent date)

        - calculate surcharges (after x days).

        - remove from customer & save.

        - increase film stock.

### Try it

- Run App as a spring-boot app:

    - command line: `gradlew :bootRun`

    - intellij: right button on `App.java` & Run...

Every time app starts, customer and films are created automatically with harcoded ids for ease of use.

Also, generated json for each user+films is printed in log console, so we can copy/paste in RestApi POST bodies.

- Use `postman_collection.json` (importing the json file in Postman client):

    - `rentFilms`: to rent

    - `customerGet`: to see customer rented films & bonusPoints

    - `returnFilms`: to return (after x days as path param)