How suryavamsi-kothapalli/url-shortener works
This is a Spring Boot URL-shortening web application: users submit long URLs to receive Base62 short links, then visit those links to be redirected to the saved destinations. The graph follows both documented request flows and includes validation, persistence, API payloads, and error handling. The service implementation and controllers were excerpted; frontend and database links are based on the README, so unsampled implementation details are not inferred.
Main entry points: UrlShortenerServiceImpl.java Shortening service · UrlRepository.java URL repository · UrlRestController.java Create URL API · GlobalExceptionHandler.java API error handler
Components 17
Web client
- Short-link UI
src/main/resources/static/js/app.js
HTTP endpoints
- Create URL API
src/main/java/com/urlshortener/controller/UrlRestController.java - Redirect endpoint
src/main/java/com/urlshortener/controller/UrlRedirectController.java - Shorten request
src/main/java/com/urlshortener/dto/ShortenRequest.java - Shorten response
src/main/java/com/urlshortener/dto/ShortenResponse.java - API error handler
src/main/java/com/urlshortener/exception/GlobalExceptionHandler.java - Error payload
src/main/java/com/urlshortener/dto/ErrorResponse.java
Shortening domain
- Invalid URL error
src/main/java/com/urlshortener/exception/InvalidUrlException.java - URL not found error
src/main/java/com/urlshortener/exception/UrlNotFoundException.java - Shortening service
src/main/java/com/urlshortener/service/UrlShortenerServiceImpl.java - URL validation
src/main/java/com/urlshortener/util/UrlValidator.java - Base62 codec
src/main/java/com/urlshortener/util/Base62.java
Persistence
- URL repository
src/main/java/com/urlshortener/repository/UrlRepository.java - URL record
src/main/java/com/urlshortener/entity/UrlEntity.java - MySQL database
Other components
- User / browser
- Destination website
Connections 22
- User / browser → Short-link UI: enters URL
README.md - Short-link UI → Create URL API: submits URL
README.md - Create URL API → Shorten request: accepts payload
src/main/java/com/urlshortener/controller/UrlRestController.java - Create URL API → Shortening service: requests shortening
src/main/java/com/urlshortener/controller/UrlRestController.java - Shortening service → URL validation: validates URL
src/main/java/com/urlshortener/service/UrlShortenerServiceImpl.java - Shortening service → Invalid URL error: throws on invalid
src/main/java/com/urlshortener/service/UrlShortenerServiceImpl.java - Shortening service → URL repository: saves record
src/main/java/com/urlshortener/service/UrlShortenerServiceImpl.java - URL repository → MySQL database: persists record
README.md - URL repository → URL record: stores entity
src/main/java/com/urlshortener/repository/UrlRepository.java - Shortening service → Base62 codec: encodes ID
src/main/java/com/urlshortener/service/UrlShortenerServiceImpl.java - Shortening service → Shorten response: returns short URL
README.md - Create URL API → Shorten response: builds payload
src/main/java/com/urlshortener/controller/UrlRestController.java - User / browser → Redirect endpoint: visits short link
README.md - Redirect endpoint → Shortening service: resolves code
src/main/java/com/urlshortener/controller/UrlRedirectController.java - Shortening service → Base62 codec: decodes code
src/main/java/com/urlshortener/service/UrlShortenerServiceImpl.java - Shortening service → URL repository: looks up ID
src/main/java/com/urlshortener/service/UrlShortenerServiceImpl.java - URL repository → MySQL database: reads record
README.md - Redirect endpoint → Destination website: redirects browser
README.md - API error handler → Error payload: builds error payload
src/main/java/com/urlshortener/exception/GlobalExceptionHandler.java - API error handler → Invalid URL error: handles validation error
src/main/java/com/urlshortener/exception/GlobalExceptionHandler.java - API error handler → URL not found error: handles missing URL
src/main/java/com/urlshortener/exception/GlobalExceptionHandler.java - Shortening service → URL not found error: throws when absent
src/main/java/com/urlshortener/service/UrlShortenerServiceImpl.java