清理目錄 Java – 使用 GroupDocs.Search 自動化文件索引與重新命名

如果您需要在自動化文件索引與重新命名的同時 clean directory java，您來對地方了。手動處理檔案搬移、刪除以及索引更新容易出錯且耗時。於本教學中，我們將示範如何讓 Java 承擔繁重工作，使用 GroupDocs.Search for Java 建立可搜尋的索引、重新命名檔案，並自動保持索引同步。

快速解答

What does “clean directory java” mean? 使用 Java 程式碼刪除目標目錄內的所有檔案/資料夾。
Which library creates the searchable index? GroupDocs.Search for Java。
How do I rename a document and keep the index updated? 使用 File.renameTo()，然後以 Notification.createRenameNotification 通知索引。
Can I copy files after cleaning the folder? 可以 — Java Streams 可在保留索引的同時複製檔案。
Is a license required for production? 商業使用需具備有效的 GroupDocs.Search 授權。

什麼是 “clean directory java”？

在 Java 中清理目錄是指以程式方式移除指定資料夾內的所有檔案與子資料夾。這通常是複製新檔案或重新建構索引之前的前置步驟，以確保過時的資料不會影響搜尋結果。

為什麼要自動化文件索引與重新命名？

Document management automation 可減少人工操作並消除人為錯誤。
create searchable index 步驟讓您能即時依內容定位任何文件。
若重新命名檔案卻未更新索引，會導致搜尋精確度下降；自動化可保持一致性。

前置條件

GroupDocs.Search for Java（版本 25.4 或更新）
JDK 8 以上，及 IntelliJ IDEA 或 Eclipse 等 IDE
基本的 Java 知識，特別是檔案 I/O

設定 GroupDocs.Search for Java

Maven 依賴

將以下儲存庫與依賴項加入您的 pom.xml：

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/search/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-search</artifactId>
      <version>25.4</version>
   </dependency>
</dependencies>

直接下載

或者，從 GroupDocs.Search for Java releases 下載最新版本。

授權

取得免費試用、臨時評估授權，或購買正式授權以供正式環境使用。

基本初始化

建立一個 Index 實例以保存可搜尋的資料：

import com.groupdocs.search.Index;

public class Main {
    public static void main(String[] args) {
        String indexFolder = "YOUR_OUTPUT_DIRECTORY/DocumentIndexingAndRenaming/Index";
        Index index = new Index(indexFolder);
    }
}

實作指南

1. 新增文件至索引（create searchable index）

import com.groupdocs.search.Index;

public class DocumentIndexingAndRenaming {
    public static void main(String[] args) {
        String indexFolder = "YOUR_OUTPUT_DIRECTORY/DocumentIndexingAndRenaming/Index";
        String documentFolder = "YOUR_DOCUMENT_DIRECTORY/DocumentIndexingAndRenaming/Documents/";

        // Create an Index
        Index index = new Index(indexFolder);

        // Add documents to the index
        index.add(documentFolder);
    }
}

說明：

indexFolder – 索引檔案的存放位置。
documentFolder – 包含您欲建立可搜尋檔案的來源資料夾。

2. 重新命名文件並通知索引

import com.groupdocs.search.Notification;

public class DocumentIndexingAndRenaming {
    public static void main(String[] args) {
        // Define paths for renaming
        String oldDocumentPath = "YOUR_DOCUMENT_DIRECTORY/DocumentIndexingAndRenaming/Documents/Lorem ipsum.txt";
        String newDocumentPath = "YOUR_DOCUMENT_DIRECTORY/DocumentIndexingAndRenaming/Documents/Lorem ipsum renamed.txt";

        java.io.File fileToRename = new java.io.File(oldDocumentPath);
        boolean renameSuccessful = fileToRename.renameTo(new java.io.File(newDocumentPath));

        if (renameSuccessful) {
            // Notify the index about the renaming
            Notification notification = Notification.createRenameNotification(oldDocumentPath, newDocumentPath);
            index.notifyIndex(notification);

            // Update the index to reflect changes
            index.update();
        }
    }
}

說明：

Java 的 File.renameTo() 執行實際的重新命名。
Notification.createRenameNotification() 告訴 GroupDocs.Search 檔名已變更，保持索引正確。

Clean Directory Java – 目錄清理與檔案複製

在大量複製前先整理資料夾，可防止重複或孤立檔案。以下提供兩段可重複使用的程式碼片段。

步驟 1：刪除資料夾內容（delete folder contents）

import java.io.File;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;

public class DirectoryCleaningAndFileCopying {
    public static void main(String[] args) throws IOException {
        String targetDirectory = "YOUR_DOCUMENT_DIRECTORY/DocumentIndexingAndRenaming/Documents/";

        Files.walk(Paths.get(targetDirectory))
             .map(Path::toFile)
             .sorted((o1, o2) -> -o1.compareTo(o2))
             .forEach(File::delete);
    }
}

說明：

Files.walk() 會遍歷每個檔案與子資料夾。
以相反順序排序可確保先刪除檔案再刪除其父目錄，從而有效 delete folder contents。

步驟 2：複製檔案（copy files java）

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.stream.Stream;

public class DirectoryCleaningAndFileCopying {
    public static void main(String[] args) throws IOException {
        String sourceDirectory = "YOUR_SOURCE_DIRECTORY/ExampleFiles/";
        String targetDirectory = "YOUR_DOCUMENT_DIRECTORY/DocumentIndexingAndRenaming/Documents/";

        try (Stream<Path> paths = Files.walk(Paths.get(sourceDirectory))) {
            paths.filter(Files::isRegularFile)
                 .forEach(sourcePath -> {
                     Path destPath = Paths.get(targetDirectory + sourcePath.getFileName().toString());
                     try {
                         Files.copy(sourcePath, destPath, java.nio.file.StandardCopyOption.REPLACE_EXISTING);
                     } catch (IOException e) {
                         e.printStackTrace();
                     }
                 });
        }
    }
}

說明：

此串流僅過濾普通檔案，然後將每個檔案複製至目標目錄，必要時覆寫已存在的檔案。

實務應用

Enterprise Document Management – 為數千份合約自動化索引，並保持檔名同步。
Legal Firms – 快速重新命名案件檔案，同時保留可搜尋內容。
Content Management Systems – 使用 clean‑directory 模式刷新媒體資料夾，免除手動清理。

效能考量

Index Size – 若索引變大，請定期壓縮索引。
Memory Usage – 分批處理檔案以避免 OutOfMemoryError。
Concurrency – 大量作業時，可考慮使用 Java 的 ExecutorService 來平行化清理與複製。

常見問題與技巧

Issue	Cause	Fix
重新命名失敗	檔案被鎖定或路徑無效	確保檔案未在其他地方開啟；使用 `Files.move` 進行較可靠的重新命名。
索引未更新	未發送通知	務必先呼叫 `index.notifyIndex(notification)`，再呼叫 `index.update()`。
複製後搜尋結果過時	索引仍指向舊檔案	重新將目標資料夾加入索引，或在複製後呼叫 `index.update()`。

常見問答

Q: 我可以清理包含子資料夾的目錄嗎？
A: 可以。Files.walk() 方法會遞迴刪除所有巢狀的檔案與資料夾。

Q: 每次重新命名後需要重新建構整個索引嗎？
A: 不需要。只要發送重新命名通知並呼叫 index.update() 即可。

Q: 在遇到效能限制前，我能清理多大的資料夾？
A: 取決於 JVM 記憶體；以較小批次處理或使用串流可協助管理大型資料集。

Q: GroupDocs.Search 可免費用於開發嗎？
A: 提供免費試用，但正式環境需購買授權。

Q: 我可以將此方法套用於其他檔案類型（例如 PDF、DOCX）嗎？
A: 當然可以。GroupDocs.Search 支援多種格式，只需將包含這些檔案的資料夾加入索引即可。

結論

您現在擁有一套完整、可投入生產的 clean directory java 解決方案，能將文件加入可搜尋的索引、重新命名檔案，並與 GroupDocs.Search 保持同步。將這些模式套用於文件管理工作流程，即可實現更快速、更可靠的搜尋體驗。

最後更新： 2025-12-29
測試版本： GroupDocs.Search 25.4
作者： GroupDocs