Package com.spaghetticodegang.trylater.image

Klasse ImageService

java.lang.Object

com.spaghetticodegang.trylater.image.ImageService

@Service
public class ImageService
extends Object

Service layer for handling business logic related to image upload and deletion. This service provides methods for uploading, scaling, and deleting images, as well as creating response DTOs for image uploads.

Konstruktorübersicht

Konstruktoren

Konstruktor	Beschreibung
ImageService()

Methodenübersicht

Modifizierer und Typ	Methode	Beschreibung
ImageUploadResponseDto	createImageUploadResponseDto(Image image)	Creates an ImageUploadResponseDto from a given Image entity.
boolean	deleteImageByImgPath(String imgPath)	Deletes an image file from the file system based on its unique ID.
ImageUploadResponseDto	uploadImage(org.springframework.web.multipart.MultipartFile imageFile)	Uploads a single image file.

Von Klasse geerbte Methoden java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Konstruktordetails

ImageService

public ImageService()

Methodendetails

createImageUploadResponseDto

public ImageUploadResponseDto createImageUploadResponseDto(Image image)

Creates an ImageUploadResponseDto from a given Image entity. This DTO contains essential information about the uploaded image, such as its unique ID and the full path where it is stored.

Parameter:

image - The Image entity representing the uploaded image. Must not be null.

Gibt zurück:

An ImageUploadResponseDto containing the image ID and its storage path.

uploadImage

public ImageUploadResponseDto uploadImage(org.springframework.web.multipart.MultipartFile imageFile)

Uploads a single image file. This method performs the following steps:

1. Validates the provided MultipartFile to ensure it is not empty and has a supported image format (png, jpeg, jpg, webp).
2. Generates a unique filename for the image using UUID and the original file extension.
3. Creates the necessary directory structure on the server if it doesn't exist.
4. Transfers the uploaded image file to the designated storage location.
5. Creates a new Image entity with the generated filename and saves it to the database using the ImageRepository.
6. Returns an ImageUploadResponseDto containing the ID and path of the newly uploaded image.

Parameter:

imageFile - The MultipartFile representing the image to be uploaded. Must not be null or empty.

Gibt zurück:

An ImageUploadResponseDto with the ID and path of the uploaded image.

Löst aus:

ImageHandleException - If the provided file is empty, has an unsupported format, or if an IOException occurs during file handling.

deleteImageByImgPath

public boolean deleteImageByImgPath(String imgPath)

Deletes an image file from the file system based on its unique ID. This method attempts to delete the file located at the path constructed using the configured upload directory and the provided imgPath.

Parameter:

imgPath - The unique identifier of the image to be deleted. This should match the filename (including extension) of the image file.

Gibt zurück:

true if the image file was successfully deleted; false if the file does not exist.

Löst aus:

ImageHandleException - If an IOException occurs during the deletion process.