Combinar arquivos Word programaticamente é uma necessidade frequente ao desenvolver aplicações centradas em documentos, especialmente para gerar relatórios ou consolidar contratos. GroupDocs.Merger Cloud SDK for Java fornece uma biblioteca simples baseada na nuvem que permite mesclar arquivos DOCX sem lidar com manipulação de arquivos de baixo nível. Neste guia você aprenderá como combinar múltiplos documentos Word em Java, verá um exemplo de código completo, explorará chamadas equivalentes em cURL e entenderá a configuração necessária. Ao final, você estará pronto para integrar a mesclagem de documentos em seus próprios projetos Java.

Exemplo completo em funcionamento para combinar vários documentos Word em Java

Este exemplo demonstra como combinar vários documentos Word em Java usando a API Merger.

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

Nota: Este exemplo de código demonstra a funcionalidade principal. Antes de usá‑lo em seu projeto, certifique‑se de atualizar quaisquer caminhos de arquivo e valores de configuração para corresponder ao seu ambiente real, verifique se todas as dependências necessárias estão devidamente instaladas e teste minuciosamente em seu ambiente de desenvolvimento. Se encontrar algum problema, consulte a documentação oficial ou entre em contato com a equipe de suporte para obter assistência.

Mesclar arquivos Word via API REST usando cURL

Se você prefere uma abordagem puramente REST, a mesma operação de mesclagem pode ser realizada com chamadas cURL. As etapas abaixo mostram como obter um token de acesso, enviar os arquivos de origem, solicitar a mesclagem e baixar o resultado.

Autenticar e obter um token de acesso:

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

Faça upload de cada arquivo DOCX para o seu armazenamento em nuvem (substitua YOUR_ACCESS_TOKEN pelo token da etapa anterior):

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

Repita o comando de upload para input2.docx e input3.docx.

Crie a solicitação de merge:

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

Baixe o documento mesclado:

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

Para mais detalhes sobre os parâmetros da solicitação, veja a documentação oficial da API.

Entendendo o Processo de Combinação de Documentos Word em Java

A seguir, uma explicação passo a passo do código mostrado anteriormente.

  1. Criar um ApiClient - new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") estabelece uma conexão com o serviço em nuvem da GroupDocs.

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

  2. Instanciar MergerApi - new MergerApi(apiClient) fornece acesso aos endpoints relacionados à mesclagem.

    MergerApi mergerApi = new MergerApi(apiClient);

  3. Preparar a lista de arquivos de origem - Cada objeto FileInfo aponta para um arquivo DOCX armazenado na nuvem. A lista é passada para MergeOptions.

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

  4. Configurar MergeOptions - Defina o caminho de saída desejado e anexe a lista de arquivos de origem.

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

  5. Executar a mesclagem - mergerApi.merge(mergeOptions) envia a solicitação e retorna um FileInfo para o documento mesclado.

    FileInfo result = mergerApi.merge(mergeOptions);

Para obter uma lista completa das propriedades disponíveis, consulte a referência da API.

Pré-requisitos e Configuração para o GroupDocs.Merger Cloud SDK

Antes de executar o código, adicione a dependência Maven ao seu projeto e certifique‑se de que possui uma conta válida do GroupDocs.

Adicione o SDK ao seu pom.xml:

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

Baixe os JARs mais recentes e o código‑fonte na página de download.
Você também precisará do Java 8 ou superior e acesso à internet para as chamadas à nuvem.
Crie uma conta GroupDocs, obtenha seu Client ID e Client Secret e mantenha‑os seguros.

Conclusão

Mesclar arquivos DOCX programaticamente agora é simples com o GroupDocs.Merger Cloud SDK for Java. O código de exemplo e os trechos cURL ilustram duas maneiras flexíveis de combinar vários documentos Word em Java, seja você quem prefira uma biblioteca nativa ou chamadas REST diretas. Lembre‑se de configurar suas credenciais, tratar arquivos grandes por streaming, se necessário, e testar a operação de mesclagem com documentos representativos. Para implantações em produção, você precisará de uma licença paga; detalhes de preços estão disponíveis na página do produto e você pode solicitar uma licença temporária para avaliação na página de licença temporária.

Perguntas frequentes

  • Como combinar vários documentos Word em Java sem escrever código personalizado de manipulação de arquivos?
    Use o GroupDocs.Merger Cloud SDK for Java. O SDK abstrai todas as operações de baixo nível e permite mesclar arquivos DOCX com algumas chamadas de API.

  • É possível mesclar documentos que estão armazenados em diferentes pastas na nuvem?
    Sim. Forneça os caminhos completos dos arquivos na nuvem nos objetos FileInfo, e a operação de mesclagem buscará cada arquivo em sua localização antes de combiná-los.

  • O que devo fazer se a mesclagem falhar com um ApiException?
    Verifique a mensagem da exceção para obter detalhes, como arquivos ausentes ou problemas de permissão. Certifique‑se de que os caminhos dos arquivos estejam corretos e de que sua conta tenha acesso de leitura/gravação ao armazenamento. Consulte a documentação oficial para códigos de erro.

  • Preciso de uma licença separada para cada ambiente (desenvolvimento, teste, produção)?
    Uma única licença cobre todos os ambientes, mas você deve respeitar os limites de uso definidos no seu contrato de licença. Para testes, você pode usar a licença temporária vinculada acima.

Read More