Проект IExcel

IExcel (https://github.com/houbb/iexcel) используется для элегантного чтения и записи в Excel.

Избегает проблем с OOM при работе с большими файлами Excel, предлагая лаконичный и эффективный подход.

Особенности

• Одна строка кода решает все задачи.

• ООП-подход к работе с Excel делает программирование более удобным и элегантным.

• Использует режим sax для чтения и SXSS для записи, что позволяет избежать проблем с OOM для больших файлов Excel.

• Основан на аннотациях, делая программирование более гибким.

• Простой дизайн и полные комментарии облегчают изучение и модификацию.

• Можно указать порядок заголовков таблиц по аннотациям.

• Поддерживает получение содержимого файла Excel в виде массива байтов, что удобно для пользовательских операций.

Журнал изменений

Журнал изменений

Основные изменения в версии 0.0.9

Исправлена проблема с неработающими аннотациями @ExcelField.

Причины создания

В реальной работе и обучении использование Apache POI для работы с Excel оказалось слишком сложным.

Недавно были рассмотрены некоторые другие инструменты и фреймворки:

• easypoi;

• easyexcel;

• hutool-poi.

Ни один из них полностью не удовлетворил реальные потребности, поэтому был создан собственный инструмент для работы с экспортом Excel.

Реализация: основана на easyexcel от Alibaba, улучшая простоту использования.

Быстрый старт

Требования к среде

JDK 1.7+

Maven 3.x

Импорт jar

Используйте управление Maven.

<dependency>
     <groupId>com.github.houbb</groupId>
     <artifactId>iexcel</artifactId>
     <version>0.0.9</version>
</dependency>

Запись в Excel

Пример

// Основные свойства
final String filePath = PathUtil.getAppTestResourcesPath()+"/excelHelper.xls";
List<User> models = User.buildUserList();

// Прямая запись в файл
ExcelHelper.write(filePath, models);

Здесь:

• User.java

public class User {

    private String name;

    private int age;

    //fluent getter/setter/toString()
}

• buildUserList()

Метод построения списка объектов выглядит следующим образом:

/**
 * Построение таблицы пользователей
 * @return Список пользователей
 * @since 0.0.4
 */
public static List<User> buildUserList() {
    List<User> users = new ArrayList<>();
    users.add(new User().name("hello").age(20));
    users.add(new User().name("excel").age(19));
    return users;
}

Результат записи

Содержимое Excel будет выглядеть так:

Чтение из Excel

Пример

final String filePath = PathUtil.getAppTestResourcesPath()+"/excelHelper.xls";
List<User> userList = ExcelHelper.read(filePath, User.class);

Информация

[User{name='hello', age=20}, User{name='excel', age=19}]

Документация

01-ExcelBs 引导类使用说明

02-ExcelField 注解指定字段属性

03-ExcelField#order 指定列顺序

04-ExcelBs#bytes 获取文件字节信息

Проблемы и вопросы

Мы приветствуем ценные предложения: Проблемы и вопросы.

Будущие планы

• Будет ли возможность указывать заголовки таблиц?

• Добавить поддержку преобразования типов.

• Поддержка аннотаций для значений перечисления.

• Поддержка стилей с помощью аннотаций.

• Многостраничная поддержка.