1. Προϊόντα
  2.   Επεξεργασίας κειμένου
  3.   Java
  4.   documents4j
 
  

Δωρεάν Java API για τη μετατροπή υψηλής ποιότητας εγγράφου Word σε PDF

Μία κορυφαία βιβλιοθήκη ανοιχτής πηγής επιτρέπει στους προγραμματιστές Java να μεταφέρουν αρχεία MS Office DOCX, XLSX και PDF με υψηλή ακρίβεια χρησιμοποιώντας εγγενείς εφαρμογές.

Τι είναι το Documents4j ;

Το documents4j είναι μια ισχυρή ανοιχτού κώδικα βιβλιοθήκη Java σχεδιασμένη για τη μετατροπή εγγράφων μεταξύ διαφορετικών μορφών, όπως DOCX σε PDF ή XLSX σε PDF. Σε αντίθεση με πολλές παραδοσιακές βιβλιοθήκες, το documents4j εκχωρεί τη διαδικασία μετατροπής σε εγγενείς εφαρμογές όπως το Microsoft Word και το Excel, εξασφαλίζοντας υψηλής ποιότητας αποτέλεσμα με ελάχιστα προβλήματα διαμόρφωσης. Η βιβλιοθήκη ακολουθεί διαφορετική προσέγγιση. Αντί να επανασχεδιάζει τη λογική της μετατροπής, λειτουργεί ως γέφυρα, εκχωρώντας τη βαριά δουλειά σε εγγενείς εφαρμογές (όπως το Microsoft Word ή το Excel) που ήδη κατανοούν τέλεια αυτές τις μορφές. Αυτό εγγυάται ότι το τελικό έγγραφο—όπως ένα PDF που δημιουργείται από ένα αρχείο Word—φαίνεται ακριβώς όπως θα ήταν αν κάνετε κλικ στο "Save As" χειροκίνητα στο MS Office.

Η κύρια αξία του documents4j βρίσκεται στην ακρίβειά του. Για επιχειρήσεις που απαιτούν έγγραφα επαγγελματικού επιπέδου όπου κάθε περιθώριο και γραμματοσειρά πρέπει να παραμείνουν αμετάβλητα, η εξάρτηση από ανοιχτού κώδικα αναλυτές μπορεί να είναι επικίνδυνη. Το documents4j είναι ιδιαίτερα χρήσιμο για τη δημιουργία τιμολογίων ή αναφορών από πρότυπα, την αυτοματοποίηση ροών εργασίας εγγράφων σε περιβάλλον Windows και την αποσύνδεση της λογικής μετατροπής από την κύρια εφαρμογή μέσω μιας απομακρυσμένης διαμόρφωσης διακομιστή. Εκμεταλλευόμενος τις εγγενείς εφαρμογές, εξασφαλίζει ασύγκριτη ακρίβεια σε σύγκριση με τις παραδοσιακές βιβλιοθήκες. Η υποστήριξή του για τοπική και απομακρυσμένη επεξεργασία, την ταυτόχρονη εκτέλεση και την εξισορρόπηση φόρτου το καθιστούν ιδιαίτερα κατάλληλο για επιχειρησιακά συστήματα.

Previous Next

Ξεκινώντας με το documents4j

Η προτεινόμενη μέθοδος για την εγκατάσταση του documents4j είναι μέσω αποθετηρίου Maven. Μπορείτε εύκολα να ενσωματώσετε τη βιβλιοθήκη documents4j απευθείας στα Maven έργα σας με απλές ρυθμίσεις.

Αποθετήριο Maven για το 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>

Εγκατάσταση documents4j από GitHub


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

Μετατρέποντας Word σε PDF μέσω Java βιβλιοθήκης

Στην καρδιά του documents4j βρίσκεται ένα κομψά σχεδιασμένο fluent API που κάνει τη μετατροπή εγγράφων να φαίνεται φυσική και εύκολα κατανοητή. Η διεπαφή IConverter παρέχει μια αλυσίδα τύπου builder που σας επιτρέπει να καθορίσετε το αρχείο ή τη ροή προέλευσης, να δηλώσετε τύπους εισόδου και εξόδου εγγράφου, να ορίσετε προτεραιότητα μετατροπής και να επιλέξετε μεταξύ συγχρονικής ή ασύγχρονης εκτέλεσης — όλα σε μία καθαρή έκφραση. Το API αποκρύπτει κάθε λεπτομέρεια υλοποίησης, ώστε η επιχειρησιακή λογική σας να μην χρειάζεται ποτέ να γνωρίζει αν εκτελείται τοπικός ή απομακρυσμένος μετατροπέας κάτω από το καπό. Ακολουθεί ένα απλό παράδειγμα που δείχνει πώς να επιτύχετε τη διαδικασία μετατροπής.

Πώς να μετατρέψετε Word σε PDF μέσω Java βιβλιοθήκης;

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

Απομακρυσμένος Μετατροπέας με REST API Server

Δεν κάθε διακομιστής εφαρμογών Java διαθέτει εγκατεστημένο το MS Office — και δεν πρέπει να το κάνει. Το documents4j επιλύει αυτό με μια ενσωματωμένη αρχιτεκτονική Remote Converter. Ένας αυτόνομος διακομιστής μετατροπής (που εσωτερικά χρησιμοποιεί LocalConverter) λειτουργεί σε ξεχωριστό μηχάνημα Windows με εγκατεστημένο το MS Office και εκθέτει ένα REST API. Η Java εφαρμογή σας χρησιμοποιεί έναν RemoteConverter που στέλνει έγγραφα μέσω HTTP και λαμβάνει το μετατρεπόμενο αρχείο πίσω. Ολόκληρη η διαδικασία χειραψίας είναι αόρατη στον κώδικα της εφαρμογής· η ίδια διεπαφή IConverter χρησιμοποιείται και στις δύο πλευρές.

Πώς να εκτελέσετε απομακρυσμένη μετατροπή εγγράφων Word σε Java εφαρμογές;

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 και Βασική Πιστοποίηση

Σε παραγωγικά περιβάλλοντα, τα αρχεία εγγράφων συχνά περιέχουν ευαίσθητα επιχειρησιακά, νομικά ή προσωπικά δεδομένα. Η μετάδοσή τους μέσω απλού HTTP αποτελεί σοβαρό κίνδυνο ασφαλείας. Η βιβλιοθήκη documents4j αντιμετωπίζει αυτό το ζήτημα με ενσωματωμένη υποστήριξη κρυπτογράφησης SSL/TLS μεταξύ του πελάτη και του διακομιστή μετατροπής, ρυθμιζόμενη μέσω του τυπικού Java SSLContext. Ο αυτόνομος διακομιστής υποστηρίζει επίσης HTTP Basic Authentication για να εξασφαλίσει ότι μόνο εξουσιοδοτημένοι πελάτες μπορούν να υποβάλουν αιτήματα μετατροπής. Και τα δύο χαρακτηριστικά ασφαλείας μπορούν να ενεργοποιηθούν με ελάχιστη διαμόρφωση, καθιστώντας το documents4j μια βιώσιμη λύση ακόμη και σε ρυθμιζόμενους κλάδους.

Ασύγχρονη και Προτεραιοποιημένη Επεξεργασία

Οι μετατροπές μπορεί να απαιτούν πολλούς πόρους. Το documents4j σας επιτρέπει να προγραμματίζετε τις μετατροπές να εκτελούνται στο παρασκήνιο (ασύγχρονα) χρησιμοποιώντας τύπο επιστροφής Future. Επιπλέον, υποστηρίζει μηχανισμό προτεραιοποίησης. Εάν η εφαρμογή σας διαχειρίζεται μεγάλο όγκο αιτήσεων, μπορείτε να εκχωρήσετε υψηλότερη προτεραιότητα σε κρίσιμα έγγραφα ώστε να μετακινούνται στην αρχή της εσωτερικής ουράς εργασιών.

 Ελληνικά