1. Tuotteet
  2.   Tekstinkäsittely
  3.   Java
  4.   documents4j
 
  

Ilmainen Java‑API Word‑asiakirjojen korkealaatuiseen muuntamiseen PDF:ksi

Johtava avoimen lähdekoodin kirjasto mahdollistaa Java‑kehittäjien muuntaa MS Office DOCX-, XLSX- ja PDF‑tiedostoja tarkasti käyttämällä natiivisovelluksia.

Mikä on Documents4j?

documents4j on tehokas avoimen lähdekoodin Java-kirjasto, jonka on suunniteltu muuntamaan asiakirjoja eri formaattien välillä, kuten DOCX PDF:ksi tai XLSX PDF:ksi. Toisin kuin monet perinteiset kirjastot, documents4j delegoi muunnosprosessin natiivisovelluksiin, kuten Microsoft Wordiin ja Exceliin, varmistaen korkean laadun ja minimaaliset muotoiluongelmat. Kirjasto käyttää erilaista lähestymistapaa. Sen sijaan, että muunnoslogiikka toteutettaisiin uudelleen, se toimii silta‑toiminnossa, delegoiden raskaan työn natiivisovelluksille (kuten Microsoft Word tai Excel), jotka tuntevat nämä formaatit täydellisesti. Tämä takaa, että tulos­asiakirja — esimerkiksi Word‑tiedostosta luotu PDF — näyttää täsmälleen samalta kuin jos olisit manuaalisesti valinnut "Save As" MS Officessa.

documents4j:n ensisijainen arvo on sen tarkkuus. Yrityksille, jotka tarvitsevat ammattilaistason dokumentaatiota, jossa jokainen marginaali ja kirjasin pysyvät muuttumattomina, avoimen lähdekoodin jäsentimien käyttäminen voi olla riskialtista. documents4j on erityisen hyödyllinen laskujen tai raporttien luomisessa malleista, asiakirjatyönkulkujen automatisoinnissa Windows‑pohjaisessa ympäristössä sekä muunnoslogiikan eriyttämisessä pääsovelluksesta etäpalvelimen avulla. Hyödyntämällä natiivisovelluksia se takaa vertaansa vailla olevan tarkkuuden perinteisiin kirjastoihin verrattuna. Sen tuki paikalliselle ja etäkäsittelylle, rinnakkaiselle suoritukselle ja kuormantasaukselle tekee siitä erinomaisen valinnan yritystason järjestelmiin.

Previous Next

Aloittaminen documents4j:n kanssa

Suositeltu tapa asentaa documents4j on Maven‑varaston kautta. Voit helposti käyttää documents4j‑kirjastoa suoraan Maven‑projekteissasi yksinkertaisilla asetuksilla.

Maven‑varasto documents4j:lle


// 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>

Asenna documents4j GitHubista


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

Sanan Word muuntaminen PDF:ksi Java‑kirjaston avulla

documents4j:n ytimessä on tyylikkäästi suunniteltu fluent‑API, joka tekee asiakirjamuunnoista luonnollisia ja luettavia. IConverter‑rajapinta tarjoaa rakenne‑tyylisen ketjun, jonka avulla voit määrittää lähdetiedoston tai -virran, ilmoittaa sisään‑ ja ulostulosien tyypit, asettaa muunnosprioriteetin ja valita synkronisen tai asynkronisen suorituksen — kaikki yhdessä selkeässä lauseessa. API piilottaa kaikki toteutustiedot, joten liiketoimintalogiikkasi ei koskaan tarvitse tietää, onko paikallinen vai etämuunnin käytössä. Tässä on yksinkertainen esimerkki, joka näyttää, miten muunnosprosessi toteutetaan.

Kuinka muuntaa Word PDF:ksi Java‑kirjaston avulla?

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

Etämuunnin REST‑API‑palvelimella

Kaikilla Java‑sovelluspalvelimilla ei ole MS Officea asennettuna — eikä niiden pitäisikaan olla. documents4j ratkaisee tämän sisäänrakennetulla etämuunninarkkitehtuurilla. Erillinen muunninp Palvelin (joka sisäisesti käyttää LocalConverteria) ajetaan omalla Windows‑koneella, jossa on MS Office asennettuna, ja se tarjoaa REST‑API:n. Java‑sovelluksesi käyttää RemoteConverteria, joka lähettää asiakirjat HTTP:n kautta ja vastaanottaa muunnetun tiedoston takaisin. Koko kädenpuristus on näkymätön sovelluskoodille; samaa IConverter‑rajapintaa käytetään kummallakin puolella.

Kuinka suorittaa etä Word‑asiakirjojen muunnos Java‑sovelluksessa?

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-salaus ja perusautentikointi

Tuotantoympäristöissä asiakirjatiedostot sisältävät usein arkaluonteista liiketoiminta-, oikeudellista tai henkilökohtaista dataa. Niiden siirtäminen pelkän HTTP:n kautta on vakava turvallisuusriski. documents4j‑kirjasto ratkaisee tämän tarjoamalla sisäänrakennetun SSL/TLS‑salaustuen muunnosasiakkaan ja -palvelimen välillä, konfiguroitavissa Java:n standardi‑SSLContext‑menetelmällä. Itsensä palvelin tukee myös HTTP‑perustavaa autentikointia, jotta vain valtuutetut asiakkaat voivat lähettää muunnospyyntöjä. Molemmat turvallisuusominaisuudet voidaan ottaa käyttöön minimaalisilla asetuksilla, mikä tekee documents4j:stä käyttökelpoisen ratkaisun myös säädellyillä aloilla.

Asynkroninen ja priorisoitu käsittely

Muunnokset voivat olla resurssivaativia. documents4j mahdollistaa muunnosten ajoittamisen taustalle (asynkronisesti) käyttämällä Future -paluuarvoa. Lisäksi se tukee priorisointimekanismia. Jos sovelluksesi käsittelee suurta määrää pyyntöjä, voit antaa korkeamman prioriteetin kriittisille asiakirjoille, jotta ne siirretään sisäisen työjonon etusijalle.

 Suomen