實戰Spring Boot構建文件預覽與轉換服務

構建一個文件預覽與轉換服務，使用Spring Boot可以幫助我們快速搭建一個基于RESTful的微服務。以下是一個簡單的步驟指南，幫助你實現這一目標。

1. 創建Spring Boot項目

首先，你可以使用Spring Initializr（https://start.spring.io/）來創建一個新的Spring Boot項目。選擇以下依賴：

• Spring Web
• Spring Boot DevTools（可選，用于開發時的熱部署）

2. 項目結構

一個典型的Spring Boot項目結構如下：

my-file-preview-service/
├── src/
│   ├── main/
│   │   ├── java/com/example/filepreviewservice/FilePreviewServiceApplication.java
│   │   ├── resources/
│   │   │   ├── application.properties
│   │   │   └── static/
│   │   └── webapp/
│   └── test/
│       └── java/com/example/filepreviewservice/FilePreviewServiceApplicationTests.java
├── pom.xml

3. 編寫代碼

FilePreviewServiceApplication.java

這是項目的入口點：

package com.example.filepreviewservice;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class FilePreviewServiceApplication {

    public static void main(String[] args) {
        SpringApplication.run(FilePreviewServiceApplication.class, args);
    }
}

application.properties

配置文件，用于服務的基本設置：

server.port=8080

4. 實現文件預覽與轉換

為了簡化示例，我們假設只支持圖片文件的預覽。你可以使用一些現有的庫來實現這一點，例如 javax.imageio.ImageIO 用于讀取圖片文件。

FilePreviewController.java

創建一個控制器來處理文件預覽請求：

package com.example.filepreviewservice;

import org.springframework.core.io.Resource;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;

import java.awt.image.BufferedImage;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;

@RestController
public class FilePreviewController {

    private final Path rootLocation = Paths.get("uploads");

    @GetMapping("/preview/{filename:.+}")
    public ResponseEntity<byte[]> serveFile(@PathVariable String filename) throws IOException {
        Resource resource = new UrlResource(rootLocation.resolve(filename).toUri());
        if (resource.exists() || resource.isReadable()) {
            byte[] bytes = Files.readAllBytes(resource.getFile().toPath());
            return ResponseEntity.ok()
                    .contentType(MediaType.IMAGE_JPEG)
                    .body(bytes);
        } else {
            return ResponseEntity.notFound().build();
        }
    }
}

5. 運行服務

在項目根目錄下運行以下命令啟動服務：

./mvnw spring-boot:run

6. 測試服務

你可以使用瀏覽器或 curl 命令來測試文件預覽服務：

curl http://localhost:8080/preview/example.jpg

確保 example.jpg 文件位于 src/main/resources/uploads 目錄下。

總結

以上是一個簡單的文件預覽與轉換服務的實現示例。你可以根據需要擴展此服務，例如支持更多文件類型、實現文件轉換功能等。Spring Boot的靈活性和強大的生態系統使得構建這樣的服務變得非常簡單和高效。