[Task] Apache Fesod (Incubating) Upgrade Guide

[alaahong]

Motivation

As some core classes changed, required some materials to highlight the upgrade details.

How to complete

Easy to migrate from Fast-Excel to Fesod

Task List

• Document
• Script

Anything else?

No response

[alaahong]

Raise one PR for Skill usage as Script
#858

[alaahong]

For Document, there is an existing version https://fesod.apache.org/zh-cn/docs/migration/from-fastexcel , but seems it's not cover Fast-Excel 1.3.X, the package only cover cn.idev.*, which might not enough to guide the upgrading. Some classes were under org.apache.fesod.sheet.* as below screenshot

[Mikkey-f]

Hi @delei, @alaahong — while migrating a project from FastExcel 1.3.0, I compared the fastexcel-1.3.0 jar against the current fesod-sheet sources and found a few things the migration guide doesn't cover yet. The guide already handles package imports, the entry-class rename (FastExcel/FastExcelFactory → FesodSheet) and the CGLIB tag very well — this would be a small follow-up section.

Would it be useful to add a "Class and module changes" section (EN + zh-CN) covering:

1. Renamed helper classes that are still referenced by name in some codebases:

   • FastExcelConstants → FesodSheetConstants (org.apache.fesod.sheet.constant)
   • FastExcelTempFileCreationStrategy → FesodTempFileCreationStrategy (org.apache.fesod.sheet.util)
   • BeanMapUtils$FastExcelNamingPolicy → BeanMapUtils$FesodSheetNamingPolicy (org.apache.fesod.sheet.util)

2. Utility classes moved to fesod-common: StringUtils, IoUtils, MapUtils, ListUtils, BooleanUtils, IntUtils, MemberUtils, PositionUtils now live in org.apache.fesod.common.util, so imports need updating.

3. New Fesod-only features FastExcel users may not know about: @FreezePane, URL image security (UrlImageFetchPolicy, SchemePolicy, CidrBlock), StringBase64ImageConverter / StringPathnameImageConverter, HeadBuilder / DefaultHeadBuilder, and HeaderMergeStrategy.

If that sounds useful I'd be happy to open a PR; otherwise no problem — just closing this out as a note.

[alaahong]

Hi @delei, @alaahong — while migrating a project from FastExcel 1.3.0, I compared the fastexcel-1.3.0 jar against the current fesod-sheet sources and found a few things the migration guide doesn't cover yet. The guide already handles package imports, the entry-class rename (FastExcel/FastExcelFactory → FesodSheet) and the CGLIB tag very well — this would be a small follow-up section.

Would it be useful to add a "Class and module changes" section (EN + zh-CN) covering:

1. Renamed helper classes that are still referenced by name in some codebases:

   • FastExcelConstants → FesodSheetConstants (org.apache.fesod.sheet.constant)
   • FastExcelTempFileCreationStrategy → FesodTempFileCreationStrategy (org.apache.fesod.sheet.util)
   • BeanMapUtils$FastExcelNamingPolicy → BeanMapUtils$FesodSheetNamingPolicy (org.apache.fesod.sheet.util)

2. Utility classes moved to fesod-common: StringUtils, IoUtils, MapUtils, ListUtils, BooleanUtils, IntUtils, MemberUtils, PositionUtils now live in org.apache.fesod.common.util, so imports need updating.

3. New Fesod-only features FastExcel users may not know about: @FreezePane, URL image security (UrlImageFetchPolicy, SchemePolicy, CidrBlock), StringBase64ImageConverter / StringPathnameImageConverter, HeadBuilder / DefaultHeadBuilder, and HeaderMergeStrategy.

If that sounds useful I'd be happy to open a PR; otherwise no problem — just closing this out as a note.

well , seems still a PR to cover latest changes, can you try to update that?

[Mikkey-f]

Hi @alaahong, done — PR #1041 is up with the "Class and module changes" section (EN + zh-CN) and matching updates to the migration skill. Thanks for the pointer!