1. Producten
  2.   Tekstverwerking
  3.   Java
  4.   documents4j
 
  

Gratis Java API om Hoogwaardig Word-document naar PDF te converteren

Een toonaangevende open source bibliotheek stelt Java-ontwikkelaars in staat MS Office DOCX-, XLSX- en PDF-bestanden met hoge nauwkeurigheid te converteren met behulp van native toepassingen.

Wat is Documents4j ?

documents4j is een krachtige open-source Java-bibliotheek ontworpen om documenten tussen verschillende formaten te converteren, zoals DOCX naar PDF of XLSX naar PDF. In tegenstelling tot vele traditionele bibliotheken delegeert documents4j het conversieproces aan native toepassingen zoals Microsoft Word en Excel, waardoor er een hoogwaardig resultaat ontstaat met minimale opmaakproblemen. De bibliotheek hanteert een andere benadering. In plaats van de conversielogica opnieuw te implementeren, fungeert zij als een brug en delegeert het zware werk aan native toepassingen (zoals Microsoft Word of Excel) die deze formaten al perfect begrijpen. Dit zorgt ervoor dat het uitvoerdocument—bijvoorbeeld een PDF gegenereerd vanuit een Word‑bestand—exact eruitziet alsof je handmatig op \"Opslaan als\" hebt geklikt in MS Office.

De primaire waarde van documents4j ligt in de nauwkeurigheid. Voor bedrijven die professionele documentatie vereisen waarbij elke marge en elk lettertype intact moet blijven, kan het vertrouwen op open-source parsers riskant zijn. documents4j is bijzonder nuttig voor het genereren van facturen of rapporten vanuit sjablonen, het automatiseren van documentworkflows in een Windows‑omgeving en het loskoppelen van conversielogica van je hoofdapplicatie via een remote server‑opzet. Door gebruik te maken van native toepassingen, biedt het ongeëvenaarde nauwkeurigheid vergeleken met traditionele bibliotheken. De ondersteuning voor lokale en remote verwerking, gelijktijdige uitvoering en load balancing maakt het zeer geschikt voor enterprise‑systemen.

Previous Next

Aan de slag met documents4j

De aanbevolen manier om documents4j te installeren is via een Maven-repository. Je kunt de documents4j-bibliotheek eenvoudig rechtstreeks in je Maven-projecten opnemen met eenvoudige configuraties.

Maven Repository voor documents4j


// Here’s a commonly used dependency (Local converter): 

<dependency>
<groupId>com.documents4j</groupId>
<artifactId>documents4j-local</artifactId>
<version>1.1.13</version>
</dependency>

//If you only need the API:
<dependency>
<groupId>com.documents4j</groupId>
<artifactId>documents4j-api</artifactId>
<version>1.1.13</version>
</dependency>

Installeer documents4j via GitHub


git clone https://github.com/documents4j/documents4j.git
cd documents4j
cd documents4j-local-demo
mvn jetty:run

Word naar PDF converteren via Java Bibliotheek

In het hart van documents4j staat een elegant ontworpen fluent API die documentconversie natuurlijk en leesbaar maakt. De IConverter-interface biedt een builder‑stijl keten waarmee je het bronbestand of de -stroom kunt specificeren, invoer‑ en uitvoer‑documenttypen kunt declareren, een conversieprioriteit kunt instellen en kunt kiezen tussen synchrone of asynchrone uitvoering — allemaal in één duidelijke expressie. De API verbergt elke implementatiedetail, zodat je bedrijfslogica nooit hoeft te weten of er een lokale of remote converter onderliggend draait. Hier is een eenvoudig voorbeeld dat laat zien hoe je het conversieproces kunt realiseren.

Hoe Word naar PDF converteren via Java Bibliotheek?

import com.documents4j.api.DocumentType;
import com.documents4j.api.IConverter;
import com.documents4j.job.LocalConverter;

import java.io.File;
import java.util.concurrent.Future;
import java.util.concurrent.TimeUnit;

public class DocumentConverter {
    public static void main(String[] args) {
        // 1. Specify the source and target files
        File wordFile = new File("C:/documents/input.docx");
        File targetFile = new File("C:/documents/output.pdf");

        // 2. Initialize the converter (Local instance)
        IConverter converter = LocalConverter.builder()
                .workerPool(20, 25, 2, TimeUnit.SECONDS)
                .processTimeout(5, TimeUnit.SECONDS)
                .build();

        // 3. Execute the conversion fluently
        boolean success = converter.convert(wordFile).as(DocumentType.MS_WORD)
                                   .to(targetFile).as(DocumentType.PDF)
                                   .execute();

        if (success) {
            System.out.println("Conversion completed successfully!");
        }

        // 4. Always shut down the converter to release native resources
        converter.shutDown();
    }
}

Remote Converter met REST API Server

Niet elke Java‑applicatieserver heeft MS Office geïnstalleerd — en dat zou ook niet moeten. documents4j lost dit op met een ingebouwde Remote Converter-architectuur. Een standalone conversieserver (die intern een LocalConverter gebruikt) draait op een aparte Windows‑machine met MS Office geïnstalleerd en stelt een REST API ter beschikking. Je Java‑applicatie maakt gebruik van een RemoteConverter die documenten via HTTP verzendt en het geconverteerde bestand terug ontvangt. De volledige handshake is onzichtbaar voor de toepassingscode; dezelfde IConverter‑interface wordt aan beide kanten gebruikt.

Hoe Remote Word-documentconversie uit te voeren binnen Java-applicaties?

import com.documents4j.api.DocumentType;
import com.documents4j.api.IConverter;
import com.documents4j.job.RemoteConverter;

import java.io.*;
import java.util.concurrent.TimeUnit;

public class RemoteConverterExample {

    public static void main(String[] args) throws Exception {

        // The RemoteConverter connects to the standalone server
        IConverter converter = RemoteConverter.builder()
                .baseFolder(new File("/tmp/documents4j"))
                .workerPool(10, 20, 5, TimeUnit.SECONDS)
                // Timeout for each HTTP conversion request
                .requestTimeout(30, TimeUnit.SECONDS)
                // URI of the running conversion server
                .baseUri("http://192.168.1.100:9998")
                .build();

        // Convert using InputStream / OutputStream — recommended for RemoteConverter
        // because data is already serialized for HTTP transport
        try (InputStream source = new FileInputStream("/input/contract.docx");
             OutputStream target = new FileOutputStream("/output/contract.pdf")) {

            boolean success = converter
                    .convert(source).as(DocumentType.MS_WORD)
                    .to(target).as(DocumentType.PDF)
                    .execute();

            System.out.println("Remote conversion success: " + success);
        }

        converter.shutDown();
    }
}

SSL-encryptie en Basisverificatie

In productieomgevingen bevatten documenten vaak gevoelige bedrijfs-, juridische of persoonlijke gegevens. Het verzenden ervan via gewone HTTP is een ernstig beveiligingsrisico. De documents4j-bibliotheek pakt dit aan met ingebouwde ondersteuning voor SSL/TLS‑versleuteling tussen de conversie‑client en -server, configureerbaar via Java's standaard SSLContext. De standalone server ondersteunt ook HTTP Basic Authentication om te garanderen dat alleen geautoriseerde clients conversieverzoeken kunnen indienen. Beide beveiligingsfuncties kunnen met minimale configuratie worden ingeschakeld, waardoor documents4j een haalbare oplossing is, zelfs in gereguleerde sectoren.

Asynchrone en Prioritaire Verwerking

Conversies kunnen veel bronnen vergen. documents4j stelt je in staat conversies in te plannen om op de achtergrond (asynchroon) te draaien met een Future-retourtype. Bovendien ondersteunt het een prioriteringsmechanisme. Als je applicatie een hoog volume aan verzoeken verwerkt, kun je kritieke documenten een hogere prioriteit geven zodat ze naar de voorkant van de interne wachtrij worden verplaatst.

 Dutch