mirror of
https://github.com/Stirling-Tools/Stirling-PDF.git
synced 2025-05-24 02:42:02 +00:00

# Description 1. **Conditional Support for DatabaseController**: - The `DatabaseController` is now annotated with `@Conditional(H2SQLCondition.class)` to ensure it is only available for H2SQL database setups. - This prevents unnecessary exposure of endpoints when the application is configured for H2SQL. 2. **Database Web Template Adjustments**: - The UI elements related to database management are conditionally hidden when the database type is not supported (e.g., `databaseVersion == 'Unknown'`). - Improves user experience by avoiding unsupported operations for non-H2SQL or unknown databases. 3. **Model Attribute Updates**: - Added a check in `DatabaseWebController` to set an informational message (`notSupported`) when the database version is unknown. 4. **H2 Database Compatibility**: - Additional adjustments to ensure the application gracefully handles H2-specific functionality without affecting other database configurations. 5. **Build File Updates**: - Updated the `build.gradle` file to exclude `H2SQLCondition` and related controllers when specific configurations (e.g., security or database type) are disabled. ### Benefits: - Enhances application flexibility by adapting to the configured database type. - Improves user feedback with clear messaging and UI adjustments for unsupported operations. - Prevents accidental exposure of database endpoints in H2SQL setups. ## Checklist - [x] I have read the [Contribution Guidelines](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/CONTRIBUTING.md) - [x] I have performed a self-review of my own code - [ ] I have attached images of the change if it is UI based - [x] I have commented my code, particularly in hard-to-understand areas - [ ] If my code has heavily changed functionality I have updated relevant docs on [Stirling-PDFs doc repo](https://github.com/Stirling-Tools/Stirling-Tools.github.io/blob/main/docs/) - [x] My changes generate no new warnings - [ ] 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)
167 lines
7.1 KiB
Java
167 lines
7.1 KiB
Java
package stirling.software.SPDF.controller.api;
|
|
|
|
import java.io.IOException;
|
|
import java.io.InputStream;
|
|
import java.net.URI;
|
|
import java.nio.file.Files;
|
|
import java.nio.file.Path;
|
|
import java.nio.file.StandardCopyOption;
|
|
|
|
import org.eclipse.jetty.http.HttpStatus;
|
|
import org.springframework.context.annotation.Conditional;
|
|
import org.springframework.core.io.InputStreamResource;
|
|
import org.springframework.http.HttpHeaders;
|
|
import org.springframework.http.MediaType;
|
|
import org.springframework.http.ResponseEntity;
|
|
import org.springframework.security.access.prepost.PreAuthorize;
|
|
import org.springframework.stereotype.Controller;
|
|
import org.springframework.web.bind.annotation.*;
|
|
import org.springframework.web.multipart.MultipartFile;
|
|
import org.springframework.web.servlet.mvc.support.RedirectAttributes;
|
|
|
|
import io.swagger.v3.oas.annotations.Hidden;
|
|
import io.swagger.v3.oas.annotations.Operation;
|
|
import io.swagger.v3.oas.annotations.Parameter;
|
|
import io.swagger.v3.oas.annotations.tags.Tag;
|
|
|
|
import lombok.extern.slf4j.Slf4j;
|
|
import stirling.software.SPDF.config.security.database.DatabaseService;
|
|
|
|
@Slf4j
|
|
@Controller
|
|
@RequestMapping("/api/v1/database")
|
|
@PreAuthorize("hasRole('ROLE_ADMIN')")
|
|
@Conditional(H2SQLCondition.class)
|
|
@Tag(name = "Database", description = "Database APIs for backup, import, and management")
|
|
public class DatabaseController {
|
|
|
|
private final DatabaseService databaseService;
|
|
|
|
public DatabaseController(DatabaseService databaseService) {
|
|
this.databaseService = databaseService;
|
|
}
|
|
|
|
@Operation(
|
|
summary = "Import a database backup file",
|
|
description = "Uploads and imports a database backup SQL file.")
|
|
@PostMapping(consumes = "multipart/form-data", value = "import-database")
|
|
public String importDatabase(
|
|
@Parameter(description = "SQL file to import", required = true)
|
|
@RequestParam("fileInput")
|
|
MultipartFile file,
|
|
RedirectAttributes redirectAttributes)
|
|
throws IOException {
|
|
if (file == null || file.isEmpty()) {
|
|
redirectAttributes.addAttribute("error", "fileNullOrEmpty");
|
|
return "redirect:/database";
|
|
}
|
|
log.info("Received file: {}", file.getOriginalFilename());
|
|
Path tempTemplatePath = Files.createTempFile("backup_", ".sql");
|
|
try (InputStream in = file.getInputStream()) {
|
|
Files.copy(in, tempTemplatePath, StandardCopyOption.REPLACE_EXISTING);
|
|
boolean importSuccess = databaseService.importDatabaseFromUI(tempTemplatePath);
|
|
if (importSuccess) {
|
|
redirectAttributes.addAttribute("infoMessage", "importIntoDatabaseSuccessed");
|
|
} else {
|
|
redirectAttributes.addAttribute("error", "failedImportFile");
|
|
}
|
|
} catch (Exception e) {
|
|
log.error("Error importing database: {}", e.getMessage());
|
|
redirectAttributes.addAttribute("error", "failedImportFile");
|
|
}
|
|
return "redirect:/database";
|
|
}
|
|
|
|
@Hidden
|
|
@Operation(
|
|
summary = "Import database backup by filename",
|
|
description = "Imports a database backup file from the server using its file name.")
|
|
@GetMapping("/import-database-file/{fileName}")
|
|
public String importDatabaseFromBackupUI(
|
|
@Parameter(description = "Name of the file to import", required = true) @PathVariable
|
|
String fileName) {
|
|
if (fileName == null || fileName.isEmpty()) {
|
|
return "redirect:/database?error=fileNullOrEmpty";
|
|
}
|
|
// Check if the file exists in the backup list
|
|
boolean fileExists =
|
|
databaseService.getBackupList().stream()
|
|
.anyMatch(backup -> backup.getFileName().equals(fileName));
|
|
if (!fileExists) {
|
|
log.error("File {} not found in backup list", fileName);
|
|
return "redirect:/database?error=fileNotFound";
|
|
}
|
|
log.info("Received file: {}", fileName);
|
|
if (databaseService.importDatabaseFromUI(fileName)) {
|
|
log.info("File {} imported to database", fileName);
|
|
return "redirect:/database?infoMessage=importIntoDatabaseSuccessed";
|
|
}
|
|
return "redirect:/database?error=failedImportFile";
|
|
}
|
|
|
|
@Hidden
|
|
@Operation(
|
|
summary = "Delete a database backup file",
|
|
description = "Deletes a specified database backup file from the server.")
|
|
@GetMapping("/delete/{fileName}")
|
|
public String deleteFile(
|
|
@Parameter(description = "Name of the file to delete", required = true) @PathVariable
|
|
String fileName) {
|
|
if (fileName == null || fileName.isEmpty()) {
|
|
throw new IllegalArgumentException("File must not be null or empty");
|
|
}
|
|
try {
|
|
if (databaseService.deleteBackupFile(fileName)) {
|
|
log.info("Deleted file: {}", fileName);
|
|
} else {
|
|
log.error("Failed to delete file: {}", fileName);
|
|
return "redirect:/database?error=failedToDeleteFile";
|
|
}
|
|
} catch (IOException e) {
|
|
log.error("Error deleting file: {}", e.getMessage());
|
|
return "redirect:/database?error=" + e.getMessage();
|
|
}
|
|
return "redirect:/database";
|
|
}
|
|
|
|
@Hidden
|
|
@Operation(
|
|
summary = "Download a database backup file",
|
|
description = "Downloads the specified database backup file from the server.")
|
|
@GetMapping("/download/{fileName}")
|
|
public ResponseEntity<?> downloadFile(
|
|
@Parameter(description = "Name of the file to download", required = true) @PathVariable
|
|
String fileName) {
|
|
if (fileName == null || fileName.isEmpty()) {
|
|
throw new IllegalArgumentException("File must not be null or empty");
|
|
}
|
|
try {
|
|
Path filePath = databaseService.getBackupFilePath(fileName);
|
|
InputStreamResource resource = new InputStreamResource(Files.newInputStream(filePath));
|
|
return ResponseEntity.ok()
|
|
.header(HttpHeaders.CONTENT_DISPOSITION, "attachment;filename=" + fileName)
|
|
.contentType(MediaType.APPLICATION_OCTET_STREAM)
|
|
.contentLength(Files.size(filePath))
|
|
.body(resource);
|
|
} catch (IOException e) {
|
|
log.error("Error downloading file: {}", e.getMessage());
|
|
return ResponseEntity.status(HttpStatus.SEE_OTHER_303)
|
|
.location(URI.create("/database?error=downloadFailed"))
|
|
.build();
|
|
}
|
|
}
|
|
|
|
@Operation(
|
|
summary = "Create a database backup",
|
|
description =
|
|
"This endpoint triggers the creation of a database backup and redirects to the"
|
|
+ " database management page.")
|
|
@GetMapping("/createDatabaseBackup")
|
|
public String createDatabaseBackup() {
|
|
log.info("Starting database backup creation...");
|
|
databaseService.exportDatabase();
|
|
log.info("Database backup successfully created.");
|
|
return "redirect:/database?infoMessage=backupCreated";
|
|
}
|
|
}
|