Java API til Word OOXML Documents

Kom godt i gang med Apache POI XWPF

Først og fremmest skal du have Java Development Kit (JDK) installeret på dit system. Hvis du allerede har det, så fortsæt til Apache POI's download-side for at få den seneste stabile udgivelse i et arkiv. Udpak indholdet af ZIP-filen i en hvilken som helst mappe, hvorfra de nødvendige biblioteker kan linkes til dit Java-program. Det er alt!

Det er endnu nemmere at henvise til Apache POI i dit Maven-baserede Java-projekt. Alt du behøver er at tilføje følgende afhængighed i din pom.xml og lade din IDE hente og referere til Apache POI Jar-filer.

<!-- https://mvnrepository.com/artifact/org.apache.poi/poi -->
<dependency>
  <groupId>org.apache.poi</groupId>
  <artifactId>poi</artifactId>
  <version>4.1.0</version>
</dependency>

Generer og rediger Word-dokumenter ved hjælp af Java API

Apache POI XWPF gør det muligt for softwareprogrammører at oprette nye Word-dokumenter i DOCX-filformat. Udviklere kan også indlæse en eksisterende Microsoft Word DOCX-fil for at redigere den i overensstemmelse med deres applikationsbehov. Det giver dig mulighed for at tilføje nye afsnit, indsætte tekst, anvende tekstjustering og rammer, ændre tekststil og mere.

// initialize a blank document
XWPFDocument document = new XWPFDocument();
// create a new file
FileOutputStream out = new FileOutputStream(new File("document.docx"));
// create a new paragraph paragraph
XWPFParagraph paragraph = document.createParagraph();
XWPFRun run = paragraph.createRun();
run.setText("File Format Developer Guide - " +
  "Learn about computer files that you come across in " +
  "your daily work at: www.fileformat.com ");
document.write(out);
out.close();

Føj afsnit, billede og tabel til Word-dokumenter

Apache POI XWPF giver udviklerne mulighed for at tilføje afsnit og billeder til Word-dokumenter. API'en giver også funktionen til at tilføje tabeller til DOCX-dokumenter, mens det gør det muligt at oprette enkle og indlejrede tabeller med brugerdefinerede data.

// initialize a blank document
XWPFDocument document = new XWPFDocument();
// create a new file
FileOutputStream out = new FileOutputStream(new File("table.docx"));
// create a new table
XWPFTable table = document.createTable();
// create first row
XWPFTableRow tableRowOne = table.getRow(0);
tableRowOne.getCell(0).setText("Serial No");
tableRowOne.addNewTableCell().setText("Products");
tableRowOne.addNewTableCell().setText("Formats");
// create second row
XWPFTableRow tableRowTwo = table.createRow();
tableRowTwo.getCell(0).setText("1");
tableRowTwo.getCell(1).setText("Apache POI XWPF");
tableRowTwo.getCell(2).setText("DOCX, HTML, FO, TXT, PDF");
// create third row
XWPFTableRow tableRowThree = table.createRow();
tableRowThree.getCell(0).setText("2");
tableRowThree.getCell(1).setText("Apache POI HWPF");
tableRowThree.getCell(2).setText("DOC, HTML, FO, TXT");
document.write(out);
out.close();

Uddrag tekst fra Word OOXML-dokument

Apache POI XWPF giver den specialiserede klasse til at udtrække data fra Microsoft Word DOCX-dokumenter med blot et par linjer kode. På samme måde kan den også udtrække overskrifter, fodnoter, tabeldata og så videre fra en Word-fil.

// load DOCX file
FileInputStream fis = new FileInputStream("document.docx");
// open file
XWPFDocument file  = new XWPFDocument(OPCPackage.open(fis));
// read text
XWPFWordExtractor ext = new XWPFWordExtractor(file);
// display text
System.out.println(ext.getText());

Føj tilpasset sidehoved og sidefod til DOCX-dokumenter

Sidehoved og sidefod er en vigtig del af Word-dokumentet, da de normalt indeholder ekstra information såsom datoer, sidetal, forfatterens navn og fodnoter, som hjælper med at holde længere dokumenter organiseret og lettere at læse. Apache POI XWPF giver Java-udviklere mulighed for at tilføje brugerdefinerede sidehoveder og sidefødder til Word-dokumenter.

public class HeaderFooterTable {
  public static void main(String[] args) throws IOException {
    try (XWPFDocument doc = new XWPFDocument()) {
      // Create a header with a 1 row, 3 column table
      XWPFHeader hdr = doc.createHeader(HeaderFooterType.DEFAULT);
      XWPFTable tbl = hdr.createTable(1, 3);
      // Set the padding around text in the cells to 1/10th of an inch
      int pad = (int) (.1 * 1440);
      tbl.setCellMargins(pad, pad, pad, pad);
      // Set table width to 6.5 inches in 1440ths of a point
      tbl.setWidth((int) (6.5 * 1440));
      CTTbl ctTbl = tbl.getCTTbl();
      CTTblPr ctTblPr = ctTbl.addNewTblPr();
      CTTblLayoutType layoutType = ctTblPr.addNewTblLayout();
      layoutType.setType(STTblLayoutType.FIXED);
      BigInteger w = new BigInteger("3120");
      CTTblGrid grid = ctTbl.addNewTblGrid();
      for (int i = 0; i < 3; i++) {
        CTTblGridCol gridCol = grid.addNewGridCol();
        gridCol.setW(w);
      }
      // Add paragraphs to the cells
      XWPFTableRow row = tbl.getRow(0);
      XWPFTableCell cell = row.getCell(0);
      XWPFParagraph p = cell.getParagraphArray(0);
      XWPFRun r = p.createRun();
      r.setText("header left cell");
      cell = row.getCell(1);
      p = cell.getParagraphArray(0);
      r = p.createRun();
      r.setText("header center cell");
      cell = row.getCell(2);
      p = cell.getParagraphArray(0);
      r = p.createRun();
      r.setText("header right cell");
      // Create a footer with a Paragraph
      XWPFFooter ftr = doc.createFooter(HeaderFooterType.DEFAULT);
      p = ftr.createParagraph();
      r = p.createRun();
      r.setText("footer text");
      try (OutputStream os = new FileOutputStream(new File("headertable.docx"))) {
        doc.write(os);
      }
    }
  }
}