README.md

Назначение

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

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

TableFactoryRegistry.add(new XmlTableFactory());

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

ExcelReader reader = new ExcelReader();
Workbook book = reader.getWorkbook(Files.newInputStream(Path.of("1.xml")));
ReportPage reportPage = new XmlReportPage(book.getWorksheetAt(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-xml-impl</artifactId>
    <version>master-SNAPSHOT</version>
</dependency>

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

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