Documentation – Преобразовать документ в Java

Java: Преобразовать документ в PDF из Java

Mon, 01 Jan 0001 00:00:00 +0000

Возможность легко и надежно конвертировать документы из одного формата в другой является ключевой особенностью Aspose.Words. Одним из самых популярных форматов для конвертации является PDF – формат с фиксированной компоновкой, который сохраняет первоначальный вид документа при его отображении на различных платформах. Термин “рендеринг” используется в Aspose.Words для описания процесса преобразования документа в формат файла, который разбит на страницы или имеет концепцию страниц.

Преобразовать документ Word в PDF

Преобразование из Word в PDF - довольно сложный процесс, требующий нескольких этапов расчета. Механизм верстки Aspose.Words имитирует работу механизма верстки страниц Microsoft Word, благодаря чему выходные документы PDF выглядят как можно ближе к тому, что вы можете увидеть в Microsoft Word.

С помощью Aspose.Words вы можете программно преобразовать документ из формата DOC или DOCX в формат PDF без использования Microsoft Office. В этой статье объясняется, как выполнить это преобразование.

Обратите внимание, что количество страниц в документе влияет на время преобразования.

Преобразование DOCX или DOC в PDF

Преобразование из формата документа DOC или DOCX в формат документа PDF в Aspose.Words очень просто и может быть выполнено всего с помощью двух строк кода, которые:

Загрузите ваш документ в объект Document, используя один из его конструкторов, указав имя документа с расширением его формата.
Вызовите один из методов Document.Save для объекта Document и укажите желаемый выходной формат как PDF, введя имя файла с расширением “.PDF”.

В следующем примере кода показано, как преобразовать документ из DOCX в PDF с помощью метода Save:

Вы можете скачать файл шаблона для этого примера с сайта Aspose.Words GitHub.

Иногда необходимо указать дополнительные параметры, которые могут повлиять на результат сохранения документа в виде PDF. Эти параметры можно задать с помощью класса PdfSaveOptions, содержащего свойства, которые определяют, как будет отображаться результат PDF.

Обратите внимание, что с помощью того же метода вы можете преобразовать любой документ в формате flow-layout в формат PDF.

Преобразование в другие стандарты PDF

Aspose.Words предоставляет перечисление PdfCompliance для поддержки преобразования DOC или DOCX в различные стандарты формата PDF (такие как PDF 1.7, PDF 1.5, и т.д.).

Следующий пример кода демонстрирует, как преобразовать документ в PDF 1.7, используя PdfSaveOptions с соблюдением PDF17:

Преобразование изображений в PDF

Преобразование в PDF не ограничено форматами документов Microsoft Word. Любой формат, поддерживаемый Aspose.Words, включая программно созданный, также может быть преобразован в PDF. Например, мы можем преобразовать одностраничные изображения, такие как JPEG, PNG, BMP, EMF, или WMF, а также многостраничные изображения, такие как TIFF и GIF, в PDF.

В следующем примере кода показано, как преобразовать изображения JPEG и TIFF в PDF:

Чтобы заставить этот код работать, вам нужно добавить ссылки на пакеты классов Aspose.Words, Java.awt.image и javax.imageio в ваш проект.

Уменьшить размер выходных данных PDF

При сохранении в PDF вы можете указать, хотите ли вы оптимизировать выходные данные. Для этого вам нужно установить флаг OptimizeOutput в значение true, и тогда избыточные вложенные холсты и пустые холсты будут удалены, соседние глифы с одинаковым форматированием будут объединены.

В следующем примере кода показано, как оптимизировать выходные данные:

Использование свойства OptimizeOutput может повлиять на точность отображения содержимого.

Смотрите также

Статья Визуализация для получения дополнительной информации о форматах фиксированной страницы и потокового макета
Статья Преобразование в формат фиксированной страницы для получения дополнительной информации о макете страницы
Статья Укажите параметры отображения при преобразовании в PDF для получения дополнительной информации об использовании класса PdfSaveOptions

Java: Преобразовать Word в Excel за Java

Mon, 01 Jan 0001 00:00:00 +0000

Преобразование документов из одного формата в другой является основной функцией Aspose.Words. Вы также можете конвертировать документы из любого доступного формата формат загрузки в формат XLSX.

Преобразовать документ в XLSX

Преобразование документа в формат XLSX - довольно сложный процесс. Чтобы сохранить документ в формате XLSX с помощью Aspose.Words, используйте класс XlsxSaveOptions и новый элемент Xlsx в перечислении SaveFormat. Как упоминалось выше, вы можете сохранить документ в любом формате загрузки, поддерживаемом параметрами от Aspose.Words до XLSX.

В следующем примере кода показано, как сохранить значение PDF в значение XLSX:

Document doc = new Document(getMyDir() + "Pdf Document.pdf");
doc.save(getArtifactsDir() + "BaseConversions.PdfToXlsx.xlsx");

Иногда необходимо указать дополнительные параметры, которые могут повлиять на результат сохранения документа в виде XLSX. Эти параметры можно задать с помощью класса XlsxSaveOptions, содержащего свойства, которые определяют, как будет отображаться результат XLSX.

Поиск и замена при сохранении в XLSX

Также, используя Aspose.Words, вы можете найти определенную строку или регулярное выражение в вашем документе и заменить их на подходящее вам. Затем вы также можете сохранить результат в формате XLSX.

В следующем примере кода показано, как выполнить операцию поиска и замены и сохранить результат в XLSX:

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.writeln("Ruby bought a ruby necklace.");

// We can use a "FindReplaceOptions" object to modify the find-and-replace process.
FindReplaceOptions options = new FindReplaceOptions();
// Set the "MatchCase" flag to "true" to apply case sensitivity while finding strings to replace.
// Set the "MatchCase" flag to "false" to ignore character case while searching for text to replace.
options.setMatchCase(true);

doc.getRange().replace("Ruby", "Jade", options);
doc.save(getArtifactsDir() + "BaseConversions.FindReplaceXlsx.xlsx");

Укажите уровень сжатия при сохранении в XLSX

Вы также можете указать уровень сжатия при сохранении, используя свойство CompressionLevel.

В следующем примере кода показано, как указать уровень сжатия при сохранении в формате XLSX:

Document doc = new Document(getMyDir() + "Document.docx");
XlsxSaveOptions saveOptions = new XlsxSaveOptions();
saveOptions.setCompressionLevel(CompressionLevel.MAXIMUM);

doc.save(getArtifactsDir() + "BaseConversions.CompressXlsx.xlsx", saveOptions);

Смотрите также

Раздел документации Защита или шифрование документа для получения дополнительной информации о защите и шифровании документа
Статья Найдите и замените для получения дополнительной информации о поиске и замене нужного вам контента

Java: Преобразуйте документ в HTML, MHTML или EPUB

Mon, 01 Jan 0001 00:00:00 +0000

Документы в форматах flow-layout HTML и MHTML также очень популярны и могут использоваться на любой веб-платформе. По этой причине преобразование документов в HTML и MHTML является важной функцией Aspose.Words.

EPUB (сокращение от “Электронная публикация”) - это формат, основанный на HTML, который обычно используется для распространения электронных книг. Этот формат полностью поддерживается в Aspose.Words для экспорта электронных книг, совместимых с большинством устройств для чтения.

Преобразование документа

Для простого преобразования в HTML, MHTML или EPUB используется одна из перегрузок метода Save. Вы можете сохранить документ в файл или поток и явно задать формат сохранения выходного документа или определить его из расширения имени файла.

В следующем примере показано, как преобразовать DOCX в HTML с указанием формата сохранения:

Чтобы преобразовать документ в MHTML или EPUB, используйте SaveFormat.MHTML или SaveFormat.EPUB соответственно.

Преобразование документа с информацией о возврате в оба конца

Формат HTML не поддерживает многие функции Microsoft Word, и если нам нужно восстановить модель документа, максимально приближенную к оригиналу, нам необходимо сохранить некоторую дополнительную информацию в файле HTML. Такая информация также называется “информацией о возврате”. Для этой цели Aspose.Words предоставляет возможность экспортировать информацию о поездке в оба конца при сохранении в HTML, MHTML или EPUB, используя свойство ExportRoundtripInformation. Сохранение обратной информации позволяет восстановить свойства документа, такие как вкладки, комментарии, верхние и нижние колонтитулы, при загрузке документов перечисленных форматов обратно в объект Document.

Значение по умолчанию равно true для HTML и false для MHTML и EPUB:

При значении true информация о маршруте в оба конца экспортируется в виде - aw - * CSS свойств соответствующих элементов HTML
При значении false нет информации о возврате в оба конца, которая должна быть выведена в созданные файлы

В следующем примере кода показано, как экспортировать информацию о доставке в оба конца при преобразовании документа из DOCX в HTML:

Вы можете скачать файл шаблона для этого примера с сайта Aspose.Words GitHub.

Укажите параметры сохранения при преобразовании в HTML

Aspose.Words позволяет преобразовать документ Word в HTML, используя стандартные или пользовательские параметры сохранения. Ниже описано несколько примеров пользовательских параметров сохранения.

Укажите папку для сохранения ресурсов

Используя Aspose.Words, мы можем указать физическую папку, в которую сохраняются все ресурсы, такие как изображения, шрифты и внешние CSS, при преобразовании документа в HTML. По умолчанию это пустая строка.

Указание свойства ResourceFolder - это самый простой способ указать папку, в которую должны быть записаны все ресурсы. Мы можем использовать отдельные свойства, такие как FontsFolder, которые сохраняют шрифты в указанную папку, и ImagesFolder, которые сохраняют изображения в указанную папку. Когда указан относительный путь, FontsFolder и ImagesFolder указывают на папку, в которой находится сборка кода, ResourceFolder и CssStyleSheetFileName указывают на выходную папку, в которой находится документ HTML.

В этом примере ResourceFolder указывает относительный путь. Этот путь относится к выходной папке, в которой сохранен документ HTML. Значение свойства ResourceFolderAlias используется для создания URLs для всех ресурсов.

В следующем примере кода показано, как работать с этими свойствами:

Используя свойство ResourceFolderAlias, мы также можем указать имя папки, используемой для создания URIs всех ресурсов, записанных в документ HTML. Это самый простой способ указать, как URIs должно быть сгенерировано для всех файлов ресурсов. Та же информация может быть указана для изображений и шрифтов отдельно через свойства ImagesFolderAlias и FontsFolderAlias соответственно.

Однако для CSS нет отдельного свойства. Поведение свойств FontsFolder, FontsFolderAlias, ImagesFolder, ImagesFolderAlias и CssStyleSheetFileName не изменено. Обратите внимание, что свойство CssStyleSheetFileName используется как для указания имени папки, так и для указания имени файла.

ResourceFolder имеет более низкий приоритет, чем папки, указанные с помощью FontsFolder, ImagesFolder и CssStyleSheetFileName. Если папка, указанная с помощью ResourceFolder, не существует, она будет создана автоматически.
ResourceFolderAlias имеет более низкий приоритет, чем FontsFolderAlias и ImagesFolderAlias. Если значение ResourceFolderAlias пусто, то для создания ресурса URIs будет использовано значение свойства ResourceFolder. Если для параметра ResourceFolderAlias задано значение “.” (точка), ресурс URIs будет содержать только имена файлов без указания пути.

Экспорт ресурсов шрифтов в кодировке Base64

Aspose.Words предоставляет возможность указать, должны ли ресурсы шрифта быть встроены в HTML в кодировках Base64. Для этого используйте свойство ExportFontsAsBase64 – это расширение свойства ExportFontResources. По умолчанию его значение равно false, и шрифты записываются в отдельные файлы. Но если для этого параметра установлено значение true, шрифты будут встроены в CSS документа в кодировке Base64. Свойство ExportFontsAsBase64 влияет только на формат HTML и не влияет на EPUB и MHTML.

В следующем примере кода показано, как экспортировать шрифты в кодировке Base64 в HTML:

Укажите параметры сохранения при преобразовании в EPUB

Aspose.Words позволяет преобразовать документ Word в формат EPUB, используя стандартные или пользовательские параметры сохранения. Вы можете указать несколько параметров, передав экземпляр HtmlSaveOptions методу Save.

В следующем примере кода показано, как преобразовать документ Word в EPUB с указанием некоторых пользовательских параметров сохранения:

Вы можете скачать файл шаблона для этого примера с сайта Aspose.Words GitHub.

Смотрите также

Как экспортировать информацию о поездке в оба конца при сохранении в HTML

Java: Преобразуйте документ в MHTML и отправьте его по электронной почте

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Words позволяет преобразовать любой документ в формат MHTML (веб-архив). Это позволяет удобно использовать Aspose.Words и Aspose.Email вместе. Вы можете загрузить предварительно определенный документ в любом поддерживаемом формате, например DOC, OOXML или RTF, в Aspose.Words, заполнить его данными, сохранить полученный документ как MHTML, а затем отправить его по электронной почте с помощью Aspose.Email.

В следующем примере кода показано, как преобразовать любой документ в MHTML и отправить его по электронной почте:

Java: Преобразовать документ в Markdown в Java

Mon, 01 Jan 0001 00:00:00 +0000

Markdown - популярный формат, используемый для разметки текста, который в дальнейшем преобразуется в HTML, PDF, DOCX, или другие форматы. Многие разработчики выбирают этот формат для написания документации, подготовки статей для публикации в блогах, описания проектов и так далее.

Markdown настолько популярен, потому что с этим форматом легко работать, а также его можно довольно просто преобразовать в другие форматы. По этой причине Aspose.Words предоставляет возможность конвертировать документ из любой поддерживаемый формат загрузки в Markdown и наоборот – Aspose.Words также поддерживает наиболее популярный сохранение форматов.

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

Преобразовать документ в Markdown

Чтобы преобразовать документ в формат Markdown, вам просто нужно загрузить документ в любом поддерживаемом формате или создать новый программно. Затем вам нужно сохранить документ в формате Markdown.

В следующем примере кода показано, как преобразовать DOCX в Markdown:

Укажите параметры сохранения при преобразовании в Markdown

Aspose.Words предоставляет возможность использовать класс MarkdownSaveOptions для работы с расширенными параметрами при сохранении документа в формате Markdown. В дополнение к другим наследуемым или перегружаемым свойствам, также был добавлен ряд свойств, специфичных для формата Markdown. Например, свойство TableContentAlignment для управления выравниванием содержимого в таблицах или ImageSavingCallback и ImagesFolder для управления сохранением изображений при преобразовании документа в формат Markdown.

Поддерживаемые функции Markdown

Aspose.Words в настоящее время поддерживает следующие Markdown функции, которые в основном соответствуют спецификации CommonMark в Aspose.Words API и представлены в виде соответствующих стилей или прямого форматирования:

Заголовки – это абзацы со стилями Heading 1 - Heading 6
Блок-кавычки - это абзацы с надписью “Quote” в названии стиля
IndentedCode - это абзацы с “IndentedCode” в названии стиля
FencedCode - это абзацы с “FencedCode” в названии стиля
InlineCode - это запуски с “InlineCode” в названии стиля Font
Горизонтальные правила - это абзацы с формой HorizontalRule
Жирный акцент
Выделено курсивом
StrikeThrough форматирование
Списки представляют собой пронумерованные или маркированные абзацы
Таблицы представлены с помощью класса Table
Ссылки представлены в виде класса FieldHyperlink

В следующем примере показано, как создать документ с некоторыми стилями и сохранить его в Markdown:

Результат выполнения этого примера кода показан ниже.

Полезные советы

Есть несколько нюансов и интересных кейсов, узнав которые, вы сможете работать с файлами Markdown более гибко и удобно. Например, есть возможность использовать:

SetextHeading это позволяет создавать многострочные заголовки в Markdown, в то время как обычные заголовки в Markdown могут быть только однострочными. SetextHeading основан на стиле “Заголовок N”, и его уровень может быть только 1 или 2. Если N в “товарной позиции N” больше или равно 2, то соответствующий SetextHeading основан на “Heading 2”, в противном случае - на “Heading 1”.
Различные маркеры для первого уровня маркированных списков ("-", “+” или “*”, маркер по умолчанию равен “-”.) и различные типы нумерации для упорядоченных списков ("." или “)”, маркер по умолчанию равен “.").

Java: Преобразуйте документ в изображение за Java

Mon, 01 Jan 0001 00:00:00 +0000

Иногда требуется получить изображение вместо документов в других форматах, таких как DOCX или PDF. Например, вам нужно добавить предварительный просмотр какой-либо страницы документа на свой веб-сайт или в приложение или создать “скан” документа для отправки счета. Именно тогда вам может понадобиться преобразовать документ в любом формате поддерживаемый формат загрузки в изображение, опять же, в любом формате поддерживаемый формат сохранения.

Преобразование в формат изображения

Как и во всех уже описанных примерах преобразования, вам необходимо создать новый документ или загрузить существующий в любом поддерживаемом формате, внести необходимые изменения и сохранить его в любом доступном графическом формате, например, JPEG, PNG или BMP.

В следующем примере кода показано, как преобразовать DOCX в JPEG:

Укажите параметры сохранения при преобразовании в изображение

Aspose.Words предоставляет вам класс ImageSaveOptions, который обеспечивает больший контроль над сохранением документов в различных графических форматах. Некоторые свойства этого класса наследуют или перегружают свойства базовых классов, таких как FixedPageSaveOptions или SaveOptions, но есть также параметры, специфичные для сохранения изображений.

Можно указать страницы, которые будут преобразованы в формат изображения, используя свойство PageSet. Например, его можно применить, если вам нужен предварительный просмотр только первой страницы или определенной страницы.

Также можно управлять качеством выходного изображения и форматом в пикселях, используя следующие свойства – HorizontalResolution, VerticalResolution, Resolution, Scale, PixelFormat,, а также настраивать параметры цвета изображения, используя следующие свойства – ImageBrightness, ImageColorMode, ImageContrast, PaperColor.

Существуют также свойства, которые применяются к определенному формату, например, JpegQuality или TiffCompression.

В следующем примере кода показано, как создать предварительный просмотр первой страницы документа с применением некоторых дополнительных настроек:

Java: Преобразуйте многостраничный документ в изображение за Java

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Words для Java позволяет пользователям экспортировать многостраничные документы в растровые изображения. Это может быть полезно для создания предварительных просмотров, архивов или визуальных представлений документов для использования без редактирования.

Какие форматы поддерживают многостраничный экспорт?

Aspose.Words поддерживает многостраничный экспорт в следующие форматы растровых изображений:

Jpeg
Gif
Png
Bmp
Tiff
WebP

Как экспортировать многостраничный документ в изображение

Функция экспорта многостраничного документа в изображение реализована с помощью класса MultiPageLayout - вы можете указать, как должны быть организованы страницы при сохранении в изображение:

SinglePage – сохранить только первую из указанных страниц
Grid – расположите страницы в виде сетки слева направо и сверху вниз, указав количество столбцов
Horizontal – расположите страницы горизонтально, бок о бок, слева направо, в виде единого вывода
Vertical – расположите страницы вертикально, одну под другой, в едином выводе
TiffFrames – оформить каждую страницу как отдельный кадр в многокадровом изображении TIFF, применимо только к форматам изображений TIFF

В следующем примере кода показано, как сохранить многостраничный DOCX документ в виде JPEG изображения с горизонтальным расположением:

Document doc = new Document("Rendering.docx");

ImageSaveOptions options = new ImageSaveOptions(SaveFormat.JPEG);
// Set up Horizontal layout.
options.setPageLayout = MultiPageLayout.Horizontal(10);

doc.save("ImageSaveOptions.HorizontalLayout.jpg", options);

Вы также можете настроить внешний вид страницы выходного файла – укажите BackColor, BorderColor и BorderWidth.

В следующем примере кода показано, как сохранить многостраничный DOCX документ в виде PNG изображения с разметкой сетки:

Document doc = new Document("Rendering.docx");

ImageSaveOptions options = new ImageSaveOptions(SaveFormat.PNG);
// Set up a grid layout with:
// - 3 columns per row.
// - 10pts spacing between pages (horizontal and vertical).
options.setPageLayout(MultiPageLayout.grid(3, 10f, 10f));

// Customize the background and border.
options.getPageLayout().setBackColor(Color.lightGray);
options.getPageLayout().setBorderColor(Color.BLUE);
options.getPageLayout().setBorderWidth(2f);

doc.save("ImageSaveOptions.GridLayout.png", options);

Java: Сериализовать документ в базе данных и работать с ним

Mon, 01 Jan 0001 00:00:00 +0000

Одной из задач, которые могут потребоваться при работе с документами, является хранение и извлечение объектов Document в базу данных и из нее. Например, это было бы необходимо, если бы вы внедряли систему управления контентом любого типа. Все предыдущие версии документов должны храниться в системе баз данных. Возможность хранить документы в базе данных также чрезвычайно полезна, когда ваше приложение предоставляет веб-сервис.

Aspose.Words предоставляет возможность преобразовать документ в массив байт для последующей работы с этим документом в базе данных.

Преобразование документа в массив байтов

Чтобы сохранить документ в базе данных или подготовить его к передаче через Интернет, часто необходимо сериализовать документ, чтобы получить массив байт.

Чтобы сериализовать объект Document в Aspose.Words:

Сохраните его в MemoryStream, используя перегрузку метода Save класса Document.
Вызовите метод ToArray, который возвращает массив байт, представляющий документ в байтовой форме.

Затем описанные выше шаги можно отменить, чтобы загрузить байты обратно в объект Document.

Выбранный формат сохранения важен для обеспечения максимальной точности при сохранении и повторной загрузке в объект Document. По этой причине рекомендуется использовать несколько форматов файлов OOXML.

В приведенном ниже примере показано, как сериализовать объект Document для получения массива байт, а затем как отменить сериализацию массива байт, чтобы снова получить объект Document:

Вы можете скачать файл шаблона для этого примера с сайта Aspose.Words GitHub.

Хранение, чтение и удаление документа в базе данных

В этом разделе показано, как сохранить документ в базе данных, а затем загрузить его обратно в объект Document для работы с ним. Для простоты имя файла является ключом, используемым для хранения и извлечения документов из базы данных. База данных содержит два столбца. Первый столбец “FileName” хранится в виде строки и используется для идентификации документов. Второй столбец “FileContent” хранится в виде объекта BLOB, который хранит объект документа в байтовой форме.

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

В этом примере мы используем базу данных MySQL для хранения документа Aspose.Words.

В следующем примере кода показано, как сохранить документ в базе данных, затем снова прочитать тот же документ и, наконец, удалить запись, содержащую документ, из базы данных:

Сохранение документа в базе данных

Чтобы сохранить документ в базе данных, преобразуйте его в массив байт, как описано в начале этой статьи. Затем сохраните этот массив байт в поле базы данных.

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

Укажите commandString, которое является выражением SQL, выполняющим всю работу:

Для сохранения документа в базе данных используется команда “INSERT INTO” и указывается таблица со значениями двух полей записи – FileName и FileContent. Чтобы избежать дополнительных параметров, имя файла берется из самого объекта Document. Значению поля FileContent присваиваются байты из потока памяти, который содержит двоичное представление сохраненного документа.
Оставшаяся строка кода выполняет команду, которая сохраняет документ Aspose.Words в базе данных.

Извлечение документа из базы данных

Чтобы извлечь документ из базы данных, выберите запись, содержащую данные документа в виде массива байт. Затем загрузите массив байт из записи в MemoryStream и создайте объект Document, который загрузит документ из MemoryStream.

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

Команда SQL “SELECT * FROM” используется для извлечения соответствующей записи на основе имени файла.

Удаление документа из базы данных

Чтобы удалить документ из базы данных, используйте соответствующую команду SQL без каких-либо манипуляций с объектом Document.

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