Jedna stránka na list: automatizujte převod tabulky do PDF v Javě

Pokud máte dost manuálního převodu tabulek do PDF, jste na správném místě. V tomto tutoriálu uvidíte, jak GroupDocs.Conversion for Java může automatizovat převod tabulek, přičemž vám poskytne detailní kontrolu—například načtením pouze potřebných řádků a vytvořením PDF výstupu jedna stránka na list. Na konci pochopíte, jak:

  • Zadat rozsahy buněk při načítání sešitu
  • Nastavit konvertor tak, aby každý list byl jednou PDF stránkou
  • Nastavit svůj Java projekt s nejnovější knihovnou GroupDocs.Conversion

Připravme si prostředí, než se ponoříme do kódu.

Rychlé odpovědi

  • Co znamená „one page per sheet“? Každý list ve zdrojovém souboru Excel je vykreslen jako jedna stránka v výsledném PDF.
  • Která knihovna provádí převod? GroupDocs.Conversion pro Javu (verze 25.2).
  • Potřebuji licenci? Bezplatná zkušební verze stačí pro hodnocení; pro produkci je vyžadována dočasná nebo zakoupená licence.
  • Mohu efektivně převádět velké tabulky? Ano—načtením pouze požadovaného rozsahu snížíte využití paměti a urychlíte proces.
  • Jaká verze Javy je vyžadována? JDK 8 nebo novější.

Co je „one page per sheet“?

One page per sheet znamená, že konvertor zkomprimuje celý obsah každého listu na jednu PDF stránku, bez ohledu na počet tiskových oblastí, které list obsahuje. To zaručuje předvídatelný počet stránek a je ideální pro zprávy nebo PDF ve stylu prezentace, kde každý list odpovídá jedné vizuální stránce.

Proč používat GroupDocs.Conversion pro Javu?

GroupDocs.Conversion pro Javu je robustní, vysoce výkonný konverzní engine. Podporuje více než 30 formátů tabulek (XLS, XLSX, CSV, ODS, atd.) a dokáže zpracovat soubory až do 500 MB aniž by načítal celý dokument do paměti, díky své streamovací architektuře. API je stručné: několik volání metod vytvoří produkční PDF, které zachovají tabulky, grafy a formátování buněk.

Požadavky

  • Java Development Kit (JDK) 8+ nainstalován
  • Maven pro správu závislostí
  • IDE, např. IntelliJ IDEA nebo Eclipse
  • Základní znalost Javy a povědomí o struktuře Maven projektu

Nastavení GroupDocs.Conversion pro Javu

Maven konfigurace

Přidejte repozitář GroupDocs a závislost pro konverzi do svého pom.xml:

pom.xml musí obsahovat položku repozitáře <groupId>com.groupdocs</groupId> a závislost <artifactId>groupdocs-conversion</artifactId>. Po uložení souboru spusťte mvn clean install pro stažení knihovny.

Kroky získání licence

  • Free trial – stáhněte si zkušební verzi pro vyzkoušení funkcí.
  • Temporary license – požádejte o dočasnou licenci pro plný přístup k funkcím během vývoje.
  • Purchase – zakupte licenci na GroupDocs website.

Po přidání závislosti můžete začít používat API:

Converter je hlavní třída, která řídí převod dokumentů. Importujte balíček com.groupdocs.conversion, vytvořte instanci Converter a zavolejte příslušné metody převodu.

Jak načíst tabulku s konkrétním rozsahem?

Načtení konkrétního rozsahu říká enginu, aby ignoroval řádky a sloupce mimo definovanou oblast, což urychlí převod a sníží spotřebu paměti.

setConvertRange konfiguruje převod tak, aby zahrnoval pouze konkrétní rozsah buněk. Metoda setConvertRange přijímá řetězec rozsahu, například “A10:C30”, a omezuje převod jen na tyto buňky. To je zvláště užitečné při práci s large Excel files kde je relevantní jen podmnožina dat pro PDF výstup.

Jak převést tabulku do PDF s jednou stránkou na list?

setOnePagePerSheet vynutí, aby byl každý list vykreslen na jedné PDF stránce. Nastavte volbu setOnePagePerSheet(true) v objektu nastavení převodu. Tento příznak nutí konvertor vykreslit každý list na jednu PDF stránku, bez ohledu na původní rozvržení tisku. Když se převod spustí, engine projde všechny listy v sešitu, aplikuje filtr rozsahu (pokud je) a zapíše každý list na vlastní stránku ve finálním PDF dokumentu.

Praktické aplikace

ScénářJak funkce pomáhají
Finanční výkaznictvíNačtěte pouze řádky obsahující čtvrtletní čísla a vytvořte čistý PDF výstup jedna stránka na list pro každé oddělení.
Akademické publikováníPřevádějte listy s výzkumnými daty, zaměřte se na relevantní rozsah, a zajistěte, aby se každý list vytiskl na vlastní stránku pro snadné citování.
Obchodní prezentaceVytvořte PDF připravené pro prezentaci, kde každá snímek odpovídá listu, díky nastavení jedna stránka na list.

Úvahy o výkonu

  • Zúžit rozsah převodu – použijte setConvertRange k omezení řádků/sloupců.
  • Okamžitě uvolnit zdroje – zavřete streamy a nechte Converter vyjít z rozsahu po převodu.
  • Paralelní zpracování – pro dávkové úlohy spusťte převody na samostatných vláknech, aby UI zůstalo responzivní.

Často kladené otázky

Q: Jaká je minimální verze Javy požadovaná pro GroupDocs.Conversion?
A: JDK 8 nebo vyšší se doporučuje pro zajištění plné kompatibility s knihovnou.

Q: Mohu převádět více formátů tabulek najednou?
A: Ano, GroupDocs.Conversion podporuje Excel, CSV, ODS a mnoho dalších formátů v jednom volání převodu.

Q: Jak získat dočasnou licenci pro plný přístup k funkcím?
A: Požádejte o ni prostřednictvím GroupDocs website.

Q: Co když je moje tabulka příliš velká na převod v paměti?
A: Načtěte pouze potřebný rozsah pomocí setConvertRange a zvažte streamování souboru na disk během převodu.

Q: Mohu integrovat GroupDocs.Conversion s cloudovými úložišti?
A: Ano, můžete číst a zapisovat do AWS S3, Azure Blob Storage, Google Cloud Storage atd., pomocí standardních Java I/O streamů.

Zdroje

Poslední aktualizace: 2026-08-14
Testováno s: GroupDocs.Conversion 25.2 for Java
Autor: GroupDocs

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

import com.groupdocs.conversion.Converter;
// Basic initialization code here...

import com.groupdocs.conversion.options.load.SpreadsheetLoadOptions;

public class FeatureLoadSpreadsheetWithRange {
    public static void run() {
        // Create load options for specifying a range of cells
        SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
        
        // Specify the cell range (e.g., "10:30" means rows 10 to 30)
        loadOptions.setConvertRange("10:30");
    }
}

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

public class FeatureConvertToPdfWithOnePagePerSheet {
    public static void run() {
        // Initialize load options with one-page-per-sheet setting
        SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
        loadOptions.setOnePagePerSheet(true);
        
        // Initialize the Converter object with your document path and load options
        Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/sample.xlsx", () -> loadOptions);
        
        // Configure PDF conversion to produce one page per sheet
        PdfConvertOptions pdfOptions = new PdfConvertOptions();
        
        // Execute the conversion process
        converter.convert("YOUR_OUTPUT_DIRECTORY/ConvertedSpreadsheet.pdf", pdfOptions);
    }
}

Související tutoriály