| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 3rd-party product dependencies
Documentation Author(s): Introduction Run-time dependencies Castor XML Castor XML - schema support files Castor XML - code generator Ant task definition for the Castor XML code generator Castor JDO Castor JDO samples Castor DSML Compile-time dependencies IntroductionThis document provides information about run-time and compile-time dependencies to 3rd-party frameworks/tools. Following this information, you'll be able to download all required JARs and configure your devlopment/run-time environment according to your needs. We strogly encourage you, though, to consider using Maven 2 for your build management (process). Information of how to use Castor with Maven 2 is provided here. Run-time dependenciesAs many other frameworks, Castor internally makes use of various existing frameworks and products to implement its functionality. As such, in order to function properly, Castor requires that these tools are available at run-time. The following table(s) enlists 3rd-party products required at run-time, though many of these JARs are required only if the feature associated with that JAR is used at all. Castor XML
Please check this page for details about the use of XML parsers with Castor and its requirements. You'll require the following (optional) JARs, if you plan to use XML validation based on regular expressions:
Please note that the version numbers given specify the minimal version Castor requires. As such, please feel free to use any higher release numbers at your convenience. If any issues arise as a result of switching towards a higher release number, please report any such issues through the mailing lists, or raise a Jira issue. Castor XML - schema support filesThe Castor XML schema support internally uses Castor XML for processing the XML schemas to be processed, and thus has the same dependencies as enlisted above. Castor XML - code generatorThe Castor XML code generator internally uses Castor XML and Castor XML schema support for processing the XML schemas to be processed, and thus has the joined dependencies of those two packages. In addition to the dependencies for the Castor XML code generator, the Castor XML code generator will require additional dependencies as enlisted below:
These dependencies are optional as the use of Velocity-based templates for XML code generation is optional with release 1.2 and higher. Once you enable this mode, all dependencies given turn required. Please refer to here for details on these code generation modes. Ant task definition for the Castor XML code generatorThe Ant task definition for the Castor XML code generator internally uses the Castor XML code generator, and thus has the same dependencies as enlisted above. In addition to the dependencies for the Castor XML code generator, the Ant task definition for the Castor XML code generator will require additional dependencies as enlisted below:
Castor JDOCastor JDO internally uses Castor XML and Castor XML schema support for processing the XML mapping file and thus has the same dependencies as enlisted above. As such, in addition to the dependencies for Castor XML, Castor JDO will require additional dependencies as enlisted below:
Castor JDO samplesThe JDO examples use Apache Derby and depend on the JDBC driver provided with the examples archive. This driver is only required for running the samples and is not required otherwise, especially if you use a different database server. As such, in addition to the dependencies for Castor JDO, the Castor JDO samples will require additional dependencies as enlisted below:
Castor DSMLCastor DSML has a dependency on Apache Xerces to provide the XML serializer package for XML document production. Castor DSML has two implementations, one that uses JNDI and one that uses the Mozilla Directory SDK. Applications that use the JNDI package ( org.exolab.castor.dsml.jndi ) are required to include jndi.jar or any alternative JAR that includes the JNDI 1.2 API. Applications that use the Mozilla Directory SDK ( org.exolab.castor.dsml.mozilla ) are required to include ldapjdk.jar or any alternative JAR that includes version 4.0 of the Mozilla Directory SDK. We recommend using the Mozilla Directory SDK as the JNDI LDAP service provider and have had positive experiences using it with OpenLDAP. The JNDI LDAP service provider is included in the ldapsp.jar. As such, in addition to the dependencies for Castor XML, Castor DSML will require additional dependencies as enlisted below:
Compile-time dependenciesIn addition to the run-time dependencies given above, developing with and in Castor will require additional dependencies as enlisted below:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||