Конвертировать HTML в PDF на Java

Файлы PDF имеют много преимуществ по сравнению с другими форматами, и иногда вам может потребоваться преобразовать HTML в PDF. Это особенно полезно для создания высококачественных, удобных для печати версий веб-страниц, создания отчетов или обмена документами, которые трудно редактировать или модифицировать.

Возможность простого и надежного преобразования HTML-документов в другие форматы является одной из основных особенностей Aspose.HTML for Java. В этой статье вы найдете информацию о том, как конвертировать HTML в PDF с помощью методов convertHTML() Converter и как применять PdfSaveOptions и ICreateStreamProvider.

HTML в PDF одной строкой кода Java

Преобразование HTML в PDF – очень востребованная функция, и Aspose.HTML for Java предлагает простое решение. С помощью статических методов класса Converter вы можете преобразовать документ HTML в файл PDF всего одной строкой кода!

// Invoke the ConvertHTML method to convert the HTML to PDF.
Converter.convertHTML("<h1>Convert HTML to PDF!</h1>", ".", new PdfSaveOptions(), $o("convert-with-single-line.pdf"));

В примере мы используем метод convertHTML(content, baseUri, options, outputPath) класса Converter, который принимает четыре параметра: строку с HTML-кодом, который нужно преобразовать, базовую папку для входного HTML-файла, экземпляр класса PdfSaveOptions, и путь к выходному файлу, где будет сохранен преобразованный файл.

Конвертировать HTML в PDF на Java

Давайте рассмотрим пошаговые инструкции для простого сценария преобразования HTML в PDF:

1. Загрузите файл HTML с помощью одного из конструкторов HTMLDocument() класса HTMLDocument. Вы можете загрузить HTML из файла, HTML-кода, потока или URL-адреса (см. статью Создание HTML-документа). В примере мы используем конструктор HTMLDocument(адрес), который инициализирует HTML-документ из файла.
2. Создайте новый объект PdfSaveOptions. Используйте пустой конструктор PdfSaveOptions() для преобразования с параметрами сохранения по умолчанию.
3. Используйте метод сonvertHTML(document, options, outputPath) класса Converter, чтобы сохранить HTML как PDF-файл.

Просмотрите следующий фрагмент кода Java, в котором показан процесс преобразования HTML в PDF с пошаговыми инструкциями:

// Prepare an HTML code and save it to the file.
String code = "<span>Hello World!!</span>";
try (java.io.FileWriter fileWriter = new java.io.FileWriter($o("document.html"))) {
    fileWriter.write(code);
}

// Initialize an HTML document from the file
HTMLDocument document = new HTMLDocument($i("spring.html"));

// Initialize PdfSaveOptions
PdfSaveOptions options = new PdfSaveOptions();

// Convert HTML to PDF
Converter.convertHTML(document, options, $o("spring-output.pdf"));

Параметры сохранения

Aspose.HTML for Java позволяет конвертировать HTML в PDF, используя стандартные или пользовательские параметры сохранения. PdfSaveOptions позволяет настроить процесс рендеринга. Вы можете указать размер страницы, поля, права доступа к файлу, MediaType и т. д.

Metod	Description
setJpegQuality(value)	Specifies the quality of JPEG compression for images. The default value is 95.
getCss()	Gets a CssOptions object which is used for configuration of CSS properties processing.
setBackgroundColor(value)	Sets the color that will fill the background of every page. By default, this property is Transparent.
setPageSetup(value)	This method sets a page setup object and uses it for configuration output page-set.
setHorizontalResolution(value)	Sets horizontal resolution for internal images, in pixels per inch. By default this property is 300 dpi.
setVerticalResolution(value)	Sets vertical resolution for output images in pixels per inch. The default value is 300 dpi.
setEncryption	This method gets or sets encryption details. If it is not set, then no encryption will be performed.

Для получения дополнительной информации о том, как настроить процесс преобразования с помощью ImageSaveOptions, вы можете обратиться к статье Fine-Tuning Converters.

Вы можете скачать полные примеры и файлы данных по адресу GitHub.

Конвертировать HTML в PDF с использованием PdfSaveOptions

С помощью Aspose.HTML for Java вы можете программно конвертировать файлы с полным контролем над широким диапазоном параметров конвертации. Выполните всего несколько шагов:

1. Загрузите файл HTML с помощью одного из конструкторов HTMLDocument() класса HTMLDocument.
2. Создайте новый объект PdfSaveOptions и укажите необходимые свойства.
3. Используйте метод сonvertHTML() класса Converter, чтобы сохранить HTML в виде файла PDF.

В следующем примере Java показано, как использовать PdfSaveOptions и создать файл PDF с пользовательским размером страницы, полями, разрешением, цветом фона и сжатием:

// Initialize an HTML document from the file
HTMLDocument document = new HTMLDocument($i("drawing.html"));

// Initialize PdfSaveOptions. Set up the page-size 500x300 pixels, margins,
// resolutions and change the background color to AliceBlue
PdfSaveOptions options = new PdfSaveOptions();
options.setHorizontalResolution(new Resolution(200, UnitType.AUTO));
options.setVerticalResolution(new Resolution(200, UnitType.AUTO));;
options.setBackgroundColor(Color.getAliceBlue());
options.setJpegQuality(100);
options.getPageSetup().setAnyPage(new Page(new Size(500, 300), new Margin(20, 10, 10, 10)));

// Convert HTML to PDF
Converter.convertHTML(document, options, $o("drawing-options.pdf"));

Конструктор PdfSaveOptions() инициализирует экземпляр класса PdfSaveOptions, который передается в convertHTML( ) метод. Метод принимает document, options, путь к выходному файлу outputPath и выполняет операцию преобразования.

Класс PdfSaveOptions предоставляет методы, которые дают вам полный контроль над широким спектром параметров и улучшают процесс преобразования HTML в формат PDF. В приведенном выше примере использовалось несколько вариантов сохранения:

• setJpegQuality() определяет качество сжатия изображений в формате JPEG.
• setBackgroundColor() устанавливает цвет, заполняющий фон.
• setHorizontalResolution() и setVerticalResolution() устанавливают разрешение по горизонтали и вертикали для выходных файлов PDF.
• setPageSetup() определяет размер страницы и поля для выходного документа.

Еще один пример Java. Здесь мы создаем HTML-документ с нуля – подготавливаем HTML-код и сохраняем его в файл. Затем мы применяем PdfSaveOptions для преобразования HTML в PDF:

// Prepare HTML code and save it to a file
String code = "<h1>  PdfSaveOptions Class</h1> " +
        "<p>Using PdfSaveOptions Class, you can programmatically " +
        "apply a wide range of conversion parameters " +
        "such as BackgroundColor, HorizontalResolution, VerticalResolution, PageSetup, etc.</p>";

FileHelper.writeAllText($o("save-options.html"), code);

// Initialize an HTML Document from the html file
HTMLDocument document = new HTMLDocument($o("save-options.html"));

// Set up the page-size, margins and change the background color to AntiqueWhite
PdfSaveOptions options = new PdfSaveOptions();
options.setBackgroundColor(Color.getAntiqueWhite());
options.getPageSetup().setAnyPage(
        new Page(
                new Size(Length.fromInches(4.9f), Length.fromInches(3.5f)),
                new Margin(30, 20, 10, 10)
        )
);

// Convert HTML to PDF
Converter.convertHTML(document, options, $o("save-options-output.pdf"));

Заключение

Преобразование HTML в PDF – полезная функция для создания высококачественных, общедоступных и удобных для печати документов. Aspose.HTML for Java предоставляет надежное решение с классом Converter, позволяющим легко преобразовывать HTML в PDF с помощью гибких методов, таких как convertHTML() и настраиваемых PdfSaveOptions.

Класс PdfSaveOptions позволяет разработчикам настраивать вывод, указывая размеры страниц, поля, разрешения, цвета фона, шифрование, параметры сжатия и т. д., обеспечивая точные и профессиональные результаты. Если вы создаете отчеты и сохраняете веб-контент в виде документов PDF, Aspose.HTML for Java упрощает процесс с минимальным количеством кода.

Aspose.HTML предлагает бесплатный онлайн Конвертер HTML в PDF, который конвертирует HTML в PDF с высоким качеством, легко и быстро. Просто загрузите, конвертируйте ваши файлы и получите результат за несколько секунд!