Как извлечь QR из PDF в Java с помощью GroupDocs.Parser
В современных бизнес‑процессах извлечение QR из PDF файлов может превратить узкое место ручного ввода данных в полностью автоматизированный конвейер. Независимо от того, работаете ли вы с транспортными накладными, розничными чеками или каталогами продукции, быстрое и надёжное получение информации из QR‑кодов имеет решающее значение для последующих систем. В этом руководстве мы покажем, как использовать GroupDocs.Parser for Java для чтения QR‑кодов (и других штрихкодов) из PDF и экспорта результатов в чистый XML‑файл, который может потреблять ваша ERP‑система, система учёта или аналитическая платформа.
Быстрые ответы
- Что делает GroupDocs.Parser for Java? Он читает PDF‑файлы и извлекает структурированные данные, такие как штрихкоды, таблицы и текст.
- Как извлечь QR‑коды? Настройте
BarcodeOptionsс типом QR и вызовитеparser.getBarcodes(). - Могу ли я читать QR‑коды в Java? Да — установите тип штрихкода
"QR"в параметрах. - Нужна ли лицензия? Пробная версия подходит для тестирования; для продакшна требуется коммерческая лицензия.
- Какая версия Java требуется? Рекомендуется Java 8 или новее.
Что означает «извлечение QR из PDF» в контексте обработки PDF?
Извлечение QR из PDF означает сканирование каждой страницы в поисках графики, закодированной QR, декодирование встроенных данных и возврат их в удобном для программы формате. GroupDocs.Parser абстрагирует низкоуровневый анализ изображений, позволяя сосредоточиться на бизнес‑логике, а не на работе с пикселями.
Почему стоит использовать GroupDocs.Parser для извлечения QR?
GroupDocs.Parser поддерживает более 30 форматов ввода и может обрабатывать PDF до 500 МБ без загрузки всего файла в память, обеспечивая высокую точность даже при сканировании с низким разрешением. Вы можете выбрать QualityMode.Low для скорости или QualityMode.High для максимальной точности, и тот же API работает с PDF, изображениями и документами Office, устраняя необходимость в нескольких библиотеках.
Предварительные требования
- GroupDocs.Parser for Java (версия 25.5 или новее).
- Maven или ручная загрузка JAR.
- Среда разработки Java 8+ (IntelliJ IDEA, Eclipse или любой редактор).
Настройка GroupDocs.Parser для Java
Использование Maven
Добавьте репозиторий GroupDocs и зависимость в ваш pom.xml:
<repositories>
<repository>
<id>repository.groupdocs.com</id>
<name>GroupDocs Repository</name>
<url>https://releases.groupdocs.com/parser/java/</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-parser</artifactId>
<version>25.5</version>
</dependency>
</dependencies>
<repositories>
<repository>
<id>repository.groupdocs.com</id>
<name>GroupDocs Repository</name>
<url>https://releases.groupdocs.com/parser/java/</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-parser</artifactId>
<version>25.5</version>
</dependency>
</dependencies>
Прямая загрузка
В качестве альтернативы загрузите последнюю JAR‑файл с GroupDocs.Parser for Java releases.
Шаги получения лицензии
- Free trial: 30‑дневная пробная версия с полным набором функций.
- Temporary license: Запросите временный ключ для расширенной оценки.
- Purchase: Приобретите коммерческую лицензию для продакшн‑развертываний.
Базовая инициализация и настройка
Создайте экземпляр Parser, указывающий на PDF, который вы хотите проанализировать:
Parser — основной класс в GroupDocs.Parser, представляющий документ и предоставляющий методы для извлечения содержимого, такого как текст, таблицы и штрихкоды.
import com.groupdocs.parser.Parser;
class BarcodeExtractor {
public static void main(String[] args) {
// Initialize Parser object with the path to your PDF document.
try (Parser parser = new Parser("YOUR_DOCUMENT_DIRECTORY")) {
// Additional setup and usage will follow in the next sections.
} catch (Exception e) {
e.printStackTrace();
}
}
}
Как читать QR‑коды в PDF на Java с помощью GroupDocs.Parser
Чтение QR‑кодов в PDF на Java с помощью GroupDocs.Parser включает создание экземпляра парсера, настройку параметров штрихкода для поиска QR‑типов, вызов метода извлечения штрихкодов и последующую обработку возвращённых объектов штрихкода. Процесс прост, работает на любой странице PDF и возвращает декодированные значения вместе с метаданными позиции для дальнейшей обработки.
Шаг 1: проверка поддержки штрихкода
Перед попыткой извлечения убедитесь, что формат документа поддерживает сканирование штрихкодов:
if (!parser.getFeatures().isBarcodes()) {
System.out.println("Document does not support barcode extraction.");
return; // Exit if the document does not support barcode extraction
}
Объяснение: Эта проверка предотвращает ошибки выполнения при работе с неподдерживаемыми типами файлов.
Шаг 2: настройка параметров штрихкода (чтение QR‑кодов Java)
BarcodeOptions — объект конфигурации, позволяющий указать, какие символьные наборы штрихкодов обнаруживать, установить режим качества сканирования и точно настроить параметры, такие как пороги обнаружения, обеспечивая оптимальную производительность для целевых QR‑кодов.
import com.groupdocs.parser.options.BarcodeOptions;
import com.groupdocs.parser.options.QualityMode;
BarcodeOptions options = new BarcodeOptions(QualityMode.Low, QualityMode.Low, "QR");
Объяснение: QualityMode.Low ускоряет обработку; переключитесь на High, если нужна повышенная точность. Аргумент "QR" указывает движку искать только штрихкоды типа QR.
Шаг 3: извлечение данных QR
parser.getBarcodes(options) сканирует документ с использованием предоставленных BarcodeOptions и возвращает коллекцию объектов PageBarcodeArea, каждый из которых содержит декодированное значение QR, номер страницы и точные координаты штрихкода на странице, позволяя точно обрабатывать их в последующих системах.
import com.groupdocs.parser.data.PageBarcodeArea;
import java.util.List;
Iterable<PageBarcodeArea> barcodes = parser.getBarcodes(options);
Объяснение: parser.getBarcodes возвращает итерируемую коллекцию объектов PageBarcodeArea, каждый из которых содержит декодированное значение QR и его расположение на странице.
Экспорт извлечённых данных в XML
Шаг 4: инициализация XML‑экспортера
XmlExporter — утилитный класс, преобразующий коллекцию объектов штрихкода в хорошо структурированный XML‑документ, автоматически создающий элементы для каждого штрихкода с атрибутами индекса страницы, позиции и декодированного значения, которые затем можно сохранить или передать другим системам.
import com.groupdocs.parser.export.XmlExporter;
XmlExporter exporter = new XmlExporter();
Объяснение: XmlExporter обрабатывает сериализацию объектов штрихкода в стандартный XML, готовый для интеграции с ERP‑ или системами учёта.
Шаг 5: запись XML‑файла
Сохраните извлечённую информацию QR на диск:
exporter.exportBarcodes(barcodes, "YOUR_OUTPUT_DIRECTORY/data.xml");
Объяснение: Полученный data.xml содержит один элемент <Barcode> на каждый QR‑код, с атрибутами номера страницы, координат и декодированного значения.
Практические применения
- Управление запасами: Автоматически заполнять базы данных запасов, считывая QR‑метки на входящих PDF‑накладных.
- Видимость цепочки поставок: Отслеживать посылки в реальном времени, извлекая QR‑идентификаторы, встроенные в логистические документы.
- Розничные чеки: Получать рекламную или гарантийную информацию из QR‑кодов, напечатанных на цифровых чеках.
Соображения по производительности
- Memory management: Для очень больших PDF обрабатывайте страницы потоково, а не загружайте весь файл в память.
- QualityMode selection: Используйте
Lowдля массовой обработки; переключайтесь наHigh, когда работаете с сканами низкого разрешения. - Library updates: Обновляйте GroupDocs.Parser до последней версии, чтобы воспользоваться новейшими улучшениями производительности и исправлениями ошибок.
Распространённые проблемы и устранение неполадок
| Симптом | Вероятная причина | Решение |
|---|---|---|
| Штрихкоды не возвращаются | Указан неверный тип штрихкода | Измените "QR" на соответствующий тип (например, "CODE_128"). |
| Ошибка Out‑of‑memory при больших PDF | Весь документ загружается сразу | Обрабатывайте страницы по отдельности или увеличьте размер кучи JVM (-Xmx2g). |
| Пустой XML‑файл | exportBarcodes вызван до извлечения | Убедитесь, что parser.getBarcodes(options) возвращает данные перед экспортом. |
Часто задаваемые вопросы
Q: Могу ли я извлекать штрихкоды из файлов изображений с помощью GroupDocs.Parser?
A: Да, библиотека поддерживает извлечение штрихкодов из распространённых форматов изображений (PNG, JPEG, TIFF).
Q: Какие форматы штрихкодов распознаются?
A: QR, Code 39, Code 128, DataMatrix, PDF417 и многие другие. Обратитесь к документации API для полного списка.
Q: Как обрабатывать PDF, защищённые паролем?
A: Передайте пароль в конструктор Parser: new Parser(filePath, "password").
Q: Достаточна ли пробная версия для тестирования в продакшн?
A: Пробная версия предоставляет полный набор функций, но добавляет водяной знак к извлечённым данным. Для продакшна приобретите коммерческую лицензию.
Q: Что делать, если мой PDF содержит как QR, так и линейные штрихкоды?
A: Создайте несколько экземпляров BarcodeOptions или передайте массив типов, чтобы сканировать все необходимые форматы за один проход.
Последнее обновление: 2026-10-12
Тестировано с: GroupDocs.Parser 25.5
Автор: GroupDocs
Ресурсы
- Документация GroupDocs.Parser Java
- Справочник API
- Скачать GroupDocs.Parser
- Репозиторий GitHub
- Форум бесплатной поддержки
- Заявка на временную лицензию