How scaleracademy/twitter-backend-java works
Moo is a Spring Boot backend for a Twitter-style social network. Clients use its REST API to authenticate, manage profiles and follows, publish and interact with posts, browse hashtags, and search posts or users. Controllers delegate to service implementations, which use repositories and JPA entities backed by MySQL (or H2). The tree and source index document these capability areas, but most controller and service implementations were not sampled; uncertain internal links are omitted. JWT and rotating refresh tokens are documented capabilities, with their detailed runtime wiring not fully shown here.
Main entry points: UsersRepository.java User repository · AuthenticationController.java Authentication API · PostServiceImpl.java Posts and reactions · UserServiceImpl.java Profile and follows
Components 21
REST API
- Authentication API
src/main/java/xyz/subho/clone/twitter/controller/AuthenticationController.java - Post API
src/main/java/xyz/subho/clone/twitter/controller/PostController.java - User API
src/main/java/xyz/subho/clone/twitter/controller/UserController.java - Hashtag API
src/main/java/xyz/subho/clone/twitter/controller/HashtagController.java - Search API
src/main/java/xyz/subho/clone/twitter/controller/SearchController.java
Identity and profiles
- Profile and follows
src/main/java/xyz/subho/clone/twitter/service/impl/UserServiceImpl.java - Token lifecycle
src/main/java/xyz/subho/clone/twitter/service/impl/RefreshTokenServiceImpl.java - User authentication lookup
src/main/java/xyz/subho/clone/twitter/security/UserDetailsServiceImpl.java - JWT utilities
src/main/java/xyz/subho/clone/twitter/security/JwtUtil.java - Request security
src/main/java/xyz/subho/clone/twitter/security/JwtRequestFilter.java
Social content
- Posts and reactions
src/main/java/xyz/subho/clone/twitter/service/impl/PostServiceImpl.java - Hashtag browsing
src/main/java/xyz/subho/clone/twitter/service/impl/HashtagServiceImpl.java - Post and user search
src/main/java/xyz/subho/clone/twitter/service/impl/SearchServiceImpl.java
Persistence
- User repository
src/main/java/xyz/subho/clone/twitter/repository/UsersRepository.java - Post repository
src/main/java/xyz/subho/clone/twitter/repository/PostsRepository.java - Hashtag repositories
src/main/java/xyz/subho/clone/twitter/repository/HashtagsRepository.java - Social data repositories
src/main/java/xyz/subho/clone/twitter/repository - User and follow entities
src/main/java/xyz/subho/clone/twitter/entity/Users.java - Post entities
src/main/java/xyz/subho/clone/twitter/entity/Posts.java
Other components
- API client
- MySQL / H2
Connections 29
- API client → Authentication API: sends requests
README.md - API client → Post API: sends requests
README.md - API client → User API: sends requests
README.md - API client → Hashtag API: sends requests
README.md - API client → Search API: sends requests
README.md - Authentication API → Profile and follows: calls
src/main/java/xyz/subho/clone/twitter/controller/AuthenticationController.java - Authentication API → Token lifecycle: rotates tokens
src/main/java/xyz/subho/clone/twitter/controller/AuthenticationController.java - Authentication API → JWT utilities: uses
src/main/java/xyz/subho/clone/twitter/controller/AuthenticationController.java - User API → Profile and follows: calls
src/main/java/xyz/subho/clone/twitter/controller/UserController.java - Post API → Posts and reactions: calls
src/main/java/xyz/subho/clone/twitter/controller/PostController.java - Hashtag API → Hashtag browsing: calls
src/main/java/xyz/subho/clone/twitter/controller/HashtagController.java - Search API → Post and user search: calls
src/main/java/xyz/subho/clone/twitter/controller/SearchController.java - Profile and follows → User repository: queries and updates
src/main/java/xyz/subho/clone/twitter/service/impl/UserServiceImpl.java - Profile and follows → Social data repositories: manages follows
src/main/java/xyz/subho/clone/twitter/service/impl/UserServiceImpl.java - Token lifecycle → Social data repositories: persists tokens
src/main/java/xyz/subho/clone/twitter/service/impl/RefreshTokenServiceImpl.java - User authentication lookup → User repository: loads users
src/main/java/xyz/subho/clone/twitter/security/UserDetailsServiceImpl.java - Posts and reactions → Post repository: reads and writes
src/main/java/xyz/subho/clone/twitter/service/impl/PostServiceImpl.java - Posts and reactions → Hashtag repositories: updates hashtag data
src/main/java/xyz/subho/clone/twitter/service/impl/PostServiceImpl.java - Posts and reactions → Social data repositories: manages likes
src/main/java/xyz/subho/clone/twitter/service/impl/PostServiceImpl.java - Post and user search → Post repository: searches posts
src/main/java/xyz/subho/clone/twitter/service/impl/SearchServiceImpl.java - Post and user search → User repository: searches users
src/main/java/xyz/subho/clone/twitter/service/impl/SearchServiceImpl.java - Hashtag browsing → Hashtag repositories: loads hashtags
- User repository → User and follow entities: persists
src/main/java/xyz/subho/clone/twitter/repository/UsersRepository.java - Post repository → Post entities: persists
src/main/java/xyz/subho/clone/twitter/repository/PostsRepository.java - Hashtag repositories → Post entities: queries associations
src/main/java/xyz/subho/clone/twitter/repository/HashtagsRepository.java - User repository → MySQL / H2: stores data
README.md - Post repository → MySQL / H2: stores data
README.md - Hashtag repositories → MySQL / H2: stores data
README.md - Request security → JWT utilities: validates tokens