Come rendere le pagine con GroupDocs.Viewer per Java

Visualizzare solo sezioni particolari di un documento nella tua applicazione web può essere impegnativo. In questo tutorial scoprirai come rendere le pagine in modo efficiente, trasformandole in file HTML autonomi che possono essere incorporati direttamente nella tua interfaccia. Che tu debba mostrare un estratto di un contratto o un singolo capitolo di un libro di testo, i passaggi seguenti ti guideranno attraverso l’intero processo usando GroupDocs.Viewer per Java.

Pronto a migliorare la tua applicazione? Iniziamo assicurandoci che la tua configurazione sia corretta.

Risposte rapide

Cosa significa “render pages”? Conversione delle pagine selezionate del documento in un formato visualizzabile come HTML.
Quale formato viene generato? HTML con risorse incorporate (immagini, CSS, font).
È necessaria una licenza? Una versione di prova funziona per la valutazione; è necessaria una licenza completa per la produzione.
Posso scegliere pagine non consecutive? Sì – specifica qualsiasi numero di pagina di cui hai bisogno.
È consigliata la cache? Assolutamente, la cache dell’HTML renderizzato riduce i tempi di caricamento per le pagine frequentemente accessate.

Render Selected Pages of a Document with GroupDocs.Viewer for Java

Cosa imparerai

Impostare GroupDocs.Viewer nel tuo ambiente Java
Renderizzare pagine specifiche del documento usando l’API Viewer
Configurare le opzioni di visualizzazione HTML per una visualizzazione ottimale
Casi d’uso pratici e scenari di integrazione

Cos’è il rendering di pagine selezionate?

Il rendering di pagine selezionate significa estrarre solo le pagine che specifichi da un documento sorgente (DOCX, PDF, PPT, ecc.) e convertirle in un formato che può essere visualizzato in un browser web. Questo approccio riduce la larghezza di banda, velocizza il caricamento delle pagine e migliora l’esperienza dell’utente finale mostrando solo il contenuto rilevante.

Perché generare HTML da un documento?

Generare HTML da un documento ti fornisce una rappresentazione leggera e indipendente dalla piattaforma che funziona su tutti i browser senza la necessità di visualizzatori o plugin esterni. Incorporare le risorse direttamente nel file HTML (immagini, font, CSS) semplifica il deployment ed elimina i problemi di cross‑origin.

Prerequisiti

Assicurati che la tua configurazione di sviluppo soddisfi questi requisiti:

Librerie richieste – Includi GroupDocs.Viewer per Java (versione 25.2 o successiva) nel tuo progetto.
Ambiente – JDK 8 o superiore; IDE come IntelliJ IDEA o Eclipse.
Conoscenze – Programmazione Java di base e gestione delle dipendenze Maven.

Configurazione di GroupDocs.Viewer per Java

Installazione tramite Maven

Aggiungi il repository e la dipendenza al tuo pom.xml:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

Acquisizione della licenza

Prova gratuita – Esplora tutte le funzionalità senza costi.
Licenza temporanea – Estendi il test oltre il periodo di prova.
Acquisto completo – Necessario per le distribuzioni in produzione.

Inizializzazione e configurazione di base

import com.groupdocs.viewer.Viewer;

public class DocumentViewer {
    public static void main(String[] args) {
        try (Viewer viewer = new Viewer("path/to/your/document.docx")) {
            // Your rendering logic here
        }
    }
}

Guida all’implementazione

Renderizzare pagine specifiche come HTML con risorse incorporate

Passo 1: Configurare il percorso di output

import java.nio.file.Path;
import java.nio.file.Paths;

Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");

Spiegazione: outputDirectory è il percorso in cui verranno salvati i file HTML generati.
Denominazione: page_{0}.html crea un file separato per ogni pagina renderizzata.

Passo 2: Configurare le opzioni di visualizzazione HTML

import com.groupdocs.viewer.options.HtmlViewOptions;

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

Spiegazione: forEmbeddedResources() raggruppa immagini, CSS e font direttamente all’interno di ciascun file HTML, rimuovendo le dipendenze esterne.

Passo 3: Renderizzare le pagine desiderate

try (Viewer viewer = new Viewer("path/to/your/document.docx")) {
    viewer.view(viewOptions, 1, 3);
}

Spiegazione: Il metodo view() riceve le HtmlViewOptions e un elenco di numeri di pagina. In questo esempio, vengono renderizzate solo la prima e la terza pagina.

Suggerimenti per la risoluzione dei problemi

Verifica che la directory di output esista e che l’applicazione abbia i permessi di scrittura.
Assicurati che il percorso del documento sia corretto e che il file non sia corrotto.
Se incontri errori di licenza, conferma che un file di licenza valido sia posizionato accanto alla tua applicazione.

Applicazioni pratiche

Il rendering di pagine selezionate è utile in molti scenari:

Documenti legali – Mostra solo le clausole rilevanti di un contratto.
Piattaforme educative – Consenti agli studenti di visualizzare in anteprima capitoli specifici senza scaricare l’intero libro di testo.
Report aziendali – Fornisci agli stakeholder riepiloghi concisi mostrando le sezioni chiave del report.

Considerazioni sulle prestazioni

Gestione della memoria – Usa try‑with‑resources (come mostrato) per liberare rapidamente le risorse del Viewer.
Cache – Memorizza l’HTML renderizzato in una cache (ad esempio Redis o in‑memory) per le pagine frequentemente accessate.
Minimizzazione delle risorse – Le risorse incorporate aumentano leggermente la dimensione del file; considera la compressione dell’output HTML se la larghezza di banda è un problema.

Problemi comuni e soluzioni

Problema	Soluzione
File non trovato	Verifica nuovamente il percorso assoluto/relativo e assicurati che il file esista.
Memoria esaurita per documenti grandi	Renderizza solo le pagine necessarie, oppure aumenta la dimensione dell’heap JVM (`-Xmx`).
Immagini mancanti nell’HTML	Verifica che `forEmbeddedResources` sia utilizzato; altrimenti, le immagini vengono salvate separatamente.
Errore di licenza	Posiziona un file `GroupDocs.Viewer.lic` valido nella radice dell’applicazione o specifica il suo percorso programmaticamente.

Domande frequenti

Cos’è GroupDocs.Viewer per Java?
Una libreria che consente il rendering di oltre 90 formati di documento (PDF, DOCX, PPT, ecc.) direttamente all’interno delle applicazioni Java.
Posso renderizzare pagine PDF usando questo metodo?
Sì – l’API Viewer supporta i PDF insieme a molti altri formati.
Come gestire documenti di grandi dimensioni in modo efficiente?
Renderizza solo le pagine di cui hai bisogno e utilizza la cache per evitare elaborazioni ripetute.
Qual è il vantaggio di incorporare le risorse nei file HTML?
Crea un unico file autonomo per pagina, semplificando il deployment ed eliminando il caricamento di risorse esterne.
Dove posso trovare ulteriori informazioni su GroupDocs.Viewer per Java?
- Documentazione: GroupDocs.Viewer Documentation
- Riferimento API: API Reference Guide

Risorse

Documentazione: GroupDocs.Viewer Documentation
Riferimento API: API Reference Guide
Download: GroupDocs.Viewer Download Page
Acquisto: Buy GroupDocs.Viewer
Prova gratuita: GroupDocs Free Trial
Licenza temporanea: Get a Temporary License
Supporto: GroupDocs Support Forum

Ultimo aggiornamento: 2026-01-15
Testato con: GroupDocs.Viewer 25.2
Autore: GroupDocs