Castor reference guide

Castor 1.3 - Reference documentation

Castor 1.3

Copyright © 2006-2008

Copies of this document may be made for your own use and for distribution to others, provided that you do not charge any fee for such copies and further provided that each copy contains this Copyright Notice, whether distributed in print or electronically.

1. Castor XML - XML data binding................................................................................................... 1 1.1. XML framework ................................................................................................................ 1 1.1.1. Introduction ............................................................................................................ 1 1.1.2. Castor XML - The XML data bindingframework ...................................................... 1 1.1.3. Sources and destinations .......................................................................................... 4 1.1.4. XMLContext - A consolidated way to bootstrap Castor .............................................. 4 1.1.5. Using existing Classes/Objects................................................................................. 5 1.1.6. Class Descriptors ..................................................................................................... 5 1.2. XML Mapping ................................................................................................................... 6 1.2.1. Introduction............................................................................................................ 6 1.2.2. Overview ................................................................................................................ 6 1.2.3. The Mapping File .................................................................................................... 8 1.2.4. Usage Pattern........................................................................................................ 21 1.2.5. xsi:type ................................................................................................................. 24 1.2.6. Location attribute .................................................................................................. 26 1.2.7. Tips...................................................................................................................... 27 1.3. Configuring Castor XML (Un)Marshaller .......................................................................... 28 1.3.1. Introduction .......................................................................................................... 28 1.3.2. Configuring the Marshaller ....................................................................................28 1.3.3. Configuring the Unmarshaller ................................................................................ 28 1.4. Usage of Castor and XML parsers ..................................................................................... 28 1.5. XML configuration file ..................................................................................................... 29 1.5.1. News.................................................................................................................... 29 1.5.2. Introduction .......................................................................................................... 29 1.5.3. Accessing the properties from within code .............................................................. 33 1.6. Castor XML - Tips &Tricks ............................................................................................. 33 1.6.1. Logging and Tracing ............................................................................................. 33 1.6.2. Indentation ............................................................................................................ 34 1.6.3. XML:Marshal validation...