Castor (framework)

<h2 id="process-flow">Process flow</h2>
<p>Basic process flows include class generation, <a href="/facts/Marshalling_(computer_science)/NhcdrmhR">marshalling</a>, unmarshalling, etc.<a class="footnote-ref" id="fnref:5" href="#fn:5"><sup>5</sup></a>  Marshalling framework includes a set of ClassDescriptors and FieldDescription to describe objects.<a class="footnote-ref" id="fnref:6" href="#fn:6"><sup>6</sup></a>
</p>
<h2 id="class-generation">Class generation</h2>
<p>Class generation is similar to <a href="/facts/Java_Architecture_for_XML_Binding/GTgm2Vvj">JAXB</a> and Zeus.  Castor supports XML Schema instead of DTDs (DTDs are not supported by Castor).<a class="footnote-ref" id="fnref:7" href="#fn:7"><sup>7</sup></a><a class="footnote-ref" id="fnref:8" href="#fn:8"><sup>8</sup></a><a class="footnote-ref" id="fnref:9" href="#fn:9"><sup>9</sup></a>
</p>
<h2 id="unmarshalling-and-marshalling">Unmarshalling and marshalling</h2>
<p>Unmarshalling and marshalling are dealt with marshall() and unmarshall() methods respectively. During marshalling, conversion process from Java to XML is carried out, and, during unmarshalling, conversion process from XML to Java is carried out.  Mapping files are the equivalent of a binding schema, which allows to transforms names from XML to Java and vice versa.<a class="footnote-ref" id="fnref:10" href="#fn:10"><sup>10</sup></a>
</p>
<h2 id="additional-features">Additional features</h2>
<p>Castor offers some additional features which are not present in JAXB. Additional features include:
</p>
<ul><li>Database and directory server mappings - mapping between databases and directory servers to Java</li>
<li>JDO - Caster supports <a href="/facts/Java_Data_Objects/3wQjEByL">Java Data Objects</a>.<a class="footnote-ref" id="fnref:11" href="#fn:11"><sup>11</sup></a></li></ul>
<h2 id="code-samples">Code samples</h2>
<p>Code for marshalling may look like as follows:
</p>
package javajaxb;
import java.io.File;
import java.io.FileReader;
import java.io.FileWriter;
import java.io.IOException;
// Castor
import org.exolab.castor.xml.MarshalException;
import org.exolab.castor.xml.ValidationException;
// Generated hr.xml classes
import javajaxb.generated.hr.*;
public class EmployeeLister {
    // Existing methods
    public void modify()
        throws IOException, MarshalException, ValidationException {
        // Add a new employee
        Employee employee = new Employee();
        employee.setName("Ben Rochester");
        Address address = new Address();
        address.setStreet1("708 Teakwood Drive");
        address.setCity("Flower Mound");
        address.setState("TX");
        address.setZipCode("75028");
        employee.addAddress(address);
        Organization organization = new Organization();
        organization.setId(43);
        organization.setName("Technical Services");
        employee.setOrganization(organization);
        Office office = new Office();
        office.setId(241);
        Address officeAddress = new Address();
        officeAddress.setStreet1("1202 Business Square");
        officeAddress.setStreet2("Suite 302");
        officeAddress.setCity("Dallas");
        officeAddress.setState("TX");
        officeAddress.setZipCode("75218-8921");
        office.setAddress(officeAddress);
        employee.setOffice(office);
        // Add employee to list
        employees.addEmployee(employee);
        // marshal
        employees.marshal(new FileWriter(outputFile));
    }
    public static void main(String[] args) {
        try {
            if (args.length != 2) {
                System.out.println("Usage: java javajaxb.EmployeeLister
" +
                    "[web.xml filename] [output.xml filename]");
                return;
            }
            EmployeeLister lister = 
                new EmployeeLister(new File(args[0]), new
File(args[1]));
            lister.list(true);
            lister.modify();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }   
}
<p><a class="footnote-ref" id="fnref:12" href="#fn:12"><sup>12</sup></a>
</p><p>Code for unmarshalling may look like as follows:
</p>
      package javajaxb;
import java.io.File;
import java.io.FileReader;
import java.io.IOException;
// Castor
import org.exolab.castor.xml.MarshalException;
import org.exolab.castor.xml.ValidationException;
// Generated hr.xml classes
import javajaxb.generated.hr.*;
public class EmployeeLister {
    /** The descriptor to read in */
    private File descriptor;
    /** The output file to write to */
150
    private File outputFile;
    /** The object tree read in */
    private Employees employees;
    public EmployeeLister(File descriptor, File outputFile) {
        employees = null;
        this.descriptor = descriptor;
        this.outputFile = outputFile;
    }
    public void list(boolean validate) 
        throws IOException, MarshalException, ValidationException {
        // Unmarshall
        employees = Employees.unmarshal(new FileReader(descriptor));
        // Do some basic printing
        System.out.println("--- Employee Listing ---\n");
        Employee[] employeeList = employees.getEmployee();
        for (int i=0; i<employeeList.length; i++) {
            Employee employee = employeeList[i];
            System.out.println("Employee: " + employee.getName());
            System.out.println("Organization: " + 
                employee.getOrganization().getName());
            System.out.println("Office: " + 
                employee.getOffice().getAddress().getCity() + ", " +
                employee.getOffice().getAddress().getState() + "\n");
        }
    }
    public static void main(String[] args) {
        try {
            if (args.length != 2) {
                System.out.println("Usage: java javajaxb.EmployeeLister
" +
                    "[web.xml filename] [output.xml filename]");
                return;
            }
            EmployeeLister lister = 
                new EmployeeLister(new File(args[0]), new
File(args[1]));
            lister.list(true);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }   
}
<p><a class="footnote-ref" id="fnref:13" href="#fn:13"><sup>13</sup></a>
</p><p>Sample mapping file may look like as follows:
</p>
      <?xml version="1.0"?>
<!DOCTYPE mapping PUBLIC "-//EXOLAB/Castor Object Mapping DTD Version 1.0//EN" "http://Castor.exolab.org/mapping.dtd">
<mapping>
  <class name="javajaxb.generated.hr.Employees">
    <map-to xml="emp-list"/>
    <field name="Employee"
           type="javajaxb.generated.hr.Employee">
      <bind-xml name="emp" />
    </field>
  </class>
  <class name="javajaxb.generated.hr.Employee">
    <field name="Id"
           type="integer">
      <bind-xml name="emp-id" node="attribute"/>
    </field>
    <field name="name"
           type="java.lang.String">
      <bind-xml name="emp-name" node="attribute"/>
    </field>
    <field name="Address"
           type="javajaxb.generated.hr.Address">
      <bind-xml name="emp-address" />
    </field>
    <field name="Organization"
           type="javajaxb.generated.hr.Organization">
      <bind-xml name="emp-org"/>
    </field>
    <field name="Office"
           type="javajaxb.generated.hr.Office">
      <bind-xml name="emp-office"/>
    </field>
  </class>
  <class name="javajaxb.generated.hr.Address">
    <field name="Street1"
           type="java.lang.String">
      <bind-xml name="line-1" node="element"/>
    </field>
    <field name="Street2"
           type="java.lang.String">
      <bind-xml name="line-2" node="element"/>
    </field>
    <field name="City"
           type="java.lang.String">
      <bind-xml name="city" node="element"/>
    </field>
    <field name="State"
           type="java.lang.String">
      <bind-xml name="state" node="element"/>
    </field>
    <field name="ZipCode"
           type="java.lang.String">
      <bind-xml name="zip-code" node="element"/>
    </field>
  </class>
  <class name="javajaxb.generated.hr.Office">
    <field name="Id"
           type="integer">
      <bind-xml name="office-id" node="attribute"/>
    </field>
    <field name="Address"
           type="javajaxb.generated.hr.Address">
      <bind-xml name="office-address" node="element"/>
    </field>
  </class>
  <class name="javajaxb.generated.hr.Organization">
    <field name="Id"
           type="integer">
      <bind-xml name="org-id" node="element"/>
    </field>
    <field name="Name"
           type="java.lang.String">
      <bind-xml name="org-name" node="element"/>
    </field>
  </class>
</mapping>
<p><a class="footnote-ref" id="fnref:14" href="#fn:14"><sup>14</sup></a>
</p><h2 id="see-also">See also</h2>
<ul>
<li>Free and open-source software portal</li><li>Computer programming portal</li></ul>
<ul><li><a href="/facts/XML_data_binding/3dJzxevS">XML data binding</a></li>
<li><a href="/facts/List_of_object-relational_mapping_software/3keRNsHk">List of object-relational mapping software</a></li>
<li><a href="/facts/Serialization/T00auFvv">Serialization</a></li>
<li><a href="/facts/Service_Data_Object/CmYC3cL6">Service Data Object</a></li>
<li><a href="/facts/Data_binding/qp1TkWzk">Data binding</a></li></ul>

<h2 id="external-links">External links</h2>
<ul><li><a href="https://castor-data-binding.github.io/castor/">Website</a></li>
<li><a href="https://github.com/castor-data-binding/castor">castor</a> on <a href="/facts/GitHub/n1hNCsc3">GitHub</a></li>
<li><a href="http://repo1.maven.org/maven2/org/codehaus/castor/">Maven repository</a></li></ul>

<h2 id="references">References</h2>

<ol>
<li id="fn:1"><p>"About". Castor. Github. Retrieved 11 February 2016. <a href="https://castor-data-binding.github.io/castor/main/index.html" target="_blank">https://castor-data-binding.github.io/castor/main/index.html</a> <a href="#fnref:1" class="footnote-back-ref">↩</a></p></li>
<li id="fn:2"><p>McLaughin, B (2002). Java and XML Data Binding. Sebastopol: O'Reilly & Associates, Inc. pp. 143–165. <a href="#fnref:2" class="footnote-back-ref">↩</a></p></li>
<li id="fn:3"><p>XML Developer's Guide. Scotts Valley, USA: Borland Software Corporation. 2002. pp. (2–29)–(2–31). <a href="#fnref:3" class="footnote-back-ref">↩</a></p></li>
<li id="fn:4"><p>XML Developer's Guide. Scotts Valley, USA: Borland Software Corporation. 2002. pp. (2–29)–(2–31). <a href="#fnref:4" class="footnote-back-ref">↩</a></p></li>
<li id="fn:5"><p>McLaughin, B (2002). Java and XML Data Binding. Sebastopol: O'Reilly & Associates, Inc. pp. 143–165. <a href="#fnref:5" class="footnote-back-ref">↩</a></p></li>
<li id="fn:6"><p>XML Developer's Guide. Scotts Valley, USA: Borland Software Corporation. 2002. pp. (2–29)–(2–31). <a href="#fnref:6" class="footnote-back-ref">↩</a></p></li>
<li id="fn:7"><p>McLaughin, B (2002). Java and XML Data Binding. Sebastopol: O'Reilly & Associates, Inc. pp. 143–165. <a href="#fnref:7" class="footnote-back-ref">↩</a></p></li>
<li id="fn:8"><p>XML Developer's Guide. Scotts Valley, USA: Borland Software Corporation. 2002. pp. (2–29)–(2–31). <a href="#fnref:8" class="footnote-back-ref">↩</a></p></li>
<li id="fn:9"><p>"The Source Code Generator". Castor. Github. Retrieved 11 February 2016. <a href="https://www2.informatik.hu-berlin.de/~xing/Lib/Docs/Castor/sourcegen.html" target="_blank">https://www2.informatik.hu-berlin.de/~xing/Lib/Docs/Castor/sourcegen.html</a> <a href="#fnref:9" class="footnote-back-ref">↩</a></p></li>
<li id="fn:10"><p>McLaughin, B (2002). Java and XML Data Binding. Sebastopol: O'Reilly & Associates, Inc. pp. 143–165. <a href="#fnref:10" class="footnote-back-ref">↩</a></p></li>
<li id="fn:11"><p>McLaughin, B (2002). Java and XML Data Binding. Sebastopol: O'Reilly & Associates, Inc. pp. 143–165. <a href="#fnref:11" class="footnote-back-ref">↩</a></p></li>
<li id="fn:12"><p>McLaughin, B (2002). Java and XML Data Binding. Sebastopol: O'Reilly & Associates, Inc. pp. 143–165. <a href="#fnref:12" class="footnote-back-ref">↩</a></p></li>
<li id="fn:13"><p>McLaughin, B (2002). Java and XML Data Binding. Sebastopol: O'Reilly & Associates, Inc. pp. 143–165. <a href="#fnref:13" class="footnote-back-ref">↩</a></p></li>
<li id="fn:14"><p>McLaughin, B (2002). Java and XML Data Binding. Sebastopol: O'Reilly & Associates, Inc. pp. 143–165. <a href="#fnref:14" class="footnote-back-ref">↩</a></p></li>
</ol>

Castor (framework) open-in-new

Castor (framework)