spacious-team / table-wrapper-excel-impl

Implements unified Table Wrapper API for Excel format and helps to easily search and access to row, column, and cell value.

Назначение

Предоставляет реализацию Table Wrapper API для удобного доступа к табличным данным, сохраненным в файлах формата Microsoft Office Excel (xls) и Office Open XML (xlsx).

Если не используется Spring Boot Starter, то сначала в реестр доступных фабрик нужно зарегистрировать фабрику excel таблиц:

TableFactoryRegistry.add(new ExcelTableFactory());

Пример создания таблиц с первого листа файла 1.xlsx

Workbook book = new XSSFWorkbook(Files.newInputStream(Path.of("1.xlsx")));
ReportPage reportPage = new ExcelSheet(book.getSheetAt(0));

Table table1 = reportPage.create("Table 1 description", ...);
...
Table tableN = reportPage.create("Table N description", ...);

Объекты table...tableN используются для удобного доступа к строкам и к значениям ячеек.

Больше подробностей в документации Table Wrapper API.

Как использовать в своем проекте

Необходимо подключить репозиторий open source библиотек github jitpack, например для Apache Maven проекта

<repositories>
    <repository>
        <id>central</id>
        <name>Central Repository</name>
        <url>https://repo.maven.apache.org/maven2</url>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
    </repository>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

и добавить зависимость

<dependency>
    <groupId>com.github.spacious-team</groupId>
    <artifactId>table-wrapper-excel-impl</artifactId>
    <version>master-SNAPSHOT</version>
</dependency>

В качестве версии можно использовать:

• версию релиза на github;
• паттерн <branch>-SNAPSHOT для сборки зависимости с последнего коммита выбранной ветки;
• короткий 10-ти значный номер коммита для сборки зависимости с указанного коммита.