You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
FastExcel is the latest work created by the original author of EasyExcel. After I left Alibaba in 2023, and with Alibaba announcing the cessation of EasyExcel updates, I decided to continue maintaining and upgrading this project. When restarting, I chose the name FastExcel to emphasize the high performance of this framework when handling Excel files, not just its simplicity and ease of use.
FastExcel will always be free and open source , use the business-friendly Apache license., making it suitable for any commercial scenarios. This provides developers and enterprises with great freedom and flexibility. Some notable features of FastExcel include:
We plan to introduce more new features in the future to continually enhance user experience and tool usability. Stay tuned to "Programmer Xiao Lan's" public account for updates on the development of FastExcel. FastExcel is committed to being your best choice for handling Excel files.
-**High-performance Reading and Writing**: FastExcel focuses on performance optimization, capable of efficiently handling large-scale Excel data. Compared to some traditional Excel processing libraries, it can significantly reduce memory consumption.
38
+
-**Simplicity and Ease of Use**: The library offers a simple and intuitive API, allowing developers to easily integrate it into projects, whether for simple Excel operations or complex data processing.
39
+
-**Stream Operations**: FastExcel supports stream reading, minimizing the problem of loading large amounts of data at once. This design is especially important when dealing with hundreds of thousands or even millions of rows of data.
39
40
40
-
## 安装
41
+
## Installation
41
42
42
-
下表列出了各版本 FastExcel 基础库对 Java 语言版本最低要求的情况：
43
+
The following table lists the minimum Java language version requirements for each version of the FastExcel library:
We strongly recommend using the latest version of FastExcel, as performance optimizations, bug fixes, and new features in the latest version will enhance your experience.
51
52
52
-
> 当前 FastExcel 底层使用 poi 作为基础包，如果您的项目中已经有 poi 相关组件，需要您手动排除 poi 的相关 jar 包。
53
+
> Currently, FastExcel uses POI as its underlying package. If your project already includes POI-related components, you will need to manually exclude POI-related jar files.
53
54
54
-
### 版本更新
55
+
### Version Update
56
+
For detailed update logs, refer to [Details of version updates](./CHANGELOG.md). You can also find all available versions in the [Maven Central Repository](https://mvnrepository.com/artifact/cn.idev.excel/fastexcel).
If you are using Maven for project building, add the following configuration in the `pom.xml` file:
62
62
```xml
63
63
<dependency>
64
64
<groupId>cn.idev.excel</groupId>
65
65
<artifactId>fastexcel</artifactId>
66
-
<version>版本号</version>
66
+
<version>version</version>
67
67
</dependency>
68
68
```
69
-
70
69
### Gradle
71
-
72
-
如果您使用 Gradle 进行项目构建，请在 `build.gradle` 文件中引入以下配置：
70
+
If you are using Gradle for project building, add the following configuration in the build.gradle file:
73
71
74
72
```gradle
75
73
dependencies {
76
-
implementation 'cn.idev.excel:fastexcel:版本号'
74
+
implementation 'cn.idev.excel:fastexcel:version'
77
75
}
78
76
```
79
77
80
-
## 示例
78
+
## EasyExcel and FastExcel
79
+
80
+
### Differences
81
+
82
+
- FastExcel supports all the features of EasyExcel but with better performance and stability.
83
+
- FastExcel has an identical API to EasyExcel, allowing seamless switching.
84
+
- FastExcel will continue to update, fix bugs, optimize performance, and add new features.
85
+
86
+
### How to Upgrade from EasyExcel to FastExcel
87
+
88
+
#### Update Dependencies
89
+
Replace the EasyExcel dependency with the FastExcel dependency, as follows:
90
+
91
+
```xml
92
+
<!-- EasyExcel dependency -->
93
+
<dependency>
94
+
<groupId>com.alibaba</groupId>
95
+
<artifactId>easyexcel</artifactId>
96
+
<version>xxx</version>
97
+
</dependency>
98
+
```
99
+
Replace with:
100
+
```xml
101
+
<dependency>
102
+
<groupId>cn.idev.excel</groupId>
103
+
<artifactId>fastexcel</artifactId>
104
+
<version>xxx</version>
105
+
</dependency>
106
+
```
107
+
#### Update Code
108
+
Replace the EasyExcel package name with the FastExcel package name, as follows:
109
+
110
+
```java
111
+
// Replace EasyExcel package name with FastExcel package name
112
+
importcom.alibaba.excel.*;
113
+
```
114
+
115
+
Replace with:
116
+
117
+
```java
118
+
importcn.idev.excel.*;
119
+
```
81
120
82
-
### 读取 Excel 文件
121
+
### Import FastExcel Without Modifying Code
122
+
If you do not want to modify the code for various reasons, you can directly depend on FastExcel by directly adding the dependency in the pom.xml file. EasyExcel and FastExcel can coexist, but long-term switching to FastExcel is recommended.
83
123
84
-
下面是读取 Excel 文档的例子：
124
+
### Future Use of FastExcel Classes Recommended
125
+
To maintain compatibility, EasyExcel classes are retained, but using FastExcel classes in the future is recommended. FastExcel classes are the entry classes for FastExcel and encompass all features of EasyExcel. New features will only be added to FastExcel classes.
85
126
127
+
## Example
128
+
129
+
### Reading Excel Files
130
+
131
+
Below is an example of reading an Excel document:
86
132
```java
87
-
//实现 ReadListener 接口，设置读取数据的操作
133
+
//Implement the ReadListener interface to set up operations for reading data
[](https://www.star-history.com/#fast-excel/fastexcel&Date)
225
203
204
+
## License
205
+
206
+
The project is licensed under the [Apache License 2.0](LICENSE).
0 commit comments