添加映射的过程

在Configuration类中，我们通过add方法添加一个映射，而add方法又把这个任务交给了Binder类的bindrooR方法。
 

protected   void  add(org.dom4j.Document doc) throws Exception  {
  try {
   Binder.bindRoot( doc, createMappings() );
  }
  catch (MappingException me) {
   log.error("Could not compile the mapping document", me);
   throw me;
  }
 }

首先，我们来看一段映射配置：

<? xml version="1.0" ?>
<! DOCTYPE hibernate-mapping
    PUBLIC "-//Hibernate/Hibernate Mapping DTD//EN"
    "http://hibernate.sourceforge.net/hibernate-mapping-2.0.dtd" >

< hibernate-mapping >

     < class  name ="net.sf.hibernate.examples.quickstart.Cat"  table ="CAT" >

         <!--  A 32 hex character is our surrogate key. It's automatically
            generated by Hibernate with the UUID pattern.  -->
         < id  name ="id"  type ="string"  unsaved-value ="null"   >
             < column  name ="CAT_ID"  sql-type ="char(32)"  not-null ="true" />
             < generator  class ="uuid.hex" />
         </ id >

         <!--  A cat has to have a name, but it shouldn' be too long.  -->
         < property  name ="name" >
             < column  name ="NAME"  sql-type ="varchar(16)"  not-null ="true" />
         </ property >

         < property  name ="sex" />

         < property  name ="weight" />

     </ class >

</ hibernate-mapping >

 

我们结合这个映射配置文件来看看bindRoot方法（由于方法过长，这里只截取其中处理class的一部分）：

  /**/ /**
  * 传入一个描述映射关系的Document用以填充Mapping
  */
  public   static   void  bindRoot(Document doc, Mappings model) throws MappingException  {

  // 取得根结点，即 hibernate-mapping 结点
  Element hmNode = doc.getRootElement();

  // 取结点的属性值
  Attribute schemaNode = hmNode.attribute("schema");
  model.setSchemaName( (schemaNode==null) ? null : schemaNode.getValue() );

  // 

  // 取得所有的class子结点。
  // 由此可以看出，一个配置文件可以配置多个class的映射。
  Iterator nodes = hmNode.elementIterator("class");
  while ( nodes.hasNext() ) {
   Element n = (Element) nodes.next();

   // 至此为止，又将权利下放到了bindRootClass方法。
   // 这是重构长方法的一种办法。
   RootClass rootclass = new RootClass();
   Binder.bindRootClass(n, rootclass, model);
   model.addClass(rootclass);
  }
  // 
  
 }

 

所有读取配置信息的工作都是使用上面这种模式：一步一步地把责任往下放，这种做法好处就在于使程序结构清晰，可惜在Binder类中做的还是不够——方法还是太长。

因为后面的代码牵涉到的内容还太多，所以暂时跟踪到此，待mapping包分析完成再来看它。