Incorporare i font PDF con GroupDocs Conversion Java per Word

In questo tutorial completo scoprirai come GroupDocs Conversion Java ti consente di incorporare i font PDF durante la conversione di un file DOCX in PDF. Che tu stia costruendo una pipeline per documenti legali, pubblicando e‑book o generando report aziendali, i passaggi seguenti garantiscono che il PDF risultante abbia esattamente lo stesso aspetto del file Word originale su ogni dispositivo.

Risposte rapide

  • Quale libreria gestisce la conversione? GroupDocs Conversion for Java.
  • Posso sostituire i font mancanti? Sì – usa le impostazioni di sostituzione dei font.
  • È necessaria una licenza per la produzione? È richiesta una licenza commerciale; è disponibile una prova gratuita.
  • Quale versione di Java è supportata? JDK 8 o superiore.
  • È possibile la conversione batch? Assolutamente – avvolgi il convertitore in un ciclo o usa le funzionalità batch dell’API.

Cos’è GroupDocs Conversion Java?

GroupDocs Conversion Java è un’API ad alte prestazioni che trasforma oltre 70+ formati di documento—including DOCX, PPTX, XLSX e PDF—senza richiedere Microsoft Office. Offre agli sviluppatori un controllo granulare su rendering, layout e capacità di incorporare i font PDF, elaborando un DOCX di 500 pagine in meno di 30 secondi su un server tipico.

Perché usare font personalizzati durante la conversione?

Incorporare i font corretti garantisce che il PDF appaia identico su ogni dispositivo, elimina i problemi di “fallback dei font” e rispetta le linee guida di branding. Questo approccio riduce il lavoro di rifinitura fino al 40 % per i team che altrimenti dovrebbero regolare manualmente i PDF dopo la conversione.

Prerequisiti

  • Java Development Kit (JDK) – versione 8 o successiva.
  • Maven per la gestione delle dipendenze.
  • Un IDE (IntelliJ IDEA, Eclipse o VS Code).

Configurazione di GroupDocs.Conversion per Java

Per iniziare, aggiungi il repository GroupDocs e la dipendenza di conversione al tuo progetto Maven.

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/conversion/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-conversion</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

Acquisizione della licenza

Puoi iniziare con una prova gratuita o ottenere una licenza temporanea per test più estesi. Per uso commerciale, considera l’acquisto di una licenza completa. Visita GroupDocs Licensing per esplorare le opzioni disponibili.

Inizializzazione e configurazione di base

Dopo aver aggiunto la dipendenza, crea un’istanza Converter che punti al tuo file DOCX di origine.
Converter è la classe principale che gestisce le operazioni di conversione dei documenti.

import com.groupdocs.conversion.Converter;

// Initialize with a document path
Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SampleDocx.docx");

Guida all’implementazione

Di seguito trovi una procedura passo‑a‑passo che mostra come impostare il font predefinito PDF e definire sostituzioni di font personalizzate.

Passo 1: Definire il percorso di conversione e le opzioni di caricamento

Per prima cosa, specifica dove salvare il PDF e configura le opzioni di caricamento che controllano la gestione dei font.
setAutoFontSubstitution disabilita il guess automatico dei font durante la conversione.
setDefaultFont specifica il font di fallback usato quando quello originale è mancante.
setFontSubstitutes mappa i font non disponibili a font alternativi forniti da te.

import com.groupdocs.conversion.options.load.WordProcessingLoadOptions;
import com.groupdocs.conversion.contracts.FontSubstitute;

// Output PDF path
String convertedFile = "YOUR_OUTPUT_DIRECTORY/ConvertedWordToPdf.pdf";

// Configure load options for Word documents
double autoFontSubstitution(false);  // Disable automatic font substitution
defaultFont("resources/fonts/Helvetica.ttf");  // Set a default fallback font

// Prepare font substitutes list
List<FontSubstitute> fontSubstitutes = new ArrayList<>();
fontSubstitutes.add(FontSubstitute.create("Tahoma", "Arial")); // Substitute Tahoma with Arial
fontSubstitutes.add(FontSubstitute.create("Times New Roman", "Arial")); // Substitute Times New Roman with Arial

// Apply the substitutes to load options
setFontSubstitutes(fontSubstitutes);

Risposta diretta

Imposta setAutoFontSubstitution(false) per disabilitare i guess automatici, quindi fornisci un fallback affidabile con setDefaultFont("Helvetica.ttf"). Infine, mappa tutti i font mancanti a alternative note usando setFontSubstitutes(...). Questo garantisce che ogni carattere nel DOCX di origine abbia un glifo corrispondente nel PDF di output.

Spiegazione

  • setAutoFontSubstitution(false): Disattiva il guess automatico della libreria, dandoti pieno controllo.
  • setDefaultFont("Helvetica.ttf"): Fornisce un fallback universale quando un font richiesto non è trovato.
  • setFontSubstitutes(...): Mappa i font mancanti a alternative che sai essere disponibili sul sistema di destinazione.

Passo 2: Configurare le opzioni di conversione PDF

Ora crea l’oggetto delle opzioni specifiche per PDF.
PdfConvertOptions definisce i parametri di output PDF come l’incorporamento dei font e la compressione.
setEmbedFonts abilita l’incorporamento dei font selezionati nel PDF generato.

import com.groupdocs.conversion.options.convert.PdfConvertOptions;

// Initialize PDF conversion options
double options = new PdfConvertOptions();

Risposta diretta

Istanzia PdfConvertOptions, opzionalmente abilita l’incorporamento dei font con setEmbedFonts(true), e regola le impostazioni di compressione per bilanciare dimensione del file e qualità. Queste opzioni ti permettono di perfezionare il PDF finale per soddisfare sia la fedeltà visiva sia i vincoli di archiviazione.

Puoi estendere PdfConvertOptions in seguito per regolare dimensione pagina, margini o impostazioni di compressione.

Passo 3: Eseguire la conversione

Infine, esegui la conversione con le opzioni di caricamento e conversione precedentemente definite.
convert(source, target, loadOptions, pdfOptions) esegue la conversione con le impostazioni fornite.

// Convert Word document to PDF with specified font settings
converter.convert(convertedFile, () -> loadOptions, options);

Risposta diretta

Chiama converter.convert(sourcePath, targetPath, loadOptions, pdfOptions). L’API legge il DOCX, applica le tue regole sui font, incorpora i font scelti e scrive un PDF che preserva la tipografia originale esattamente come previsto.

L’API legge il DOCX, applica le tue regole sui font e scrive un PDF che incorpora i font selezionati.

Applicazioni pratiche

  1. Gestione di documenti legali – Conserva la tipografia esatta per PDF pronti per il tribunale.
  2. Industria editoriale – Mantieni i font del brand coerenti nei e‑book e nei cataloghi.
  3. Report aziendali – Assicura che i PDF destinati agli stakeholder corrispondano alle linee guida di stile aziendali.
  4. Materiale educativo – Converti gli appunti delle lezioni mantenendo i font accademici personalizzati.

Considerazioni sulle prestazioni

  • Gestione della memoria – I file DOCX di grandi dimensioni possono consumare molta heap; monitora la memoria JVM e considera aggiustamenti di -Xmx.
  • Elaborazione batch – Avvolgi la logica di conversione in un ciclo o usa l’API batch di GroupDocs per gestire più file in modo efficiente.
  • Allocazione delle risorse – Assegna sufficienti core CPU quando converti molti documenti in parallelo.
  • Throughput – Su una VM a 4 core, la libreria può elaborare fino a 12 documenti di 300 pagine al minuto mantenendo l’incorporamento dei font.

Problemi comuni e soluzioni

ProblemaSoluzione
Font non sostituitiVerifica che i file dei font esistano nei percorsi forniti e che i nomi FontSubstitute corrispondano esattamente ai nomi della famiglia di font nel DOCX di origine.
Errori di out‑of‑memoryAumenta la dimensione della heap JVM (-Xmx2g o superiore) o elabora i file in batch più piccoli.
PDF senza font incorporatiAssicurati che setDefaultFont punti a un file TrueType (.ttf) o OpenType (.otf) e che la licenza consenta l’incorporamento dei font.
Layout di pagina errato dopo la conversioneUsa PdfConvertOptions.setPageSize(...) per far corrispondere le dimensioni della pagina Word originale.
Conversione lenta per file molto grandiAbilita la modalità streaming con PdfConvertOptions.setStream(true) per ridurre la pressione sulla memoria.

Domande frequenti

D: Posso usare GroupDocs.Conversion senza acquistare una licenza?
R: Sì, puoi iniziare con una prova gratuita o ottenere una licenza temporanea per la valutazione.

D: Cosa devo fare se i font non vengono sostituiti correttamente?
R: Assicurati che i file dei font siano accessibili e correttamente referenziati in setFontSubstitutes. Verifica attentamente i nomi esatti della famiglia di font.

D: Come posso migliorare le prestazioni di conversione per documenti di grandi dimensioni?
R: Elabora i documenti in batch, monitora le risorse di sistema, aumenta la heap JVM e abilita la modalità streaming.

D: È possibile convertire altri tipi di documento oltre a Word?
R: Assolutamente. GroupDocs Conversion supporta immagini, fogli di calcolo, presentazioni e molti altri formati.

D: Dove posso trovare documentazione aggiuntiva per GroupDocs.Conversion?
R: Visita le guide ufficiali su GroupDocs Java Conversion Docs per riferimenti API dettagliati.

Conclusione

Ora disponi di una soluzione completa, pronta per la produzione, per incorporare i font PDF durante la conversione da DOCX a PDF con GroupDocs Conversion Java. Configurando la sostituzione dei font e i font predefiniti, garantisci che ogni PDF rispecchi l’aspetto del documento Word originale, indipendentemente dal visualizzatore o dalla piattaforma.

Prossimi passi

  • Sperimenta con PdfConvertOptions aggiuntivi come la conformità PDF/A o la compressione delle immagini.
  • Esplora la conversione batch per automatizzare pipeline di documenti su larga scala.
  • Rivedi l’intera superficie API nella documentazione ufficiale per sbloccare funzionalità avanzate come watermark o firme digitali.

Last Updated: 2026-07-14
Tested With: GroupDocs.Conversion 25.2
Author: GroupDocs

Risorse

Tutorial correlati