- SpringBoot
- Spring Security + JWT
- Docker
- Docker compose
- PostgreSQL
- Lombok
- Mapstruct
- Spring Data JPA
- H2 in-memory DB
- Mockito
- MockMvc
- Flyway
- How to run this application
- How to access the spring boot restful application
- PostgreSQL version based Wholesale Application
- Advantages of this application
- Application support H2 in-mem DB and Postgres DB, by default postgres DB is being used. If you want to use H2 in-mem DB, application-h2.properties shall be used.
- List all accounts
- List all transactions by account id
- Navigate the the root folder /wholesale under the command line
- Run the command to build the whole project: gradle clean build
- Either run the command to start the application: java -jar ./build/libs/wholesale-0.0.1-SNAPSHOT.jar
- Or run docker-compose up, then application and postgres DB are both up and running.
username/password : tiger/password (normal user without any admin role). this user can login successfully but not allowed to get account list nor transaction list
username/password : sisi/password (admin with role admin and read/write permission). This use can login successfully and be able to access all the endpoints.
username/password : cathy/password (group admin with role group admin and only read permission) This user can login successfully and allowed to get account list but not allowed to get transaction list.
Please find the postman collection file in postman folder and import into your postman to check more details.
- Hibernate builds the entity layer to connect PostgreSQL database server
- Flyway prepared the initial data.
- Spring Data JPA builds the repository layer (DAO) & H2 in-mem database used as Unit Test to test this layer
- Mapstruct used to map data between entities and dtos
- Mockito and MockMvc unit test service and controller layer
- All the exceptions can be centrally handled in one place (ControllerExceptionHandler.java)
- Lombok makes our life easierIt automatically generates getter,setter, constructor, hashcode, log etc.
- Dockerfile utilize multi stage and put application files into docker instead of using fat jar.
- Utilize Spring security to implement authentication and authorization.
- Docker compose has been used in local to easily set up the local environment.