URL Shortener Rest API Endpoints

pom.xml

@@ -2,8 +2,8 @@
  <modelVersion>4.0.0</modelVersion>
 
  <groupId>com.tpximpact</groupId>
- <artifactId>url_shortener_api</artifactId>
- <version>1.0</version>
+ <artifactId>url_shortener</artifactId>
+ <version>1.0.0</version>
 
  <parent>
  <groupId>org.springframework.boot</groupId>
@@ -16,17 +16,42 @@
  </properties>
 
  <dependencies>
- <!-- Core -->
+ <!-- Web -->
  <dependency>
  <groupId>org.springframework.boot</groupId>
- <artifactId>spring-boot-starter</artifactId>
+ <artifactId>spring-boot-starter-web</artifactId>
  </dependency>
 
- <!-- Web -->
+ <!-- Spring Data JPA -->
  <dependency>
  <groupId>org.springframework.boot</groupId>
- <artifactId>spring-boot-starter-web</artifactId>
+ <artifactId>spring-boot-starter-data-jpa</artifactId>
  </dependency>
- </dependencies>
 
+ <!-- Embedded H2 DB FileBased mode -->
+ <dependency>
+ <groupId>com.h2database</groupId>
+ <artifactId>h2</artifactId>
+ <scope>runtime</scope>
+ </dependency>
+
+ <!--validation-->
+ <dependency>
+ <groupId>org.springframework.boot</groupId>
+ <artifactId>spring-boot-starter-validation</artifactId>
+ </dependency>
+
+ <!-- Actuator (health checks, metrics)-->
+ <dependency>
+ <groupId>org.springframework.boot</groupId>
+ <artifactId>spring-boot-starter-actuator</artifactId>
+ </dependency>
+
+ <!-- Lombok (optional, reduces boilerplate) -->
+ <dependency>
+ <groupId>org.projectlombok</groupId>
+ <artifactId>lombok</artifactId>
+ <optional>true</optional>
+ </dependency>
+ </dependencies>
 </project>

src/main/java/com/tpximpact/urlshortener/UrlShortenerApplication.java

@@ -0,0 +1,13 @@
+package com.tpximpact.urlshortener;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+class UrlShortenerApplication {
+
+ public static void main(String[] args) {
+ SpringApplication.run(UrlShortenerApplication.class, args);
+ }
+
+}

src/main/java/com/tpximpact/urlshortener/controller/UrlController.java

@@ -0,0 +1,53 @@
+package com.tpximpact.urlshortener.controller;
+
+import com.tpximpact.urlshortener.dto.UrlListResponse;
+import com.tpximpact.urlshortener.dto.UrlRequest;
+import com.tpximpact.urlshortener.dto.UrlResponse;
+import com.tpximpact.urlshortener.service.UrlService;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RestController;
+import java.net.URI;
+import java.util.List;
+
+@RestController
+@RequiredArgsConstructor
+@Slf4j
+class UrlController {
+ private final UrlService urlService;
+
+ @PostMapping("/shorten")
+ public ResponseEntity<UrlResponse> shorten(@RequestBody @Valid UrlRequest request) {
+ UrlResponse response = urlService.shorten(request);
+ return ResponseEntity.status(201).body(response);
+ }
+
+ @GetMapping("/{alias}")
+ public ResponseEntity<Void> redirect(@PathVariable String alias) {
+ log.info("Contacting urlService to full url with: {}", alias);
+ String fullUrl = urlService.getFullUrl(alias);
+ log.info("Received Full url to redirect: {}", fullUrl);
+ return ResponseEntity.status(302)
+ .location(URI.create(fullUrl))
+ .build();
+ }
+
+ @GetMapping("/urls")
+ public ResponseEntity<List<UrlListResponse>> getAll() {
+ return ResponseEntity.ok(urlService.getAll());
+ }
+
+ @DeleteMapping("/{alias}")
+ public ResponseEntity<Void> delete(@PathVariable String alias) {
+ urlService.delete(alias);
+ return ResponseEntity.noContent().build();
+ }
+
+}

src/main/java/com/tpximpact/urlshortener/dto/UrlListResponse.java

@@ -0,0 +1,7 @@
+package com.tpximpact.urlshortener.dto;
+
+public record UrlListResponse(
+ String alias,
+ String fullUrl,
+ String shortUrl
+) {}

src/main/java/com/tpximpact/urlshortener/dto/UrlRequest.java

@@ -0,0 +1,8 @@
+package com.tpximpact.urlshortener.dto;
+
+import jakarta.validation.constraints.NotBlank;
+
+public record UrlRequest (
+ @NotBlank String fullUrl,
+ String customAlias
+) {}

src/main/java/com/tpximpact/urlshortener/dto/UrlResponse.java

@@ -0,0 +1,5 @@
+package com.tpximpact.urlshortener.dto;
+
+public record UrlResponse(
+ String shortUrl
+) {}

src/main/java/com/tpximpact/urlshortener/entity/Url.java

@@ -0,0 +1,35 @@
+package com.tpximpact.urlshortener.entity;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.Table;
+import jakarta.persistence.UniqueConstraint;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+
+@Entity
+@Table(name = "urls", uniqueConstraints = {
+ @UniqueConstraint(columnNames = "alias")
+})
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class Url {
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @Column(nullable = false)
+ private String fullUrl;
+
+ @Column(nullable = false, unique = true)
+ private String alias;
+}

src/main/java/com/tpximpact/urlshortener/exception/BadRequestException.java

@@ -0,0 +1,5 @@
+package com.tpximpact.urlshortener.exception;
+
+public class BadRequestException extends RuntimeException {
+ public BadRequestException(String message) { super(message); }
+}

src/main/java/com/tpximpact/urlshortener/exception/GlobalExceptionHandler.java

@@ -0,0 +1,19 @@
+package com.tpximpact.urlshortener.exception;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+
+@RestControllerAdvice
+public class GlobalExceptionHandler {
+
+ @ExceptionHandler(BadRequestException.class)
+ public ResponseEntity<String> handleBadRequest(BadRequestException ex) {
+ return ResponseEntity.badRequest().body(ex.getMessage());
+ }
+
+ @ExceptionHandler(NotFoundException.class)
+ public ResponseEntity<String> handleNotFound(NotFoundException ex) {
+ return ResponseEntity.status(404).body(ex.getMessage());
+ }
+}

src/main/java/com/tpximpact/urlshortener/exception/NotFoundException.java

@@ -0,0 +1,7 @@
+package com.tpximpact.urlshortener.exception;
+
+public class NotFoundException extends RuntimeException {
+ public NotFoundException(String message) {
+ super(message);
+ }
+}

src/main/java/com/tpximpact/urlshortener/repository/UrlRepository.java

@@ -0,0 +1,15 @@
+package com.tpximpact.urlshortener.repository;
+
+import com.tpximpact.urlshortener.entity.Url;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.Optional;
+
+@Repository
+public interface UrlRepository extends JpaRepository<Url, Long> {
+
+ boolean existsByAlias(String alias);
+
+ Optional<Url> findByAlias(String alias);
+}

src/main/java/com/tpximpact/urlshortener/service/UrlService.java

@@ -0,0 +1,18 @@
+package com.tpximpact.urlshortener.service;
+
+import com.tpximpact.urlshortener.dto.UrlListResponse;
+import com.tpximpact.urlshortener.dto.UrlRequest;
+import com.tpximpact.urlshortener.dto.UrlResponse;
+
+import java.util.List;
+
+public interface UrlService {
+
+ UrlResponse shorten(UrlRequest request);
+
+ String getFullUrl(String alias);
+
+ List<UrlListResponse> getAll();
+
+ void delete(String alias);
+}

src/main/java/com/tpximpact/urlshortener/service/UrlServiceImpl.java

@@ -0,0 +1,71 @@
+package com.tpximpact.urlshortener.service;
+
+import com.tpximpact.urlshortener.dto.UrlListResponse;
+import com.tpximpact.urlshortener.dto.UrlRequest;
+import com.tpximpact.urlshortener.dto.UrlResponse;
+import com.tpximpact.urlshortener.entity.Url;
+import com.tpximpact.urlshortener.exception.BadRequestException;
+import com.tpximpact.urlshortener.exception.NotFoundException;
+import com.tpximpact.urlshortener.repository.UrlRepository;
+import com.tpximpact.urlshortener.util.UrlUtils;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import java.util.List;
+
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class UrlServiceImpl implements UrlService {
+ private static final String BASE_URL = "http://localhost:8080/";
+ private final UrlRepository urlRepository;
+
+ @Override
+ public UrlResponse shorten(UrlRequest request) {
+
+ String alias = request.customAlias() != null
+ ? request.customAlias() : UrlUtils.generateAlias();
+
+ if (urlRepository.existsByAlias(alias)) {
+ throw new BadRequestException("Invalid input or alias already taken");
+ }
+
+ Url url = Url
+ .builder()
+ .fullUrl(request.fullUrl())
+ .alias(alias)
+ .build();
+
+ urlRepository.save(url);
+
+ return new UrlResponse(BASE_URL + alias);
+ }
+
+ @Override
+ public String getFullUrl(String alias) {
+ log.info("Getting full url for alias ' {} ' from the DB", alias);
+ return urlRepository.findByAlias(alias)
+ .map(Url::getFullUrl)
+ .orElseThrow(() -> new NotFoundException("Alias not found"));
+ }
+
+ @Override
+ public List<UrlListResponse> getAll() {
+ return urlRepository.findAll().stream()
+ .map(url -> new UrlListResponse(
+ url.getAlias(),
+ url.getFullUrl(),
+ BASE_URL + url.getAlias()
+ ))
+ .toList();
+ }
+
+ public void delete(String alias) {
+
+ Url url = urlRepository.findByAlias(alias)
+ .orElseThrow(() -> new NotFoundException("Alias not found"));
+ log.info("Deleting shorten url for alias '{}' from the DB", url.getAlias());
+ urlRepository.delete(url);
+ }
+}

src/main/java/com/tpximpact/urlshortener/util/UrlUtils.java

@@ -0,0 +1,13 @@
+package com.tpximpact.urlshortener.util;
+
+import lombok.extern.slf4j.Slf4j;
+
+import java.util.UUID;
+
+@Slf4j
+public class UrlUtils {
+
+ public static String generateAlias() {
+ return UUID.randomUUID().toString().substring(0, 6);
+ }
+}

src/main/resources/application-dev.yaml

@@ -0,0 +1,16 @@
+spring:
+ datasource:
+ url: jdbc:h2:file:./data/mydb
+ driver-class-name: org.h2.Driver
+ username: sa
+ password:
+
+ h2:
+ console:
+ enabled: true
+ path: /h2-console
+
+ jpa:
+ show_sql: true
+ hibernate:
+ ddl-auto: update

pom.xml

@@ -2,8 +2,8 @@
  <modelVersion>4.0.0</modelVersion>
 
  <groupId>com.tpximpact</groupId>
- <artifactId>url_shortener_api</artifactId>
- <version>1.0</version>
+ <artifactId>url_shortener</artifactId>
+ <version>1.0.0</version>
 
  <parent>
  <groupId>org.springframework.boot</groupId>
@@ -16,17 +16,42 @@
  </properties>
 
  <dependencies>
- <!-- Core -->
+ <!-- Web -->
  <dependency>
  <groupId>org.springframework.boot</groupId>
- <artifactId>spring-boot-starter</artifactId>
+ <artifactId>spring-boot-starter-web</artifactId>
  </dependency>
 
- <!-- Web -->
+ <!-- Spring Data JPA -->
  <dependency>
  <groupId>org.springframework.boot</groupId>
- <artifactId>spring-boot-starter-web</artifactId>
+ <artifactId>spring-boot-starter-data-jpa</artifactId>
  </dependency>
- </dependencies>
 
+ <!-- Embedded H2 DB FileBased mode -->
+ <dependency>
+ <groupId>com.h2database</groupId>
+ <artifactId>h2</artifactId>
+ <scope>runtime</scope>
+ </dependency>
+
+ <!--validation-->
+ <dependency>
+ <groupId>org.springframework.boot</groupId>
+ <artifactId>spring-boot-starter-validation</artifactId>
+ </dependency>
+
+ <!-- Actuator (health checks, metrics)-->
+ <dependency>
+ <groupId>org.springframework.boot</groupId>
+ <artifactId>spring-boot-starter-actuator</artifactId>
+ </dependency>
+
+ <!-- Lombok (optional, reduces boilerplate) -->
+ <dependency>
+ <groupId>org.projectlombok</groupId>
+ <artifactId>lombok</artifactId>
+ <optional>true</optional>
+ </dependency>
+ </dependencies>
 </project>

src/main/java/com/tpximpact/urlshortener/UrlShortenerApplication.java

@@ -0,0 +1,13 @@
+package com.tpximpact.urlshortener;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+class UrlShortenerApplication {
+
+ public static void main(String[] args) {
+ SpringApplication.run(UrlShortenerApplication.class, args);
+ }
+
+}

src/main/java/com/tpximpact/urlshortener/controller/UrlController.java

@@ -0,0 +1,53 @@
+package com.tpximpact.urlshortener.controller;
+
+import com.tpximpact.urlshortener.dto.UrlListResponse;
+import com.tpximpact.urlshortener.dto.UrlRequest;
+import com.tpximpact.urlshortener.dto.UrlResponse;
+import com.tpximpact.urlshortener.service.UrlService;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RestController;
+import java.net.URI;
+import java.util.List;
+
+@RestController
+@RequiredArgsConstructor
+@Slf4j
+class UrlController {
+ private final UrlService urlService;
+
+ @PostMapping("/shorten")
+ public ResponseEntity<UrlResponse> shorten(@RequestBody @Valid UrlRequest request) {
+ UrlResponse response = urlService.shorten(request);
+ return ResponseEntity.status(201).body(response);
+ }
+
+ @GetMapping("/{alias}")
+ public ResponseEntity<Void> redirect(@PathVariable String alias) {
+ log.info("Contacting urlService to full url with: {}", alias);
+ String fullUrl = urlService.getFullUrl(alias);
+ log.info("Received Full url to redirect: {}", fullUrl);
+ return ResponseEntity.status(302)
+ .location(URI.create(fullUrl))
+ .build();
+ }
+
+ @GetMapping("/urls")
+ public ResponseEntity<List<UrlListResponse>> getAll() {
+ return ResponseEntity.ok(urlService.getAll());
+ }
+
+ @DeleteMapping("/{alias}")
+ public ResponseEntity<Void> delete(@PathVariable String alias) {
+ urlService.delete(alias);
+ return ResponseEntity.noContent().build();
+ }
+
+}

src/main/java/com/tpximpact/urlshortener/dto/UrlListResponse.java

@@ -0,0 +1,7 @@
+package com.tpximpact.urlshortener.dto;
+
+public record UrlListResponse(
+ String alias,
+ String fullUrl,
+ String shortUrl
+) {}

src/main/java/com/tpximpact/urlshortener/dto/UrlRequest.java

@@ -0,0 +1,8 @@
+package com.tpximpact.urlshortener.dto;
+
+import jakarta.validation.constraints.NotBlank;
+
+public record UrlRequest (
+ @NotBlank String fullUrl,
+ String customAlias
+) {}

src/main/java/com/tpximpact/urlshortener/dto/UrlResponse.java

@@ -0,0 +1,5 @@
+package com.tpximpact.urlshortener.dto;
+
+public record UrlResponse(
+ String shortUrl
+) {}

src/main/java/com/tpximpact/urlshortener/entity/Url.java

@@ -0,0 +1,35 @@
+package com.tpximpact.urlshortener.entity;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.Table;
+import jakarta.persistence.UniqueConstraint;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+
+@Entity
+@Table(name = "urls", uniqueConstraints = {
+ @UniqueConstraint(columnNames = "alias")
+})
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class Url {
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @Column(nullable = false)
+ private String fullUrl;
+
+ @Column(nullable = false, unique = true)
+ private String alias;
+}

src/main/java/com/tpximpact/urlshortener/exception/BadRequestException.java

@@ -0,0 +1,5 @@
+package com.tpximpact.urlshortener.exception;
+
+public class BadRequestException extends RuntimeException {
+ public BadRequestException(String message) { super(message); }
+}

src/main/java/com/tpximpact/urlshortener/exception/GlobalExceptionHandler.java

@@ -0,0 +1,19 @@
+package com.tpximpact.urlshortener.exception;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+
+@RestControllerAdvice
+public class GlobalExceptionHandler {
+
+ @ExceptionHandler(BadRequestException.class)
+ public ResponseEntity<String> handleBadRequest(BadRequestException ex) {
+ return ResponseEntity.badRequest().body(ex.getMessage());
+ }
+
+ @ExceptionHandler(NotFoundException.class)
+ public ResponseEntity<String> handleNotFound(NotFoundException ex) {
+ return ResponseEntity.status(404).body(ex.getMessage());
+ }
+}

src/main/java/com/tpximpact/urlshortener/exception/NotFoundException.java

@@ -0,0 +1,7 @@
+package com.tpximpact.urlshortener.exception;
+
+public class NotFoundException extends RuntimeException {
+ public NotFoundException(String message) {
+ super(message);
+ }
+}

src/main/java/com/tpximpact/urlshortener/repository/UrlRepository.java

@@ -0,0 +1,15 @@
+package com.tpximpact.urlshortener.repository;
+
+import com.tpximpact.urlshortener.entity.Url;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.Optional;
+
+@Repository
+public interface UrlRepository extends JpaRepository<Url, Long> {
+
+ boolean existsByAlias(String alias);
+
+ Optional<Url> findByAlias(String alias);
+}

src/main/java/com/tpximpact/urlshortener/service/UrlService.java

@@ -0,0 +1,18 @@
+package com.tpximpact.urlshortener.service;
+
+import com.tpximpact.urlshortener.dto.UrlListResponse;
+import com.tpximpact.urlshortener.dto.UrlRequest;
+import com.tpximpact.urlshortener.dto.UrlResponse;
+
+import java.util.List;
+
+public interface UrlService {
+
+ UrlResponse shorten(UrlRequest request);
+
+ String getFullUrl(String alias);
+
+ List<UrlListResponse> getAll();
+
+ void delete(String alias);
+}

src/main/java/com/tpximpact/urlshortener/service/UrlServiceImpl.java

@@ -0,0 +1,71 @@
+package com.tpximpact.urlshortener.service;
+
+import com.tpximpact.urlshortener.dto.UrlListResponse;
+import com.tpximpact.urlshortener.dto.UrlRequest;
+import com.tpximpact.urlshortener.dto.UrlResponse;
+import com.tpximpact.urlshortener.entity.Url;
+import com.tpximpact.urlshortener.exception.BadRequestException;
+import com.tpximpact.urlshortener.exception.NotFoundException;
+import com.tpximpact.urlshortener.repository.UrlRepository;
+import com.tpximpact.urlshortener.util.UrlUtils;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import java.util.List;
+
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class UrlServiceImpl implements UrlService {
+ private static final String BASE_URL = "http://localhost:8080/";
+ private final UrlRepository urlRepository;
+
+ @Override
+ public UrlResponse shorten(UrlRequest request) {
+
+ String alias = request.customAlias() != null
+ ? request.customAlias() : UrlUtils.generateAlias();
+
+ if (urlRepository.existsByAlias(alias)) {
+ throw new BadRequestException("Invalid input or alias already taken");
+ }
+
+ Url url = Url
+ .builder()
+ .fullUrl(request.fullUrl())
+ .alias(alias)
+ .build();
+
+ urlRepository.save(url);
+
+ return new UrlResponse(BASE_URL + alias);
+ }
+
+ @Override
+ public String getFullUrl(String alias) {
+ log.info("Getting full url for alias ' {} ' from the DB", alias);
+ return urlRepository.findByAlias(alias)
+ .map(Url::getFullUrl)
+ .orElseThrow(() -> new NotFoundException("Alias not found"));
+ }
+
+ @Override
+ public List<UrlListResponse> getAll() {
+ return urlRepository.findAll().stream()
+ .map(url -> new UrlListResponse(
+ url.getAlias(),
+ url.getFullUrl(),
+ BASE_URL + url.getAlias()
+ ))
+ .toList();
+ }
+
+ public void delete(String alias) {
+
+ Url url = urlRepository.findByAlias(alias)
+ .orElseThrow(() -> new NotFoundException("Alias not found"));
+ log.info("Deleting shorten url for alias '{}' from the DB", url.getAlias());
+ urlRepository.delete(url);
+ }
+}

src/main/java/com/tpximpact/urlshortener/util/UrlUtils.java

@@ -0,0 +1,13 @@
+package com.tpximpact.urlshortener.util;
+
+import lombok.extern.slf4j.Slf4j;
+
+import java.util.UUID;
+
+@Slf4j
+public class UrlUtils {
+
+ public static String generateAlias() {
+ return UUID.randomUUID().toString().substring(0, 6);
+ }
+}

src/main/resources/application-dev.yaml

@@ -0,0 +1,16 @@
+spring:
+ datasource:
+ url: jdbc:h2:file:./data/mydb
+ driver-class-name: org.h2.Driver
+ username: sa
+ password:
+
+ h2:
+ console:
+ enabled: true
+ path: /h2-console
+
+ jpa:
+ show_sql: true
+ hibernate:
+ ddl-auto: update

pom.xml

@@ -2,8 +2,8 @@
  <modelVersion>4.0.0</modelVersion>
 
  <groupId>com.tpximpact</groupId>
- <artifactId>url_shortener_api</artifactId>
- <version>1.0</version>
+ <artifactId>url_shortener</artifactId>
+ <version>1.0.0</version>
 
  <parent>
  <groupId>org.springframework.boot</groupId>
@@ -16,17 +16,42 @@
  </properties>
 
  <dependencies>
- <!-- Core -->
+ <!-- Web -->
  <dependency>
  <groupId>org.springframework.boot</groupId>
- <artifactId>spring-boot-starter</artifactId>
+ <artifactId>spring-boot-starter-web</artifactId>
  </dependency>
 
- <!-- Web -->
+ <!-- Spring Data JPA -->
  <dependency>
  <groupId>org.springframework.boot</groupId>
- <artifactId>spring-boot-starter-web</artifactId>
+ <artifactId>spring-boot-starter-data-jpa</artifactId>
  </dependency>
- </dependencies>
 
+ <!-- Embedded H2 DB FileBased mode -->
+ <dependency>
+ <groupId>com.h2database</groupId>
+ <artifactId>h2</artifactId>
+ <scope>runtime</scope>
+ </dependency>
+
+ <!--validation-->
+ <dependency>
+ <groupId>org.springframework.boot</groupId>
+ <artifactId>spring-boot-starter-validation</artifactId>
+ </dependency>
+
+ <!-- Actuator (health checks, metrics)-->
+ <dependency>
+ <groupId>org.springframework.boot</groupId>
+ <artifactId>spring-boot-starter-actuator</artifactId>
+ </dependency>
+
+ <!-- Lombok (optional, reduces boilerplate) -->
+ <dependency>
+ <groupId>org.projectlombok</groupId>
+ <artifactId>lombok</artifactId>
+ <optional>true</optional>
+ </dependency>
+ </dependencies>
 </project>

src/main/java/com/tpximpact/urlshortener/UrlShortenerApplication.java

@@ -0,0 +1,13 @@
+package com.tpximpact.urlshortener;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+class UrlShortenerApplication {
+
+ public static void main(String[] args) {
+ SpringApplication.run(UrlShortenerApplication.class, args);
+ }
+
+}

src/main/java/com/tpximpact/urlshortener/controller/UrlController.java

@@ -0,0 +1,53 @@
+package com.tpximpact.urlshortener.controller;
+
+import com.tpximpact.urlshortener.dto.UrlListResponse;
+import com.tpximpact.urlshortener.dto.UrlRequest;
+import com.tpximpact.urlshortener.dto.UrlResponse;
+import com.tpximpact.urlshortener.service.UrlService;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RestController;
+import java.net.URI;
+import java.util.List;
+
+@RestController
+@RequiredArgsConstructor
+@Slf4j
+class UrlController {
+ private final UrlService urlService;
+
+ @PostMapping("/shorten")
+ public ResponseEntity<UrlResponse> shorten(@RequestBody @Valid UrlRequest request) {
+ UrlResponse response = urlService.shorten(request);
+ return ResponseEntity.status(201).body(response);
+ }
+
+ @GetMapping("/{alias}")
+ public ResponseEntity<Void> redirect(@PathVariable String alias) {
+ log.info("Contacting urlService to full url with: {}", alias);
+ String fullUrl = urlService.getFullUrl(alias);
+ log.info("Received Full url to redirect: {}", fullUrl);
+ return ResponseEntity.status(302)
+ .location(URI.create(fullUrl))
+ .build();
+ }
+
+ @GetMapping("/urls")
+ public ResponseEntity<List<UrlListResponse>> getAll() {
+ return ResponseEntity.ok(urlService.getAll());
+ }
+
+ @DeleteMapping("/{alias}")
+ public ResponseEntity<Void> delete(@PathVariable String alias) {
+ urlService.delete(alias);
+ return ResponseEntity.noContent().build();
+ }
+
+}

src/main/java/com/tpximpact/urlshortener/dto/UrlListResponse.java

@@ -0,0 +1,7 @@
+package com.tpximpact.urlshortener.dto;
+
+public record UrlListResponse(
+ String alias,
+ String fullUrl,
+ String shortUrl
+) {}

src/main/java/com/tpximpact/urlshortener/dto/UrlRequest.java

@@ -0,0 +1,8 @@
+package com.tpximpact.urlshortener.dto;
+
+import jakarta.validation.constraints.NotBlank;
+
+public record UrlRequest (
+ @NotBlank String fullUrl,
+ String customAlias
+) {}

src/main/java/com/tpximpact/urlshortener/dto/UrlResponse.java

@@ -0,0 +1,5 @@
+package com.tpximpact.urlshortener.dto;
+
+public record UrlResponse(
+ String shortUrl
+) {}

src/main/java/com/tpximpact/urlshortener/entity/Url.java

@@ -0,0 +1,35 @@
+package com.tpximpact.urlshortener.entity;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.Table;
+import jakarta.persistence.UniqueConstraint;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+
+@Entity
+@Table(name = "urls", uniqueConstraints = {
+ @UniqueConstraint(columnNames = "alias")
+})
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class Url {
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @Column(nullable = false)
+ private String fullUrl;
+
+ @Column(nullable = false, unique = true)
+ private String alias;
+}

src/main/java/com/tpximpact/urlshortener/exception/BadRequestException.java

@@ -0,0 +1,5 @@
+package com.tpximpact.urlshortener.exception;
+
+public class BadRequestException extends RuntimeException {
+ public BadRequestException(String message) { super(message); }
+}

src/main/java/com/tpximpact/urlshortener/exception/GlobalExceptionHandler.java

@@ -0,0 +1,19 @@
+package com.tpximpact.urlshortener.exception;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+
+@RestControllerAdvice
+public class GlobalExceptionHandler {
+
+ @ExceptionHandler(BadRequestException.class)
+ public ResponseEntity<String> handleBadRequest(BadRequestException ex) {
+ return ResponseEntity.badRequest().body(ex.getMessage());
+ }
+
+ @ExceptionHandler(NotFoundException.class)
+ public ResponseEntity<String> handleNotFound(NotFoundException ex) {
+ return ResponseEntity.status(404).body(ex.getMessage());
+ }
+}

src/main/java/com/tpximpact/urlshortener/exception/NotFoundException.java

@@ -0,0 +1,7 @@
+package com.tpximpact.urlshortener.exception;
+
+public class NotFoundException extends RuntimeException {
+ public NotFoundException(String message) {
+ super(message);
+ }
+}

src/main/java/com/tpximpact/urlshortener/repository/UrlRepository.java

@@ -0,0 +1,15 @@
+package com.tpximpact.urlshortener.repository;
+
+import com.tpximpact.urlshortener.entity.Url;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.Optional;
+
+@Repository
+public interface UrlRepository extends JpaRepository<Url, Long> {
+
+ boolean existsByAlias(String alias);
+
+ Optional<Url> findByAlias(String alias);
+}

src/main/java/com/tpximpact/urlshortener/service/UrlService.java

@@ -0,0 +1,18 @@
+package com.tpximpact.urlshortener.service;
+
+import com.tpximpact.urlshortener.dto.UrlListResponse;
+import com.tpximpact.urlshortener.dto.UrlRequest;
+import com.tpximpact.urlshortener.dto.UrlResponse;
+
+import java.util.List;
+
+public interface UrlService {
+
+ UrlResponse shorten(UrlRequest request);
+
+ String getFullUrl(String alias);
+
+ List<UrlListResponse> getAll();
+
+ void delete(String alias);
+}

src/main/java/com/tpximpact/urlshortener/service/UrlServiceImpl.java

@@ -0,0 +1,71 @@
+package com.tpximpact.urlshortener.service;
+
+import com.tpximpact.urlshortener.dto.UrlListResponse;
+import com.tpximpact.urlshortener.dto.UrlRequest;
+import com.tpximpact.urlshortener.dto.UrlResponse;
+import com.tpximpact.urlshortener.entity.Url;
+import com.tpximpact.urlshortener.exception.BadRequestException;
+import com.tpximpact.urlshortener.exception.NotFoundException;
+import com.tpximpact.urlshortener.repository.UrlRepository;
+import com.tpximpact.urlshortener.util.UrlUtils;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import java.util.List;
+
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class UrlServiceImpl implements UrlService {
+ private static final String BASE_URL = "http://localhost:8080/";
+ private final UrlRepository urlRepository;
+
+ @Override
+ public UrlResponse shorten(UrlRequest request) {
+
+ String alias = request.customAlias() != null
+ ? request.customAlias() : UrlUtils.generateAlias();
+
+ if (urlRepository.existsByAlias(alias)) {
+ throw new BadRequestException("Invalid input or alias already taken");
+ }
+
+ Url url = Url
+ .builder()
+ .fullUrl(request.fullUrl())
+ .alias(alias)
+ .build();
+
+ urlRepository.save(url);
+
+ return new UrlResponse(BASE_URL + alias);
+ }
+
+ @Override
+ public String getFullUrl(String alias) {
+ log.info("Getting full url for alias ' {} ' from the DB", alias);
+ return urlRepository.findByAlias(alias)
+ .map(Url::getFullUrl)
+ .orElseThrow(() -> new NotFoundException("Alias not found"));
+ }
+
+ @Override
+ public List<UrlListResponse> getAll() {
+ return urlRepository.findAll().stream()
+ .map(url -> new UrlListResponse(
+ url.getAlias(),
+ url.getFullUrl(),
+ BASE_URL + url.getAlias()
+ ))
+ .toList();
+ }
+
+ public void delete(String alias) {
+
+ Url url = urlRepository.findByAlias(alias)
+ .orElseThrow(() -> new NotFoundException("Alias not found"));
+ log.info("Deleting shorten url for alias '{}' from the DB", url.getAlias());
+ urlRepository.delete(url);
+ }
+}

src/main/java/com/tpximpact/urlshortener/util/UrlUtils.java

@@ -0,0 +1,13 @@
+package com.tpximpact.urlshortener.util;
+
+import lombok.extern.slf4j.Slf4j;
+
+import java.util.UUID;
+
+@Slf4j
+public class UrlUtils {
+
+ public static String generateAlias() {
+ return UUID.randomUUID().toString().substring(0, 6);
+ }
+}

src/main/resources/application-dev.yaml

@@ -0,0 +1,16 @@
+spring:
+ datasource:
+ url: jdbc:h2:file:./data/mydb
+ driver-class-name: org.h2.Driver
+ username: sa
+ password:
+
+ h2:
+ console:
+ enabled: true
+ path: /h2-console
+
+ jpa:
+ show_sql: true
+ hibernate:
+ ddl-auto: update

pom.xml

@@ -2,8 +2,8 @@
  <modelVersion>4.0.0</modelVersion>
 
  <groupId>com.tpximpact</groupId>
- <artifactId>url_shortener_api</artifactId>
- <version>1.0</version>
+ <artifactId>url_shortener</artifactId>
+ <version>1.0.0</version>
 
  <parent>
  <groupId>org.springframework.boot</groupId>
@@ -16,17 +16,42 @@
  </properties>
 
  <dependencies>
- <!-- Core -->
+ <!-- Web -->
  <dependency>
  <groupId>org.springframework.boot</groupId>
- <artifactId>spring-boot-starter</artifactId>
+ <artifactId>spring-boot-starter-web</artifactId>
  </dependency>
 
- <!-- Web -->
+ <!-- Spring Data JPA -->
  <dependency>
  <groupId>org.springframework.boot</groupId>
- <artifactId>spring-boot-starter-web</artifactId>
+ <artifactId>spring-boot-starter-data-jpa</artifactId>
  </dependency>
- </dependencies>
 
+ <!-- Embedded H2 DB FileBased mode -->
+ <dependency>
+ <groupId>com.h2database</groupId>
+ <artifactId>h2</artifactId>
+ <scope>runtime</scope>
+ </dependency>
+
+ <!--validation-->
+ <dependency>
+ <groupId>org.springframework.boot</groupId>
+ <artifactId>spring-boot-starter-validation</artifactId>
+ </dependency>
+
+ <!-- Actuator (health checks, metrics)-->
+ <dependency>
+ <groupId>org.springframework.boot</groupId>
+ <artifactId>spring-boot-starter-actuator</artifactId>
+ </dependency>
+
+ <!-- Lombok (optional, reduces boilerplate) -->
+ <dependency>
+ <groupId>org.projectlombok</groupId>
+ <artifactId>lombok</artifactId>
+ <optional>true</optional>
+ </dependency>
+ </dependencies>
 </project>

src/main/java/com/tpximpact/urlshortener/UrlShortenerApplication.java

@@ -0,0 +1,13 @@
+package com.tpximpact.urlshortener;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+class UrlShortenerApplication {
+
+ public static void main(String[] args) {
+ SpringApplication.run(UrlShortenerApplication.class, args);
+ }
+
+}

src/main/java/com/tpximpact/urlshortener/controller/UrlController.java

@@ -0,0 +1,53 @@
+package com.tpximpact.urlshortener.controller;
+
+import com.tpximpact.urlshortener.dto.UrlListResponse;
+import com.tpximpact.urlshortener.dto.UrlRequest;
+import com.tpximpact.urlshortener.dto.UrlResponse;
+import com.tpximpact.urlshortener.service.UrlService;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RestController;
+import java.net.URI;
+import java.util.List;
+
+@RestController
+@RequiredArgsConstructor
+@Slf4j
+class UrlController {
+ private final UrlService urlService;
+
+ @PostMapping("/shorten")
+ public ResponseEntity<UrlResponse> shorten(@RequestBody @Valid UrlRequest request) {
+ UrlResponse response = urlService.shorten(request);
+ return ResponseEntity.status(201).body(response);
+ }
+
+ @GetMapping("/{alias}")
+ public ResponseEntity<Void> redirect(@PathVariable String alias) {
+ log.info("Contacting urlService to full url with: {}", alias);
+ String fullUrl = urlService.getFullUrl(alias);
+ log.info("Received Full url to redirect: {}", fullUrl);
+ return ResponseEntity.status(302)
+ .location(URI.create(fullUrl))
+ .build();
+ }
+
+ @GetMapping("/urls")
+ public ResponseEntity<List<UrlListResponse>> getAll() {
+ return ResponseEntity.ok(urlService.getAll());
+ }
+
+ @DeleteMapping("/{alias}")
+ public ResponseEntity<Void> delete(@PathVariable String alias) {
+ urlService.delete(alias);
+ return ResponseEntity.noContent().build();
+ }
+
+}

src/main/java/com/tpximpact/urlshortener/dto/UrlListResponse.java

@@ -0,0 +1,7 @@
+package com.tpximpact.urlshortener.dto;
+
+public record UrlListResponse(
+ String alias,
+ String fullUrl,
+ String shortUrl
+) {}

src/main/java/com/tpximpact/urlshortener/dto/UrlRequest.java

@@ -0,0 +1,8 @@
+package com.tpximpact.urlshortener.dto;
+
+import jakarta.validation.constraints.NotBlank;
+
+public record UrlRequest (
+ @NotBlank String fullUrl,
+ String customAlias
+) {}

src/main/java/com/tpximpact/urlshortener/dto/UrlResponse.java

@@ -0,0 +1,5 @@
+package com.tpximpact.urlshortener.dto;
+
+public record UrlResponse(
+ String shortUrl
+) {}

src/main/java/com/tpximpact/urlshortener/entity/Url.java

@@ -0,0 +1,35 @@
+package com.tpximpact.urlshortener.entity;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.Table;
+import jakarta.persistence.UniqueConstraint;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+
+@Entity
+@Table(name = "urls", uniqueConstraints = {
+ @UniqueConstraint(columnNames = "alias")
+})
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class Url {
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @Column(nullable = false)
+ private String fullUrl;
+
+ @Column(nullable = false, unique = true)
+ private String alias;
+}

src/main/java/com/tpximpact/urlshortener/exception/BadRequestException.java

@@ -0,0 +1,5 @@
+package com.tpximpact.urlshortener.exception;
+
+public class BadRequestException extends RuntimeException {
+ public BadRequestException(String message) { super(message); }
+}

src/main/java/com/tpximpact/urlshortener/exception/GlobalExceptionHandler.java

@@ -0,0 +1,19 @@
+package com.tpximpact.urlshortener.exception;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+
+@RestControllerAdvice
+public class GlobalExceptionHandler {
+
+ @ExceptionHandler(BadRequestException.class)
+ public ResponseEntity<String> handleBadRequest(BadRequestException ex) {
+ return ResponseEntity.badRequest().body(ex.getMessage());
+ }
+
+ @ExceptionHandler(NotFoundException.class)
+ public ResponseEntity<String> handleNotFound(NotFoundException ex) {
+ return ResponseEntity.status(404).body(ex.getMessage());
+ }
+}

src/main/java/com/tpximpact/urlshortener/exception/NotFoundException.java

@@ -0,0 +1,7 @@
+package com.tpximpact.urlshortener.exception;
+
+public class NotFoundException extends RuntimeException {
+ public NotFoundException(String message) {
+ super(message);
+ }
+}

src/main/java/com/tpximpact/urlshortener/repository/UrlRepository.java

@@ -0,0 +1,15 @@
+package com.tpximpact.urlshortener.repository;
+
+import com.tpximpact.urlshortener.entity.Url;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.Optional;
+
+@Repository
+public interface UrlRepository extends JpaRepository<Url, Long> {
+
+ boolean existsByAlias(String alias);
+
+ Optional<Url> findByAlias(String alias);
+}

src/main/java/com/tpximpact/urlshortener/service/UrlService.java

@@ -0,0 +1,18 @@
+package com.tpximpact.urlshortener.service;
+
+import com.tpximpact.urlshortener.dto.UrlListResponse;
+import com.tpximpact.urlshortener.dto.UrlRequest;
+import com.tpximpact.urlshortener.dto.UrlResponse;
+
+import java.util.List;
+
+public interface UrlService {
+
+ UrlResponse shorten(UrlRequest request);
+
+ String getFullUrl(String alias);
+
+ List<UrlListResponse> getAll();
+
+ void delete(String alias);
+}

src/main/java/com/tpximpact/urlshortener/service/UrlServiceImpl.java

@@ -0,0 +1,71 @@
+package com.tpximpact.urlshortener.service;
+
+import com.tpximpact.urlshortener.dto.UrlListResponse;
+import com.tpximpact.urlshortener.dto.UrlRequest;
+import com.tpximpact.urlshortener.dto.UrlResponse;
+import com.tpximpact.urlshortener.entity.Url;
+import com.tpximpact.urlshortener.exception.BadRequestException;
+import com.tpximpact.urlshortener.exception.NotFoundException;
+import com.tpximpact.urlshortener.repository.UrlRepository;
+import com.tpximpact.urlshortener.util.UrlUtils;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import java.util.List;
+
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class UrlServiceImpl implements UrlService {
+ private static final String BASE_URL = "http://localhost:8080/";
+ private final UrlRepository urlRepository;
+
+ @Override
+ public UrlResponse shorten(UrlRequest request) {
+
+ String alias = request.customAlias() != null
+ ? request.customAlias() : UrlUtils.generateAlias();
+
+ if (urlRepository.existsByAlias(alias)) {
+ throw new BadRequestException("Invalid input or alias already taken");
+ }
+
+ Url url = Url
+ .builder()
+ .fullUrl(request.fullUrl())
+ .alias(alias)
+ .build();
+
+ urlRepository.save(url);
+
+ return new UrlResponse(BASE_URL + alias);
+ }
+
+ @Override
+ public String getFullUrl(String alias) {
+ log.info("Getting full url for alias ' {} ' from the DB", alias);
+ return urlRepository.findByAlias(alias)
+ .map(Url::getFullUrl)
+ .orElseThrow(() -> new NotFoundException("Alias not found"));
+ }
+
+ @Override
+ public List<UrlListResponse> getAll() {
+ return urlRepository.findAll().stream()
+ .map(url -> new UrlListResponse(
+ url.getAlias(),
+ url.getFullUrl(),
+ BASE_URL + url.getAlias()
+ ))
+ .toList();
+ }
+
+ public void delete(String alias) {
+
+ Url url = urlRepository.findByAlias(alias)
+ .orElseThrow(() -> new NotFoundException("Alias not found"));
+ log.info("Deleting shorten url for alias '{}' from the DB", url.getAlias());
+ urlRepository.delete(url);
+ }
+}

src/main/java/com/tpximpact/urlshortener/util/UrlUtils.java

@@ -0,0 +1,13 @@
+package com.tpximpact.urlshortener.util;
+
+import lombok.extern.slf4j.Slf4j;
+
+import java.util.UUID;
+
+@Slf4j
+public class UrlUtils {
+
+ public static String generateAlias() {
+ return UUID.randomUUID().toString().substring(0, 6);
+ }
+}

src/main/resources/application-dev.yaml

@@ -0,0 +1,16 @@
+spring:
+ datasource:
+ url: jdbc:h2:file:./data/mydb
+ driver-class-name: org.h2.Driver
+ username: sa
+ password:
+
+ h2:
+ console:
+ enabled: true
+ path: /h2-console
+
+ jpa:
+ show_sql: true
+ hibernate:
+ ddl-auto: update

pom.xml

@@ -2,8 +2,8 @@
  <modelVersion>4.0.0</modelVersion>
 
  <groupId>com.tpximpact</groupId>
- <artifactId>url_shortener_api</artifactId>
- <version>1.0</version>
+ <artifactId>url_shortener</artifactId>
+ <version>1.0.0</version>
 
  <parent>
  <groupId>org.springframework.boot</groupId>
@@ -16,17 +16,42 @@
  </properties>
 
  <dependencies>
- <!-- Core -->
+ <!-- Web -->
  <dependency>
  <groupId>org.springframework.boot</groupId>
- <artifactId>spring-boot-starter</artifactId>
+ <artifactId>spring-boot-starter-web</artifactId>
  </dependency>
 
- <!-- Web -->
+ <!-- Spring Data JPA -->
  <dependency>
  <groupId>org.springframework.boot</groupId>
- <artifactId>spring-boot-starter-web</artifactId>
+ <artifactId>spring-boot-starter-data-jpa</artifactId>
  </dependency>
- </dependencies>
 
+ <!-- Embedded H2 DB FileBased mode -->
+ <dependency>
+ <groupId>com.h2database</groupId>
+ <artifactId>h2</artifactId>
+ <scope>runtime</scope>
+ </dependency>
+
+ <!--validation-->
+ <dependency>
+ <groupId>org.springframework.boot</groupId>
+ <artifactId>spring-boot-starter-validation</artifactId>
+ </dependency>
+
+ <!-- Actuator (health checks, metrics)-->
+ <dependency>
+ <groupId>org.springframework.boot</groupId>
+ <artifactId>spring-boot-starter-actuator</artifactId>
+ </dependency>
+
+ <!-- Lombok (optional, reduces boilerplate) -->
+ <dependency>
+ <groupId>org.projectlombok</groupId>
+ <artifactId>lombok</artifactId>
+ <optional>true</optional>
+ </dependency>
+ </dependencies>
 </project>

src/main/java/com/tpximpact/urlshortener/UrlShortenerApplication.java

@@ -0,0 +1,13 @@
+package com.tpximpact.urlshortener;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+class UrlShortenerApplication {
+
+ public static void main(String[] args) {
+ SpringApplication.run(UrlShortenerApplication.class, args);
+ }
+
+}

src/main/java/com/tpximpact/urlshortener/controller/UrlController.java

@@ -0,0 +1,53 @@
+package com.tpximpact.urlshortener.controller;
+
+import com.tpximpact.urlshortener.dto.UrlListResponse;
+import com.tpximpact.urlshortener.dto.UrlRequest;
+import com.tpximpact.urlshortener.dto.UrlResponse;
+import com.tpximpact.urlshortener.service.UrlService;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RestController;
+import java.net.URI;
+import java.util.List;
+
+@RestController
+@RequiredArgsConstructor
+@Slf4j
+class UrlController {
+ private final UrlService urlService;
+
+ @PostMapping("/shorten")
+ public ResponseEntity<UrlResponse> shorten(@RequestBody @Valid UrlRequest request) {
+ UrlResponse response = urlService.shorten(request);
+ return ResponseEntity.status(201).body(response);
+ }
+
+ @GetMapping("/{alias}")
+ public ResponseEntity<Void> redirect(@PathVariable String alias) {
+ log.info("Contacting urlService to full url with: {}", alias);
+ String fullUrl = urlService.getFullUrl(alias);
+ log.info("Received Full url to redirect: {}", fullUrl);
+ return ResponseEntity.status(302)
+ .location(URI.create(fullUrl))
+ .build();
+ }
+
+ @GetMapping("/urls")
+ public ResponseEntity<List<UrlListResponse>> getAll() {
+ return ResponseEntity.ok(urlService.getAll());
+ }
+
+ @DeleteMapping("/{alias}")
+ public ResponseEntity<Void> delete(@PathVariable String alias) {
+ urlService.delete(alias);
+ return ResponseEntity.noContent().build();
+ }
+
+}

src/main/java/com/tpximpact/urlshortener/dto/UrlListResponse.java

@@ -0,0 +1,7 @@
+package com.tpximpact.urlshortener.dto;
+
+public record UrlListResponse(
+ String alias,
+ String fullUrl,
+ String shortUrl
+) {}

src/main/java/com/tpximpact/urlshortener/dto/UrlRequest.java

@@ -0,0 +1,8 @@
+package com.tpximpact.urlshortener.dto;
+
+import jakarta.validation.constraints.NotBlank;
+
+public record UrlRequest (
+ @NotBlank String fullUrl,
+ String customAlias
+) {}

src/main/java/com/tpximpact/urlshortener/dto/UrlResponse.java

@@ -0,0 +1,5 @@
+package com.tpximpact.urlshortener.dto;
+
+public record UrlResponse(
+ String shortUrl
+) {}

src/main/java/com/tpximpact/urlshortener/entity/Url.java

@@ -0,0 +1,35 @@
+package com.tpximpact.urlshortener.entity;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.Table;
+import jakarta.persistence.UniqueConstraint;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+
+@Entity
+@Table(name = "urls", uniqueConstraints = {
+ @UniqueConstraint(columnNames = "alias")
+})
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class Url {
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @Column(nullable = false)
+ private String fullUrl;
+
+ @Column(nullable = false, unique = true)
+ private String alias;
+}

src/main/java/com/tpximpact/urlshortener/exception/BadRequestException.java

@@ -0,0 +1,5 @@
+package com.tpximpact.urlshortener.exception;
+
+public class BadRequestException extends RuntimeException {
+ public BadRequestException(String message) { super(message); }
+}

src/main/java/com/tpximpact/urlshortener/exception/GlobalExceptionHandler.java

@@ -0,0 +1,19 @@
+package com.tpximpact.urlshortener.exception;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+
+@RestControllerAdvice
+public class GlobalExceptionHandler {
+
+ @ExceptionHandler(BadRequestException.class)
+ public ResponseEntity<String> handleBadRequest(BadRequestException ex) {
+ return ResponseEntity.badRequest().body(ex.getMessage());
+ }
+
+ @ExceptionHandler(NotFoundException.class)
+ public ResponseEntity<String> handleNotFound(NotFoundException ex) {
+ return ResponseEntity.status(404).body(ex.getMessage());
+ }
+}

src/main/java/com/tpximpact/urlshortener/exception/NotFoundException.java

@@ -0,0 +1,7 @@
+package com.tpximpact.urlshortener.exception;
+
+public class NotFoundException extends RuntimeException {
+ public NotFoundException(String message) {
+ super(message);
+ }
+}

src/main/java/com/tpximpact/urlshortener/repository/UrlRepository.java

@@ -0,0 +1,15 @@
+package com.tpximpact.urlshortener.repository;
+
+import com.tpximpact.urlshortener.entity.Url;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.Optional;
+
+@Repository
+public interface UrlRepository extends JpaRepository<Url, Long> {
+
+ boolean existsByAlias(String alias);
+
+ Optional<Url> findByAlias(String alias);
+}

src/main/java/com/tpximpact/urlshortener/service/UrlService.java

@@ -0,0 +1,18 @@
+package com.tpximpact.urlshortener.service;
+
+import com.tpximpact.urlshortener.dto.UrlListResponse;
+import com.tpximpact.urlshortener.dto.UrlRequest;
+import com.tpximpact.urlshortener.dto.UrlResponse;
+
+import java.util.List;
+
+public interface UrlService {
+
+ UrlResponse shorten(UrlRequest request);
+
+ String getFullUrl(String alias);
+
+ List<UrlListResponse> getAll();
+
+ void delete(String alias);
+}

src/main/java/com/tpximpact/urlshortener/service/UrlServiceImpl.java

@@ -0,0 +1,71 @@
+package com.tpximpact.urlshortener.service;
+
+import com.tpximpact.urlshortener.dto.UrlListResponse;
+import com.tpximpact.urlshortener.dto.UrlRequest;
+import com.tpximpact.urlshortener.dto.UrlResponse;
+import com.tpximpact.urlshortener.entity.Url;
+import com.tpximpact.urlshortener.exception.BadRequestException;
+import com.tpximpact.urlshortener.exception.NotFoundException;
+import com.tpximpact.urlshortener.repository.UrlRepository;
+import com.tpximpact.urlshortener.util.UrlUtils;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import java.util.List;
+
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class UrlServiceImpl implements UrlService {
+ private static final String BASE_URL = "http://localhost:8080/";
+ private final UrlRepository urlRepository;
+
+ @Override
+ public UrlResponse shorten(UrlRequest request) {
+
+ String alias = request.customAlias() != null
+ ? request.customAlias() : UrlUtils.generateAlias();
+
+ if (urlRepository.existsByAlias(alias)) {
+ throw new BadRequestException("Invalid input or alias already taken");
+ }
+
+ Url url = Url
+ .builder()
+ .fullUrl(request.fullUrl())
+ .alias(alias)
+ .build();
+
+ urlRepository.save(url);
+
+ return new UrlResponse(BASE_URL + alias);
+ }
+
+ @Override
+ public String getFullUrl(String alias) {
+ log.info("Getting full url for alias ' {} ' from the DB", alias);
+ return urlRepository.findByAlias(alias)
+ .map(Url::getFullUrl)
+ .orElseThrow(() -> new NotFoundException("Alias not found"));
+ }
+
+ @Override
+ public List<UrlListResponse> getAll() {
+ return urlRepository.findAll().stream()
+ .map(url -> new UrlListResponse(
+ url.getAlias(),
+ url.getFullUrl(),
+ BASE_URL + url.getAlias()
+ ))
+ .toList();
+ }
+
+ public void delete(String alias) {
+
+ Url url = urlRepository.findByAlias(alias)
+ .orElseThrow(() -> new NotFoundException("Alias not found"));
+ log.info("Deleting shorten url for alias '{}' from the DB", url.getAlias());
+ urlRepository.delete(url);
+ }
+}

src/main/java/com/tpximpact/urlshortener/util/UrlUtils.java

@@ -0,0 +1,13 @@
+package com.tpximpact.urlshortener.util;
+
+import lombok.extern.slf4j.Slf4j;
+
+import java.util.UUID;
+
+@Slf4j
+public class UrlUtils {
+
+ public static String generateAlias() {
+ return UUID.randomUUID().toString().substring(0, 6);
+ }
+}

src/main/resources/application-dev.yaml

@@ -0,0 +1,16 @@
+spring:
+ datasource:
+ url: jdbc:h2:file:./data/mydb
+ driver-class-name: org.h2.Driver
+ username: sa
+ password:
+
+ h2:
+ console:
+ enabled: true
+ path: /h2-console
+
+ jpa:
+ show_sql: true
+ hibernate:
+ ddl-auto: update

pom.xml

@@ -2,8 +2,8 @@
  <modelVersion>4.0.0</modelVersion>
 
  <groupId>com.tpximpact</groupId>
- <artifactId>url_shortener_api</artifactId>
- <version>1.0</version>
+ <artifactId>url_shortener</artifactId>
+ <version>1.0.0</version>
 
  <parent>
  <groupId>org.springframework.boot</groupId>
@@ -16,17 +16,42 @@
  </properties>
 
  <dependencies>
- <!-- Core -->
+ <!-- Web -->
  <dependency>
  <groupId>org.springframework.boot</groupId>
- <artifactId>spring-boot-starter</artifactId>
+ <artifactId>spring-boot-starter-web</artifactId>
  </dependency>
 
- <!-- Web -->
+ <!-- Spring Data JPA -->
  <dependency>
  <groupId>org.springframework.boot</groupId>
- <artifactId>spring-boot-starter-web</artifactId>
+ <artifactId>spring-boot-starter-data-jpa</artifactId>
  </dependency>
- </dependencies>
 
+ <!-- Embedded H2 DB FileBased mode -->
+ <dependency>
+ <groupId>com.h2database</groupId>
+ <artifactId>h2</artifactId>
+ <scope>runtime</scope>
+ </dependency>
+
+ <!--validation-->
+ <dependency>
+ <groupId>org.springframework.boot</groupId>
+ <artifactId>spring-boot-starter-validation</artifactId>
+ </dependency>
+
+ <!-- Actuator (health checks, metrics)-->
+ <dependency>
+ <groupId>org.springframework.boot</groupId>
+ <artifactId>spring-boot-starter-actuator</artifactId>
+ </dependency>
+
+ <!-- Lombok (optional, reduces boilerplate) -->
+ <dependency>
+ <groupId>org.projectlombok</groupId>
+ <artifactId>lombok</artifactId>
+ <optional>true</optional>
+ </dependency>
+ </dependencies>
 </project>

src/main/java/com/tpximpact/urlshortener/UrlShortenerApplication.java

@@ -0,0 +1,13 @@
+package com.tpximpact.urlshortener;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+class UrlShortenerApplication {
+
+ public static void main(String[] args) {
+ SpringApplication.run(UrlShortenerApplication.class, args);
+ }
+
+}

src/main/java/com/tpximpact/urlshortener/controller/UrlController.java

@@ -0,0 +1,53 @@
+package com.tpximpact.urlshortener.controller;
+
+import com.tpximpact.urlshortener.dto.UrlListResponse;
+import com.tpximpact.urlshortener.dto.UrlRequest;
+import com.tpximpact.urlshortener.dto.UrlResponse;
+import com.tpximpact.urlshortener.service.UrlService;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RestController;
+import java.net.URI;
+import java.util.List;
+
+@RestController
+@RequiredArgsConstructor
+@Slf4j
+class UrlController {
+ private final UrlService urlService;
+
+ @PostMapping("/shorten")
+ public ResponseEntity<UrlResponse> shorten(@RequestBody @Valid UrlRequest request) {
+ UrlResponse response = urlService.shorten(request);
+ return ResponseEntity.status(201).body(response);
+ }
+
+ @GetMapping("/{alias}")
+ public ResponseEntity<Void> redirect(@PathVariable String alias) {
+ log.info("Contacting urlService to full url with: {}", alias);
+ String fullUrl = urlService.getFullUrl(alias);
+ log.info("Received Full url to redirect: {}", fullUrl);
+ return ResponseEntity.status(302)
+ .location(URI.create(fullUrl))
+ .build();
+ }
+
+ @GetMapping("/urls")
+ public ResponseEntity<List<UrlListResponse>> getAll() {
+ return ResponseEntity.ok(urlService.getAll());
+ }
+
+ @DeleteMapping("/{alias}")
+ public ResponseEntity<Void> delete(@PathVariable String alias) {
+ urlService.delete(alias);
+ return ResponseEntity.noContent().build();
+ }
+
+}

src/main/java/com/tpximpact/urlshortener/dto/UrlListResponse.java

@@ -0,0 +1,7 @@
+package com.tpximpact.urlshortener.dto;
+
+public record UrlListResponse(
+ String alias,
+ String fullUrl,
+ String shortUrl
+) {}

src/main/java/com/tpximpact/urlshortener/dto/UrlRequest.java

@@ -0,0 +1,8 @@
+package com.tpximpact.urlshortener.dto;
+
+import jakarta.validation.constraints.NotBlank;
+
+public record UrlRequest (
+ @NotBlank String fullUrl,
+ String customAlias
+) {}

src/main/java/com/tpximpact/urlshortener/dto/UrlResponse.java

@@ -0,0 +1,5 @@
+package com.tpximpact.urlshortener.dto;
+
+public record UrlResponse(
+ String shortUrl
+) {}

src/main/java/com/tpximpact/urlshortener/entity/Url.java

@@ -0,0 +1,35 @@
+package com.tpximpact.urlshortener.entity;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.Table;
+import jakarta.persistence.UniqueConstraint;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+
+@Entity
+@Table(name = "urls", uniqueConstraints = {
+ @UniqueConstraint(columnNames = "alias")
+})
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class Url {
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @Column(nullable = false)
+ private String fullUrl;
+
+ @Column(nullable = false, unique = true)
+ private String alias;
+}

src/main/java/com/tpximpact/urlshortener/exception/BadRequestException.java

@@ -0,0 +1,5 @@
+package com.tpximpact.urlshortener.exception;
+
+public class BadRequestException extends RuntimeException {
+ public BadRequestException(String message) { super(message); }
+}

src/main/java/com/tpximpact/urlshortener/exception/GlobalExceptionHandler.java

@@ -0,0 +1,19 @@
+package com.tpximpact.urlshortener.exception;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+
+@RestControllerAdvice
+public class GlobalExceptionHandler {
+
+ @ExceptionHandler(BadRequestException.class)
+ public ResponseEntity<String> handleBadRequest(BadRequestException ex) {
+ return ResponseEntity.badRequest().body(ex.getMessage());
+ }
+
+ @ExceptionHandler(NotFoundException.class)
+ public ResponseEntity<String> handleNotFound(NotFoundException ex) {
+ return ResponseEntity.status(404).body(ex.getMessage());
+ }
+}

src/main/java/com/tpximpact/urlshortener/exception/NotFoundException.java

@@ -0,0 +1,7 @@
+package com.tpximpact.urlshortener.exception;
+
+public class NotFoundException extends RuntimeException {
+ public NotFoundException(String message) {
+ super(message);
+ }
+}

src/main/java/com/tpximpact/urlshortener/repository/UrlRepository.java

@@ -0,0 +1,15 @@
+package com.tpximpact.urlshortener.repository;
+
+import com.tpximpact.urlshortener.entity.Url;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.Optional;
+
+@Repository
+public interface UrlRepository extends JpaRepository<Url, Long> {
+
+ boolean existsByAlias(String alias);
+
+ Optional<Url> findByAlias(String alias);
+}

src/main/java/com/tpximpact/urlshortener/service/UrlService.java

@@ -0,0 +1,18 @@
+package com.tpximpact.urlshortener.service;
+
+import com.tpximpact.urlshortener.dto.UrlListResponse;
+import com.tpximpact.urlshortener.dto.UrlRequest;
+import com.tpximpact.urlshortener.dto.UrlResponse;
+
+import java.util.List;
+
+public interface UrlService {
+
+ UrlResponse shorten(UrlRequest request);
+
+ String getFullUrl(String alias);
+
+ List<UrlListResponse> getAll();
+
+ void delete(String alias);
+}

src/main/java/com/tpximpact/urlshortener/service/UrlServiceImpl.java

@@ -0,0 +1,71 @@
+package com.tpximpact.urlshortener.service;
+
+import com.tpximpact.urlshortener.dto.UrlListResponse;
+import com.tpximpact.urlshortener.dto.UrlRequest;
+import com.tpximpact.urlshortener.dto.UrlResponse;
+import com.tpximpact.urlshortener.entity.Url;
+import com.tpximpact.urlshortener.exception.BadRequestException;
+import com.tpximpact.urlshortener.exception.NotFoundException;
+import com.tpximpact.urlshortener.repository.UrlRepository;
+import com.tpximpact.urlshortener.util.UrlUtils;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import java.util.List;
+
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class UrlServiceImpl implements UrlService {
+ private static final String BASE_URL = "http://localhost:8080/";
+ private final UrlRepository urlRepository;
+
+ @Override
+ public UrlResponse shorten(UrlRequest request) {
+
+ String alias = request.customAlias() != null
+ ? request.customAlias() : UrlUtils.generateAlias();
+
+ if (urlRepository.existsByAlias(alias)) {
+ throw new BadRequestException("Invalid input or alias already taken");
+ }
+
+ Url url = Url
+ .builder()
+ .fullUrl(request.fullUrl())
+ .alias(alias)
+ .build();
+
+ urlRepository.save(url);
+
+ return new UrlResponse(BASE_URL + alias);
+ }
+
+ @Override
+ public String getFullUrl(String alias) {
+ log.info("Getting full url for alias ' {} ' from the DB", alias);
+ return urlRepository.findByAlias(alias)
+ .map(Url::getFullUrl)
+ .orElseThrow(() -> new NotFoundException("Alias not found"));
+ }
+
+ @Override
+ public List<UrlListResponse> getAll() {
+ return urlRepository.findAll().stream()
+ .map(url -> new UrlListResponse(
+ url.getAlias(),
+ url.getFullUrl(),
+ BASE_URL + url.getAlias()
+ ))
+ .toList();
+ }
+
+ public void delete(String alias) {
+
+ Url url = urlRepository.findByAlias(alias)
+ .orElseThrow(() -> new NotFoundException("Alias not found"));
+ log.info("Deleting shorten url for alias '{}' from the DB", url.getAlias());
+ urlRepository.delete(url);
+ }
+}

src/main/java/com/tpximpact/urlshortener/util/UrlUtils.java

@@ -0,0 +1,13 @@
+package com.tpximpact.urlshortener.util;
+
+import lombok.extern.slf4j.Slf4j;
+
+import java.util.UUID;
+
+@Slf4j
+public class UrlUtils {
+
+ public static String generateAlias() {
+ return UUID.randomUUID().toString().substring(0, 6);
+ }
+}

src/main/resources/application-dev.yaml

@@ -0,0 +1,16 @@
+spring:
+ datasource:
+ url: jdbc:h2:file:./data/mydb
+ driver-class-name: org.h2.Driver
+ username: sa
+ password:
+
+ h2:
+ console:
+ enabled: true
+ path: /h2-console
+
+ jpa:
+ show_sql: true
+ hibernate:
+ ddl-auto: update

pom.xml

@@ -2,8 +2,8 @@
  <modelVersion>4.0.0</modelVersion>
 
  <groupId>com.tpximpact</groupId>
- <artifactId>url_shortener_api</artifactId>
- <version>1.0</version>
+ <artifactId>url_shortener</artifactId>
+ <version>1.0.0</version>
 
  <parent>
  <groupId>org.springframework.boot</groupId>
@@ -16,17 +16,42 @@
  </properties>
 
  <dependencies>
- <!-- Core -->
+ <!-- Web -->
  <dependency>
  <groupId>org.springframework.boot</groupId>
- <artifactId>spring-boot-starter</artifactId>
+ <artifactId>spring-boot-starter-web</artifactId>
  </dependency>
 
- <!-- Web -->
+ <!-- Spring Data JPA -->
  <dependency>
  <groupId>org.springframework.boot</groupId>
- <artifactId>spring-boot-starter-web</artifactId>
+ <artifactId>spring-boot-starter-data-jpa</artifactId>
  </dependency>
- </dependencies>
 
+ <!-- Embedded H2 DB FileBased mode -->
+ <dependency>
+ <groupId>com.h2database</groupId>
+ <artifactId>h2</artifactId>
+ <scope>runtime</scope>
+ </dependency>
+
+ <!--validation-->
+ <dependency>
+ <groupId>org.springframework.boot</groupId>
+ <artifactId>spring-boot-starter-validation</artifactId>
+ </dependency>
+
+ <!-- Actuator (health checks, metrics)-->
+ <dependency>
+ <groupId>org.springframework.boot</groupId>
+ <artifactId>spring-boot-starter-actuator</artifactId>
+ </dependency>
+
+ <!-- Lombok (optional, reduces boilerplate) -->
+ <dependency>
+ <groupId>org.projectlombok</groupId>
+ <artifactId>lombok</artifactId>
+ <optional>true</optional>
+ </dependency>
+ </dependencies>
 </project>

src/main/java/com/tpximpact/urlshortener/UrlShortenerApplication.java

@@ -0,0 +1,13 @@
+package com.tpximpact.urlshortener;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+class UrlShortenerApplication {
+
+ public static void main(String[] args) {
+ SpringApplication.run(UrlShortenerApplication.class, args);
+ }
+
+}

src/main/java/com/tpximpact/urlshortener/controller/UrlController.java

@@ -0,0 +1,53 @@
+package com.tpximpact.urlshortener.controller;
+
+import com.tpximpact.urlshortener.dto.UrlListResponse;
+import com.tpximpact.urlshortener.dto.UrlRequest;
+import com.tpximpact.urlshortener.dto.UrlResponse;
+import com.tpximpact.urlshortener.service.UrlService;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RestController;
+import java.net.URI;
+import java.util.List;
+
+@RestController
+@RequiredArgsConstructor
+@Slf4j
+class UrlController {
+ private final UrlService urlService;
+
+ @PostMapping("/shorten")
+ public ResponseEntity<UrlResponse> shorten(@RequestBody @Valid UrlRequest request) {
+ UrlResponse response = urlService.shorten(request);
+ return ResponseEntity.status(201).body(response);
+ }
+
+ @GetMapping("/{alias}")
+ public ResponseEntity<Void> redirect(@PathVariable String alias) {
+ log.info("Contacting urlService to full url with: {}", alias);
+ String fullUrl = urlService.getFullUrl(alias);
+ log.info("Received Full url to redirect: {}", fullUrl);
+ return ResponseEntity.status(302)
+ .location(URI.create(fullUrl))
+ .build();
+ }
+
+ @GetMapping("/urls")
+ public ResponseEntity<List<UrlListResponse>> getAll() {
+ return ResponseEntity.ok(urlService.getAll());
+ }
+
+ @DeleteMapping("/{alias}")
+ public ResponseEntity<Void> delete(@PathVariable String alias) {
+ urlService.delete(alias);
+ return ResponseEntity.noContent().build();
+ }
+
+}

src/main/java/com/tpximpact/urlshortener/dto/UrlListResponse.java

@@ -0,0 +1,7 @@
+package com.tpximpact.urlshortener.dto;
+
+public record UrlListResponse(
+ String alias,
+ String fullUrl,
+ String shortUrl
+) {}

src/main/java/com/tpximpact/urlshortener/dto/UrlRequest.java

@@ -0,0 +1,8 @@
+package com.tpximpact.urlshortener.dto;
+
+import jakarta.validation.constraints.NotBlank;
+
+public record UrlRequest (
+ @NotBlank String fullUrl,
+ String customAlias
+) {}

src/main/java/com/tpximpact/urlshortener/dto/UrlResponse.java

@@ -0,0 +1,5 @@
+package com.tpximpact.urlshortener.dto;
+
+public record UrlResponse(
+ String shortUrl
+) {}

src/main/java/com/tpximpact/urlshortener/entity/Url.java

@@ -0,0 +1,35 @@
+package com.tpximpact.urlshortener.entity;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.Table;
+import jakarta.persistence.UniqueConstraint;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+
+@Entity
+@Table(name = "urls", uniqueConstraints = {
+ @UniqueConstraint(columnNames = "alias")
+})
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class Url {
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @Column(nullable = false)
+ private String fullUrl;
+
+ @Column(nullable = false, unique = true)
+ private String alias;
+}

src/main/java/com/tpximpact/urlshortener/exception/BadRequestException.java

@@ -0,0 +1,5 @@
+package com.tpximpact.urlshortener.exception;
+
+public class BadRequestException extends RuntimeException {
+ public BadRequestException(String message) { super(message); }
+}

src/main/java/com/tpximpact/urlshortener/exception/GlobalExceptionHandler.java

@@ -0,0 +1,19 @@
+package com.tpximpact.urlshortener.exception;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+
+@RestControllerAdvice
+public class GlobalExceptionHandler {
+
+ @ExceptionHandler(BadRequestException.class)
+ public ResponseEntity<String> handleBadRequest(BadRequestException ex) {
+ return ResponseEntity.badRequest().body(ex.getMessage());
+ }
+
+ @ExceptionHandler(NotFoundException.class)
+ public ResponseEntity<String> handleNotFound(NotFoundException ex) {
+ return ResponseEntity.status(404).body(ex.getMessage());
+ }
+}

src/main/java/com/tpximpact/urlshortener/exception/NotFoundException.java

@@ -0,0 +1,7 @@
+package com.tpximpact.urlshortener.exception;
+
+public class NotFoundException extends RuntimeException {
+ public NotFoundException(String message) {
+ super(message);
+ }
+}

src/main/java/com/tpximpact/urlshortener/repository/UrlRepository.java

@@ -0,0 +1,15 @@
+package com.tpximpact.urlshortener.repository;
+
+import com.tpximpact.urlshortener.entity.Url;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.Optional;
+
+@Repository
+public interface UrlRepository extends JpaRepository<Url, Long> {
+
+ boolean existsByAlias(String alias);
+
+ Optional<Url> findByAlias(String alias);
+}

src/main/java/com/tpximpact/urlshortener/service/UrlService.java

@@ -0,0 +1,18 @@
+package com.tpximpact.urlshortener.service;
+
+import com.tpximpact.urlshortener.dto.UrlListResponse;
+import com.tpximpact.urlshortener.dto.UrlRequest;
+import com.tpximpact.urlshortener.dto.UrlResponse;
+
+import java.util.List;
+
+public interface UrlService {
+
+ UrlResponse shorten(UrlRequest request);
+
+ String getFullUrl(String alias);
+
+ List<UrlListResponse> getAll();
+
+ void delete(String alias);
+}

src/main/java/com/tpximpact/urlshortener/service/UrlServiceImpl.java

@@ -0,0 +1,71 @@
+package com.tpximpact.urlshortener.service;
+
+import com.tpximpact.urlshortener.dto.UrlListResponse;
+import com.tpximpact.urlshortener.dto.UrlRequest;
+import com.tpximpact.urlshortener.dto.UrlResponse;
+import com.tpximpact.urlshortener.entity.Url;
+import com.tpximpact.urlshortener.exception.BadRequestException;
+import com.tpximpact.urlshortener.exception.NotFoundException;
+import com.tpximpact.urlshortener.repository.UrlRepository;
+import com.tpximpact.urlshortener.util.UrlUtils;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import java.util.List;
+
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class UrlServiceImpl implements UrlService {
+ private static final String BASE_URL = "http://localhost:8080/";
+ private final UrlRepository urlRepository;
+
+ @Override
+ public UrlResponse shorten(UrlRequest request) {
+
+ String alias = request.customAlias() != null
+ ? request.customAlias() : UrlUtils.generateAlias();
+
+ if (urlRepository.existsByAlias(alias)) {
+ throw new BadRequestException("Invalid input or alias already taken");
+ }
+
+ Url url = Url
+ .builder()
+ .fullUrl(request.fullUrl())
+ .alias(alias)
+ .build();
+
+ urlRepository.save(url);
+
+ return new UrlResponse(BASE_URL + alias);
+ }
+
+ @Override
+ public String getFullUrl(String alias) {
+ log.info("Getting full url for alias ' {} ' from the DB", alias);
+ return urlRepository.findByAlias(alias)
+ .map(Url::getFullUrl)
+ .orElseThrow(() -> new NotFoundException("Alias not found"));
+ }
+
+ @Override
+ public List<UrlListResponse> getAll() {
+ return urlRepository.findAll().stream()
+ .map(url -> new UrlListResponse(
+ url.getAlias(),
+ url.getFullUrl(),
+ BASE_URL + url.getAlias()
+ ))
+ .toList();
+ }
+
+ public void delete(String alias) {
+
+ Url url = urlRepository.findByAlias(alias)
+ .orElseThrow(() -> new NotFoundException("Alias not found"));
+ log.info("Deleting shorten url for alias '{}' from the DB", url.getAlias());
+ urlRepository.delete(url);
+ }
+}

src/main/java/com/tpximpact/urlshortener/util/UrlUtils.java

@@ -0,0 +1,13 @@
+package com.tpximpact.urlshortener.util;
+
+import lombok.extern.slf4j.Slf4j;
+
+import java.util.UUID;
+
+@Slf4j
+public class UrlUtils {
+
+ public static String generateAlias() {
+ return UUID.randomUUID().toString().substring(0, 6);
+ }
+}

src/main/resources/application-dev.yaml

@@ -0,0 +1,16 @@
+spring:
+ datasource:
+ url: jdbc:h2:file:./data/mydb
+ driver-class-name: org.h2.Driver
+ username: sa
+ password:
+
+ h2:
+ console:
+ enabled: true
+ path: /h2-console
+
+ jpa:
+ show_sql: true
+ hibernate:
+ ddl-auto: update

pom.xml

@@ -2,8 +2,8 @@
  <modelVersion>4.0.0</modelVersion>
 
  <groupId>com.tpximpact</groupId>
- <artifactId>url_shortener_api</artifactId>
- <version>1.0</version>
+ <artifactId>url_shortener</artifactId>
+ <version>1.0.0</version>
 
  <parent>
  <groupId>org.springframework.boot</groupId>
@@ -16,17 +16,42 @@
  </properties>
 
  <dependencies>
- <!-- Core -->
+ <!-- Web -->
  <dependency>
  <groupId>org.springframework.boot</groupId>
- <artifactId>spring-boot-starter</artifactId>
+ <artifactId>spring-boot-starter-web</artifactId>
  </dependency>
 
- <!-- Web -->
+ <!-- Spring Data JPA -->
  <dependency>
  <groupId>org.springframework.boot</groupId>
- <artifactId>spring-boot-starter-web</artifactId>
+ <artifactId>spring-boot-starter-data-jpa</artifactId>
  </dependency>
- </dependencies>
 
+ <!-- Embedded H2 DB FileBased mode -->
+ <dependency>
+ <groupId>com.h2database</groupId>
+ <artifactId>h2</artifactId>
+ <scope>runtime</scope>
+ </dependency>
+
+ <!--validation-->
+ <dependency>
+ <groupId>org.springframework.boot</groupId>
+ <artifactId>spring-boot-starter-validation</artifactId>
+ </dependency>
+
+ <!-- Actuator (health checks, metrics)-->
+ <dependency>
+ <groupId>org.springframework.boot</groupId>
+ <artifactId>spring-boot-starter-actuator</artifactId>
+ </dependency>
+
+ <!-- Lombok (optional, reduces boilerplate) -->
+ <dependency>
+ <groupId>org.projectlombok</groupId>
+ <artifactId>lombok</artifactId>
+ <optional>true</optional>
+ </dependency>
+ </dependencies>
 </project>

src/main/java/com/tpximpact/urlshortener/UrlShortenerApplication.java

@@ -0,0 +1,13 @@
+package com.tpximpact.urlshortener;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+class UrlShortenerApplication {
+
+ public static void main(String[] args) {
+ SpringApplication.run(UrlShortenerApplication.class, args);
+ }
+
+}

src/main/java/com/tpximpact/urlshortener/controller/UrlController.java

@@ -0,0 +1,53 @@
+package com.tpximpact.urlshortener.controller;
+
+import com.tpximpact.urlshortener.dto.UrlListResponse;
+import com.tpximpact.urlshortener.dto.UrlRequest;
+import com.tpximpact.urlshortener.dto.UrlResponse;
+import com.tpximpact.urlshortener.service.UrlService;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RestController;
+import java.net.URI;
+import java.util.List;
+
+@RestController
+@RequiredArgsConstructor
+@Slf4j
+class UrlController {
+ private final UrlService urlService;
+
+ @PostMapping("/shorten")
+ public ResponseEntity<UrlResponse> shorten(@RequestBody @Valid UrlRequest request) {
+ UrlResponse response = urlService.shorten(request);
+ return ResponseEntity.status(201).body(response);
+ }
+
+ @GetMapping("/{alias}")
+ public ResponseEntity<Void> redirect(@PathVariable String alias) {
+ log.info("Contacting urlService to full url with: {}", alias);
+ String fullUrl = urlService.getFullUrl(alias);
+ log.info("Received Full url to redirect: {}", fullUrl);
+ return ResponseEntity.status(302)
+ .location(URI.create(fullUrl))
+ .build();
+ }
+
+ @GetMapping("/urls")
+ public ResponseEntity<List<UrlListResponse>> getAll() {
+ return ResponseEntity.ok(urlService.getAll());
+ }
+
+ @DeleteMapping("/{alias}")
+ public ResponseEntity<Void> delete(@PathVariable String alias) {
+ urlService.delete(alias);
+ return ResponseEntity.noContent().build();
+ }
+
+}

src/main/java/com/tpximpact/urlshortener/dto/UrlListResponse.java

@@ -0,0 +1,7 @@
+package com.tpximpact.urlshortener.dto;
+
+public record UrlListResponse(
+ String alias,
+ String fullUrl,
+ String shortUrl
+) {}

src/main/java/com/tpximpact/urlshortener/dto/UrlRequest.java

@@ -0,0 +1,8 @@
+package com.tpximpact.urlshortener.dto;
+
+import jakarta.validation.constraints.NotBlank;
+
+public record UrlRequest (
+ @NotBlank String fullUrl,
+ String customAlias
+) {}

src/main/java/com/tpximpact/urlshortener/dto/UrlResponse.java

@@ -0,0 +1,5 @@
+package com.tpximpact.urlshortener.dto;
+
+public record UrlResponse(
+ String shortUrl
+) {}

src/main/java/com/tpximpact/urlshortener/entity/Url.java

@@ -0,0 +1,35 @@
+package com.tpximpact.urlshortener.entity;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.Table;
+import jakarta.persistence.UniqueConstraint;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+
+@Entity
+@Table(name = "urls", uniqueConstraints = {
+ @UniqueConstraint(columnNames = "alias")
+})
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class Url {
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @Column(nullable = false)
+ private String fullUrl;
+
+ @Column(nullable = false, unique = true)
+ private String alias;
+}

src/main/java/com/tpximpact/urlshortener/exception/BadRequestException.java

@@ -0,0 +1,5 @@
+package com.tpximpact.urlshortener.exception;
+
+public class BadRequestException extends RuntimeException {
+ public BadRequestException(String message) { super(message); }
+}

src/main/java/com/tpximpact/urlshortener/exception/GlobalExceptionHandler.java

@@ -0,0 +1,19 @@
+package com.tpximpact.urlshortener.exception;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+
+@RestControllerAdvice
+public class GlobalExceptionHandler {
+
+ @ExceptionHandler(BadRequestException.class)
+ public ResponseEntity<String> handleBadRequest(BadRequestException ex) {
+ return ResponseEntity.badRequest().body(ex.getMessage());
+ }
+
+ @ExceptionHandler(NotFoundException.class)
+ public ResponseEntity<String> handleNotFound(NotFoundException ex) {
+ return ResponseEntity.status(404).body(ex.getMessage());
+ }
+}

src/main/java/com/tpximpact/urlshortener/exception/NotFoundException.java

@@ -0,0 +1,7 @@
+package com.tpximpact.urlshortener.exception;
+
+public class NotFoundException extends RuntimeException {
+ public NotFoundException(String message) {
+ super(message);
+ }
+}

src/main/java/com/tpximpact/urlshortener/repository/UrlRepository.java

@@ -0,0 +1,15 @@
+package com.tpximpact.urlshortener.repository;
+
+import com.tpximpact.urlshortener.entity.Url;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.Optional;
+
+@Repository
+public interface UrlRepository extends JpaRepository<Url, Long> {
+
+ boolean existsByAlias(String alias);
+
+ Optional<Url> findByAlias(String alias);
+}

src/main/java/com/tpximpact/urlshortener/service/UrlService.java

@@ -0,0 +1,18 @@
+package com.tpximpact.urlshortener.service;
+
+import com.tpximpact.urlshortener.dto.UrlListResponse;
+import com.tpximpact.urlshortener.dto.UrlRequest;
+import com.tpximpact.urlshortener.dto.UrlResponse;
+
+import java.util.List;
+
+public interface UrlService {
+
+ UrlResponse shorten(UrlRequest request);
+
+ String getFullUrl(String alias);
+
+ List<UrlListResponse> getAll();
+
+ void delete(String alias);
+}

src/main/java/com/tpximpact/urlshortener/service/UrlServiceImpl.java

@@ -0,0 +1,71 @@
+package com.tpximpact.urlshortener.service;
+
+import com.tpximpact.urlshortener.dto.UrlListResponse;
+import com.tpximpact.urlshortener.dto.UrlRequest;
+import com.tpximpact.urlshortener.dto.UrlResponse;
+import com.tpximpact.urlshortener.entity.Url;
+import com.tpximpact.urlshortener.exception.BadRequestException;
+import com.tpximpact.urlshortener.exception.NotFoundException;
+import com.tpximpact.urlshortener.repository.UrlRepository;
+import com.tpximpact.urlshortener.util.UrlUtils;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import java.util.List;
+
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class UrlServiceImpl implements UrlService {
+ private static final String BASE_URL = "http://localhost:8080/";
+ private final UrlRepository urlRepository;
+
+ @Override
+ public UrlResponse shorten(UrlRequest request) {
+
+ String alias = request.customAlias() != null
+ ? request.customAlias() : UrlUtils.generateAlias();
+
+ if (urlRepository.existsByAlias(alias)) {
+ throw new BadRequestException("Invalid input or alias already taken");
+ }
+
+ Url url = Url
+ .builder()
+ .fullUrl(request.fullUrl())
+ .alias(alias)
+ .build();
+
+ urlRepository.save(url);
+
+ return new UrlResponse(BASE_URL + alias);
+ }
+
+ @Override
+ public String getFullUrl(String alias) {
+ log.info("Getting full url for alias ' {} ' from the DB", alias);
+ return urlRepository.findByAlias(alias)
+ .map(Url::getFullUrl)
+ .orElseThrow(() -> new NotFoundException("Alias not found"));
+ }
+
+ @Override
+ public List<UrlListResponse> getAll() {
+ return urlRepository.findAll().stream()
+ .map(url -> new UrlListResponse(
+ url.getAlias(),
+ url.getFullUrl(),
+ BASE_URL + url.getAlias()
+ ))
+ .toList();
+ }
+
+ public void delete(String alias) {
+
+ Url url = urlRepository.findByAlias(alias)
+ .orElseThrow(() -> new NotFoundException("Alias not found"));
+ log.info("Deleting shorten url for alias '{}' from the DB", url.getAlias());
+ urlRepository.delete(url);
+ }
+}

src/main/java/com/tpximpact/urlshortener/util/UrlUtils.java

@@ -0,0 +1,13 @@
+package com.tpximpact.urlshortener.util;
+
+import lombok.extern.slf4j.Slf4j;
+
+import java.util.UUID;
+
+@Slf4j
+public class UrlUtils {
+
+ public static String generateAlias() {
+ return UUID.randomUUID().toString().substring(0, 6);
+ }
+}

src/main/resources/application-dev.yaml

@@ -0,0 +1,16 @@
+spring:
+ datasource:
+ url: jdbc:h2:file:./data/mydb
+ driver-class-name: org.h2.Driver
+ username: sa
+ password:
+
+ h2:
+ console:
+ enabled: true
+ path: /h2-console
+
+ jpa:
+ show_sql: true
+ hibernate:
+ ddl-auto: update