Как объединить файлы Excel в Java с помощью GroupDocs.Merger: Руководство разработчика

Управление несколькими файлами Excel может быть сложным, и знание того, как объединять excel файлов является ежедневной потребностью многих разработчиков. В этом руководстве вы узнаете, как объединять excel файлы с помощью GroupDocs.Merger для Java, от настройки библиотеки до сохранения окончательной объединённой рабочей книги. Мы также рассмотрим реальные сценарии, такие как пакетное объединение excel для финансовой отчётности и консолидация данных excel между отделами.

Быстрые ответы

  • Какая библиотека обрабатывает объединение Excel в Java? GroupDocs.Merger for Java
  • Могу ли я объединить несколько файлов xls за один шаг? Да – используйте метод join многократно
  • Нужна ли лицензия для использования в продакшене? Для коммерческих развертываний требуется действующая лицензия GroupDocs
  • Поддерживается ли пакетная обработка? Да — вы можете проходить по списку файлов и объединять их один за другим
  • Какие версии Java совместимы? Java 8+ полностью поддерживается

Что такое “how to merge excel” с GroupDocs.Merger?

GroupDocs.Merger — это мощный API, который позволяет программно объединять, разделять и манипулировать документами таблиц. Он абстрагирует низкоуровневую работу с файлами, предоставляя чистый объектно‑ориентированный способ add excel file java объектов в одну рабочую книгу.

Почему стоит использовать GroupDocs.Merger для объединения Excel?

  • Speed & Reliability: Optimized for large workbooks, reducing memory overhead. → Оптимизировано для больших рабочих книг, снижая нагрузку на память.
  • Format Flexibility: Works with XLS, XLSX and can even merge PDFs or Word files in the same workflow. → Работает с XLS, XLSX и может даже объединять PDF или Word файлы в том же рабочем процессе.
  • Enterprise‑Ready Licensing: Scales from free trial to full‑scale production. → Масштабируется от бесплатной пробной версии до полномасштабного продакшена.

Предварительные требования

  • Java Development Environment – JDK 8 or newer installed. → Установлена JDK 8 или новее.
  • Maven or Gradle – for dependency management. → для управления зависимостями.
  • Basic Java knowledge – to understand object creation and method calls. → для понимания создания объектов и вызовов методов.

Требуемые библиотеки и зависимости

Include GroupDocs.Merger for Java in your project using Maven, Gradle, or direct download:

Maven

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger</artifactId>
    <version>latest-version</version>
</dependency>

Gradle

implementation 'com.groupdocs:groupdocs-merger:latest-version'

Direct Download
Download the latest version from GroupDocs.Merger Java Docs.

Шаги получения лицензии

  1. Free Trial – Start with a free trial to explore functionalities. → Начните с бесплатной пробной версии, чтобы изучить возможности.
  2. Temporary License – Obtain a temporary key if you need more evaluation time. → Получите временный ключ, если вам требуется больше времени для оценки.
  3. Purchase – Buy a full license for unlimited production use. → Купите полную лицензию для неограниченного использования в продакшене.

Настройка GroupDocs.Merger для Java

  1. Install Dependencies – Add the Maven or Gradle snippet above to your pom.xml or build.gradle. → Добавьте фрагмент Maven или Gradle выше в ваш pom.xml или build.gradle.
  2. Download & Extract (if you chose direct download) – Place the JARs into your project’s lib folder. → Поместите JAR‑файлы в папку lib вашего проекта.
  3. Basic Initialization – Create a Merger instance pointing at your first XLS file:
import com.groupdocs.merger.Merger;

String sourceXlsPath = "YOUR_DOCUMENT_DIRECTORY/SAMPLE_XLS.xls";
Merger merger = new Merger(sourceXlsPath);

Этот объект теперь представляет рабочую книгу, к которой вы будете добавлять.

Руководство по реализации

Загрузка исходного XLS файла

Overview: Первый шаг в любой задаче excel data consolidation — загрузка основной рабочей книги.

Шаг 1: Инициализировать Merger с исходным файлом

import com.groupdocs.merger.Merger;

// Placeholder path for document directory
String sourceXlsPath = "YOUR_DOCUMENT_DIRECTORY/SAMPLE_XLS.xls";
Merger merger = new Merger(sourceXlsPath);

Добавление другого XLS файла для объединения

Overview: После загрузки начального файла вы можете добавить add excel file java объекты в очередь объединения.

Шаг 2: Добавить дополнительный файл

import com.groupdocs.merger.Merger;

// Placeholder path for an additional document to be merged
String additionalXlsPath = "YOUR_DOCUMENT_DIRECTORY/SAMPLE_XLS_2.xls";
Merger merger = new Merger("YOUR_DOCUMENT_DIRECTORY/SAMPLE_XLS.xls");
merger.join(additionalXlsPath);

Вы можете повторять merger.join(...) столько раз, сколько необходимо, чтобы combine multiple xls файлы.

Сохранение объединённого XLS файла

Overview: После объединения всех рабочих книг сохраните результат на диск.

Шаг 3: Сохранить вывод

import com.groupdocs.merger.Merger;

// Placeholder paths for output directory and file name
String outputFile = "YOUR_OUTPUT_DIRECTORY/merged.xls";
Merger merger = new Merger("YOUR_DOCUMENT_DIRECTORY/SAMPLE_XLS.xls");
merger.join("YOUR_DOCUMENT_DIRECTORY/SAMPLE_XLS_2.xls");
merger.save(outputFile);

Метод save записывает объединённую рабочую книгу в merged.xls, завершая процесс batch merge excel.

Практические применения

Объединение файлов Excel — это не просто техническое упражнение; оно решает реальные бизнес‑проблемы:

  1. Financial Reporting – Combine monthly statements into a single annual report. → Объединить ежемесячные отчёты в один годовой отчёт.
  2. Data Consolidation – Aggregate departmental spreadsheets for unified analytics. → Собрать таблицы отделов для единой аналитики.
  3. Project Management – Merge timelines and resource plans for a master schedule. → Объединить графики и планы ресурсов в главное расписание.

GroupDocs.Merger также легко интегрируется с CRM, ERP или BI платформами, позволяя автоматизировать эти рабочие процессы.

Соображения по производительности

  • Optimize File Sizes: Keep individual workbooks under a few megabytes to reduce processing time. → Сохраняйте отдельные рабочие книги менее нескольких мегабайт, чтобы сократить время обработки.
  • Memory Management: Close any streams you open and let the JVM garbage‑collect unused objects. → Закрывайте все открытые потоки и позволяйте JVM собирать неиспользуемые объекты.
  • Batch Processing: For large batches, merge files in groups (e.g., 10 at a time) to avoid memory spikes. → Для больших пакетов объединяйте файлы группами (например, по 10) чтобы избежать всплесков памяти.

Распространённые проблемы и решения

ПроблемаРешение
OutOfMemoryError при объединении больших файловУвеличьте размер кучи JVM (-Xmx2g) или объединяйте небольшими партиями.
Incorrect sheet order после объединенияИспользуйте merger.reorder(...) (доступно в более новых версиях API) для определения нужного порядка.
License not found во время выполненияУбедитесь, что путь к файлу лицензии правильно установлен через License license = new License(); license.setLicense("path/to/license.file");

Часто задаваемые вопросы

Q: Как получить лицензию для GroupDocs.Merger?
A: Начните с бесплатной пробной версии, затем запросите временную лицензию или приобретите полную лицензию по необходимости.

Q: Можно ли объединить более двух файлов Excel одновременно?
A: Да — просто вызывайте merger.join() для каждого дополнительного файла перед вызовом save().

Q: Какие форматы файлов поддерживает GroupDocs.Merger?
A: Он работает с XLS, XLSX, DOCX, PDF, PPTX и многими другими распространёнными типами документов.

Q: Есть ли ограничение на размер файлов, которые можно объединять?
A: Ограничения зависят от памяти вашей системы; следите за использованием кучи при работе с очень большими рабочими книгами.

Q: Как следует обрабатывать ошибки во время объединения?
A: Оберните вызовы объединения в блоки try‑catch и записывайте детали MergerException для быстрой диагностики.

Ресурсы


Последнее обновление: 2026-04-02
Тестировано с: GroupDocs.Merger 23.12 (latest at time of writing)
Автор: GroupDocs