{"id":148,"date":"2011-10-29T13:42:34","date_gmt":"2011-10-29T03:42:34","guid":{"rendered":"http:\/\/www.docx4java.org\/blog\/?p=148"},"modified":"2011-10-29T13:42:34","modified_gmt":"2011-10-29T03:42:34","slug":"hello-maven-central","status":"publish","type":"post","link":"https:\/\/www.docx4java.org\/blog\/2011\/10\/hello-maven-central\/","title":{"rendered":"Hello Maven Central"},"content":{"rendered":"

With version 2.7.1, docx4j – a library for manipulating Word docx, Powerpoint pptx, and Excel xlsx xml files in Java – and all its dependencies, are available from Maven Central.<\/p>\n

This makes it really easy to get going with docx4j.\u00a0 With Eclipse and m2eclipse installed, you just add docx4j, and you’re done.\u00a0 No need to mess around with manually installing jars, setting class paths etc.<\/p>\n

This post demonstrates that, starting with a fresh OS (Win 7 is used, but these steps would work equally well on OSX or Linux).<\/p>\n

Step 1 – Install the JDK<\/strong><\/p>\n

For the purposes of this article, I used JDK 7, but docx4j works with Java 6 and 1.5.<\/p>\n

Step 2 – Install Eclipse Indigo (3.7.1)<\/strong><\/p>\n

I normally download the version for J2EE developers. Unzip it and run eclipse<\/p>\n

Step 3 – Install m2eclipse.<\/strong><\/p>\n

In Eclipse, click Help > Install New Software.<\/p>\n

Type “http:\/\/download.eclipse.org\/technology\/m2e\/releases” in the “Work with” field as shown:<\/p>\n

\"\"<\/a><\/div>\n

then follow the prompts.<\/p>\n

Step 4 – Create your Maven project<\/strong><\/p>\n

In Eclipse, File > New > Project.., then choose Maven project<\/p>\n

You should see:<\/p>\n

\"\"<\/a><\/p>\n

<\/strong><\/p>\n

Check “Create a simple project (skip archetype selection)” then press next.<\/p>\n

Allocate group and artifact id (what you choose as your artifact id will become the name of your new project in Eclipse):<\/p>\n

\"\"<\/a><\/p>\n

Press finish<\/p>\n

This will create a project with directories using Maven conventions:<\/p>\n

\"\"<\/a><\/p>\n

(Note: If your starting point is a new or existing Java <\/strong>project in Eclipse, you can right click on the project, then choose Configure > Convert to Maven project)<\/p>\n

Step 5 – Add docx4j to your POM<\/strong><\/p>\n

Double Click on pom.xml<\/p>\n

Next click on the dependencies tab, then click the “add dependency” button, and enter the docx4j coordinates as shown in the image below:<\/p>\n

\"\"<\/a><\/p>\n

The result is this pom:<\/p>\n

\r\n\r\n<project xmlns="http:\/\/maven.apache.org\/POM\/4.0.0" xmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance" xsi:schemaLocation="http:\/\/maven.apache.org\/POM\/4.0.0 http:\/\/maven.apache.org\/xsd\/maven-4.0.0.xsd">\r\n  <modelVersion>4.0.0<\/modelVersion>\r\n  <groupId>mygroup<\/groupId>\r\n  <artifactId>myartifact<\/artifactId>\r\n  <version>0.0.1-SNAPSHOT<\/version>\r\n  <dependencies>\r\n  \t<dependency>\r\n  \t\t<groupId>org.docx4j<\/groupId>\r\n  \t\t<artifactId>docx4j<\/artifactId>\r\n  \t\t<version>2.7.1<\/version>\r\n  \t<\/dependency>\r\n  <\/dependencies>\r\n<\/project>\r\n\r\n<\/pre>\n
Ctrl-S to save it.<\/p>\n
m2eclipse may take some time to download the dependencies.<\/p>\n
When it has finished, you should be able to see them:<\/p>\n
\"\"<\/a><\/p>\n
Step 6 – Create HelloMavenCentral.java<\/strong><\/p>\n
If you made a Maven project as per step 4 above, you should already have  src\/main\/java on your build path.<\/p>\n
If not, create the folder and add it.<\/p>\n
Now add a new class:<\/p>\n
\r\nimport org.docx4j.openpackaging.packages.WordprocessingMLPackage;\r\n\r\npublic class HelloMavenCentral {\r\n\r\n\tpublic static void main(String[] args) throws Exception {\r\n\t\t\r\n\t\tWordprocessingMLPackage wordMLPackage = WordprocessingMLPackage.createPackage();\r\n\t\t\r\n\t\twordMLPackage.getMainDocumentPart()\r\n\t\t\t.addStyledParagraphOfText("Title", "Hello Maven Central");\r\n\r\n\t\twordMLPackage.getMainDocumentPart().addParagraphOfText("from docx4j!");\r\n\t\t\t\t\r\n\t\t\/\/ Now save it \r\n\t\twordMLPackage.save(new java.io.File(System.getProperty("user.dir") + "\/helloMavenCentral.docx") );\r\n\t\t\r\n\t}\t\r\n}\r\n\r\n<\/pre>\n
Step 7 – Click Run<\/strong><\/p>\n
When you click run, all being well, a new docx called helloMavenCentral.docx will be saved.<\/p>\n
You can open it in Word (or anything else which can read docx), or unzip it to inspect its contents.<\/p>\n
Step 8 – Adding docx4j.properties<\/strong><\/p>\n
One final thing. If you plan on creating documents from scratch using docx4j, it is useful to set paper size etc, via docx4j.properties.  Put something like the following on your path:<\/p>\n
# Page size: use a value from org.docx4j.model.structure.PageSizePaper enum\r\n# eg A4, LETTER\r\ndocx4j.PageSize=LETTER\r\n# Page size: use a value from org.docx4j.model.structure.MarginsWellKnown enum\r\ndocx4j.PageMargins=NORMAL\r\ndocx4j.PageOrientationLandscape=false\r\n\r\n# Page size: use a value from org.pptx4j.model.SlideSizesWellKnown enum\r\n# eg A4, LETTER\r\npptx4j.PageSize=LETTER\r\npptx4j.PageOrientationLandscape=false\r\n\r\n# These will be injected into docProps\/app.xml\r\n# if App.Write=true\r\ndocx4j.App.write=true\r\ndocx4j.Application=docx4j\r\ndocx4j.AppVersion=2.7.1\r\n# of the form XX.YYYY where X and Y represent numerical values\r\n\r\n# These will be injected into docProps\/core.xml\r\ndocx4j.dc.write=true\r\ndocx4j.dc.creator.value=docx4j\r\ndocx4j.dc.lastModifiedBy.value=docx4j\r\n\r\n#\r\n#docx4j.McPreprocessor=true\r\n\r\n# If you haven't configured log4j yourself\r\n# docx4j will autoconfigure it.  Set this to true to disable that\r\ndocx4j.Log4j.Configurator.disabled=false<\/pre>\n
And that’s it.  For more information on docx4j, see our Getting Started<\/a> document.<\/p>\n
Please click the +1 button if you found this article helpful.<\/p>\n","protected":false},"excerpt":{"rendered":"
With version 2.7.1, docx4j – a library for manipulating Word docx, Powerpoint pptx, and Excel xlsx xml files in Java – and all its dependencies, are available from Maven Central. This makes it really easy to get going with docx4j.\u00a0 With Eclipse and m2eclipse installed, you just add docx4j, and you’re done.\u00a0 No need to […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[92,71,1],"tags":[81,82,80],"class_list":["post-148","post","type-post","status-publish","format-standard","hentry","category-docx4j","category-microsoft-word","category-uncategorized","tag-eclipse","tag-m2e","tag-maven-central"],"_links":{"self":[{"href":"https:\/\/www.docx4java.org\/blog\/wp-json\/wp\/v2\/posts\/148","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.docx4java.org\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.docx4java.org\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.docx4java.org\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.docx4java.org\/blog\/wp-json\/wp\/v2\/comments?post=148"}],"version-history":[{"count":23,"href":"https:\/\/www.docx4java.org\/blog\/wp-json\/wp\/v2\/posts\/148\/revisions"}],"predecessor-version":[{"id":178,"href":"https:\/\/www.docx4java.org\/blog\/wp-json\/wp\/v2\/posts\/148\/revisions\/178"}],"wp:attachment":[{"href":"https:\/\/www.docx4java.org\/blog\/wp-json\/wp\/v2\/media?parent=148"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.docx4java.org\/blog\/wp-json\/wp\/v2\/categories?post=148"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.docx4java.org\/blog\/wp-json\/wp\/v2\/tags?post=148"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}