From: Nick Burch Date: Wed, 2 Jun 2010 11:30:13 +0000 (+0000) Subject: Update the FAQ with a note about poi-ooxml-schemas vs the full ooxml-schemas X-Git-Tag: REL_3_7_BETA1~32 X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=fe3cb0b4e35b515b3767a4b291a2198b9efbf232;p=poi.git Update the FAQ with a note about poi-ooxml-schemas vs the full ooxml-schemas git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@950499 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/src/documentation/content/xdocs/faq.xml b/src/documentation/content/xdocs/faq.xml index 87ed8c990b..829caa5f27 100644 --- a/src/documentation/content/xdocs/faq.xml +++ b/src/documentation/content/xdocs/faq.xml @@ -51,6 +51,45 @@ System.out.println("Core POI came from " + path); classpath. See the prior answer.

+ + + I'm using the poi-ooxml-schemas jar, but my code is failing with "java.lang.NoClassDefFoundError: org/openxmlformats/schemas/*something*" + + +

To use the new OOXML file formats, POI requires a jar containing + the file format XSDs, as compiled by + XMLBeans. These + XSDs, once compiled into Java classes, live in the + org.openxmlformats.schemas namespace.

+

There are two jar files available, as described in + the components overview section. + The full jar of all of the schemas is ooxml-schemas-1.0.jar, + and it is currently around 15mb. The smaller poi-ooxml-schemas + jar is only about 4mb. This latter jar file only contains the + typically used parts though.

+

Many users choose to use the smaller poi-ooxml-schemas jar to save + space. However, the poi-ooxml-schemas jar only contains the XSDs and + classes that are typically used, as identified by the unit tests. + Every so often, you may try to use part of the file format which + isn't included in the minimal poi-ooxml-schemas jar. In this case, + you should switch to the full ooxml-schemas-1.0.jar. Longer term, + you may also wish to submit a new unit test which uses the extra + parts of the XSDs, so that a future poi-ooxml-schemas jar will + include them.

+

There are a number of ways to get the full ooxml-schemas-1.0.jar. + If you are a maven user, see the + the components overview section + for the artifact details to have maven download it for you. + If you download the source release of POI, and/or checkout the + source code from subversion, + then you can run the ant task "compile-ooxml-xsds" to have the + OOXML schemas downloaded and compiled for you (This will also + give you the XMLBeans generated source code, in case you wish to + look at this). Finally, you can download the jar by hand from the + POI + Maven Repository.

+
+
Why is reading a simple sheet taking so long?