repository·master·Indexed 23 days ago
https://github.com/zealon159/light-reading-cloudA microservices-based book reading application implementing the Spring Cloud ecosystem. The project demonstrates service discovery and configuration via Nacos, gateway routing with Spring Cloud Gateway, and inter-service communication using OpenFeign. Key technical implementations include JWT-based authentication, ElasticSearch search synchronization via RabbitMQ, and Redis-backed chapter navigation using a doubly linked list structure.
Light Reading Cloud (轻松阅读) is a microservices-based book reading application built using the Spring Cloud ecosystem. It serves as a practical implementation of microservices architecture, utilizing technologies such as Spring Cloud Gateway, Nacos, Hystrix, OpenFeign, JWT, and ElasticSearch.
The project is designed to demonstrate how to implement microservices in real-world business scenarios. The client-side is developed using Vue.js and Vuetify.
reading-cloud-feign-client project contains Feign client definitions designed to be imported as dependencies by other microservices within the light-reading-cloud ecosystem. Instead of manually defining HTTP clients for every service call, you can include this module to use pre-defined Feign interfaces for seamless inter-service communication.The project is divided into two main types of modules:
reading-cloud-book), Account Center (reading-cloud-account), and Homepage Center (reading-cloud-homepage).Additionally, reading-cloud-common is a shared module containing POJOs, constants, and utility classes used as a standalone JAR dependency across other services to prevent code redundancy.
The project uses Alibaba-Nacos to handle two critical infrastructure roles:
.yml or .properties files across different nodes, all services fetch their configurations from Nacos. This simplifies deployment and reduces errors when scaling service nodes.The system follows a microservices architecture where:
SpringCloud-Gateway.FeignClient clients.The reading-cloud-common module is a shared JAR package used across the system. It is designed to centralize reusable components to ensure consistency and reduce duplication. It primarily contains:
common to provide a unified interface for all microservices in the ecosystem.Search functionality is implemented using ElasticSearch (v6.3.1) with the Jest client. While logically a separate service, it is currently hosted within the reading-cloud-homepage project.
To keep the ElasticSearch index in sync with the primary database, two methods are discussed:
The reading-cloud-account service handles user registration, login, and bookshelves. Security is implemented using JWT (JSON Web Token).
Authorization header for subsequent requests.AuthFilter.The reading-cloud-book service provides book details, chapters, and reading interfaces.
To optimize performance, chapter navigation (previous/next chapter) is implemented using a doubly linked list structure stored in Redis (Hash type). This avoids expensive database calculations for every page turn.
Data Structure Model:
Each entry in the Redis Hash uses the chapter ID as the key. The value contains the chapter details and pointers to the previous (pre) and next (next) chapters.
[
{
"key":"519",
"value":{
"id":529,
"name":"第一章 装B的乞丐",
"pre":null,
"next":[
{
"id":530,
"name":"第二章 资格"
}
]
}
},
{
"key":"530",
"value":{
"id":530,
"name":"第二章 资格",
"pre":[
{
"id":529,
"name":"第一章 装B的乞丐"
}
],
"next":[
{
"id":531,
"name":"第三章 开始修炼清心诀"
}
]
}
}
]Workflow:
book/chapter/readChapter.[
{
"key":"519",
"value":{
"id":529,
"name":"第一章 装B的乞丐",
"pre":null,
"next":[
{
"id":530,
"name":"第二章 资格"
}
]
}
}
]The project uses bootstrap.yml files for service configuration. Due to potential Nacos instability, these configuration files are stored in the bootstrap-config directory. Each microservice has a corresponding YAML file that should be used for its specific configuration.
| Project | Configuration File |
|---|---|
reading-cloud-account | reading-cloud-account.yml |
reading-cloud-book | reading-cloud-book.yml |
reading-cloud-gateway | reading-cloud-gateway.yml |
reading-cloud-homepage | reading-cloud-homepage.yml |
To run the Light Reading Cloud project locally, follow these steps:
Import the provided database scripts to create the following databases and run the table creation scripts:
reading_cloud_resourcereading_cloud_accountBecause the hosted version uses a configuration center, you may need to manually update the bootstrap.yml file in each project module to match your local environment. Update settings for:
Start the services in the following order to ensure proper registration and discovery: