Apache POI - Excel-Datei einlesen - Versionsgeschichte

L-ectron-X am 27. Januar 2020 um 17:05 Uhr

2020-01-27T17:05:52Z

← Nächstältere Version		Version vom 27. Januar 2020, 17:05 Uhr
Zeile 72:		Zeile 72:
	* @author Gernot Segieth		* @author Gernot Segieth
	*/		*/
	public class ~~ExcelFileProxy~~ {		public class ExcelFileReader {

	private File excelFile;		private File excelFile;
Zeile 91:		Zeile 91:
	* es Probleme mit dem Format der Datei oder der Verschlüsselung gibt		* es Probleme mit dem Format der Datei oder der Verschlüsselung gibt
	*/		*/
	public ~~ExcelFileProxy~~(File excelFile) throws ClassNotFoundException, IOException, InvalidFormatException {		public ExcelFileReader(File excelFile) throws ClassNotFoundException, IOException, InvalidFormatException {
	this.excelFile = excelFile;		this.excelFile = excelFile;
	createWorkbook(excelFile);		createWorkbook(excelFile);

L-ectron-X am 9. Oktober 2019 um 16:41 Uhr

2019-10-09T16:41:29Z

← Nächstältere Version		Version vom 9. Oktober 2019, 16:41 Uhr
Zeile 413:		Zeile 413:

	{{In Arbeit}}		{{In Arbeit}}

			{{Fragen stellen}}

L-ectron-X am 22. Juli 2019 um 15:13 Uhr

2019-07-22T15:13:13Z

← Nächstältere Version		Version vom 22. Juli 2019, 15:13 Uhr
Zeile 2:		Zeile 2:
	Mit dem Java-[[Framework]] Apache POI kann man recht komfortabel Microsoft Excel-Dateien auslesen und erzeugen (schreiben).		Mit dem Java-[[Framework]] Apache POI kann man recht komfortabel Microsoft Excel-Dateien auslesen und erzeugen (schreiben).

	Hier ein vollständiges Beispiel zum Auslesen des Tabelleninhaltes einer beliebigen Excel-Datei. Das heißt, wir mit ~~diesem~~ Code das binäre Format (.xls) sowie das auf [[XML]] basierende Format .xslx einlesen.		Hier ein vollständiges Beispiel zum Auslesen des Tabelleninhaltes einer beliebigen Excel-Datei. Das heißt, wir können mit folgendem Code das binäre Format (.xls) sowie das auf [[XML]] basierende Format .xslx einlesen.

	Diese Klasse wurde mit der Apache License 2.0 veröffentlicht:		Diese Klasse wurde mit der Apache License 2.0 veröffentlicht:

L-ectron-X am 25. Juni 2019 um 14:49 Uhr

2019-06-25T14:49:36Z

Änderungen zeigen

L-ectron-X am 14. Mai 2019 um 16:08 Uhr

2019-05-14T16:08:01Z

← Nächstältere Version		Version vom 14. Mai 2019, 16:08 Uhr
Zeile 1:		Zeile 1:
	[[Kategorie:Java-Codeschnipsel]]		[[Kategorie:Java-Codeschnipsel]]
	Mit dem Java-[[Framework]] Apache POI kann man recht komfortabel Excel-Dateien auslesen und erzeugen (schreiben).		Mit dem Java-[[Framework]] Apache POI kann man recht komfortabel Microsoft Excel-Dateien auslesen und erzeugen (schreiben).

	Hier ein Beispiel zum Auslesen einer beliebigen Excel-Datei. Das heißt, wir verarbeiten das binäre Format (.xls) sowie das auf XML basierende Format .xslx .		Hier ein Beispiel zum Auslesen einer beliebigen Excel-Datei. Das heißt, wir verarbeiten das binäre Format (.xls) sowie das auf [[XML]] basierende Format .xslx .

	==Excel-Datei einlesen==		==Excel-Datei einlesen==
Zeile 61:		Zeile 61:
	</syntaxhighlight>		</syntaxhighlight>

	Anschließend ~~eine~~ fügen wir die bereits im Konstruktor aufgerufene [[Methode]], die die Dateitypen unterscheidet, unsere eben erstellten Methoden aufruft und damit das <code>Workbook</code> aus der übergebenen Datei ({{JAPI\|File}} erzeugt, ein.		Anschließend fügen wir die bereits im Konstruktor aufgerufene [[Methode]], die die Dateitypen unterscheidet, unsere eben erstellten Methoden aufruft und damit das <code>Workbook</code> aus der übergebenen Datei ({{JAPI\|File}} erzeugt, ein.
	<syntaxhighlight lang="java" line="true">		<syntaxhighlight lang="java" line="true">
	private void createWorkbook(File file) throws ClassNotFoundException, IOException, InvalidFormatException {		private void createWorkbook(File file) throws ClassNotFoundException, IOException, InvalidFormatException {

L-ectron-X am 14. Mai 2019 um 16:01 Uhr

2019-05-14T16:01:21Z

← Nächstältere Version		Version vom 14. Mai 2019, 16:01 Uhr
Zeile 23:		Zeile 23:

	/**		/**
	* ~~ExcelFileProxy~~ liest die Excel-Datei ein und erzeugt ein tabellarisches		* ExcelFileReader liest die Excel-Datei ein und erzeugt ein tabellarisches
	* Abbild der Arbeitsmappe in Form von verschachtelten Listen.		* Abbild der Arbeitsmappe in Form von verschachtelten Listen.
	*		*

L-ectron-X am 10. März 2019 um 15:46 Uhr

2019-03-10T15:46:34Z

← Nächstältere Version		Version vom 10. März 2019, 15:46 Uhr
Zeile 1:		Zeile 1:
	[[Kategorie:Codeschnipsel]]		[[Kategorie:Java-Codeschnipsel]]
	Mit dem Java-[[Framework]] Apache POI kann man recht komfortabel Excel-Dateien auslesen und erzeugen (schreiben).		Mit dem Java-[[Framework]] Apache POI kann man recht komfortabel Excel-Dateien auslesen und erzeugen (schreiben).

L-ectron-X am 3. März 2019 um 19:15 Uhr

2019-03-03T19:15:16Z

← Nächstältere Version		Version vom 3. März 2019, 19:15 Uhr
Zeile 59:		Zeile 59:

	}		}
	</~~syntaxhightlight~~>		</syntaxhighlight>

	Anschließend eine fügen wir die bereits im Konstruktor aufgerufene [[Methode]], die die Dateitypen unterscheidet, unsere eben erstellten Methoden aufruft und damit das <code>Workbook</code> aus der übergebenen Datei ({{JAPI\|File}} erzeugt, ein.		Anschließend eine fügen wir die bereits im Konstruktor aufgerufene [[Methode]], die die Dateitypen unterscheidet, unsere eben erstellten Methoden aufruft und damit das <code>Workbook</code> aus der übergebenen Datei ({{JAPI\|File}} erzeugt, ein.
Zeile 84:		Zeile 84:
	}		}
	}		}
	</~~syntaxhightlight~~>		</syntaxhighlight>

	Damit haben wir den Code zum Öffnen und Einlesen von Excel-Dateien schon geschrieben.		Damit haben wir den Code zum Öffnen und Einlesen von Excel-Dateien schon geschrieben.
Zeile 93:		Zeile 93:
	Ein Arbeitsblatt besteht also aus Zeilen, über die in einer Schleife iteriert werden kann.		Ein Arbeitsblatt besteht also aus Zeilen, über die in einer Schleife iteriert werden kann.

	===Workbook vollständig auslesen==		===Workbook vollständig auslesen===
	In diesem Abschnitt schreiben wir uns den Code zum vollständigen Auslesen '''eines''' Arbeitsblattes einer Excel-Datei.		In diesem Abschnitt schreiben wir uns den Code zum vollständigen Auslesen '''eines''' Arbeitsblattes einer Excel-Datei.
	<syntaxhighlight lang="java" line="true">		<syntaxhighlight lang="java" line="true">
Zeile 175:		Zeile 175:
	return sheetData;		return sheetData;
	}		}
	</~~syntaxhightlight~~>		</syntaxhighlight>

	===Workbook teilweise auslesen===		===Workbook teilweise auslesen===

	{{In Arbeit}}		{{In Arbeit}}

L-ectron-X: Die Seite wurde neu angelegt: „Kategorie:Codeschnipsel Mit dem Java-Framework Apache POI kann man recht komfortabel Excel-Dateien auslesen und erzeugen (schreiben). Hier ein Beispie…“

2019-03-03T19:11:59Z

Die Seite wurde neu angelegt: „Kategorie:Codeschnipsel Mit dem Java-Framework Apache POI kann man recht komfortabel Excel-Dateien auslesen und erzeugen (schreiben). Hier ein Beispie…“

Neue Seite

[[Kategorie:Codeschnipsel]]
Mit dem Java-[[Framework]] Apache POI kann man recht komfortabel Excel-Dateien auslesen und erzeugen (schreiben).

Hier ein Beispiel zum Auslesen einer beliebigen Excel-Datei. Das heißt, wir verarbeiten das binäre Format (.xls) sowie das auf XML basierende Format .xslx .

==Excel-Datei einlesen==
Wir schreiben uns zunächst eine [[Klasse]], die zwei private [[Methoden]] implementiert, die die beiden Dateitypen separat verarbeiten:
<syntaxhighlight lang="java" line="true">
import org.apache.poi.EncryptedDocumentException;
import org.apache.poi.hssf.usermodel.HSSFWorkbook;
import org.apache.poi.openxml4j.exceptions.InvalidFormatException;
import org.apache.poi.openxml4j.opc.OPCPackage;
import org.apache.poi.poifs.filesystem.POIFSFileSystem;
import org.apache.poi.ss.usermodel.Cell;
import org.apache.poi.ss.usermodel.CreationHelper;
import org.apache.poi.ss.usermodel.DateUtil;
import org.apache.poi.ss.usermodel.FormulaEvaluator;
import org.apache.poi.ss.usermodel.Row;
import org.apache.poi.ss.usermodel.Sheet;
import org.apache.poi.ss.usermodel.Workbook;
import org.apache.poi.ss.util.WorkbookUtil;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;

/**
* ExcelFileProxy liest die Excel-Datei ein und erzeugt ein tabellarisches
* Abbild der Arbeitsmappe in Form von verschachtelten Listen.
*
* @author Gernot Segieth
*/
public class ExcelFileReader {
private Workbook workbook

/**
* Liest die ihm übergebene Excel-Datei ein und erzeugt ein tabellarisches Abbild
* davon.
*
* @param excelFile Die einzulesene Excel-Datei
* @throws java.lang.ClassNotFoundException wenn eine Klasse nicht gefunden
* wurde
* @throws java.io.IOException wenn die Datei nicht eingelesen werde konnte
* @throws org.apache.poi.openxml4j.exceptions.InvalidFormatException wenn
* es Probleme mit dem Format der Datei oder der Verschlüsselung gibt
*/
public ExcelFileReader(File excelFile) throws ClassNotFoundException, IOException, InvalidFormatException {
createWorkbook(excelFile);
}

private void readHSSFWorkbook(File file) throws IOException {
POIFSFileSystem fs = new POIFSFileSystem(file);
workbook = new HSSFWorkbook(fs.getRoot(), true);
fs.close();
}

private void readXSSFWorkbook(File file) throws InvalidFormatException, IOException {
OPCPackage pkg = OPCPackage.open(file);
workbook = new XSSFWorkbook(pkg);
pkg.close();
}

}
</syntaxhightlight>

Anschließend eine fügen wir die bereits im Konstruktor aufgerufene [[Methode]], die die Dateitypen unterscheidet, unsere eben erstellten Methoden aufruft und damit das <code>Workbook</code> aus der übergebenen Datei ({{JAPI|File}} erzeugt, ein.
<syntaxhighlight lang="java" line="true">
private void createWorkbook(File file) throws ClassNotFoundException, IOException, InvalidFormatException {
String filename = file.getName().toLowerCase();
try {
if (filename.endsWith(".xls")) {
readHSSFWorkbook(file);
} else if (filename.endsWith(".xlsx")) {
readXSSFWorkbook(file);
} else {
throw new IllegalArgumentException("Ausnahmefehler: Die übergebene Datei " + file.getName() + " ist keine valide Microsoft Excel-Datei (*.xls bzw. *.xlsx)!");
}
} catch (IOException ioe) {
System.err.println(getClass().getName() + ": " + ioe);
throw new IOException("Ausnahmefehler: Die Datei " + file.getName() + " konnte nicht eingelesen werden!");
} catch (EncryptedDocumentException ede) {
System.err.println(getClass().getName() + ": " + ede);
throw new EncryptedDocumentException("Ausnahmefehler: Die Datei " + file.getName() + " ist mit einem Passwort geschützt und kann daher nicht geöffnet werden!");
} catch (NoClassDefFoundError err) {
System.err.println(getClass().getName() + ": " + err.toString());
throw new ClassNotFoundException("Schwerer Ausnahmefehler: Klassendefinition nicht gefunden!\nPrüfen Sie die Programmdateien und externen Bibliotheken auf Vollständigkeit!");
}
}
</syntaxhightlight>

Damit haben wir den Code zum Öffnen und Einlesen von Excel-Dateien schon geschrieben.

==Workbook auslesen==
Eine Excel-Datei wird als <code>Workbook</code> bezeichnet und besteht aus mindestens einem Arbeitsblatt. Wir sprechen hier vom [[Interface]] <code>Sheet</code>. Ein Arbeitsblatt enthält wiederum Zellen, die in POI als Spalten in Zeilen organisiert sind und mit dem Interface <code>Cell</code> repräsentiert werden. Eine Zelle kann verschiedene Zelltypen haben, die in der Enumeration <code>CellType</code> aufgelistet sind.

Ein Arbeitsblatt besteht also aus Zeilen, über die in einer Schleife iteriert werden kann.

===Workbook vollständig auslesen==
In diesem Abschnitt schreiben wir uns den Code zum vollständigen Auslesen '''eines''' Arbeitsblattes einer Excel-Datei.
<syntaxhighlight lang="java" line="true">
/**
* Gibt den Inhalt des übergebenen Tabellenblattes in einer Liste
* die Listen mit Objekten speichert, zurück.
*
* @param sheetIndex der Index des Tabellenblattes
* @return eine Liste aus Listen (Zeilen mit Spalten)
*/
public List<List<?>> getSheetContent(int sheetIndex) {
evaluator = workbook.getCreationHelper().createFormulaEvaluator();
Sheet sheet = workbook.getSheetAt(sheetIndex);
List<List<?>> sheetData = new ArrayList<>();

for (Row row : sheet) {

if (row != null) {
List<Object> rowData = new ArrayList<>();
boolean isEmptyRow = true; //Zeile erstmal als leer ansehen

for (Cell cell : row) {

if (cell != null) {

switch (cell.getCellType()) {
case STRING:
String string = cell.getRichStringCellValue().getString();
if (string.isEmpty()) {
rowData.add(null);
} else {
rowData.add(string.trim());
isEmptyRow = false;
}
break;
case NUMERIC:
if (DateUtil.isCellDateFormatted(cell)) {
Date date = cell.getDateCellValue();
if (date.toString().isEmpty()) {
rowData.add(null);
} else {
rowData.add(date);
isEmptyRow = false;
}
} else {
Number number = cell.getNumericCellValue();
if (number.toString().isEmpty()) {
rowData.add(null);
} else {
rowData.add(number);
isEmptyRow = false;
}
}
break;
case BOOLEAN:
Boolean bool = (cell.getBooleanCellValue());
if (bool.toString().isEmpty()) {
rowData.add(null);
} else {
rowData.add(bool);
isEmptyRow = false;
}
break;
case _NONE:
case FORMULA:
case BLANK:
case ERROR:
default:
rowData.add(null);
break;
}
} else {
rowData.add(null);
}
}
if (!isEmptyRow) { //leere Zeilen nicht aufnehmen
sheetData.add(rowData);
}
}
}
return sheetData;
}
</syntaxhightlight>

===Workbook teilweise auslesen===
{{In Arbeit}}