Note: Due to HTTPExchange mocking not being supported in JDK 23, I degraded the version to 17, but since project metadata is built around 23, make sure to run the following steps before running on local. (See Issue: #7)
- POM -> In java source and target version, change from 17 to 23.
- Comment out the tests in ServerTest.java, HelperMethodsTest.java, these classes use HTTPExchange.
A lightweight URL shortener built using plain Java with com.sun.net.httpserver.HttpServer, H2 Database, and vanilla HTML/CSS/JS frontend.
- 🔗 Anonymous URL shortening: Convert long URLs into short ones instantly.
- 🧑💻 User login: Create an account and log in.
- 🌐 Custom short URLs: Logged-in users can create their own alias URLs.
- ↪️ Redirection: Short URLs automatically redirect to the long ones.
| Layer | Technology |
|---|---|
| Frontend | HTML, CSS, JavaScript (no framework) |
| Backend | Java, com.sun.net.httpserver.HttpServer |
| Database | H2 using JDBC |
| Logging | SLF4J |
| Testing | JUnit 5, Mockito |
| CI/CD | GitHub Actions |
## 🚀 Getting Started
### Prerequisites
* Java 17+
* Maven
### Run Application
```bash
mvn clean package
java -jar target/shorten.jar
Visit http://localhost:8080 in your browser.
- H2 in-memory mode used.
- JDBC with prepared statements.
- CI configured in
.github/workflows/ci.ymlto run tests on every PR and merge tomain.
| Endpoint | Method | Description |
|---|---|---|
/shorten |
POST | Shortens a given long URL |
/s/{shortUrl} |
GET | Redirects to original long URL |
/register |
POST | Register a new user |
/login |
POST | Log in existing user |
- All core components are tested with JUnit 5
- Mocked database and auth dependencies with Mockito
- GitHub Issues created for each task
- Separate branches for every feature
- Pull Requests with self-review
- CI runs on every PR and merge
This project is licensed under the MIT License.
Built with ❤️ using pure Java.
Snapshots:
Anonymous User:
Logged in user: (Custom URL workflow)
Registration Screen:
Log in screen:
