Here I will show you how to parse a docx file and map it to a Java object (POJO). You can download the final code from this example here: . https://github.com/e-reznik/DocxJavaMapper-example Technical Background Docx is a standard document format, first introduced in 2007 with the release of Microsoft Office 2007. It stores documents as a set of individual folders and files in a zip archive, unlike the old doc format that uses binary files. Docx files can be opened by Microsoft Word 2007 and later, and by some open source office products, like and . To simply view the contents of a docx, change its extension to .zip and view the resulting archive using any file archiver. LibreOffice OpenOffice The main content is located in the file document.xml in the folder word. It contains the actual text and some styling information of the entire document. This is the file we will be focusing on in this tutorial. Detailed information about the structure of a docx can be found at . http://officeopenxml.com/anatomyofOOXML.php First, we will extract the docx archive. Next, we will read and map the file word/document.xml to a Java object, which can be used for further processing. Creating an example docx file We need to create a simple docx that we will be using throughout this tutorial. I created a short text with some simple formatting: Extracting document.xml We need to locate and extract the contents of document.xml. As already mentioned, a docx can be handled like a regular zip file. For reading entries from a zip file, Java provides us with the class . We create a new instance and pass our docx file as a parameter to the constructor. To the method public ZipEntry getEntry(String name) we pass the entry that we want to read. In our case, it’s document.xml which is in the folder word. Finally, we return the input stream of that specific entry, so that we can read its contents. ZipFile { ZipFile zipFile = ZipFile(docx); ZipEntry zipEntry = zipFile.getEntry( ); zipFile.getInputStream(zipEntry); } InputStream IOException public static getStreamToDocumentXml (File docx) throws new "word/document.xml" return We can call that method and save its return value as an InputStream. Viewing and interpreting the results For testing purposes, we can return the content of the document.xml as a string. String text = BufferedReader( InputStreamReader(inputStream, StandardCharsets.UTF_8)) .lines() .collect(Collectors.joining( )); System.out.println(text); new new "\n" This is the result xml. Can you find and interpret our example text (see above)? <?xml version= encoding= standalone= ?> <w:document xmlns:o= xmlns:r= xmlns:v= xmlns:w= xmlns:w10= xmlns:wp= xmlns:wps= xmlns:wpg= xmlns:mc= xmlns:wp14= xmlns:w14= mc:Ignorable= ><w:body><w:p><w:pPr><w:pStyle w:val= /><w:bidi w:val= /><w:jc w:val= /><w:rPr><w:color w:val= /><w:lang w:val= w:eastAsia= w:bidi= /></w:rPr></w:pPr><w:r><w:rPr><w:color w:val= /><w:sz w:val= /><w:szCs w:val= /><w:u w:val= /><w:lang w:val= w:eastAsia= w:bidi= /></w:rPr><w:t>This</w:t></w:r><w:r><w:rPr><w:color w:val= /><w:sz w:val= /><w:szCs w:val= /><w:lang w:val= w:eastAsia= w:bidi= /></w:rPr><w:t xml:space= > is my </w:t></w:r><w:r><w:rPr><w:b/><w:bCs/><w:i/><w:iCs/><w:color w:val= /><w:sz w:val= /><w:szCs w:val= /><w:lang w:val= w:eastAsia= w:bidi= /></w:rPr><w:t>example</w:t></w:r><w:r><w:rPr><w:color w:val= /><w:sz w:val= /><w:szCs w:val= /><w:lang w:val= w:eastAsia= w:bidi= /></w:rPr><w:t xml:space= > text.</w:t></w:r></w:p><w:sectPr><w:type w:val= /><w:pgSz w:w= w:h= /><w:pgMar w:left= w:right= w:header= w:top= w:footer= w:bottom= w:gutter= /><w:pgNumType w:fmt= /><w:formProt w:val= /><w:textDirection w:val= /><w:docGrid w:type= w:linePitch= w:charSpace= /></w:sectPr></w:body></w:document> "1.0" "UTF-8" "yes" "urn:schemas-microsoft-com:office:office" "http://schemas.openxmlformats.org/officeDocument/2006/relationships" "urn:schemas-microsoft-com:vml" "http://schemas.openxmlformats.org/wordprocessingml/2006/main" "urn:schemas-microsoft-com:office:word" "http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing" "http://schemas.microsoft.com/office/word/2010/wordprocessingShape" "http://schemas.microsoft.com/office/word/2010/wordprocessingGroup" "http://schemas.openxmlformats.org/markup-compatibility/2006" "http://schemas.microsoft.com/office/word/2010/wordprocessingDrawing" "http://schemas.microsoft.com/office/word/2010/wordml" "w14 wp14" "Normal" "0" "left" "2A6099" "en-US" "zh-CN" "hi-IN" "2A6099" "28" "28" "single" "en-US" "zh-CN" "hi-IN" "2A6099" "28" "28" "en-US" "zh-CN" "hi-IN" "preserve" "2A6099" "28" "28" "en-US" "zh-CN" "hi-IN" "2A6099" "28" "28" "en-US" "zh-CN" "hi-IN" "preserve" "nextPage" "11906" "16838" "1134" "1134" "0" "1134" "0" "1134" "0" "decimal" "false" "lrTb" "default" "100" "0" The document.xml follows a specific structure displayed below. This illustration only shows the elements, that are relevant in this example. More information about the xml structure in that file can be found at . http://officeopenxml.com/WPcontentOverview.php Mapping contents to a Java object Now, that we can read the contents of a docx, we should be able to parse and map it to a POJO. Doing so, we will need to use some tools and create some POJOs in order to map our xml file. Setting up required tools 1. Maven build automation tool 2. JAXB tool for mapping xml documents and Java objects I will use the Eclipse Implementation of JAXB 3. Lombok Reduces boilerplate code You can simply copy the required dependencies in your pom.xml: jakarta.xml.bind jakarta.xml.bind-api 3.0.0 com.sun.xml.bind jaxb-impl 3.0.0 runtime org.projectlombok lombok 1.18.16 < > dependency < > groupId </ > groupId < > artifactId </ > artifactId < > version </ > version </ > dependency < > dependency < > groupId </ > groupId < > artifactId </ > artifactId < > version </ > version < > scope </ > scope </ > dependency < > dependency < > groupId </ > groupId < > artifactId </ > artifactId < > version </ > version </ > dependency Creating POJOs In order to be able to map the document.xml to our Java object, we need to create some classes, following the structure of our file (see above). Every document has 1 node document, which itself has 1 node body. We only need getters in order to access its contents later. The fields can be private. Using the and JAXB, the POJO (or DTO) for our document element would look like: annotations from Lombok (level = AccessLevel.PRIVATE) (name = ) (XmlAccessType.FIELD) { (name = ) DJMBody body; } @Getter @FieldDefaults @XmlRootElement "document" @XmlAccessorType public class DJMDocument @XmlElement "body" 1 body can have multiple paragraphs, that’s why we need to map the paragraphs to a list. The setter is private, because we only need it internally, inside of the class itself. The POJO for the body looks like: (level = AccessLevel.PRIVATE) { List<BodyElement> bodyElements; ({ (name = , type = DJMParagraph.class) }) { bodyElements; } { .bodyElements = bodyElements; } } @FieldDefaults public class DJMBody @XmlElements @XmlElement "p" List<BodyElement> public getBodyElements () return private void setBodyElements (List<BodyElement> bodyElements) this Similarly, we need to create a class for every element that we want to map to. I will not go too much into detail here. As already mentioned, you can find the complete example project in my GitHub account. Checking the results After successfully creating all required classes, we want to check whether we can get the actual text of our docx. The following method iterates through the document, finds all the runs, appends their texts to a StringBuffer and returns it: { StringBuilder stringBuilder = StringBuilder(); (BodyElement bodyElement : djmDocument.getBody().getBodyElements()) { (bodyElement DJMParagraph) { DJMParagraph dJMParagraph = (DJMParagraph) bodyElement; (ParagraphElement paragraphElement : dJMParagraph.getParagraphElements()) { (paragraphElement DJMRun) { DJMRun dJMRun = (DJMRun) paragraphElement; stringBuilder.append(dJMRun.getText()); } } } } stringBuilder.toString(); } String public static getTextFromDocument (DJMDocument djmDocument) new // Different elements can be of type BodyElement for // Check, if current BodyElement is of type DJMParagraph if instanceof // Different elements can be of type ParagraphElement for // Check, if current ParagraphElement is of type DJMRun if instanceof return Executing that method, we receive our text from the document: This example . is my text But how can we get the text formattings, like colors, fonts etc.? Using a debugger, we can take a look at our newly created document object during runtime. Unsurprisingly, we can find all the attributes that we set in your docx: Besides the actual text, we can see the font, color and if a particular word is bold. If we slightly change our method, we can find all words in our text, and put them into a list: bold { List<String> boldWords = ArrayList<>(); (BodyElement bodyElement : djmDocument.getBody().getBodyElements()) { (bodyElement DJMParagraph) { DJMParagraph dJMParagraph = (DJMParagraph) bodyElement; (ParagraphElement paragraphElement : dJMParagraph.getParagraphElements()) { (paragraphElement DJMRun) { DJMRun dJMRun = (DJMRun) paragraphElement; isBold = dJMRun.getRunProperties().isBold(); (isBold) { String text = dJMRun.getText(); boldWords.add(text); } } } } } boldWords; } List<String> public static getBoldWords (DJMDocument djmDocument) new // Different elements can be of type BodyElement for // Check, if current BodyElement is of type DJMParagraph if instanceof // Different elements can be of type ParagraphElement for // Check, if current ParagraphElement is of type DJMRun if instanceof boolean if return After executing that method, we correctly get: [my, example] Next Steps… The final code used in this tutorial can be found here: . You can clone that project, play around on your machine and try to extends it with more elements, like images, tables, lists etc. https://github.com/e-reznik/DocxJavaMapper-example A more advanced project with more mapped elements can be found here: . https://github.com/e-reznik/DocxJavaMapper You can also check out one of my other projects, where I create a pdf from a docx, using this approach: . https://github.com/e-reznik/Docx2PDF
