repository·master·Indexed 19 days ago
https://github.com/carlphilipp/clean-architecture-exampleA Java demonstration of Clean Architecture principles featuring implementations for Spring Boot and Vert.x. The project includes a User API and a manual application mode using ManualConfig to wire use cases for creating, finding, and logging in users.
After compiling, you can run the Vert.x implementation by executing the generated fat JAR file located in the application/vertx-app/build/libs/ directory.
java -jar application/vertx-app/build/libs/vertx-app-1.0.0-fat.jarAfter compiling, you can run the Spring implementation by executing the generated JAR file located in the application/spring-app/build/libs/ directory.
java -jar application/spring-app/build/libs/spring-app-1.0.0.jarTo compile the project and build the necessary artifacts, use the Gradle wrapper included in the repository.
./gradlew clean buildThe Main class provides a manual entry point to demonstrate the core business logic of the application without a full web server (like Spring or Vert.x). It uses ManualConfig to wire together use cases for user management.
To use this mode, you must initialize a ManualConfig instance to obtain the necessary use case handlers: createUser(), findUser(), and loginUser().
// Setup
var config = new ManualConfig();
var createUser = config.createUser();
var findUser = config.findUser();
var loginUser = config.loginUser();
// Create a user
var user = User.builder()
.email("john.doe@gmail.com")
.password("mypassword")
.lastName("doe")
.firstName("john")
.build();
var actualCreateUser = createUser.create(user);
// Find a user by id
var actualFindUser = findUser.findById(actualCreateUser.getId());
// List all users
var users = findUser.findAllUsers();
// Login
loginUser.login("john.doe@gmail.com", "mypassword");The application provides several endpoints to manage users. Note that the base URL is http://localhost:8080.
#### Create User
```http
POST http://localhost:8080/users
{
"email": "test@test.com",
"password": "mypassword",
"lastName": "Doe",
"firstName": "John"
}GET http://localhost:8080/usersGET http://localhost:8080/users/0675171368e011e882d5acde48001122GET http://localhost:8080/login?email=test@test.com&password=mypasswordThe ManualConfig class acts as a manual dependency injection container for the application's use cases. It provides methods to retrieve specific service handlers:
createUser(): Returns a handler to create new users.findUser(): Returns a handler to query users (supports findById and findAllUsers).loginUser(): Returns a handler to perform user authentication via login(email, password).