Wie man mehrere Word-Dokumente in Java kombiniert

Das programmatische Zusammenführen von Word‑Dateien ist eine häufige Anforderung beim Erstellen dokumenten‑zentrierter Anwendungen, insbesondere beim Erzeugen von Berichten oder beim Konsolidieren von Verträgen. GroupDocs.Merger Cloud SDK for Java bietet eine einfache, cloud‑basierte Bibliothek, mit der Sie DOCX‑Dateien zusammenführen können, ohne sich mit Low‑Level‑Dateiverarbeitung befassen zu müssen. In diesem Leitfaden lernen Sie, wie Sie mehrere Word‑Dokumente in Java kombinieren, sehen ein vollständiges Code‑Beispiel, erkunden äquivalente cURL‑Aufrufe und verstehen die erforderliche Einrichtung. Am Ende sind Sie bereit, das Zusammenführen von Dokumenten in Ihre eigenen Java‑Projekte zu integrieren.

Vollständiges funktionierendes Beispiel zum Kombinieren mehrerer Word‑Dokumente in Java

Dieses Beispiel zeigt, wie man mehrere Word‑Dokumente in Java mithilfe der Merger‑API kombiniert.

import com.groupdocs.merger.cloud.client.ApiClient;
import com.groupdocs.merger.cloud.client.ApiException;
import com.groupdocs.merger.cloud.api.MergerApi;
import com.groupdocs.merger.cloud.model.FileInfo;
import com.groupdocs.merger.cloud.model.MergeOptions;
import java.util.ArrayList;
import java.util.List;

public class CombineWordDocuments {
    public static void main(String[] args) {
        // Initialize the API client with your credentials
        ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        MergerApi mergerApi = new MergerApi(apiClient);

try {
            // List of Word documents to combine
            List<FileInfo> sourceFiles = new ArrayList<>();
            sourceFiles.add(new FileInfo().setFilePath("input1.docx"));
            sourceFiles.add(new FileInfo().setFilePath("input2.docx"));
            sourceFiles.add(new FileInfo().setFilePath("input3.docx"));

// Configure merge options
            MergeOptions mergeOptions = new MergeOptions();
            mergeOptions.setOutputPath("merged_output.docx");
            mergeOptions.setFileInfos(sourceFiles);

// Execute the merge operation
            FileInfo result = mergerApi.merge(mergeOptions);

System.out.println("Merge completed successfully. Output file: " + result.getFilePath());
        } catch (ApiException e) {
            System.err.println("An error occurred while merging documents: " + e.getMessage());
        }
    }
}

Hinweis: Dieses Codebeispiel demonstriert die Kernfunktionalität. Bevor Sie es in Ihrem Projekt verwenden, stellen Sie sicher, dass Sie alle Dateipfade und Konfigurationswerte an Ihre tatsächliche Umgebung anpassen, überprüfen Sie, dass alle erforderlichen Abhängigkeiten korrekt installiert sind, und testen Sie gründlich in Ihrer Entwicklungsumgebung. Wenn Sie auf Probleme stoßen, lesen Sie bitte die offizielle Dokumentation oder wenden Sie sich an das Support-Team für Unterstützung.

Word-Dateien per REST-API mit cURL zusammenführen

Wenn Sie einen reinen REST-Ansatz bevorzugen, kann derselbe Zusammenführungsvorgang mit cURL-Aufrufen durchgeführt werden. Die nachstehenden Schritte zeigen, wie Sie ein Zugriffstoken erhalten, Quelldateien hochladen, die Zusammenführung anfordern und das Ergebnis herunterladen.

Authentifizieren und ein Zugriffstoken erhalten:

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

Laden Sie jede DOCX-Datei in Ihren Cloud‑Speicher hoch (ersetzen Sie YOUR_ACCESS_TOKEN durch das Token aus dem vorherigen Schritt):

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input1.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document" \
     --data-binary @input1.docx

Wiederholen Sie den Upload‑Befehl für input2.docx und input3.docx.

Erstelle die Merge‑Anfrage:

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/merge" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "outputPath":"merged_output.docx",
           "fileInfos":[
               {"filePath":"input1.docx"},
               {"filePath":"input2.docx"},
               {"filePath":"input3.docx"}
           ]
         }'

Laden Sie das zusammengeführte Dokument herunter:

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/merged_output.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o merged_output.docx

Weitere Details zu den Anforderungsparametern finden Sie in der offiziellen API-Dokumentation.

Verständnis des Prozesses zum Kombinieren von Word‑Dokumenten in Java

Im Folgenden finden Sie eine schrittweise Aufschlüsselung des zuvor gezeigten Codes.

Create an ApiClient - new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") establishes a connection to the GroupDocs cloud service.

ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

Instantiate MergerApi - new MergerApi(apiClient) gives access to merge‑related endpoints.

MergerApi mergerApi = new MergerApi(apiClient);

Prepare source file list - Each FileInfo object points to a DOCX file stored in the cloud. The list is passed to MergeOptions.

List<FileInfo> sourceFiles = new ArrayList<>();
sourceFiles.add(new FileInfo().setFilePath("input1.docx"));

Configure MergeOptions - Set the desired output path and attach the list of source files.

MergeOptions mergeOptions = new MergeOptions();
mergeOptions.setOutputPath("merged_output.docx");
mergeOptions.setFileInfos(sourceFiles);

Execute merge - mergerApi.merge(mergeOptions) sends the request and returns a FileInfo for the merged document.

FileInfo result = mergerApi.merge(mergeOptions);

Für eine vollständige Liste der verfügbaren Eigenschaften, siehe die API-Referenz.

Voraussetzungen und Einrichtung für GroupDocs.Merger Cloud SDK

Bevor Sie den Code ausführen können, fügen Sie die Maven‑Abhängigkeit zu Ihrem Projekt hinzu und stellen Sie sicher, dass Sie ein gültiges GroupDocs‑Konto besitzen.

Fügen Sie das SDK zu Ihrer pom.xml hinzu:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger-cloud</artifactId>
    <version>25.11</version>
</dependency>

Laden Sie die neuesten JARs und den Quellcode von der Download‑Seite herunter.
Sie benötigen außerdem Java 8 oder höher sowie Internetzugang für die Cloud‑Aufrufe.
Erstellen Sie ein GroupDocs‑Konto, erhalten Sie Ihre Client ID und Client Secret und bewahren Sie diese sicher auf.

Fazit

Das Zusammenführen von DOCX-Dateien programmgesteuert ist jetzt einfach mit dem GroupDocs.Merger Cloud SDK for Java. Der Beispielcode und die cURL‑Snippets zeigen zwei flexible Möglichkeiten, mehrere Word‑Dokumente in Java zu kombinieren, egal ob Sie eine native Bibliothek oder direkte REST‑Aufrufe bevorzugen. Denken Sie daran, Ihre Anmeldeinformationen zu konfigurieren, große Dateien bei Bedarf per Streaming zu verarbeiten und den Merge‑Vorgang mit repräsentativen Dokumenten zu testen. Für produktive Einsätze benötigen Sie eine kostenpflichtige Lizenz; Preisdetails finden Sie auf der Produktseite und Sie können eine temporäre Lizenz zur Evaluierung über die temporäre Lizenzseite anfordern.

FAQs

Wie kann ich mehrere Word‑Dokumente in Java kombinieren, ohne eigenen Code für die Dateiverarbeitung zu schreiben?
Verwenden Sie das GroupDocs.Merger Cloud SDK for Java. Das SDK abstrahiert alle Low‑Level‑Operationen und ermöglicht das Zusammenführen von DOCX‑Dateien mit wenigen API‑Aufrufen.
Ist es möglich, Dokumente zusammenzuführen, die in verschiedenen Cloud-Ordnern gespeichert sind?
Ja. Geben Sie die vollständigen Cloud-Dateipfade in den FileInfo-Objekten an, und die Zusammenführungsoperation ruft jede Datei von ihrem Speicherort ab, bevor sie kombiniert wird.
Was soll ich tun, wenn das Zusammenführen mit einer ApiException fehlschlägt?
Überprüfen Sie die Fehlermeldung auf Details wie fehlende Dateien oder Berechtigungsprobleme. Stellen Sie sicher, dass die Dateipfade korrekt sind und dass Ihr Konto Lese‑/Schreibzugriff auf den Speicher hat. Konsultieren Sie die offizielle Dokumentation für Fehlercodes.
Brauche ich für jede Umgebung (Entwicklung, Staging, Produktion) eine separate Lizenz?
Eine einzelne Lizenz deckt alle Umgebungen ab, aber Sie müssen die in Ihrer Lizenzvereinbarung festgelegten Nutzungslimits einhalten. Für Tests können Sie die oben verlinkte temporäre Lizenz verwenden.

Vollständiges funktionierendes Beispiel zum Kombinieren mehrerer Word‑Dokumente in Java#

Word-Dateien per REST-API mit cURL zusammenführen#

Verständnis des Prozesses zum Kombinieren von Word‑Dokumenten in Java#

Voraussetzungen und Einrichtung für GroupDocs.Merger Cloud SDK#

Fazit#

FAQs#

Mehr lesen#