feat: add Validators & FileZipManager

Author: Abega1642

build.gradle

@@ -56,6 +56,7 @@ dependencies {
 
     implementation 'org.apache.commons:commons-lang3:3.20.0'
     implementation 'commons-io:commons-io:2.21.0'
+    implementation 'org.apache.commons:commons-compress:1.28.0'
 
     testImplementation 'org.springframework.boot:spring-boot-starter-test'
     testImplementation 'org.springframework.boot:spring-boot-testcontainers'

src/main/java/com/example/arInfra/config/MultipartConfigurer.java

@@ -0,0 +1,65 @@
+package com.example.arInfra.config;
+
+import jakarta.servlet.MultipartConfigElement;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.boot.web.servlet.MultipartConfigFactory;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.util.unit.DataSize;
+import org.springframework.web.multipart.MultipartResolver;
+import org.springframework.web.multipart.support.StandardServletMultipartResolver;
+
+/**
+ * Secure multipart file upload configuration.
+ *
+ * <p>Security measures implemented:
+ *
+ * <ul>
+ *   <li>Configurable maximum file sizes to prevent DoS attacks
+ *   <li>Request size limits to prevent memory exhaustion
+ *   <li>File size threshold for in-memory vs disk storage
+ *   <li>Temporary file location for secure file handling
+ * </ul>
+ */
+@Configuration
+public class MultipartConfigurer {
+
+  @Value("${spring.servlet.multipart.max-file-size:10MB}")
+  private String maxFileSize;
+
+  @Value("${spring.servlet.multipart.max-request-size:10MB}")
+  private String maxRequestSize;
+
+  @Value("${spring.servlet.multipart.file-size-threshold:2MB}")
+  private String fileSizeThreshold;
+
+  @Value("${spring.servlet.multipart.location:${java.io.tmpdir}}")
+  private String location;
+
+  /**
+   * Configures multipart file upload limits with security controls.
+   *
+   * @return configured MultipartConfigElement
+   */
+  @Bean
+  public MultipartConfigElement multipartConfigElement() {
+    MultipartConfigFactory factory = new MultipartConfigFactory();
+
+    factory.setMaxFileSize(DataSize.parse(maxFileSize));
+    factory.setMaxRequestSize(DataSize.parse(maxRequestSize));
+    factory.setFileSizeThreshold(DataSize.parse(fileSizeThreshold));
+    factory.setLocation(location);
+
+    return factory.createMultipartConfig();
+  }
+
+  /**
+   * Standard servlet multipart resolver.
+   *
+   * @return configured MultipartResolver
+   */
+  @Bean
+  public MultipartResolver multipartResolver() {
+    return new StandardServletMultipartResolver();
+  }
+}

src/main/java/com/example/arInfra/endpoint/rest/controller/MultipartExceptionHandler.java

@@ -0,0 +1,75 @@
+package com.example.arInfra.endpoint.rest.controller;
+
+import static java.lang.String.format;
+import static org.owasp.encoder.Encode.forJava;
+
+import com.example.arInfra.InfraGenerated;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ProblemDetail;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+import org.springframework.web.multipart.MaxUploadSizeExceededException;
+import org.springframework.web.multipart.MultipartException;
+
+/**
+ * Global exception handler for multipart file upload errors.
+ *
+ * <p>Provides secure error handling without exposing sensitive system information.
+ */
+@Slf4j
+@InfraGenerated
+@RestControllerAdvice
+public class MultipartExceptionHandler {
+
+  @Value("${spring.servlet.multipart.max-file-size:10MB}")
+  private String maxFileSize;
+
+  @Value("${spring.servlet.multipart.max-request-size:10MB}")
+  private String maxRequestSize;
+
+  /**
+   * Handles file size exceeded exceptions with user-friendly messages.
+   *
+   * @param ex the exception
+   * @return problem detail response
+   */
+  @ExceptionHandler(MaxUploadSizeExceededException.class)
+  public ProblemDetail handleMaxUploadSizeExceeded(MaxUploadSizeExceededException ex) {
+    log.warn("File upload size limit exceeded", ex);
+
+    ProblemDetail problemDetail =
+        ProblemDetail.forStatusAndDetail(
+            HttpStatus.PAYLOAD_TOO_LARGE,
+            format(
+                "Upload size exceeds the maximum allowed. Max file size: %s, Max request size: %s",
+                forJava(maxFileSize), forJava(maxRequestSize)));
+
+    problemDetail.setTitle("File Size Limit Exceeded");
+    problemDetail.setProperty("maxFileSize", maxFileSize);
+    problemDetail.setProperty("maxRequestSize", maxRequestSize);
+
+    return problemDetail;
+  }
+
+  /**
+   * Handles general multipart exceptions.
+   *
+   * @param ex the exception
+   * @return problem detail response
+   */
+  @ExceptionHandler(MultipartException.class)
+  public ProblemDetail handleMultipartException(MultipartException ex) {
+    log.error("Multipart request processing failed", ex);
+
+    ProblemDetail problemDetail =
+        ProblemDetail.forStatusAndDetail(
+            HttpStatus.BAD_REQUEST,
+            "Failed to process multipart request. Please ensure your file meets the requirements.");
+
+    problemDetail.setTitle("Multipart Request Error");
+
+    return problemDetail;
+  }
+}