Da die gesamten Vorlageninformationen Teil des Ausdrucks sind, müssen auch gewöhnliche Zeichenfolgen speziell gekennzeichnet werden. Die Unterausdrücke im Ausdruck werden im Folgenden einzeln erläutert.
!fe: Daten durchlaufen, ohne Zeilen zu erstellen.
Dieser Satz im offiziellen Dokument kann für jeden etwas verwirrend sein. Was bedeutet es, keinen Streit zu verursachen? Tatsächlich ist das Nichterstellen einer Zeile relativ zum Erstellen einer Zeile, und der Ausdruck zum Erstellen einer Zeile lautet fe:.
So wie jeder Datensatz in der Datenbank einem Entitätsobjekt entspricht, bedeutet das Erstellen einer Zeile, dass jede Zeile ein Entitätsobjekt ist. Die Attribute dieses Entitätsobjekts werden mit {{}}-Ausdrücken umschlossen.
Wenn keine Zeile erstellt wird, gibt es im gesamten Ausdruck nur ein Entitätsobjekt, dieses Objekt ist jedoch etwas Besonderes. Es wird durch N Entitäten in der Liste zusammengefügt. Jede Entität bezieht sich nicht nur auf das Modell selbst, sondern enthält auch den Excel-Stil, z. B. wie viele Zellen sie einnimmt, die Koordinaten der Zellen, die Anordnungsreihenfolge usw.
list ist ein benutzerdefinierter Name, der die Datensammlung im Ausdruck darstellt. Der Code verwendet list als Schlüssel, um die Sammlung von Werten aus Map zu erhalten.
Die Namensliste ist leicht verständlich. Sie ist lediglich ein Platzhalter und kann frei gewählt werden. Wenn EasyPOI die Liste analysiert, weiß es, dass es eine Reihe von Werten des Schlüssels in Map gibt. Wenn es die Daten später analysiert, kann es diese einfach aus der Menge übernehmen.
Durchsuchen Sie das offizielle Konto von Java Zhiyin, antworten Sie auf „Backend-Interview“ und wir geben Ihnen einen Java-Interview-Fragenleitfaden.pdf
t Vordefinierter Wert, der jedes Objekt in der Sammlung darstellt.
Aus der Vorlage können wir ungefähr ersehen, dass jedes Objekt in der Liste t heißt und t.name das Namensattribut von t darstellt, sodass der Name t beiläufig aufgerufen werden kann. Wie auch immer, es ist dasselbe wie list, und es fungiert als Platzhalter.
Aber eigentlich ist das eine große Grube! Wenn Sie t durch einen anderen Wert wie g ersetzen, g.name g.code usw. an anderer Stelle in der Vorlage schreiben, wird es letztendlich nicht geparst! Die offizielle Dokumentation betont diesen Punkt nicht, aber der Autor hat ihn erst entdeckt, nachdem er tatsächlich in die Falle getreten ist!
]] Newline-Zeichen Export mit mehrzeiligem Durchlauf.
Die offizielle Erklärung dieses Symbols ist ebenfalls verwirrend. Was ist ein Zeilenumbruch und -export? Tatsächlich bedeutet dies, dass, wenn der Ausdruck dieses Symbol enthält, der Inhalt nach der Zeile nicht analysiert wird, unabhängig davon, ob sich dahinter ein anderer Inhalt oder Stil befindet.
Dieses Symbol muss in die letzte Spalte jeder Zeile geschrieben werden, da sonst die Anzahl der Zeilen und Spalten unterschiedlich ist und eine Nullzeiger-Ausnahme gemeldet wird, wenn EasyPOI eine interne Zuweisung durchführt.
‘‘ Einfache Anführungszeichen stellen konstante Werte dar‘‘ Zum Beispiel ‚1‘, dann ist die Ausgabe 1
Die Einführung hier in der offiziellen Dokumentation hat auch Fallstricke. '' bedeutet einen konstanten Wert, aber tatsächlich ist es falsch, dies nur in Excel zu haben, denn wenn Excel in einer Zelle auf ' trifft, geht es davon aus, dass es sich bei den folgenden Werten ausschließlich um Zeichenfolgen handelt, sodass Sie '' Bibliothekstyp: ' hineinschreiben müssen die Zelle, sodass „Bibliothekstyp:“ angezeigt wird, nicht die Zeichenfolge „Bibliothekstyp:“.
Nach der obigen Analyse ähnelt die Vorlage im Bild tatsächlich der folgenden:
{{!fe: list t.id ‘库别:’ t.bin 换行 ‘商品名称:’ t.name 换行 ‘商品编号:’ t.code t.barcode 换行 ‘生产日期:’ t.proDate 换行 ‘进货日期:’ t.recvDate}}
如果list中有多条记录，上述字符串就再循环拼接一些内容，最终都在一个{{}}表达式中。
至此，模板的设计已剖析完毕，读者可根据自己的需求结合官方文档自行设计模板。下面将对模板赋值进行介绍。
准备模板数据
从上节的描述中可知，只需要准备一个Map的对象即可，其中键为list，值为一个List数组，数组中元素类型为Map。代码如下：
Map<String, Object> total = new HashMap<>();
List<Map<String, Object>> mapList = new ArrayList<>();
for (int i = 1; i <= 5; i++) {
Map<String, Object> map = new HashMap<>();
map.put("id", i + "");
map.put("bin", "001 1000千克");
map.put("name", "商品" + i);
map.put("code", "goods" + i);
map.put("proDate", "2019-05-30");
map.put("recvDate", "2019-07-07");
// 插入图片
ByteArrayOutputStream byteArrayOut = new ByteArrayOutputStream();
BufferedImage bufferImg = ImageIO.read(BarcodeUtil.generateToStream("001"));
ImageIO.write(bufferImg, "jpg", byteArrayOut);
ImageEntity imageEntity = new ImageEntity(byteArrayOut.toByteArray(), 200, 1000);
map.put("barcode", imageEntity);
mapList.add(map);
}
total.put("list", mapList);Nach dem Login kopieren
图片数据导出
上述代码中需要特殊关注的是图片导出部分。EasyPOI导出图片有两种方式，一种是通过图片的Url，还有一种是获取图片的byte[]，毕竟图片的本质就是byte[]。因为笔者的项目中图片不是存放在数据库之中，而是需要根据查询结果动态生成条码，所以通过byte[]导出图片。
ImageEntity是EasyPOI内置的一个JavaBean，用于设定图片的宽度和高度、导出方式、RowSpan和ColumnSpan等。调试EasyPOI的源码可知，当设置了RowSpan或者ColumnSpan之后，图片的高度设置就失效了，图片大小会自动填充图片所在的单元格。
图片导出的坑点在于导出图片的大小。假设我们将四个单元格合成为一个，希望导出的图片能填充合并之后的单元格，但是对不起，EasyPOI暂时做不到，它只会填充合并之前左上角的单元格，具体原因如下源码所示：
//BaseExportService.java
ClientAnchor anchor;
if (type.equals(ExcelType.HSSF)) {
anchor = new HSSFClientAnchor(0, 0, 0, 0, (short) cell.getColumnIndex(), cell.getRow().getRowNum(), (short) (cell.getColumnIndex() + 1),
cell.getRow().getRowNum() + 1);
} else {
anchor = new XSSFClientAnchor(0, 0, 0, 0, (short) cell.getColumnIndex(), cell.getRow().getRowNum(), (short) (cell.getColumnIndex() + 1),
cell.getRow().getRowNum() + 1);
}Nach dem Login kopieren
可以看到，在创建图片插入位置的时候已经指定了图片的跨度为1行1列，即左上角的单元格。如果之前又设置了RowSpan或者ColumnSpan，那么图片高度的设置也会失效，最终导致导出的图片非常小。
搜索Java知音公众号，回复“后端面试”，送你一份Java面试题宝典.pdf
个人认为ImageEntity提供的RowSpan或者ColumnSpan的set方法并没有什么用，因为我们动态创建的合并单元格并不能被赋值。所以，导出图片的最好方式就是直接指定它的高度，因为宽度会自动填充单元格，模板中单元格的宽度要合适。
//ExcelExportOfTemplateUtil.java
if (img.getRowspan()>1 || img.getColspan() > 1){
img.setHeight(0);
PoiMergeCellUtil.addMergedRegion(cell.getSheet(),cell.getRowIndex(),
cell.getRowIndex() + img.getRowspan() - 1, cell.getColumnIndex(), cell.getColumnIndex() + img.getColspan() -1);
}Nach dem Login kopieren
将数据导出至模板
以上准备工作全部完成后就可以将模板和数据进行组装了，或者说是渲染，代码如下所示：
public static void exportByTemplate(String templateName, Map<String, Object> data, OutputStream fileOut) {
TemplateExportParams params = new TemplateExportParams("export/template/" + templateName, true);
try {
Workbook workbook = ExcelExportUtil.exportExcel(params, data);
workbook.write(fileOut);
} catch (Exception e) {
LogUtil.error("", e);
}
}Nach dem Login kopieren
总结
网上针对EasyPOI的介绍多限于最基本的行插入功能，但实际上Excel模板的需求可能各式各样。本文只是抛砖引玉，对EasyPOI中的部分概念做了详细介绍，希望帮助大家少踩坑。
如果想详细了解EasyPOI的各种功能，参考链接中的文档说明及测试项目源码就是最好的学习资料。希望大家都能得心应手地使用EasyPOI，大大提升开发效率！
参考链接
EasyPOI官方文档
- https://opensource.afterturn.cn/doc/easypoi.html
EasyPOI测试项目
- https://gitee.com/lemur/easypoi-test
一些坑
近日有网友求助我解决EasyPOI的复杂模板配置问题，通过解决该网友的问题发现了EasyPOI中的几个坑点，补充说明几个问题。
Wie Sie komplexe Vorlagen konfigurieren, die von EasyPOI unterstützt werden, wurde im Abschnitt „Analyse komplexer Vorlagendesigns“ beschrieben. Die Konfiguration dieser Vorlage ist absolut korrekt, es gibt jedoch drei Punkte, die nicht klar angegeben sind, und es ist leicht, dass jeder beim Kopieren des Kürbisses Fehler macht:
- {{!fe: Liste muss in einer separaten sein Spalte. Im EasyPOI-Quellcode wird die Anzahl der für jedes Element in der Liste erforderlichen Zeilen basierend auf der Zeilen- und Spaltenspanne der Zelle bestimmt. Im obigen Bild beträgt die Spanne der Zelle beispielsweise 5 Zeilen und 1 Spalte. Mit anderen Worten: Jedes Element in der Liste wird in Zukunft 5 Zeilen belegen. Wenn Sie der Meinung sind, dass diese Spalte nicht dem Stil der benutzerdefinierten Vorlage entspricht, können Sie die Spaltenbreite der Spalte auf 0 setzen, Sie müssen jedoch über {{!fe: list.
- Zwischen dem Start- und Endsymbol {{}} des Objekts dürfen keine leeren Zellen vorhanden sein! Der Code löst direkt eine Ausnahme aus, wenn er analysiert, dass die Zelle leer ist. Wenn Sie möchten, dass die Zelle leer ist, müssen Sie eine leere Zeichenfolge schreiben: ''''.
- Zeilenumbruchzeichen]] muss die letzte Zelle jeder Zeile einnehmen! Wenn sich beispielsweise in der ersten Zeile 10 Zellen befinden und in der zweiten Zeile nur die ersten 5 verwendet werden, können Sie das Zeilenumbruchzeichen ]] nicht direkt am Ende der 5. Zeile schreiben. Stattdessen müssen Sie 6 zusammenführen -10 Zellen und schreiben Sie dann Enter]]. Beachten Sie die letzte Spalte der Zeile mit dem Produktionsdatum im Bild oben. Der Grund für diese Einstellung ist, dass EasyPOI eine exakt gleiche Anzahl von Zellen in jeder Zeile erfordert, da der Spaltenumfang jeder Zelle im Quellcode festgelegt wird. Bei Verwendung des Zeilenumbruchzeichens ]] wird die Anzahl festgelegt Wenn sich die Anzahl der Spalten von denen anderer Zeilen unterscheidet, kommt es beim Zuweisen von Werten zu Problemen und es treten Indexausnahmen auf.
