feat: add support for column-based reading of CSV files

[sapienza88]

Purpose of the pull request

Related: #950
Related: #942 (XLSX Format Implementation)

What's changed?

• Added support for column-based reading (CSV only).

Column filtering behavior: CsvExcelReadExecutor#dealRecord

When includeColumnIndexes != null:

• Only process target columns
• Rewrite target columns’ internal indexes to consecutive (0-based)

When includeColumnIndexes == null:

• Keep the original behavior

API Usage Example

// data for csv
NO,Name,Age,Password
1,Jackson,22,123456

List<Map<Integer, String>> results = FesodSheet.read(pathname)
		.csv()
		.includeColumnIndexes(Arrays.asList(1, 3))
		.doReadSync();

Map<Integer, String> data = results.get(0);

assertEquals(2, data.size());
assertEquals("Jackson", data.get(0));
assertEquals("123456", data.get(1));

Checklist

• I have read the Contributor Guide.
• I have written the necessary doc or comment.
• I have added the necessary unit tests and all cases have passed.

[sapienza88]

@delei @bengbengbalabalabeng pls run CI on this

[bengbengbalabalabeng]

Please resolve the code conflict issue first.

[bengbengbalabalabeng]

Method call chain error.

[sapienza88]

Can you point out the test example?

[bengbengbalabalabeng]

The includeColumnIndexes() method is not defined in .csv() (CsvReaderBuilder).

[bengbengbalabalabeng]

The includeColumnIndexes() method is not defined in .read(...) (ExcelReaderBuilder).

Please confirm that the unit tests pass locally before submitting.

[sapienza88]

@bengbengbalabalabeng the test now passes locally, pls check again and merge this if all is ok.

[sapienza88]

@bengbengbalabalabeng @delei is csv supporting non header data?
does it make possible writing something like the following to make reading data without header possible (eg. read data from row 0 : no header)?:

FesodSheet.read(fileName, DemoData.class, new DemoDataListener())
            .sheet()
            .headRowNumber(-1) // or 0
            .doRead();

as of now the default is 1 so the first row will always be skipped (because it is considered header) when reading data

[bengbengbalabalabeng]

@bengbengbalabalabeng @delei is csv supporting non header data? does it make possible writing something like the following to make reading data without header possible (eg. read data from row 0 : no header)?:

FesodSheet.read(fileName, DemoData.class, new DemoDataListener())
            .sheet()
            .headRowNumber(-1) // or 0
            .doRead();

as of now the default is 1 so the first row will always be skipped (because it is considered header) when reading data

.headRowNumber(0) with non-head read: yes

[bengbengbalabalabeng]

Hi @sapienza88,

Please help confirm whether the updated PR description accurately reflects the changes.

[sapienza88]

Hi @sapienza88,

Please help confirm whether the updated PR description accurately reflects the changes.

Yes it does. Thanks

[bengbengbalabalabeng]

LGTM.

merge in 24h.