关于数据映射

一个笔记：
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文件。