<properties>
    <aspose.pdf.version>25.3</aspose.pdf.version>
</properties>
<repositories>
    <repository>
        <id>aspose-repo</id>
        <name>Aspose Java API Repository</name>
        <url>https://releases.aspose.com/java/repo/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>com.aspose</groupId>
        <artifactId>aspose-pdf</artifactId>
        <version>${aspose.pdf.version}</version>
    </dependency>
</dependencies>

@Component
public class AsposeLicenseConfig {
    @PostConstruct
    public void init() {
        try {
            License license = new License();
            // 從 classpath 加載 license 文件
            InputStream is = getClass()
                .getClassLoader()
                .getResourceAsStream("license/Aspose.PDF.lic");
            if (is != null) {
                license.setLicense(is);
                log.info("Aspose.PDF License 加載成功");
            } else {
                log.warn("未找到 Aspose.PDF License 文件，將使用評(píng)估模式（有水印）");
            }
        } catch (Exception e) {
            log.error("Aspose.PDF License 加載失敗", e);
        }
    }
}

@Component
public class AsposeMeteredLicenseConfig {

    @PostConstruct
    public void init() {
        try {
            Metered metered = new Metered();
            // 使用你在 Aspose 官網(wǎng)申請(qǐng)的公鑰和私鑰
            metered.setMeteredKey(
                "你的公鑰-public-key",
                "你的私鑰-private-key"
            );
            log.info("Aspose.PDF Metered License 加載成功");
        } catch (Exception e) {
            log.error("Metered License 加載失敗", e);
        }
    }
}

@Service
@Slf4j
public class PdfToWordService {

    /**
     * PDF 轉(zhuǎn) Word（DOCX）
     *
     * @param pdfFilePath  輸入 PDF 文件路徑
     * @param outputDir    輸出目錄
     * @return 轉(zhuǎn)換后的 DOCX 文件路徑
     */
    public String convertPdfToWord(String pdfFilePath, String outputDir) {
        long startTime = System.currentTimeMillis();

        try {
            // 1. 加載 PDF 文檔
            Document pdfDocument = new Document(pdfFilePath);

            // 2. 設(shè)置轉(zhuǎn)換參數(shù)（優(yōu)化轉(zhuǎn)換質(zhì)量）
            DocSaveOptions saveOptions = new DocSaveOptions();
            saveOptions.setFormat(DocSaveOptions.DocFormat.DocX);
            // 識(shí)別列表/表格結(jié)構(gòu)（提升排版還原度）
            saveOptions.setRecognizeListItems(true);
            // 相對(duì)對(duì)齊優(yōu)化
            saveOptions.setRelativeHorizontalProximity(2.5f);
            // 模式：增強(qiáng)排版還原
            saveOptions.setMode(DocSaveOptions.RecognitionMode.TextBoxFlow);

            // 3. 生成輸出文件名
            String fileName = FilenameUtils.getBaseName(pdfFilePath) + ".docx";
            String outputPath = outputDir + File.separator + fileName;

            // 4. 執(zhí)行轉(zhuǎn)換
            pdfDocument.save(outputPath, saveOptions);
            pdfDocument.close();

            long cost = System.currentTimeMillis() - startTime;
            log.info("PDF轉(zhuǎn)Word完成，耗時(shí): {}ms，文件: {}", cost, outputPath);

            return outputPath;

        } catch (Exception e) {
            log.error("PDF轉(zhuǎn)Word失敗，文件: {}", pdfFilePath, e);
            throw new RuntimeException("PDF轉(zhuǎn)Word轉(zhuǎn)換失敗: " + e.getMessage());
        }
    }
}

/**
 * 根據(jù)不同 PDF 類型選擇最優(yōu)轉(zhuǎn)換策略
 */
public String convertWithStrategy(String pdfFilePath, String outputDir, ConvertStrategy strategy) {
    Document pdfDocument = new Document(pdfFilePath);
    DocSaveOptions saveOptions = new DocSaveOptions();
    saveOptions.setFormat(DocSaveOptions.DocFormat.DocX);

    switch (strategy) {
        case HIGH_FIDELITY:
            // 高保真模式：最大程度還原排版（適合復(fù)雜排版的 PDF）
            saveOptions.setMode(DocSaveOptions.RecognitionMode.TextBoxFlow);
            saveOptions.setRecognizeListItems(true);
            saveOptions.setRelativeHorizontalProximity(2.5f);
            break;

        case TEXT_FOCUS:
            // 文本優(yōu)先模式：犧牲部分排版，提升文本提取準(zhǔn)確度（適合掃描件）
            saveOptions.setMode(DocSaveOptions.RecognitionMode.PureTextBox);
            break;

        case FAST:
            // 快速模式：轉(zhuǎn)換速度最快（適合簡(jiǎn)單 PDF）
            saveOptions.setMode(DocSaveOptions.RecognitionMode.TextBoxFlow);
            saveOptions.setRecognizeListItems(false);
            break;

        default:
            saveOptions.setMode(DocSaveOptions.RecognitionMode.TextBoxFlow);
    }

    String outputPath = outputDir + File.separator 
        + FilenameUtils.getBaseName(pdfFilePath) + ".docx";
    pdfDocument.save(outputPath, saveOptions);
    pdfDocument.close();
    return outputPath;
}

public enum ConvertStrategy {
    HIGH_FIDELITY,  // 高保真（默認(rèn)推薦）
    TEXT_FOCUS,     // 文本優(yōu)先
    FAST            // 快速轉(zhuǎn)換
}

@RestController
@RequestMapping("/api/convert")
@Slf4j
public class ConvertController {

    @Autowired
    private PdfToWordService pdfToWordService;

    @Autowired
    private FileStorageService fileStorageService;

    /**
     * PDF 轉(zhuǎn) Word 接口
     */
    @PostMapping("/pdf-to-word")
    public Result<ConvertResultVO> convertPdfToWord(
            @RequestParam("file") MultipartFile file,
            @RequestParam(value = "strategy", defaultValue = "HIGH_FIDELITY") ConvertStrategy strategy) {

        // 1. 校驗(yàn)文件
        if (file.isEmpty()) {
            return Result.fail("文件不能為空");
        }
        String originalName = file.getOriginalFilename();
        if (!originalName.toLowerCase().endsWith(".pdf")) {
            return Result.fail("僅支持 PDF 格式文件");
        }

        // 2. 保存上傳文件到臨時(shí)目錄
        String pdfFilePath = fileStorageService.saveTempFile(file);

        try {
            // 3. 執(zhí)行轉(zhuǎn)換
            String outputDir = fileStorageService.getTempOutputDir();
            String docxFilePath = pdfToWordService.convertWithStrategy(
                pdfFilePath, outputDir, strategy);

            // 4. 獲取文件大小信息
            File pdfFile = new File(pdfFilePath);
            File docxFile = new File(docxFilePath);

            ConvertResultVO result = new ConvertResultVO();
            result.setOutputFileName(FilenameUtils.getName(docxFilePath));
            result.setOutputFileSize(docxFile.length());
            result.setInputFileSize(pdfFile.length());
            result.setOutputUrl("/files/download/" + FilenameUtils.getName(docxFilePath));

            return Result.success(result);

        } finally {
            // 5. 清理臨時(shí) PDF 文件（轉(zhuǎn)換結(jié)果保留 48 小時(shí)后自動(dòng)清理）
            fileStorageService.scheduleDelete(pdfFilePath, 48);
        }
    }
}

場(chǎng)景：非會(huì)員每日 3 次免費(fèi)，假設(shè) DAU = 1000

日轉(zhuǎn)換量 ≈ 1000 × 3 = 3,000 次/天
月轉(zhuǎn)換量 ≈ 90,000 次/月

Metered License 成本 ≈ 90,000 × $0.02 ≈ $1,800/月（約 ￥13,000/月）
永久授權(quán)成本 ≈ $1,199 + $399/年 ≈ ￥11,500 首年（無(wú)限次）

┌─────────────┐     ┌──────────────────┐     ┌─────────────┐
│  微信小程序   │────?│  SpringBoot 后端  │────?│   MinIO     │
│  (文件上傳)   │     │  Aspose.PDF 轉(zhuǎn)換  │     │ (文件存儲(chǔ))   │
└─────────────┘     └──────────────────┘     └─────────────┘
                           │
                    ┌──────┴──────┐
                    │  MySQL      │
                    │  (記錄/用戶)  │
                    └─────────────┘