This project implements a distributed in-memory cache system using Java and Spring Boot. It features an LRU eviction policy, thread-safe operations, a simple REST API for cache operations, and basic clustering support with consistent hashing.

• LRU Eviction Policy: Automatically removes the least recently used entries when the cache reaches its limit.
• Thread-Safe Operations: Utilizes ConcurrentHashMap to ensure safe access to cache entries in a multi-threaded environment.
• REST API: Provides endpoints for creating, retrieving, and deleting cache entries.
• Clustering Support: Implements consistent hashing to distribute cache entries across multiple nodes.

• Java
• Spring Boot
• ConcurrentHashMap
• REST API

distributed-cache-system
├── src
│   ├── main
│   │   ├── java
│   │   │   └── com
│   │   │       └── example
│   │   │           ├── cache
│   │   │           │   ├── CacheApplication.java
│   │   │           │   ├── controller
│   │   │           │   │   └── CacheController.java
│   │   │           │   ├── service
│   │   │           │   │   └── CacheService.java
│   │   │           │   ├── model
│   │   │           │   │   └── CacheEntry.java
│   │   │           │   └── clustering
│   │   │           │       └── ConsistentHashing.java
│   │   ├── resources
│   │   │   ├── application.properties
│   │   │   └── static
│   │   │       └── dashboard.html
│   ├── test
│   │   └── java
│   │       └── com
│   │           └── example
│   │               └── cache
│   │                   └── CacheServiceTest.java
├── pom.xml
└── README.md

1. Clone the repository:

   git clone https://github.com/yourusername/distributed-cache-system.git
   cd distributed-cache-system
   

2. Build the project using Maven:

   mvn clean install
   

3. Run the application:

   mvn spring-boot:run
   

4. Access the REST API at http://localhost:8080/api/cache.

• Create Cache Entry

  • Endpoint: POST /api/cache
  • Request Body: { "key": "string", "value": "string" }
  • Response: 201 Created

• Get Cache Entry

  • Endpoint: GET /api/cache/{key}
  • Response: 200 OK with cache entry details or 404 Not Found

• Delete Cache Entry

  • Endpoint: DELETE /api/cache/{key}
  • Response: 204 No Content

Unit tests for the CacheService class are located in src/test/java/com/example/cache/CacheServiceTest.java. Run the tests using:

mvn test

A simple HTML dashboard is provided to monitor cache statistics. Access it at http://localhost:8080/dashboard.html.

This project is licensed under the MIT License. See the LICENSE file for details.