Binary or source?
Most users will want to download a binary release of XMLBeans. If you're interested in contributing or like to live on the bleeding edge, you may want to compile the source for yourself.
XMLBeans requires JDK 1.6. Last version to work with JDK 1.4 is 2.6.0 which has not been updated in a while.
Once you've downloaded the distribution or checked out the source, you should:
26 March 2019 - XMLBeans 3.1.0 available
The Apache POI team is pleased to announce the release of XMLBeans 3.1.0. Featured are a handful of bug fixes and packaging cleanup.
A summary of changes is available in the Release Notes. A full list of changes is available in the change log or the corresponding Jira ticket. People interested should also follow the dev list to track progress.
The XMLBeans source release as well as the pre-built binary deployment packages are listed below. Pre-built versions are available in the central Maven repository under Group ID "org.apache.xmlbeans" and Version "3.1.0".
SHA256 checksum: abc4883f38b6147090c5995a31ec71b5c8d8207e03665acadc076c1fc21c8b32
SHA512 checksum: cc744021b0c8aa89ed2e4ccb8dd460d854c7c9431ad90b462f13e47493c626a6fe5bd12b0ff5bc3f2ca556a3f57d2b230baf15d47a6bcf78be61fced47314034
SHA256 checksum: dea9b80f636268634338914e32fd0f057c85195060dc99300efadd3b30b96b3a
SHA512 checksum: c6db9849104da634a3e64773a5db4e992afc1a9f767f0209432a820137fbb751dfc0abcb484636f256d2cdc900ec7c7b241dac6e9e3dbcb94dc4a190625bd090
SHA256 checksum: 4bb715283c970ddeaecdd63909bd7f8d43a3bebb644af517ceff97a7b763edd9
SHA512 checksum: 4493509c3e74ef103b95b84f9a3c9aebd9fa7c5b569ac2bddf1857d01e65f417350ca670eef7d323053b1448dfdcbac465fe11446ab1a37e52e7be9e1f725d03
SHA256 checksum: 04341d9439328acd28b10594693654fb5ed1b324f71441722115769bda698f8c
SHA512 checksum: 0271d19e8864504ade6a4872ec2302718cea86efb624db389a965c274a9ccaa2c0279ab05c8b432a32fa4e007c6e774319c90d5f4298cc2b49f2afd9fb9ef5d5
It is essential that you verify the integrity of the downloaded files using the PGP and SHA signatures. Please read Verifying Apache HTTP Server Releases for more information on why you should verify our releases. This page provides detailed instructions which you can use for POI artifacts.
The PGP signatures can be verified using PGP or GPG. First download the KEYS file as well as the .asc signature files for the relevant release packages. Make sure you get these files from the main distribution directory, rather than from a mirror. Then verify the signatures.
As an example:
% pgpk -a KEYS % pgpv xmlbeans-X.Y.Z.jar.asc
% pgp -ka KEYS % pgp xmlbeans-X.Y.Z.jar.asc
% gpg --import KEYS % gpg --verify xmlbeans-X.Y.Z.jar.asc xmlbeans-X.Y.Z.jar
Sample verification of xmlbeans-bin-3.1.0.tgz
% gpg --import KEYS gpg: key 38DAC8E212DAE9BE: "Glen Stampoultzis <glens at apache.org>" not changed gpg: key F5C260164CEED75F: 32 duplicate signatures removed gpg: key F5C260164CEED75F: 108 signatures not checked due to missing keys gpg: key F5C260164CEED75F: 1 signature reordered gpg: key F5C260164CEED75F: "Nick Burch <nick at gagravarr.org>" not changed gpg: key 8AAF88D6D84E41AE: 1 duplicate signature removed ... % gpg --verify xmlbeans-bin-3.1.0.tgz.asc gpg: assuming signed data in `xmlbeans-bin-3.1.0.tgz' gpg: Signature made Fri, Mar 22, 2019 3:09:34 PM PDT using RSA key ID D5718BA4 gpg: Good signature from "Greg Woolsey <firstname.lastname@example.org>" gpg: aka "Greg Woolsey (personal) <email@example.com>" % gpg --fingerprint D5718BA4 pub 2048R/1556F3A4 2016-10-04 Key fingerprint = 6072 A0C8 CE08 EAAA BF39 ED4F 2D15 E54A 1556 F3A4 uid Greg Woolsey <firstname.lastname@example.org> uid Greg Woolsey (personal) <email@example.com> sub 2048R/8CF53C56 2016-10-04 sub 4096R/D5718BA4 2017-01-09
Using XPath/XQuery requires an additional download of saxonb9-0-0-4j.zip and placing on the classpath of the files saxon9.jar and saxon9-dom.jar that it contains. The zip is available here. We cannot distribute this zip in a binary distribution due to licensing issues.
There are a few ways to get the XMLBeans source code. You can download the source for a particular release, browse the source using ViewSVN/CVS, or check the source out from SVN.
Source via ViewSVN/CVS
You can browse the XMLBeans source via ViewSVN/CVS
Source via SVN checkout
In SVN, you will find the actively developed version of XMLBeans under "trunk". Under "tags" there are a number of tags corresponding to the released versions of XMLBeans, as an alternative to downloading the source distribution (there are additional things like tests, which are not included in the distribution as well).
If you have SVN installed on your machine you can issue the following commands to get XMLBeans source:
# get the version of XMLBeans under development svn co https://svn.apache.org/repos/asf/xmlbeans/trunk/ xmlbeans # or, just get the samples for XMLBeans svn co https://svn.apache.org/repos/asf/xmlbeans/trunk/samples/ xmlbeans-samples
Source via Git
Please see the Git at Apache page for details. As of this writing the Git acess is read-only.
Git Clone URL: git://git.apache.org/xmlbeans.git
Http Clone URL: http://git.apache.org/xmlbeans.git
XMLBeans requires that you have Ant installed (1.6.5 works fine).
After the steps above you should see an "xmlbeans" directory (or you can choose a different name in the previous step, of course):
cd xmlbeans\ xbeanenv ant
This will create a build directory containing the executables. The xbean.jar is in the xmlbeans\ar directory. Try ant -projecthelp to see other build options.
Building on Unix or Cygwin is essentially the same as for Windows:
cd xmlbeans/ ./xbeanenv.sh ant