Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/easyj-projects/easyj
简化java项目开发
https://github.com/easyj-projects/easyj
java spring-boot
Last synced: 10 days ago
JSON representation
简化java项目开发
- Host: GitHub
- URL: https://github.com/easyj-projects/easyj
- Owner: easyj-projects
- License: apache-2.0
- Created: 2021-07-07T02:19:31.000Z (over 3 years ago)
- Default Branch: develop
- Last Pushed: 2024-07-16T07:15:05.000Z (4 months ago)
- Last Synced: 2024-07-16T09:25:51.389Z (4 months ago)
- Topics: java, spring-boot
- Language: Java
- Homepage: https://easyj.icu
- Size: 2.99 MB
- Stars: 4
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# easyj
### 官网
[https://easyj.icu](https://easyj.icu)
### 介绍
本项目主要提供一系列的封装好的工具类或功能，供大家使用。 项目宗旨：能用一行代码解决的问题，就不用两行。
### 安装教程
1. springboot项目
```xml
icu.easyj.boot
easyj-spring-boot-bom
0.7.9-SNAPSHOT
pom
import
```
```xml
icu.easyj.boot
easyj-spring-boot-starter-web
icu.easyj.boot
easyj-spring-boot-starter-poi-excel
icu.easyj.boot
easyj-spring-boot-starter-poi-excel-afterturn
```
2. 非springboot项目
```xml
icu.easyj
easyj-all
0.7.9-SNAPSHOT
```
### 使用说明
###### # 注：下面的`MyEntity`为任意的自定义领域模型类。
#### 1、`@ExcelExport, @Excel, @ExcelCell`三个注解，实现Excel文件导出功能
1. 在Controller接口上，添加`@ExcelExport(fileNamePre = "文件名前缀", dataType = MyEntity.class)`
2. 在`MyEntity`类上添加`@Excel`注解，用于配置导出的表格的样式，如：是否添加序号列、是否冻结首行、是否添加数据筛选等等
3. 在`MyEntity`类的属性上添加`@ExcelCell`注解，用于配置列相关信息，如：列名、列号、列宽、列字体颜色、列背景颜色等等
4. 请求多传一个GET参数`&doExport=true`，表示此次请求为文件导出请求
5. 后端在接收到`doExport`参数时，此次请求，将分页功能禁用掉，主要是为了导出不分页情况下的所有数据
#### 2、`ExcelUtils`一个方法，`@Excel, @ExcelCell`两个注解，实现Excel文件导入功能
1.
```java
@RestController
public class XxxController {
@PostMapping("/test/excel-import")
public List testExcelImport(@RequestPart("file") MultipartFile file) {
// excel文件转为列表数据
List list = ExcelUtils.toList(file.getInputStream(), MyEntity.class);
// 打印一下
System.out.println(StringUtils.toString(list));
// 将转换后的数据直接返回，方便查看
return list;
}
}
```
2. `@Excel`和`@ExcelCell`注解的使用方法同`Excel文件导出功能`中的使用方法
#### 3、`@Cache304`一个注解实现GET接口的304缓存功能
1. 在Controller的GET接口上，添加`@Cache304(cacheSeconds = 60, cacheDays = 1, useMaxAge = true)`
2. 在自定义领域模型类`MyEntity`上添加`@Excel`注解，用于配置导出的表格的样式
3. 在自定义领域模型类`MyEntity`的属性上添加`@ExcelCell`注解，用于配置列相关信息
### 使用示例
详见使用示例项目：[https://gitee.com/easyj-projects/easyj-samples](https://gitee.com/easyj-projects/easyj-samples)
### 参与贡献的方法
1. Fork 本仓库到自己的个人仓库中
2. 在Fork下来的仓库的最新代码上新建分支，名称分支可任意自定义
3. 编写代码，并Push
4. 回到本仓库提交 Pull Request，[传送门](https://gitee.com/easyj-projects/easyj/pull/new)