![]() | ![]() | ![]() | ![]() | ![]() | ![]() | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![]() | ![]() | ![]() | ![]() | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![]() | ![]() | ![]() | ![]() | ![]() | ![]() | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![]() | ![]()
|
The Castor configuration file Dependent Libraries Castor XML Castor JDO Castor DSML Building Castor Directory Structure The Castor configuration fileCastor uses a configuration file for environmental properties that are shared across all the Castor sub systems. The configuration file is specified as a Java properties file with the name castor.properties. The Castor JAR includes a default configuration file. A configuration file in the Java library directory (e.g. /jdk1.2/lib) can be used to override the default configuration file with system wide properties. In addition, a configuration file can be placed in the classpath and will override both the system wide properties and default configuration. When running the provided examples, Castor will use the configuration file located in the examples directory which specifies additional debugging information and pretty printing of all produced XML documents. The following properties are currently supported in the configuration file: # Defines the default XML parser to be used by castor # The parser must implement org.xml.sax.Parser # org.exolab.castor.parser=org.apache.xerces.parsers.SAXParser # Defines the default XML serializer to be used by castor # The serializer must implement org.apache.xml.serialize.Serializer # org.exolab.castor.serializer=org.apache.xml.serialize.XMLSerializer # True if all documents should be indented on output by default # org.exolab.castor.indent=false # True if all documents should be validated on input by default # org.exolab.castor.validation=true # Comma separated list of SAX 2 features that should be enabled # for the default parser # org.exolab.castor.features= # True if should produce verbose messages # org.exolab.castor.debug=false # List of collection handlers for Java 1.1 and Java 1.2 run-times # org.exolab.castor.mapping.collections=\ org.exolab.castor.mapping.loader.J1CollectionHandlers,\ org.exolab.castor.mapping.loader.J2CollectionHandlers # List of persistence factories for the supported database servers # org.exolab.castor.jdo.engines=\ org.exolab.castor.jdo.drivers.OracleFactory,\ org.exolab.castor.jdo.drivers.PostgreSQLFactory,\ org.exolab.castor.jdo.drivers.SybaseFactory,\ org.exolab.castor.jdo.drivers.SQLServerFactory,\ org.exolab.castor.jdo.drivers.DB2Factory,\ org.exolab.castor.jdo.drivers.GenericFactory # List of key generator factories # org.exolab.castor.jdo.keyGeneratorFactories=\ org.exolab.castor.jdo.drivers.MaxKeyGeneratorFactory,\ org.exolab.castor.jdo.drivers.HighLowKeyGeneratorFactory,\ org.exolab.castor.jdo.drivers.IdentityKeyGeneratorFactory,\ org.exolab.castor.jdo.drivers.SequenceKeyGeneratorFactory # Collection handlers for the source code generator # org.exolab.castor.builder.type.j2=\ org.exolab.castor.builder.FieldInfoFactoryJ2 org.exolab.castor.builder.type.j1=\ org.exolab.castor.builder.FieldInfoFactory org.exolab.castor.builder.type.odmg=\ org.exolab.castor.builder.FieldInfoFactoryODMG30 Dependent LibrariesJARs required to build Castor and dependencies for various packages are contained in the lib directory. JARs required for distribution are marked with bold text:
Castor XMLCastor XML is dependent on the latest release of Xerces available from the library directory and XML Apache. Other XML parser may be used instead of Xerces, however, Xerces is required to provide the XML serializer package for XML document production. Castor JDOCastor JDO uses Castor XML for processing the XML mapping file and has the same dependency on Xerces. In addition applications that use Castor JDO must include jdbc-se2.0.jar or any alternative JAR that includes the javax.sql.DataSource interface. The JDO example uses the PostgreSQL database and depends on the provided JDBC driver which includes javax.sql.DataSource support. This driver is not required for distribution or if a different database server is used. Castor DSMLCastor DSML is dependent on the latest release of Xerces available from the library directory and XML Apache. Other XML parser may be used instead of Xerces, however, Xerces is required 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 positive experience using it with OpenLDAP. The JNDI LDAP service provider is included in the ldapsp.jar. Building CastorCastor uses Ant as the build environment. To build Castor from the source run build.sh or build.bat in the Castor root directory with one (or any) of the following targets:
The tarball will includes the Castor JAR, all dependent library JARs, readme and license files, and all DTDs and XML schemas in the schema directory. Directory Structure
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![]() ![]() | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![]() | ![]() | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![]() | ![]() | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![]() |