Download one of the jibx-ws packages:
Unpacking the zip file will create a jibxws directory that contains the distribution files, including a complete copy of this documentation in the /docs directory. The /build directory provides the full JiBX/WS source and the actual Ant build file, while the /starter and /examples directories contain the starter and example applications (with their own build files). The jibx-ws.jar file containing the compiled JiBX/WS code is in the /lib directory.
The jar files that JiBX/WS depends on are in the /dep-lib folder. JiBX/WS can be used without the Spring Framework, however if you do wish to use it with Spring, the additional jars are in the /spring-lib folder.
If using the minimal distribution, JiBX/WS requires the jibx-bind, jibx-extras, jibx-run and xbis-jibx jars from the JiBX installation. There are 4 configuration options:
Alternatively, the easiest way to install all the jars that JiBX/WS depends on is to run the "ant retrieve" target from the build folder of the download. This target installs and uses Ivy to download the dependencies. The ivy.xml file describes the dependencies.
In order to use JiBX/WS, you'll need at least a basic understanding of JiBX.
The starter application contains a manually created JiBX binding file. If you are not using existing binding files, the recommended approach is to use the JiBX generator tools. These provide a simple, flexible means for generating bindings, and will also generate an XML schema definition if starting from code, or the Java data model if starting from an XML schema.
The starter application, in the /starter folder, illustrates these basic steps required to build a JiBX/WS application:
These steps assume the application is running SOAP over HTTP using a text encoding. For other options, configuration changes are required. To run over TCP, JiBX/WS includes a TcpServer, which does not require the service to be packaged as a .war file.
Building and running
The Starter Application can be run using Ant, Maven or Gradle. See /starter/README.html for further details.