MOXy!

[jason]

As of now, docx4j in GitHub can easily be made to use MOXy (http://www.eclipse.org/eclipselink/moxy.php ) as its JAXB implementation.

There are a few longstanding issues with the Sun/Oracle JAXB in Java 6/7:

• its fairly broken XPath implementation (see http://java.net/jira/browse/JAXB-459 and http://java.net/jira/browse/JAXB-874 ).
  The xpath expressions are evaluated against the XML document as it was when first opened in docx4j. You can update the associated XML document once only, by passing true into getJAXBNodesViaXPath. Updating it again with current JAXB 2.1.x or 2.2.x) will cause an error.
• cases where getParent won't work (see http://java.net/projects/jaxb/lists/use ... message/20 )

Hopefully MOXy doesn't suffer from these deficiencies. In any case, the MOXy guys have been really responsive so far (via StackOverflow), so I'm confident they'd help with any issues we uncover.

To use MOXy as your JAXB implementation
# 1. in pom.xml, uncomment the org.eclipse.persistence.moxy dependency, and the EclipseLink Repo
# 2. run ant JAXB-use-MOXy

To switch back to the Oracle / reference implementation
# 1. run ant JAXB-switch-from-MOXy-to-Oracle
# 2. in pom.xml, comment those things again

If you are successfully using MOXy, your logs should contain:

Code: Select all

INFO org.docx4j.jaxb.Context .<clinit> line 70 - MOXy JAXB implementation intended..
INFO org.docx4j.jaxb.Context .<clinit> line 102 - loading Context jc
INFO org.docx4j.jaxb.Context .<clinit> line 112 - loaded org.eclipse.persistence.jaxb.JAXBContext .. loading others ..
INFO org.docx4j.jaxb.Context .<clinit> line 115 - MOXy is being used.


Another way to try using MOXy is to download it from http://www.eclipse.org/eclipselink/downloads/ and use http://www.docx4java.org/docx4j/docx4j- ... 121106.jar

I tried it with:

Code: Select all

         +- org.eclipse.persistence:org.eclipse.persistence.moxy:jar:2.4.1
         |  +- org.eclipse.persistence:org.eclipse.persistence.core:jar:2.4.1
         |  |  \- org.eclipse.persistence:org.eclipse.persistence.asm:jar:3.3.1.v201206041142
         |  \- org.eclipse.persistence:org.eclipse.persistence.antlr:jar:3.2.0.v201206041011      


I'm thinking the next release of docx4j will be designated 3.0, to make it easy to know the point at which MOXy support was offered.

Feedback welcome.

[jason]

Hmmm, see http://stackoverflow.com/questions/1324 ... ong-object

Please wait until this issue is addressed before trying it out!

[bdoughan]

We're very happy to see docx4j using MOXy. I came across the corresponding issue on Stack Overflow and haven't been able to reproduce the results. I have posted an answer that contains what I have tried so far. Could someone take a look at it and help me refine the test case?

- http://stackoverflow.com/a/13249757/383861

-Blaise

Blaise Doughan
Team Lead, EclipseLink MOXy

[jason]

Hi Blaise

Thanks for taking an interest in what we're doing.

I've updated the question on SO with a test case based on yours, which exhibits the issue.

cheers .. Jason

[bdoughan]

Hi Jason,

We have been able to reproduce the error you are seeing in EclipseLink 2.4.1. We have not been able to reproduce the issue in the EclipseLink 2.4.2 or 2.5.0 streams. I would recommend downloading the latest 2.4.2 nightly build and trying it out:

- http://www.eclipse.org/eclipselink/downloads/nightly.php

We are still investigating this issue to ensure that it is truly fixed.

-Blaise

[jason]

To enable MOXy in docx4j 3, you need:

1. the relevant EclipseLink jars
2. docx4j-MOXy-JAXBContext-3.0.0.jar (which just contains the jaxb.properties files)

The jaxb.properties files just say:

javax.xml.bind.context.factory=org.eclipse.persistence.jaxb.JAXBContextFactory

If you are using maven, you'll just need to add:

<dependency>
<groupId>org.docx4j</groupId>
<artifactId>docx4j-MOXy-JAXBContext</artifactId>
<version>3.0.0</version>
</dependency>
<dependency>
<groupId>org.eclipse.persistence</groupId>
<artifactId>org.eclipse.persistence.moxy</artifactId>
<version>2.5.1</version>
</dependency>

docx4j-MOXy-JAXBContext isn't in Maven Central quite yet; get it from

http://www.docx4java.org/docx4j/docx4j- ... -3.0.0.jar

[jason]

Its in Maven Central now (along with docx4j v3); see http://search.maven.org/#browse%7C-2131768902

[PUE]

Does Java 8 also suffer from those issues?