Сохранить HTML-документ – Java

После работы с файлом HTML или создания документа HTML с нуля вы можете сохранить изменения, используя один из методов HTMLDocument.save(). Библиотека Java предоставляет классы SaveOptions и ResourceHandlingOptions, которые позволяют задавать параметры для операций сохранения.

В библиотеке Aspose.HTML for Java есть две разные концепции создания выходных файлов:

• Первая концепция основана на создании HTML-подобных файлов в качестве вывода – файлов HTML, MHTML, Markdown и SVG. SaveOptions – это базовый класс для этого подхода, который помогает обрабатывать процесс сохранения связанных ресурсов, таких как сценарии, стили, изображения и т. д.
• Вторая концепция может быть использована для визуального представления HTML в результате. Базовым классом для этой концепции является RenderingOptions; он имеет специализированные методы для указания размера страницы, полей страницы, разрешения, пользовательских стилей и т. д.

В этой статье описывается только то, как использовать класс SaveOptions и методы save() для сохранения HTML-документов. Чтобы узнать больше о механизме рендеринга, обратитесь к статье Конвертеры тонкой настройки.

Сохранить HTML

После внесения изменений в HTML вы можете сохранить документ используя один из методов HTMLDocument.save(). Следующий пример – самый простой способ сохранить HTML-файл:

// Initialize an empty HTML document
HTMLDocument document = new HTMLDocument();

// Create a text node and add it to the document
Text text = document.createTextNode("Hello World!");
document.getBody().appendChild(text);

// Save the HTML document to the file on a disk
document.save($o("save-to-file.html"));

Пример выше довольно прост. Однако в реальных приложениях часто требуется дополнительный контроль над процессом сохранения. Следующие несколько разделов описывают, как использовать параметры обработки ресурсов или сохранять документ в различных форматах.

Сохранить HTML в файл

В следующем фрагменте кода показано, как использовать ResourceHandlingOptions для управления связанными документами. В примере мы создаем простой HTML-файл с нуля со связанным документом с именем «linked.html».

Чтобы применить параметры сохранения, мы используем конструктор HTMLSaveOptions() для создания экземпляра класса HTMLSaveOptions. Затем с помощью метода getResourceHandlingOptions() мы устанавливаем максимальную глубину обработки связанных ресурсов в параметрах сохранения на 1. Это означает, что сохранение HTML-документа будет включать в себя основной документ и любые напрямую связанные ресурсы до глубины 1. И, наконец, мы вызываем метод save(path, options) объекта документа вместе с указанными параметрами сохранения.

// Prepare a simple HTML file with a linked document
java.nio.file.Files.write(
        java.nio.file.Paths.get($o("save-with-linked-file.html")),
        "<p>Hello World!</p><a href='linked.html'>linked file</a>".getBytes());

// Prepare a simple linked HTML file
java.nio.file.Files.write(java.nio.file.Paths.get(
        $o("linked.html")),
        "<p>Hello linked file!</p>".getBytes());

// Load the "save-with-linked-file.html" into memory
HTMLDocument document = new HTMLDocument($o("save-with-linked-file.html"));

// Create a save options instance
HTMLSaveOptions options = new HTMLSaveOptions();

// The following line with value '0' cuts off all other linked HTML-files while saving this instance
// If you remove this line or change value to the '1', the 'linked.html' file will be saved as well to the output folder
options.getResourceHandlingOptions().setMaxHandlingDepth(1);

// Save the document with the save options
document.save($o("save-with-linked-file_out.html"), options);

Сохранить HTML в MHTML

В некоторых случаях вам нужно сохранить HTML документ в виде одного файла MHTML. Документ MHTML может быть очень полезен для этой цели, поскольку он представляет собой архив веб-страницы и хранит все внутри себя. HTMLSaveFormat указывает формат, в котором документ сохраняется, это могут быть форматы HTML, MHTML и MD. В приведенном ниже примере показано, как использовать метод save(path, saveFormat) для сохранения HTML в MHTML.

// Prepare a simple HTML file with a linked document
java.nio.file.Files.write(
        java.nio.file.Paths.get($o("document.html")),
        "<p>Hello World!</p><a href='linked-file.html'>linked file</a>".getBytes());

// Prepare a simple linked HTML file
java.nio.file.Files.write(
        java.nio.file.Paths.get($o("linked-file.html")),
        "<p>Hello linked file!</p>".getBytes());

// Load the "document.html" into memory
HTMLDocument document = new HTMLDocument($o("document.html"));

// Save the document to MHTML format
document.save($o("save-to-MTHML.mht"), HTMLSaveFormat.MHTML);

Как и для примера Сохранить HTML в файл, вы можете использовать MHTMLSaveOptions и настроить необходимые параметры обработки связанных ресурсов при сохранении.

Сохранить HTML в Markdown

Markdown – это язык разметки с простым текстовым синтаксисом. Чтобы сохранить HTML как файлы Markdown, взгляните на следующий пример:

// Prepare HTML code
String html_code = "<H2>Hello World!</H2>";

// Initialize a document from the string variable
HTMLDocument document = new HTMLDocument(html_code);

// Save the document as a Markdown file
document.save($o("save-to-MD.md"), HTMLSaveFormat.Markdown);

Aspose.HTML for Java, в дополнение к функции сохранения HTML в Markdown, также предлагает конвертер HTML в Markdown. Дополнительные сведения об использовании конвертера вы найдете в статье HTML to Markdown.

Сохранить SVG

Обычно вы можете видеть документ SVG как часть файла HTML; он представляет векторные данные на странице: изображения, значки, таблицы и т. д. Однако SVG также можно извлечь из веб-страницы, и вы можете манипулировать им так же, как документом HTML. Поскольку SVGDocument и HTMLDocument основаны на одном и том же стандарте WHATWG DOM, все операции, такие как загрузка, чтение, редактирование, преобразование и сохранение, аналогичны для обоих документов. Итак, все примеры, в которых вы видите манипуляции с HTMLDocument, применимы и к SVGDocument.

Чтобы сохранить изменения в SVG, используйте следующее:

// Prepare SVG code
String code = "<svg xmlns='http://www.w3.org/2000/svg' height='200' width='300'>" +
        "<g fill='none' stroke-width= '10' stroke-dasharray='30 10'>" +
        "<path stroke='red' d='M 25 40 l 215 0' />" +
        "<path stroke='black' d='M 35 80 l 215 0' />" +
        "<path stroke='blue' d='M 45 120 l 215 0' />" +
        "</g>" +
        "</svg>";

// Initialize an SVG instance from the content string
SVGDocument document = new SVGDocument(code, ".");

// Save the SVG file to a disk
document.save($o($o("save-to-SVG.svg")));

Заключение

1. Пакет aspose.html.Saving позволяет разработчикам настраивать и оптимизировать процесс сохранения документов HTML и SVG с помощью расширенных параметров, таких как SaveOptions и ResourceHandlingOptions. Используя эти классы, вы можете эффективно управлять связанными ресурсами, выбирать определенные форматы вывода и настраивать процесс сохранения в соответствии с потребностями вашего приложения.
2. Aspose.HTML for Java позволяет сохранять документы HTML в различных форматах, включая HTML, MHTML и Markdown, обеспечивая точный контроль и простоту.
3. Примеры в этой статье демонстрируют простоту и мощь операций сохранения. Ознакомьтесь со статьей [Fine-Tuning Converters]( Fine-Tuning Converters), чтобы подробнее изучить параметры рендеринга и другие расширенные функции.

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