表头国际化

fesod-examples/src/test/java/org/apache/fesod/excel/demo/read/AutoMessageSource.java

@@ -0,0 +1,55 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.apache.fesod.excel.demo.read;
+
+import org.apache.fesod.excel.il8n.ExcelMessageSource;
+
+import java.util.HashMap;
+import java.util.Locale;
+import java.util.Map;
+
+/**
+ * AutoMessageSource
+ *
+ * @author GGBOUD
+ * @date 2025/10/20
+ */
+public class AutoMessageSource implements ExcelMessageSource {
+    private final static Map<String, Map<Locale, String>> MESSAGE_MAP = new HashMap<>();
+
+    @Override
+    public String resolveCode(String code, Locale locale) {
+        Map<Locale, String> localeMap = MESSAGE_MAP.get(code);
+        if (localeMap == null) {
+            return code;
+        } else {
+            String message = localeMap.get(locale);
+            return message == null ? code : message;
+        }
+    }
+
+    @Override
+    public void addMessage(String code, Locale locale, String msg) {
+        MESSAGE_MAP.computeIfAbsent(code, (key) -> new HashMap<>(4)).put(locale, msg);
+    }
+
+    public void addMessages(Map<String, String> messages, Locale locale) {
+        messages.forEach((code, msg) -> addMessage(code, locale, msg));
+    }
+}

fesod-examples/src/test/java/org/apache/fesod/excel/demo/read/Il8nHeadDemoDataListener.java

@@ -0,0 +1,56 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.apache.fesod.excel.demo.read;
+
+import com.alibaba.fastjson2.JSON;
+import lombok.extern.slf4j.Slf4j;
+import org.apache.fesod.excel.context.AnalysisContext;
+import org.apache.fesod.excel.read.listener.ReadListener;
+
+/**
+ * Il8nHeadDemoDataListener
+ *
+ * @author GGBOUD
+ * @date 2025/10/20
+ */
+@Slf4j
+public class Il8nHeadDemoDataListener implements ReadListener<Il8nZhHeadDemoData> {
+
+    public Il8nHeadDemoDataListener() {
+
+    }
+
+    @Override
+    public void invoke(Il8nZhHeadDemoData data, AnalysisContext context) {
+        log.info("Parsed one row of data: {}", JSON.toJSONString(data));
+    }
+
+    /**
+     * doAfterAllAnalysed
+     *
+     * @param context
+     */
+    @Override
+    public void doAfterAllAnalysed(AnalysisContext context) {
+        log.info("All data has been parsed!");
+    }
+
+
+}

fesod-examples/src/test/java/org/apache/fesod/excel/demo/read/Il8nZhHeadDemoData.java

@@ -0,0 +1,46 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.apache.fesod.excel.demo.read;
+
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.Setter;
+import org.apache.fesod.excel.annotation.ExcelProperty;
+
+import java.util.Date;
+
+/**
+ * 基础数据类.这里的排序和excel里面的排序一致
+ *
+ *
+ **/
+@Getter
+@Setter
+@EqualsAndHashCode
+public class Il8nZhHeadDemoData {
+    @ExcelProperty(value = {"head.str"})
+    private String string;
+    @ExcelProperty(value = {"head.date"})
+    private Date date;
+    @ExcelProperty(value = {"head.doubleData"})
+    private Double doubleData;
+    @ExcelProperty(value = {"head.str1"})
+    private String string1;
+}

fesod-examples/src/test/java/org/apache/fesod/excel/demo/read/ReadTest.java

@@ -20,9 +20,6 @@
 package org.apache.fesod.excel.demo.read;
 
 import com.alibaba.fastjson2.JSON;
-import java.io.File;
-import java.util.List;
-import java.util.Map;
 import lombok.extern.slf4j.Slf4j;
 import org.apache.fesod.excel.ExcelReader;
 import org.apache.fesod.excel.FastExcel;
@@ -42,10 +39,13 @@
 import org.junit.jupiter.api.Nested;
 import org.junit.jupiter.api.Test;
 
+import java.io.File;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+
 /**
  * Common approaches for reading Excel files
- *
- *
  */
 @Slf4j
 public class ReadTest {
@@ -127,7 +127,7 @@ private void saveData() {
         fileName = TestFileUtil.getPath() + "demo" + File.separator + "demo.xlsx";
         // One reader per file
         try (ExcelReader excelReader =
-                FastExcel.read(fileName, DemoData.class, new DemoDataListener()).build()) {
+                     FastExcel.read(fileName, DemoData.class, new DemoDataListener()).build()) {
             // Build a sheet. You can specify the name or index.
             ReadSheet readSheet = FastExcel.readSheet(0).build();
             readSheet.setNumRows(2);
@@ -404,6 +404,41 @@ public void noModelRead() {
         FastExcel.read(fileName, new NoModelDataListener()).sheet().doRead();
     }
 
+    /**
+     * Reading without creating objects
+     */
+    @Test
+    public void il8nZhHeadRead() {
+        String fileName = TestFileUtil.getPath() + "demo" + File.separator + "il8n-head-demo-zh.xlsx";
+        AutoMessageSource autoMessageSource = new AutoMessageSource();
+        autoMessageSource.addMessage("head.str", Locale.CHINA, "这是个中文表头");
+        autoMessageSource.addMessage("head.date", Locale.CHINA, "Date");
+        autoMessageSource.addMessage("head.doubleData", Locale.CHINA, "Number");
+        autoMessageSource.addMessage("head.str", Locale.US, "This is a English head");
+        autoMessageSource.addMessage("head.date", Locale.US, "Date");
+        autoMessageSource.addMessage("head.doubleData", Locale.US, "Number");
+        FastExcel.read(fileName, Il8nZhHeadDemoData.class, new Il8nHeadDemoDataListener())
+                .locale(Locale.CHINA).messageResource(autoMessageSource).sheet().doRead();
+    }
+
+    /**
+     * Reading without creating objects
+     */
+    @Test
+    public void il8nUsHeadRead() {
+        String fileName = TestFileUtil.getPath() + "demo" + File.separator + "il8n-head-demo-us.xlsx";
+        AutoMessageSource autoMessageSource = new AutoMessageSource();
+        autoMessageSource.addMessage("head.str", Locale.CHINA, "这是个中文表头");
+        autoMessageSource.addMessage("head.date", Locale.CHINA, "Date");
+        autoMessageSource.addMessage("head.doubleData", Locale.CHINA, "Number");
+        autoMessageSource.addMessage("head.str", Locale.US, "This is a English head");
+        autoMessageSource.addMessage("head.date", Locale.US, "Date");
+        autoMessageSource.addMessage("head.doubleData", Locale.US, "Number");
+        autoMessageSource.addMessage("head.str1", Locale.US, "这是个中文表头1");
+        FastExcel.read(fileName, Il8nZhHeadDemoData.class, new Il8nHeadDemoDataListener())
+                .locale(Locale.US).messageResource(autoMessageSource).sheet().doRead();
+    }
+
     /**
      * Custom modification of CSV configuration
      */
@@ -446,7 +481,8 @@ public void invoke(DemoChainAccessorsData data, AnalysisContext context) {
                                 }
 
                                 @Override
-                                public void doAfterAllAnalysed(AnalysisContext context) {}
+                                public void doAfterAllAnalysed(AnalysisContext context) {
+                                }
                             })
                     .build()) {
                 excelReader.readAll();

fesod-examples/src/test/java/org/apache/fesod/excel/demo/write/WriteTest.java

@@ -19,14 +19,6 @@
 
 package org.apache.fesod.excel.demo.write;
 
-import java.io.File;
-import java.io.InputStream;
-import java.net.URL;
-import java.util.ArrayList;
-import java.util.Date;
-import java.util.HashSet;
-import java.util.List;
-import java.util.Set;
 import org.apache.fesod.excel.ExcelWriter;
 import org.apache.fesod.excel.FastExcel;
 import org.apache.fesod.excel.annotation.ExcelProperty;
@@ -35,13 +27,10 @@
 import org.apache.fesod.excel.annotation.write.style.ColumnWidth;
 import org.apache.fesod.excel.annotation.write.style.ContentRowHeight;
 import org.apache.fesod.excel.annotation.write.style.HeadRowHeight;
+import org.apache.fesod.excel.demo.read.Il8nZhHeadDemoData;
 import org.apache.fesod.excel.enums.CellDataTypeEnum;
-import org.apache.fesod.excel.metadata.data.CommentData;
-import org.apache.fesod.excel.metadata.data.FormulaData;
-import org.apache.fesod.excel.metadata.data.HyperlinkData;
-import org.apache.fesod.excel.metadata.data.ImageData;
-import org.apache.fesod.excel.metadata.data.RichTextStringData;
-import org.apache.fesod.excel.metadata.data.WriteCellData;
+import org.apache.fesod.excel.demo.read.AutoMessageSource;
+import org.apache.fesod.excel.metadata.data.*;
 import org.apache.fesod.excel.util.BooleanUtils;
 import org.apache.fesod.excel.util.FileUtils;
 import org.apache.fesod.excel.util.ListUtils;
@@ -58,16 +47,16 @@
 import org.apache.fesod.excel.write.metadata.style.WriteFont;
 import org.apache.fesod.excel.write.style.HorizontalCellStyleStrategy;
 import org.apache.fesod.excel.write.style.column.LongestMatchColumnWidthStyleStrategy;
-import org.apache.poi.ss.usermodel.Cell;
-import org.apache.poi.ss.usermodel.CellStyle;
-import org.apache.poi.ss.usermodel.FillPatternType;
-import org.apache.poi.ss.usermodel.IndexedColors;
-import org.apache.poi.ss.usermodel.Sheet;
-import org.apache.poi.ss.usermodel.Workbook;
+import org.apache.poi.ss.usermodel.*;
 import org.apache.poi.ss.util.CellRangeAddress;
 import org.apache.poi.xssf.streaming.SXSSFSheet;
 import org.junit.jupiter.api.Test;
 
+import java.io.File;
+import java.io.InputStream;
+import java.net.URL;
+import java.util.*;
+
 /**
  * 写的常见写法
  *
@@ -779,7 +768,31 @@ public void afterSheetDispose(SheetWriteHandlerContext context) {
                 .doWrite(this::data);
         System.out.println(fileName);
     }
+    @Test
+    public void sheetIl8nHeadWriteTest() {
+        List<Locale> locales=new ArrayList<>();
+        locales.add(Locale.CHINA);
+        locales.add(Locale.US);
+        AutoMessageSource autoMessageSource = new AutoMessageSource();
+        autoMessageSource.addMessage("head.str", Locale.CHINA,"这是个中文表头");
+        autoMessageSource.addMessage("head.str1", Locale.CHINA,"这是个中文表头2");
+        autoMessageSource.addMessage("head.date", Locale.CHINA,"Date");
+        autoMessageSource.addMessage("head.doubleData", Locale.CHINA,"Number");
+        autoMessageSource.addMessage("head.str", Locale.US,"This is a English head");
+        autoMessageSource.addMessage("head.date", Locale.US,"Date");
+        autoMessageSource.addMessage("head.doubleData", Locale.US,"Number");
+        autoMessageSource.addMessage("head.str1", Locale.US,"这是个中文表头1");
+        for (Locale locale:locales){
+            String fileName = TestFileUtil.getPath() + "simpleWrite" + System.currentTimeMillis() + locale.getLanguage()+".xlsx";
+            FastExcel.write(fileName, Il8nZhHeadDemoData.class)
+                    .locale( locale)
+                    .messageResource(autoMessageSource)
+                    .sheet("模板")
+                    .doWrite(this::Il8nHeadDemoDataList);
+            System.out.println(fileName);
+        }
 
+    }
     private List<LongestMatchColumnWidthData> dataLong() {
         List<LongestMatchColumnWidthData> list = ListUtils.newArrayList();
         for (int i = 0; i < 10; i++) {
@@ -855,4 +868,17 @@ private List<DemoData> dataHex() {
         }
         return list;
     }
+
+    private List<Il8nZhHeadDemoData> Il8nHeadDemoDataList() {
+        List<Il8nZhHeadDemoData> list = ListUtils.newArrayList();
+        for (int i = 0; i < 10; i++) {
+            Il8nZhHeadDemoData data = new Il8nZhHeadDemoData();
+            data.setString("STRING" + i);
+            data.setDate(new Date());
+            data.setDoubleData(0.56);
+            data.setString1("测试000"+i);
+            list.add(data);
+        }
+        return list;
+    }
 }