How zevolution/netflix-hexagonal-architecture works
This Spring service exposes a lookup for software by author and name, returning repository details from a configured Git provider. The request enters through the REST API, passes through a use case and repository abstraction, and is handled by a GitHub or GitLab data source; the README describes switching providers. Provider responses are mapped into the shared Software entity and then to the API representation. The tree and excerpts support the GitLab adapter’s calls; GitHub adapter wiring and provider selection are less fully shown, so those links are documented or marked unverified.
Main entry points: SoftwareRepository.java Repository port · GitlabSoftwaresDataSource.java GitLab adapter · AuthorsApiImpl.java Authors endpoint · GithubReposClient.java GitHub repository client
Components 18
REST API
- Authors endpoint
src/main/java/dev/zevolution/netflixhexaarch/transportlayers/restapi/AuthorsApiImpl.java - Response mapper
src/main/java/dev/zevolution/netflixhexaarch/transportlayers/mapper/SoftwareMapper.java
Application Domain
- Software lookup
src/main/java/dev/zevolution/netflixhexaarch/interactors/GetSoftwareByAuthorAndSoftwareNameUseCase.java - Repository port
src/main/java/dev/zevolution/netflixhexaarch/repositories/SoftwareRepository.java - Software entity
src/main/java/dev/zevolution/netflixhexaarch/entities/Software.java
Git Providers
- GitHub adapter
src/main/java/dev/zevolution/netflixhexaarch/datasources/GithubSoftwaresDataSource.java - GitHub repository client
src/main/java/dev/zevolution/netflixhexaarch/datasources/services/GithubReposClient.java - GitLab adapter
src/main/java/dev/zevolution/netflixhexaarch/datasources/GitlabSoftwaresDataSource.java - GitLab users client
src/main/java/dev/zevolution/netflixhexaarch/datasources/services/GitlabUsersClient.java - Provider response models
src/main/java/dev/zevolution/netflixhexaarch/datasources/services/data/response - Provider mapper
src/main/java/dev/zevolution/netflixhexaarch/datasources/services/mapper/SoftwareMapper.java
Runtime Support
- Exception advice
src/main/java/dev/zevolution/netflixhexaarch/configs/ExceptionAdviceConfiguration.java - API error model
src/main/java/dev/zevolution/netflixhexaarch/configs/RESTAPIException.java - Metrics configuration
src/main/java/dev/zevolution/netflixhexaarch/configs/MetricsConfig.java - Application bootstrap
src/main/java/dev/zevolution/netflixhexaarch/Application.java
Other components
- API caller
- GitHub service
- GitLab service
Connections 18
- API caller → Authors endpoint: requests
README.md - Authors endpoint → Software lookup: invokes
src/main/java/dev/zevolution/netflixhexaarch/transportlayers/restapi/AuthorsApiImpl.java - Authors endpoint → Response mapper: maps response
src/main/java/dev/zevolution/netflixhexaarch/transportlayers/restapi/AuthorsApiImpl.java - Software lookup → Repository port: queries
src/main/java/dev/zevolution/netflixhexaarch/interactors/GetSoftwareByAuthorAndSoftwareNameUseCase.java - Repository port → Software entity: returns
src/main/java/dev/zevolution/netflixhexaarch/repositories/SoftwareRepository.java - Response mapper → Software entity: maps entity
src/main/java/dev/zevolution/netflixhexaarch/transportlayers/mapper/SoftwareMapper.java - GitHub adapter → Repository port: implements
src/main/java/dev/zevolution/netflixhexaarch/datasources/GithubSoftwaresDataSource.java - GitLab adapter → Repository port: implements
src/main/java/dev/zevolution/netflixhexaarch/datasources/GitlabSoftwaresDataSource.java - GitLab adapter → GitLab users client: calls
src/main/java/dev/zevolution/netflixhexaarch/datasources/GitlabSoftwaresDataSource.java - GitLab adapter → Provider mapper: maps projects
src/main/java/dev/zevolution/netflixhexaarch/datasources/GitlabSoftwaresDataSource.java - GitHub adapter → GitHub repository client: calls
src/main/java/dev/zevolution/netflixhexaarch/datasources/GithubSoftwaresDataSource.java - GitHub repository client → GitHub service: fetches repository
- GitLab users client → GitLab service: fetches users/projects
- GitLab users client → Provider response models: returns models
src/main/java/dev/zevolution/netflixhexaarch/datasources/services/GitlabUsersClient.java - GitHub repository client → Provider response models: returns model
src/main/java/dev/zevolution/netflixhexaarch/datasources/services/GithubReposClient.java - Provider mapper → Provider response models: maps from
src/main/java/dev/zevolution/netflixhexaarch/datasources/services/mapper/SoftwareMapper.java - Provider mapper → Software entity: maps to
src/main/java/dev/zevolution/netflixhexaarch/datasources/services/mapper/SoftwareMapper.java - Exception advice → API error model: creates errors
src/main/java/dev/zevolution/netflixhexaarch/configs/ExceptionAdviceConfiguration.java