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
Copy file name to clipboardExpand all lines: README.md
+40-72Lines changed: 40 additions & 72 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -21,52 +21,60 @@
21
21
22
22
## What is FastExcel
23
23
24
-
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.
24
+
Fast, Concise, Java tool for processing Excel files that solves memory overflow issues with large files.
25
25
26
-
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:
27
-
28
-
- Full compatibility with all functionalities and features of the original EasyExcel, allowing users to transition seamlessly.
29
-
- Migrating from EasyExcel to FastExcel only requires a simple change of package name and Maven dependency to complete the upgrade.
30
-
- Functionally, it offers more innovations and improvements than EasyExcel.
31
-
- The FastExcel 1.0.0 version introduced the ability to read a specified number of Excel rows and convert Excel to PDF.
32
-
33
-
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.
26
+
FastExcel will always be free and open source, use the business-friendly Apache license, making it suitable for any
27
+
commercial scenarios. This provides developers and enterprises with great freedom and flexibility.
28
+
We plan to introduce more new features in the future to continually enhance user experience and tool usability. Stay
29
+
tuned to "Programmer Xiao Lan's" public account for updates on the development of FastExcel. FastExcel is committed to
30
+
being your best choice for handling Excel files.
34
31
35
32
## Features
36
33
37
-
-**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.
34
+
-**High-performance Reading and Writing**: FastExcel focuses on performance optimization, capable of efficiently
35
+
handling large-scale Excel data. Compared to some traditional Excel processing libraries, it can significantly reduce
36
+
memory consumption.
37
+
-**Simplicity and Ease of Use**: The library offers a simple and intuitive API, allowing developers to easily integrate
38
+
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
40
+
once. This design is especially important when dealing with hundreds of thousands or even millions of rows of data.
40
41
41
42
## Installation
42
43
43
44
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.
52
+
We strongly recommend using the latest version of FastExcel, as performance optimizations, bug fixes, and new features
53
+
in the latest version will enhance your experience.
52
54
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.
55
+
> Currently, FastExcel uses POI as its underlying package. If your project already includes POI-related components, you
56
+
> will need to manually exclude POI-related jar files.
54
57
55
58
### 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).
57
59
60
+
For detailed update logs, refer to [Details of version updates](./CHANGELOG.md). You can also find all available
61
+
versions in the [Maven Central Repository](https://mvnrepository.com/artifact/cn.idev.excel/fastexcel).
58
62
59
63
### Maven
60
64
61
65
If you are using Maven for project building, add the following configuration in the `pom.xml` file:
66
+
62
67
```xml
68
+
63
69
<dependency>
64
70
<groupId>cn.idev.excel</groupId>
65
71
<artifactId>fastexcel</artifactId>
66
72
<version>version</version>
67
73
</dependency>
68
74
```
75
+
69
76
### Gradle
77
+
70
78
If you are using Gradle for project building, add the following configuration in the build.gradle file:
71
79
72
80
```gradle
@@ -75,68 +83,21 @@ dependencies {
75
83
}
76
84
```
77
85
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
-
```
120
-
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.
123
-
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.
126
-
127
86
## Example
128
87
129
-
### Reading Excel Files
88
+
### Reading Excel Files
130
89
131
90
Below is an example of reading an Excel document:
91
+
132
92
```java
133
93
// Implement the ReadListener interface to set up operations for reading data
具体的なバージョンアップ内容は[バージョンアップ詳細](CHANGELOG.md)で確認できます。 [Maven Central Repository](https://mvnrepository.com/artifact/cn.idev.excel/fastexcel) 内のすべてのバージョンをクエリすることもできます。
0 commit comments