mirror of
https://github.com/Stirling-Tools/Stirling-PDF.git
synced 2025-06-22 23:45:02 +00:00

# Description of Changes - **What was changed:** - Removed explicit constructor definitions annotated with `@Autowired` across services, controllers, filters, and schedulers. - Added Lombok’s `@RequiredArgsConstructor` to automatically generate required-args constructors and eliminate boilerplate. - Introduced other Lombok annotations (`@Data`, `@Getter`, `@Setter`, `@EqualsAndHashCode`, `@NoArgsConstructor`) on model and API classes to replace manual getters/setters and constructors. - Standardized string comparisons to use the constant-first form (e.g., `"value".equals(variable)`). - Cleaned up unused imports and organized OpenAPI configuration by extracting default title/description constants. - **Why the change was made:** - To reduce repetitive boilerplate code and improve maintainability. - To leverage Lombok for cleaner, more consistent dependency injection and data modeling. - To ensure a uniform coding style across the entire codebase. #3406 --- ## Checklist ### General - [x] I have read the [Contribution Guidelines](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/CONTRIBUTING.md) - [ ] I have read the [Stirling-PDF Developer Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/DeveloperGuide.md) (if applicable) - [ ] I have read the [How to add new languages to Stirling-PDF](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/HowToAddNewLanguage.md) (if applicable) - [x] I have performed a self-review of my own code - [x] My changes generate no new warnings ### Documentation - [ ] I have updated relevant docs on [Stirling-PDF's doc repo](https://github.com/Stirling-Tools/Stirling-Tools.github.io/blob/main/docs/) (if functionality has heavily changed) - [ ] I have read the section [Add New Translation Tags](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/HowToAddNewLanguage.md#add-new-translation-tags) (for new translation tags only) ### UI Changes (if applicable) - [ ] Screenshots or videos demonstrating the UI changes are attached ### Testing (if applicable) - [ ] I have tested my changes locally. Refer to the [Testing Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/DeveloperGuide.md#6-testing) for more details.
78 lines
3.1 KiB
Java
78 lines
3.1 KiB
Java
package stirling.software.SPDF.controller.api;
|
|
|
|
import java.io.ByteArrayOutputStream;
|
|
import java.io.IOException;
|
|
|
|
import org.apache.pdfbox.pdmodel.PDDocument;
|
|
import org.springframework.http.ResponseEntity;
|
|
import org.springframework.web.bind.annotation.ModelAttribute;
|
|
import org.springframework.web.bind.annotation.PostMapping;
|
|
import org.springframework.web.bind.annotation.RequestMapping;
|
|
import org.springframework.web.bind.annotation.RestController;
|
|
|
|
import io.swagger.v3.oas.annotations.Operation;
|
|
import io.swagger.v3.oas.annotations.tags.Tag;
|
|
|
|
import lombok.RequiredArgsConstructor;
|
|
|
|
import stirling.software.SPDF.model.api.PDFFile;
|
|
import stirling.software.SPDF.service.CustomPDFDocumentFactory;
|
|
import stirling.software.SPDF.service.PdfImageRemovalService;
|
|
import stirling.software.SPDF.utils.WebResponseUtils;
|
|
|
|
/**
|
|
* Controller class for handling PDF image removal requests. Provides an endpoint to remove images
|
|
* from a PDF file to reduce its size.
|
|
*/
|
|
@RestController
|
|
@RequestMapping("/api/v1/general")
|
|
@Tag(name = "General", description = "General APIs")
|
|
@RequiredArgsConstructor
|
|
public class PdfImageRemovalController {
|
|
|
|
// Service for removing images from PDFs
|
|
private final PdfImageRemovalService pdfImageRemovalService;
|
|
|
|
private final CustomPDFDocumentFactory pdfDocumentFactory;
|
|
|
|
/**
|
|
* Endpoint to remove images from a PDF file.
|
|
*
|
|
* <p>This method processes the uploaded PDF file, removes all images, and returns the modified
|
|
* PDF file with a new name indicating that images were removed.
|
|
*
|
|
* @param file The PDF file with images to be removed.
|
|
* @return ResponseEntity containing the modified PDF file as byte array with appropriate
|
|
* content type and filename.
|
|
* @throws IOException If an error occurs while processing the PDF file.
|
|
*/
|
|
@PostMapping(consumes = "multipart/form-data", value = "/remove-image-pdf")
|
|
@Operation(
|
|
summary = "Remove images from file to reduce the file size.",
|
|
description =
|
|
"This endpoint remove images from file to reduce the file size.Input:PDF"
|
|
+ " Output:PDF Type:MISO")
|
|
public ResponseEntity<byte[]> removeImages(@ModelAttribute PDFFile file) throws IOException {
|
|
// Load the PDF document
|
|
PDDocument document = pdfDocumentFactory.load(file);
|
|
|
|
// Remove images from the PDF document using the service
|
|
PDDocument modifiedDocument = pdfImageRemovalService.removeImagesFromPdf(document);
|
|
|
|
// Create a ByteArrayOutputStream to hold the modified PDF data
|
|
ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
|
|
|
|
// Save the modified PDF document to the output stream
|
|
modifiedDocument.save(outputStream);
|
|
modifiedDocument.close();
|
|
|
|
// Generate a new filename for the modified PDF
|
|
String mergedFileName =
|
|
file.getFileInput().getOriginalFilename().replaceFirst("[.][^.]+$", "")
|
|
+ "_removed_images.pdf";
|
|
|
|
// Convert the byte array to a web response and return it
|
|
return WebResponseUtils.bytesToWebResponse(outputStream.toByteArray(), mergedFileName);
|
|
}
|
|
}
|