Pełny działający przykład łączenia wielu dokumentów Word w Javie

Ten przykład pokazuje, jak połączyć wiele dokumentów Word w Javie przy użyciu Merger API.

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());
        }
    }
}

Uwaga: Ten przykład kodu demonstruje podstawową funkcjonalność. Przed użyciem go w swoim projekcie upewnij się, że zaktualizowałeś wszystkie ścieżki plików i wartości konfiguracyjne, aby odpowiadały rzeczywistemu środowisku, zweryfikuj, że wszystkie wymagane zależności są prawidłowo zainstalowane, oraz dokładnie przetestuj w środowisku deweloperskim. Jeśli napotkasz jakiekolwiek problemy, odwołaj się do oficjalnej dokumentacji lub skontaktuj się z zespołem wsparcia w celu uzyskania pomocy.

Scalanie plików Word przy użyciu REST API i cURL

Jeśli wolisz czyste podejście REST, tę samą operację scalania można wykonać przy użyciu wywołań cURL. Poniższe kroki pokazują, jak uzyskać token dostępu, przesłać pliki źródłowe, złożyć żądanie scalenia i pobrać wynik.

Uwierzytelnij się i uzyskaj token dostępu:

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"}'

Prześlij każdy plik DOCX do swojej pamięci w chmurze (zamień YOUR_ACCESS_TOKEN na token z poprzedniego kroku):

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

Powtórz polecenie przesyłania dla input2.docx i input3.docx.

Utwórz żądanie scalenia:

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"}
           ]
         }'

Pobierz połączony dokument:

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

Aby uzyskać więcej informacji o parametrach żądania, zobacz oficjalną dokumentację API.

Zrozumienie procesu łączenia dokumentów Word w Javie

Poniżej znajduje się szczegółowy opis krok po kroku kodu przedstawionego wcześniej.

1. Utwórz ApiClient - new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") nawiązuje połączenie z usługą chmurową GroupDocs.

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

2. Zainicjuj MergerApi - new MergerApi(apiClient) zapewnia dostęp do endpointów związanych z łączeniem.

   MergerApi mergerApi = new MergerApi(apiClient);
   

3. Przygotuj listę plików źródłowych - Każdy obiekt FileInfo wskazuje na plik DOCX przechowywany w chmurze. Lista jest przekazywana do MergeOptions.

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

4. Skonfiguruj MergeOptions - Ustaw żądaną ścieżkę wyjściową i dołącz listę plików źródłowych.

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

5. Wykonaj łączenie - mergerApi.merge(mergeOptions) wysyła żądanie i zwraca FileInfo dla połączonego dokumentu.

   FileInfo result = mergerApi.merge(mergeOptions);
   

Aby uzyskać pełną listę dostępnych właściwości, odnieś się do referencji API.

Wymagania wstępne i konfiguracja dla GroupDocs.Merger Cloud SDK

Zanim będziesz mógł uruchomić kod, dodaj zależność Maven do swojego projektu i upewnij się, że masz ważne konto GroupDocs.

Dodaj SDK do swojego pom.xml:

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

Pobierz najnowsze pliki JAR i kod źródłowy ze strony pobierania.
Będziesz także potrzebować Java 8 lub nowszej oraz dostępu do Internetu dla wywołań w chmurze.
Utwórz konto GroupDocs, uzyskaj swój Client ID i Client Secret i przechowuj je w bezpiecznym miejscu.

Podsumowanie

Scalanie plików DOCX programowo jest teraz proste dzięki GroupDocs.Merger Cloud SDK for Java. Przykładowy kod i fragmenty cURL ilustrują dwa elastyczne sposoby łączenia wielu dokumentów Word w Javie, niezależnie od tego, czy wolisz natywną bibliotekę, czy bezpośrednie wywołania REST. Pamiętaj, aby skonfigurować swoje poświadczenia, w razie potrzeby obsługiwać duże pliki poprzez strumieniowanie oraz przetestować operację scalania przy użyciu reprezentatywnych dokumentów. W środowiskach produkcyjnych potrzebna będzie płatna licencja; szczegóły cenowe są dostępne na stronie produktu, a tymczasową licencję do oceny możesz zamówić na stronie tymczasowej licencji.

FAQs

• Jak połączyć wiele dokumentów Word w Javie bez pisania własnego kodu obsługi plików?
  Użyj GroupDocs.Merger Cloud SDK for Java. SDK abstrahuje wszystkie operacje niskiego poziomu i pozwala łączyć pliki DOCX przy użyciu kilku wywołań API.

• Czy można scalać dokumenty przechowywane w różnych folderach w chmurze?
  Tak. Podaj pełne ścieżki plików w chmurze w obiektach FileInfo, a operacja scalania pobierze każdy plik z jego lokalizacji przed ich połączeniem.

• Co powinienem zrobić, jeśli scalanie nie powiedzie się z ApiException?
  Sprawdź komunikat wyjątku, aby uzyskać szczegóły, takie jak brakujące pliki lub problemy z uprawnieniami. Upewnij się, że ścieżki do plików są prawidłowe i że Twoje konto ma dostęp do odczytu/zapisu w magazynie. Zapoznaj się z oficjalną dokumentacją w celu uzyskania kodów błędów.

• Czy potrzebuję oddzielnej licencji dla każdego środowiska (development, staging, production)?
  Jedna licencja obejmuje wszystkie środowiska, ale musisz przestrzegać limitów użytkowania określonych w umowie licencyjnej. Do testów możesz użyć tymczasowej licencji podanej powyżej.

Read More

• Zabezpiecz plik ZIP hasłem przy użyciu oprogramowania do ochrony hasłem
• Zabezpiecz Excel hasłem przy użyciu usługi ochrony hasłem
• Połącz dokumenty Word w C#

Scalanie wielu dokumentów Word w Node.JS - kompletny przykład kodu

Ten przykład pokazuje, jak połączyć trzy pliki DOCX w jeden dokument przy użyciu GroupDocs.Merger Cloud SDK for Node.js.

const GroupDocsMergerCloud = require("@groupdocs/merger-cloud");

// ==== Configuration ====
// Replace with your actual credentials
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);
const mergeApi = new GroupDocsMergerCloud.MergeApi(config);

// ==== Input / Output paths ====
const inputFiles = [
    "documents/input1.docx",
    "documents/input2.docx",
    "documents/input3.docx"
];
const outputFile = "documents/combined_output.docx";

// ==== Build request ====
const documentEntries = inputFiles.map(path => {
    return new GroupDocsMergerCloud.Models.DocumentEntry({
        fileInfo: new GroupDocsMergerCloud.Models.FileInfo({
            filePath: path
        })
    });
});

const mergeRequest = new GroupDocsMergerCloud.Models.MergeDocumentsRequest({
    documents: documentEntries,
    outputPath: outputFile
});

// ==== Execute merge ====
(async () => {
    try {
        const result = await mergeApi.mergeDocuments(mergeRequest);
        console.log(`Merge completed successfully. Output file: ${result.path}`);
    } catch (error) {
        console.error("Error during merging:", error);
    }
})();

Uwaga: Ten przykład kodu demonstruje podstawową funkcjonalność. Przed użyciem go w swoim projekcie upewnij się, że zaktualizowałeś ścieżki do plików (input1.docx, combined_output.docx itp.), aby odpowiadały rzeczywistym lokalizacjom, sprawdź, czy wszystkie wymagane zależności są poprawnie zainstalowane, i dokładnie przetestuj w środowisku programistycznym. Jeśli napotkasz jakiekolwiek problemy, odwołaj się do oficjalnej dokumentacji lub skontaktuj się z zespołem wsparcia w celu uzyskania pomocy.

Łączenie dokumentów Word za pomocą REST API przy użyciu cURL

Jeśli wolisz czyste podejście REST, tę samą operację scalania można wykonać przy użyciu poleceń cURL. Poniżej znajduje się zwięzły przepływ pracy, który uwierzytelnia, przesyła pliki źródłowe, uruchamia scalanie i pobiera wynik.

1. Uwierzytelnianie i uzyskanie tokenu dostępu

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

Odpowiedź zawiera access_token używany w kolejnych wywołaniach.

2. Prześlij pliki źródłowe

Powtórz ten krok dla każdego pliku DOCX, który chcesz scalić.

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/upload?path=documents/input1.docx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/octet-stream" \
--data-binary "@path/to/input1.docx"

3. Wykonaj operację scalania

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

API zwraca ścieżkę do połączonego pliku.

4. Pobierz połączony dokument

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/download?path=documents/combined_output.docx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o combined_output.docx

Aby uzyskać więcej informacji o ładunkach żądań i opcjach, zobacz oficjalną dokumentację API.

Jak działa scalanie wielu dokumentów Word w Node.JS

SDK abstrahuje proces scalania w kilka logicznych kroków:

1. Tworzenie konfiguracji - new GroupDocsMergerCloud.Configuration(clientId, clientSecret) tworzy kontekst uwierzytelniania. Zobacz odniesienie do klasy w Referencja API.

const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);

2. Instancja API - new GroupDocsMergerCloud.MergeApi(config) zapewnia dostęp do operacji scalania.

   const mergeApi = new GroupDocsMergerCloud.MergeApi(config);
   

3. Wpisy dokumentu – każdy plik źródłowy jest opakowany w DocumentEntry, który zawiera FileInfo z ścieżką pliku.

const documentEntries = inputFiles.map(path => {
    return new GroupDocsMergerCloud.Models.DocumentEntry({
        fileInfo: new GroupDocsMergerCloud.Models.FileInfo({ filePath: path })
    });
});

4. Merge Request - MergeDocumentsRequest pakietuje wpisy i żądaną ścieżkę wyjściową.

   const mergeRequest = new GroupDocsMergerCloud.Models.MergeDocumentsRequest({
       documents: documentEntries,
       outputPath: outputFile
   });
   

5. Wykonanie - mergeApi.mergeDocuments(mergeRequest) wysyła żądanie do usługi w chmurze. Obietnica zwraca obiekt wyniku zawierający ścieżkę do pliku wyjściowego.

   const result = await mergeApi.mergeDocuments(mergeRequest);
   console.log(`Merge completed successfully. Output file: ${result.path}`);
   

Te kroki razem umożliwiają łączenie wielu dokumentów Word w sposób efektywny, bez obsługi strumieni plików niskiego poziomu.

Przygotowanie środowiska dla GroupDocs.Merger

1. Zainstaluj SDK

npm install groupdocs-merger-cloud

Pakiet jest dostępny na oficjalnej stronie pobierania.

2. Node.js Version - Upewnij się, że używasz Node.js 12 lub nowszego.

3. Skonfiguruj poświadczenia - Zastąp YOUR_CLIENT_ID i YOUR_CLIENT_SECRET w kodzie wartościami z konta GroupDocs Cloud.

4. Utwórz folder projektu - Umieść pliki źródłowe DOCX w podfolderze documents/, jak pokazano w przykładzie.

Po wykonaniu tych kroków jesteś gotowy uruchomić skrypt scalania lub wywołać endpointy REST.

Podsumowanie

Łączenie wielu dokumentów Word w Node.JS staje się proste dzięki GroupDocs.Merger Cloud SDK for Node.js. SDK obsługuje przesyłanie plików, logikę scalania i generowanie wyników, pozwalając skupić się na logice biznesowej, a nie na niskopoziomowej manipulacji plikami. Pamiętaj, aby zabezpieczyć odpowiednią licencję do użytku produkcyjnego; możesz rozpocząć od tymczasowej licencji i przejść na pełną subskrypcję w miarę rosnących potrzeb. Rozpocznij scalanie już dziś i usprawnij przepływy pracy dokumentów.

Najczęściej zadawane pytania

• Jak połączyć wiele dokumentów Word w Node.JS przy użyciu SDK?
  Użyj klasy MergeApi, aby utworzyć MergeDocumentsRequest, który wymienia każdy plik DOCX jako DocumentEntry. SDK łączy je w podanej kolejności i zapisuje wynik w określonej ścieżce wyjściowej.

• Czy można łączyć pliki PDF razem przy użyciu tego samego SDK?
  Tak, Merger SDK obsługuje PDF, DOCX, ODT oraz kilka innych formatów. Wystarczy zmienić rozszerzenia plików w tablicy inputFiles, a SDK automatycznie zajmie się konwersją. Zobacz oficjalną dokumentację po szczegóły dotyczące formatów.

• Jakie są limity liczby dokumentów, które mogę scalić w jednym żądaniu?
  Usługa w chmurze narzuca limit rozmiaru, a nie sztywną liczbę. O ile łączny rozmiar mieści się w przydziale Twojego konta, możesz scalić dziesiątki plików. W przypadku bardzo dużych partii rozważ najpierw przesłanie plików do magazynu GroupDocs i odwoływanie się do nich za pomocą identyfikatora.

• Czy muszę martwić się o licencjonowanie w środowisku deweloperskim a produkcyjnym?
  Rozwój i testowanie mogą korzystać z tymczasowej licencji uzyskanej ze strony tymczasowej licencji. Dla wdrożeń produkcyjnych zakup pełnej licencji, aby odblokować nieograniczone łączenia i priorytetowe wsparcie.

Czytaj dalej

• Zabezpiecz plik ZIP hasłem przy użyciu oprogramowania do ochrony hasłem
• Zabezpiecz plik Excel hasłem przy użyciu usługi ochrony hasłem
• Scal dokumenty Word w C#