https://github.com/jasmine1601/bookstore
A simple SpringBoot application with two microservices book-service and order-service
https://github.com/jasmine1601/bookstore
docker spring-boot spring-cloud spring-data-jpa
Last synced: about 1 month ago
JSON representation
A simple SpringBoot application with two microservices book-service and order-service
- Host: GitHub
- URL: https://github.com/jasmine1601/bookstore
- Owner: jasmine1601
- License: gpl-3.0
- Created: 2024-12-01T19:57:02.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2024-12-31T07:02:46.000Z (4 months ago)
- Last Synced: 2025-01-30T09:41:49.198Z (3 months ago)
- Topics: docker, spring-boot, spring-cloud, spring-data-jpa
- Language: Java
- Homepage:
- Size: 44.9 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: .github/contributing.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Book Store Application
## Overview
The **Book Store Application** demonstrates:
- REST API development
- Microservices architecture
- Inter-service communication using OpenFeign
- Containerization with Docker
The project comprises two microservices:
1. **Book Service**: Manages book inventory.
2. **Order Service**: Places orders and fetches book details via Book Service.
---
## Technologies Used
- **Programming Language**: Java
- **Framework**: Spring Boot 3.4.0
- **Database**: H2 (in-memory)
- **Inter-Service Communication**: OpenFeign
- **Containerization**: Docker
- **Build Tool**: Maven
---
## Features
### Book Service
- Add a new book
- Retrieve all books
### Order Service
- Place an order
- Retrieve book details by communicating with Book Service
---
## Project Structure
```
bookstore/
│
├── book-service/
│ ├── src/main/java/com/example/bookservice/
│ │ ├── BookServiceApplication.java
│ │ ├── controller/BookController.java
│ │ ├── model/Book.java
│ │ ├── repository/BookRepository.java
│ │ └── service/BookService.java
│ ├── src/main/resources/
│ │ └── application.yml
│ └── Dockerfile
│
├── order-service/
│ ├── src/main/java/com/example/orderservice/
│ │ ├── OrderServiceApplication.java
│ │ ├── controller/OrderController.java
│ │ ├── model/Order.java
│ │ └── client/BookClient.java
│ ├── src/main/resources/
│ │ └── application.yml
│ └── Dockerfile
│
└── docker-compose.yml
```
---
## Prerequisites
- OpenJDK 21
- Maven
- Docker & Docker Compose
---
## Getting Started
### 1. Clone the Repository
```bash
git clone
cd bookstore
```
### 2. Build the Applications
```bash
mvn clean package
```
### 3. Start the Containers
```bash
docker-compose up --build
```
---
## API Endpoints
### **Book Service**
| HTTP Method | Endpoint | Description |
|-------------|-----------------|------------------------|
| GET | `/api/books` | Retrieves all books |
| POST | `/api/books` | Adds a new book |
**Sample Request Body (POST /api/books)**
```json
{
"title": "The Lost Symbol",
"author": "Dan Brown",
"price": 350.00
}
```
---
### **Order Service**
| HTTP Method | Endpoint | Description |
|-------------|--------------------|----------------------------------|
| POST | `/api/orders` | Places an order for a book |
| GET | `/api/orders/books`| Fetches books via Book Service |
**Sample Request Body (POST /api/orders)**
```json
{
"bookId": 1,
"quantity": 2
}
```
---
## Accessing the Services
- **Book Service**: `http://localhost:8081/api/books`
- **Order Service**: `http://localhost:8082/api/orders`
---
## Testing
- Use Postman or a similar API client to interact with the APIs.
- Verify:
- Books are added and retrieved correctly in Book Service.
- Orders are placed successfully in Order Service.
- Order Service retrieves book details from Book Service.
---
## Future Enhancements
- Replace H2 with a persistent database (e.g., MySQL, PostgreSQL, or MongoDB).
- Use RabbitMQ or Kafka for asynchronous communication.
- Add unit and integration tests for comprehensive testing.
- Introduce monitoring with Prometheus and Grafana.
---
## Contributing
This repository is contribution friendly. Refer to [Contribution Guidelines](.github/contributing.md).
---
## License
This project is licensed under the GNU General Public License v3.0
---