一个笔记：
1 关于marshal类：（对映射文件的处理）
Marshaller类用来将一个Java类转换为XML数据。UnMarshaller类转换一个XML文档成Java对象。
对映射文件处理的简单例子的代码片断：
Marshaller marshaller;
Mapping _mapping;
PrintWriter writer;
MyClass myObject;
………………
// 创建marshaller对象并载入Mapping映射规则
marshaller = new Marshaller( writer );
marshaller.setMapping( _mapping );
// OO对象到XML数据 (可以是流，DOM树节点，或是SAX遍历句柄)
的映射转换
java.io.Writer out;
marshaller.marshal(myObject, out);
org.w3c.dom.Node node
marshaller.marshal(myObject, node);
org.xml.sax.DocumentHandler handler
marshaller.marshal(myObject, handler);
………………
几个重要概念:
编组（Marshalling）是把内存中的数据转化到存储媒介上的过程。因此在 Java 和 XML 环境中，编组就是把一些 Java 对象转化成一个（或多个） XML 文档。在数据库环境中，则是把 Java 表示的数据存入数据库。显然，编组的秘密在于把 Java 实例中的面向对象结构转化成适用于 XML 的扁平结构，或者 RDBMS 中的关系结构（使用 Java 技术转换到 OODBMS 实际上很简单）。
解组（Unmarshalling）是把数据从存储媒介转换到内存中的过程——正好与编组相反。因此需要把 XML 文档解组到 Java VM 中。这里的复杂性不是在扁平数据中，因为这不是必需的，而在于从正确的数据到正确的 Java 代码变量的映射。如果映射是错误的，就不可能正确地访问数据。当然，如果再尝试重新编组还会造成更大的问题，并且问题传播得很快。
往返（Round-tripping）可能是最重要也最容易误解的数据绑定术语。往返用于描述从存储媒介到内存然后回到存储媒介的完整循环。在 XML 和 Java 技术环境中，这就意味着从 XML 文档到 Java 实例变量，然后再回到 XML 文档。正确的往返要求，如果中间没有修改数据，XML 输入和 XML 输出应该是等同的。
Castor 框架：
Castor XML 数据绑定很容易上手，甚至不需要定义 XML 文档格式。只要您的数据用类 JavaBean 的对象表示，Castor 就能自动生成表示这些数据的文档格式，然后从文档重构原始数据。
用一个例子(Castor)来说明：Jbuilder中调试
This bean was auto generated from a schema
清单 1. XmlEmployeeType信息 bean
package com.borland.samples.xml.databinding.castor;
import java.io.IOException;
import java.io.Reader;
import java.io.Serializable;
import java.io.Writer;
import org.exolab.castor.xml.MarshalException;
import org.exolab.castor.xml.Marshaller;
import org.exolab.castor.xml.Unmarshaller;
import org.exolab.castor.xml.ValidationException;
import org.xml.sax.ContentHandler;
/**
* Class XmlEmployeeType.
* @version $Revision$ $Date$
*/
public class XmlEmployeeType implements java.io.Serializable {
private java.lang.String _empNo;
private java.lang.String _firstName;
private java.lang.String _lastName;
private java.lang.String _phoneExt;
private java.lang.String _hireDate;
private java.lang.String _deptNo;
private java.lang.String _jobCode;
private java.lang.String _jobGrade;
private java.lang.String _jobCountry;
private java.lang.String _salary;
private java.lang.String _fullName;
public XmlEmployeeType() {
super();
}
public java.lang.String getDeptNo()
{
return this._deptNo;
}
public java.lang.String getEmpNo()
{
return this._empNo;
}
public java.lang.String getFirstName()
{
return this._firstName;
}
public java.lang.String getFullName()
{
return this._fullName;
}
public java.lang.String getHireDate()
{
return this._hireDate;
}
public java.lang.String getJobCode()
{
return this._jobCode;
} tJobCode()
public java.lang.String getJobCountry()
{
return this._jobCountry;
}
public java.lang.String getJobGrade()
{
return this._jobGrade;
}
public java.lang.String getLastName()
{
return this._lastName;
}
public java.lang.String getPhoneExt()
{
return this._phoneExt;
}
public java.lang.String getSalary()
{
return this._salary;
} //-- java.lang.String getSalary()
public boolean isValid()
{
try {
validate();
}
catch (org.exolab.castor.xml.ValidationException vex) {
return false;
}
return true;
}
public void marshal(java.io.Writer out)
throws org.exolab.castor.xml.MarshalException, org.exolab.castor.xml.ValidationException
{
Marshaller.marshal(this, out);
}
public void marshal(org.xml.sax.ContentHandler handler)
throwsjava.io.IOException,org.exolab.castor.xml.MarshalException, org.exolab.castor.xml.ValidationException
{
Marshaller.marshal(this, handler);
}
public void setDeptNo(java.lang.String deptNo)
{
this._deptNo = deptNo;
}
public void setEmpNo(java.lang.String empNo)
{
this._empNo = empNo;
}
public void setFirstName(java.lang.String firstName)
{
this._firstName = firstName;
} //-- void setFirstName(java.lang.String)
public void setFullName(java.lang.String fullName)
{
this._fullName = fullName;
} //-- void setFullName(java.lang.String)
public void setHireDate(java.lang.String hireDate)
{
this._hireDate = hireDate;
} //-- void setHireDate(java.lang.String)
public void setJobCode(java.lang.String jobCode)
{
this._jobCode = jobCode;
} //-- void setJobCode(java.lang.String)
public void setJobCountry(java.lang.String jobCountry)
{
this._jobCountry = jobCountry;
} //-- void setJobCountry(java.lang.String)
public void setJobGrade(java.lang.String jobGrade)
{
this._jobGrade = jobGrade;
} //-- void setJobGrade(java.lang.String)
public void setLastName(java.lang.String lastName)
{
this._lastName = lastName;
} //-- void setLastName(java.lang.String)
public void setPhoneExt(java.lang.String phoneExt)
{
this._phoneExt = phoneExt;
} //-- void setPhoneExt(java.lang.String)
public void setSalary(java.lang.String salary)
{
this._salary = salary;
} //-- void setSalary(java.lang.String)
public static java.lang.Object unmarshal(java.io.Reader reader)
throws org.exolab.castor.xml.MarshalException, org.exolab.castor.xml.ValidationException
{
Return(com.borland.samples.xml.databinding.castor.XmlEmployeeType) Unmarshaller.unmarshal(com.borland.samples.xml.databinding.castor.XmlEmployeeType.class, reader);
} //-- java.lang.Object unmarshal(java.io.Reader)
public void validate()
throws org.exolab.castor.xml.ValidationException
{
org.exolab.castor.xml.Validator validator = new org.exolab.castor.xml.Validator();
validator.validate(this);
} //-- void validate()
}
清单 2. 测试默认的数据绑定
/**
* Title: XML Tutorial
* Description: XML Tutorial for JBuilder
* Company: Borland Software Coporation
* @author
* @version 1.0
*/
import java.io.*;
import org.exolab.castor.xml.*;
public class DB_Castor {
public DB_Castor() {
}
public static void main(String[] args) {
try {
String fileName = "Employees.xml";
System.out.println("== unmarshalling \"" + fileName + "\" ==");
//Unmarshal XML file.
XmlEmployees xmlEmployees = (XmlEmployees)XmlEmployees.unmarshal(new FileReader(fileName));
System.out.println("TotalNumber of XmlEmployees read = " + xmlEmployees.getXmlEmployeeCount());
System.out.println("FirstXmlEmployee's Full Name is " + xmlEmployees.getXmlEmployee(0).getFullName());
System.out.println("LastXmlEmployee's Full Name is " + xmlEmployees.getXmlEmployee(xmlEmployees.getXmlEmployeeCount()-1).getFullName());
// Add an XmlEmployee.
xmlEmployees.addXmlEmployee(getXmlEmployee("8000","400","Charlie","Castor","3/3/2001","VP","USA","2","1993","155000.00"));
// Modify the last XmlEmployee.
xmlEmployees.setXmlEmployee(xmlEmployees.getXmlEmployeeCount()-1, getXmlEmployee("8000","600","Peter","Castor","3/3/2001","VP","USA","3","2096","125000.00"));
// Marshal out the data to the same XML file.
xmlEmployees.marshal(new java.io.FileWriter(fileName));
}
catch (Exception ex) {
ex.printStackTrace();
}
}
private static XmlEmployee getXmlEmployee(String XmlEmployeeNumber,String departmentNumber,String firstName,String lastName,String hireDate,String jobCode,String jobCountry,String jobGrade,String phoneExt,String salary){
XmlEmployee xmlEmployee = new XmlEmployee();
xmlEmployee.setEmpNo(XmlEmployeeNumber);
xmlEmployee.setDeptNo(departmentNumber);
xmlEmployee.setFirstName(firstName);
xmlEmployee.setLastName(lastName);
xmlEmployee.setFullName(lastName+", "+firstName);
xmlEmployee.setHireDate(hireDate);
xmlEmployee.setJobCode(jobCode);
xmlEmployee.setJobCountry(jobCountry);
xmlEmployee.setJobGrade(jobGrade);
xmlEmployee.setPhoneExt(phoneExt);
xmlEmployee.setSalary(salary);
return xmlEmployee;
}
}
最后，看看运行的效果;XML是不是变化了；此篇仅仅描述了一个Castor框架，还有JAXB(Sun的框架)；以及其他开源的框架需要不断的去学习。
==========================
Castor 学习笔记
Castor XML
http://www.castor.org/xml-framework.html
Castor XML 是XML数据绑定的framework。
与两种主要的XML API(DOM及SAX)不同，它们主要是处理XML文件的结构，
而Castor能够通过表现数据的对象，处理XML文件中的数据。
Castor XML能处理几乎所有java bean格式的java对象，从xml读取或生成xml。
大多数情况下，marshalling框架使用ClassDescriptors和FieldDescriptors来描述
一个对象怎么marshal成xml文件，或从xml文件中unmarshal。
术语marshal 和unmarshal，是表示转换数据流从/到一个对象的行为。
marshalling转换对象到stream，unmarshalling从stream到一个对象。
The marshalling framework
负责执行java和xml之间的转换。
包含两个主要的类：
org.exolab.castor.xml.Marshaller and org.exolab.castor.xml.Unmarshaller.
假设有一个Member类，marshal一个对象，只需要简单的调用Marshaller如下：
Member Member = new Member("Ryan 'Mad Dog' Madden");
writer = new FileWriter("test.xml");
Marshaller.marshal(Member, writer);
unmarshal需要调用Unmarshaller如下：
reader = new FileReader("test.xml");
Member Member = (Member)Unmarshaller.unmarshal(Member.class, reader);
注意：当使用mapping文件时，以上代码是不够的：
Mapping mapping = new Mapping();
mapping.loadMapping("mapping.xml");
reader = new FileReader("test.xml");
Unmarshaller unmarshaller = new Unmarshaller(Member.class);
unmarshaller.setMapping(mapping);
Member Member = (Member)unmarshaller.unmarshal(reader);
Using Existing Classes/Objects
Castor能marshal几乎所有任意的对象从/到xml。
当特殊类的描述不可用时，
marshalling framework使用reflection得到对象的信息。
把描述放在java 源文件中，比放在内存中，修改和编译所花的工作更小。
如果class文件中存在描述，则Castor使用这些描述来控制marshalling。
marshalling对象时，一个主要的约束，是要有一个缺省的无参的构造方法。
并且要有get和set方法来进行marshalling和unmarshalling。
Class Descriptors
class descriptors提供了Castor框架必须的信息，
这样class才能正确的marshalling和unmarshalling。
class descriptors包含了field descriptors的集合。
XML格式的class descriptors提供castor框架marshalling所需的信息。
XMLClassDescriptor的实现类是：org.exolab.castor.xml.XMLClassDescriptor.
XML Class Descriptors有四种方法创建，两种基于运行时，两种基于编译时。
Compile-Time Descriptors
使用compile time descriptors，方法之一是实现org.exolab.castor.xml.XMLClassDescriptor，
或者用Source Code Generator来创建描述。
Run-Time Descriptors
使用run tiem descriptors,方法之一是提供一个mapping文件，
让Castor introspect(应该翻译成内省？)
或者组合使用缺省的introspection和特殊的mapping文件。