easyj

官网

https://easyj.icu

介绍

Данный проект предоставляет ряд готовых инструментов и функций для использования. Цель проекта: проблемы, которые можно решить одной строкой кода, не должны решаться двумя строками.

Установка

1. Springboot-проект:

<dependencyManagement>
	<dependencies>
		<groupId>icu.easyj.boot</groupId>
		<artifactId>easyj-spring-boot-bom</artifactId>
		<version>0.7.8</version>
		<type>pom</type>
		<scope>import</scope>
	</dependencies>
</dependencyManagement>

<dependencies>
  <!-- @Cache304所需依赖 -->
  <dependency>
    <groupId>icu.easyj.boot</groupId>
    <artifactId>easyj-spring-boot-starter-web</artifactId>
  </dependency>
  <!-- @ExcelExport所需依践 -->
  <dependency>
    <groupId>icu.easyj.boot</groupId>
    <artifactId>easyj-spring-boot-starter-poi-excel</artifactId>
  </dependency>
  <dependency>
    <groupId>icu.easyj.boot</groupId>
    <artifactId>easyj-spring-boot-starter-poi-excel-afterturn</artifactId>
  </dependency>
</dependencies>

2. Не springboot-проект:

<dependencies>
  <dependency>
    <groupId>icu.easyj</groupId>
    <artifactId>easyj-all</artifactId>
    <version>0.7.8</version>
  </dependency>
</dependencies>

Использование

# 注：下面的 MyEntity 为任意的自定义领域模型类。

1. @ExcelExport, @Excel, @ExcelCell три аннотации, реализуют функцию экспорта в Excel

1. В интерфейсе Controller добавьте @ExcelExport(fileNamePre = "文件名前缀", dataType = MyEntity.class).
2. Добавьте аннотацию @Excel к классу MyEntity, чтобы настроить стиль таблицы экспорта, например, добавлять ли номер строки, замораживать ли первую строку, добавлять ли фильтр данных и т. д.
3. Добавьте аннотацию @ExcelCell к свойствам класса MyEntity, чтобы настроить информацию о столбцах, такую как имя столбца, номер столбца, ширина столбца, цвет шрифта столбца, цвет фона столбца и т.д.
4. Отправьте запрос с параметром GET &doExport=true, что означает, что этот запрос является запросом на экспорт файла.
5. После получения параметра doExport сервер отключает функцию разбиения на страницы, чтобы экспортировать все данные без разбивки на страницы.

2. Метод ExcelUtils, аннотации @Excel, @ExcelCell, реализуют функцию импорта из Excel

@RestController
public class XxxController {

  @PostMapping("/test/excel-import")
  public List<MyEntity> testExcelImport(@RequestPart("file") MultipartFile file) {
    // excel файл преобразуется в список данных
    List<MyEntity> list = ExcelUtils.toList(file.getInputStream(), MyEntity.class);

    // печать
    System.out.println(StringUtils.toString(list));

    // вернуть преобразованные данные напрямую, удобно просматривать
    return list;
  }
}

2. Аннотации @Excel и @ExcelCell используются так же, как и в функции экспорта файлов Excel.

3. Аннотация @Cache304 реализует функцию кэширования 304 для GET-интерфейса

1. Добавьте @Cache304(cacheSeconds = 60, cacheDays = 1, useMaxAge = true) в интерфейс GET контроллера.
2. Добавьте аннотацию @Excel в класс модели домена MyEntity, чтобы настроить таблицу экспорта.
3. Добавьте аннотацию @ExcelCell в свойства класса модели домена MyEntity.

Примеры использования

См. примеры использования: https://gitee.com/easyj-projects/easyj-samples.

Как внести свой вклад

1. Fork этот репозиторий в свой личный репозиторий.
2. Создайте новую ветку в своём репозитории на основе последней версии кода после форка.
3. Напишите код и отправьте его.
4. Вернитесь в этот репозиторий и отправьте Pull Request: передающая дверь.