Hibernate的对象关系映射（1）

1. 映射文件

hibernate-mapping-3.0.dtd，位于“/src/org/hibernate”下。

2. 类映射

2.1 抽象类映射 

抽象类Container的定义如下：

package com.weportal.container;

/** *//**
 * @hibernate.class
 *         table = "CONTAINER"
 * @hibernate.discriminator 
 *         column = "CONTAINER_TYPE"
 *         type = "String"
 */
public abstract class Container ...{
    private String containerId;
    private double size;
    private String name;
    private String description;
    /** *//**
     * @hibernate.id 
     *         generator-class = "hilo"
     */
    public String getContainerId() ...{
        return containerId;
    }     
    /** *//**
     * @hibernate.property 
     */
    public String getName() ...{
        return name;
    }
    /** *//**
     * @hibernate.property 
     */
    public String getDescription() ...{
        return description;
    }
    /** *//**
     * @param description The description to set.
     */
    public void setDescription(String description) ...{
        this.description = description;
    }
    
    /** *//**
     * @param name The name to set.
     */
    public void setName(String name) ...{
        this.name = name;
    }
    /** *//**
     * @return Returns the size.
     * @hibernate.property 
     */
    public double getSize() ...{
        return size;
    }
    /** *//**
     * @param size The size to set.
     */
    public void setSize(double size) ...{
        this.size = size;
    }

    /** *//**
     * @param containerId The containerId to set.
     */
    public void setContainerId(String containerId) ...{
        this.containerId = containerId;
    }
}

Box和Bottle类的定义如下：

package com.weportal.container;
/** *//**
 * @hibernate.subclass
 *         discriminator-values = "BOX" 
 */
public class Box extends Container ...{
    private double height;
    private double length;
    private double width;
    /** *//**
     * @hibernate.property
     */
    public double getLength() ...{
        return length;
    }     
    /** *//**
     * @hibernate.property
     */
    public double getWidth() ...{
        return width;
    }    
    /** *//**
     * @hibernate.property
     */
    public double getHeight() ...{
        return height;
    }
   
    /** *//**
     * @param height The height to set.
     */
    public void setHeight(double height) ...{
        this.height = height;
    }

    /** *//**
     * @param length The length to set.
     */
    public void setLength(double length) ...{
        this.length = length;
    }

    /** *//**
     * @param width The width to set.
     */
    public void setWidth(double width) ...{
        this.width = width;
    }
}

 

package com.weportal.container;

/**//**
 * @hibernate.subclass 
 *         discriminator-values = "BOTTLE" 
 */
public class Bottle extends Container ...{
    private double diameter;
    private double height;
    /**//**
     * @return Returns the diameter.
     * @hibernate.property
     */
    public double getDiameter() ...{
        return diameter;
    }
    /**//**
     * @param diameter The diameter to set.
     */
    public void setDiameter(double diameter) ...{
        this.diameter = diameter;
    }
    /**//**
     * @return Returns the height.
     * @hibernate.property
     */
    public double getHeight() ...{
        return height;
    }
    /**//**
     * @param height The height to set.
     */
    public void setHeight(double height) ...{
        this.height = height;
    }

}

 映射文件Container.hbm.xml如下：

Container类的主键id，生成主键所使用的generator是uuid，uuid是利用128位的UUID算法生成的字符串来作为主键。而native表示主键的生成由数据库底层去选择算法。

<?xml version="1.0"?>
<!DOCTYPE hibernate-mapping PUBLIC
    "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
    "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
<hibernate-mapping package="com.weportal.container">
  <class name="Container">
      <id name="containerId" type="string">
          <generator class="uuid"></generator>
      </id>
      <discriminator column="CONTAINER_TYPE"></discriminator>
      <property name="size"></property>
      <property name="name"></property>
      <property name="description"></property>
      <subclass name="Box" discriminator-value="BOX">
          <property name="height"></property>
          <property name="length"></property>
          <property name="width"></property>
      </subclass>
      <subclass name="Bottle" discriminator-value="BOTTLE">
          <property name="diameter"></property>
          <property name="height"></property>
      </subclass>
  </class>
</hibernate-mapping>

使用下面的类来自动生成数据库表（so cool!），

package com.weportal;

import org.apache.log4j.PropertyConfigurator;
import org.hibernate.SessionFactory;
import org.hibernate.cfg.Configuration;
import org.hibernate.cfg.Environment;

public class DatabaseGenerate ...{

    public static void main(String[] args) ...{
        DatabaseGenerate idbg = new DatabaseGenerate();
        idbg.generate(true);
    }
    
    public void generate(boolean create)...{
        PropertyConfigurator.configure("log4j.Properties");
        Configuration cfg = new Configuration();
        cfg.configure();
        if(create)...{
            cfg.setProperty(Environment.HBM2DDL_AUTO, "create-drop");
        }
        SessionFactory sf = cfg.buildSessionFactory();
    }
}

生成的表container的定义如下：

    create table `hibernate`.`container`(
        `containerId` varchar(255) default '' not null,
       `CONTAINER_TYPE` varchar(255) default '' not null,
       `size` double,
       `name` varchar(255),
       `description` varchar(255),
       `height` double,
       `length` double,
       `width` double,
       `diameter` double,
        primary key (`containerId`)
    );

    create unique index `PRIMARY` on `hibernate`.`container`(`containerId`);

观察上表，container中既包含了Container中的属性，也包含了Box和Bottle两个之类中的属性，它们共享这个表。

 2.1.1 主键ID

可以自定义一个org.hibernate.id.IdentifierGenerator接口的实现类作为主键ID的generator，例如下面的代码使用的是IP和当前的时间混合来作为ID。

package com.weportal.generator;

import java.io.Serializable;
import java.net.InetAddress;
import java.net.UnknownHostException;

import org.hibernate.HibernateException;
import org.hibernate.engine.SessionImplementor;
import org.hibernate.id.IdentifierGenerator;

public class MyGenerator implements IdentifierGenerator ...{

    /**//* (non-Javadoc)
     * @see org.hibernate.id.IdentifierGenerator#generate(org.hibernate.engine.SessionImplementor, java.lang.Object)
     */
    public Serializable generate(SessionImplementor session, Object obj)
            throws HibernateException ...{
        StringBuilder sb = new StringBuilder();
        try ...{
            sb.append(InetAddress.getLocalHost().getAddress().toString());
        } catch (UnknownHostException e) ...{
            e.printStackTrace();
        }
        sb.append(System.currentTimeMillis());
        return sb.toString();
    }

    /**//* (non-Javadoc)
     * @see org.hibernate.id.IdentifierGenerator#generate(org.hibernate.engine.SessionImplementor, java.lang.Object, java.lang.String)
     */
    public Serializable generate(SessionImplementor session, Object obj,
            String entity) throws HibernateException ...{
        StringBuilder sb = new StringBuilder();
        try ...{
            sb.append(InetAddress.getLocalHost().getAddress().toString());
        } catch (UnknownHostException e) ...{
            e.printStackTrace();
        }
        sb.append(System.currentTimeMillis());
        return sb.toString();
    }
}

利用MyGenerator代替Container中的“uuid”，

      <id name="containerId" type="string">
          <generator class="com.weportal.generator.MyGenerator"></generator>
      </id>

hibernate自带的generator如下：

generator	算法说明
foreign	使用另外一个相关联的对象的标识符作为主键
assigned	主键由外部程序负责生成，在 save() 之前指定一个
hilo	通过hi/lo 算法实现的主键生成机制，需要额外的数据库表或字段提供高位值来源
seqhilo	与hilo 类似，通过hi/lo 算法实现的主键生成机制，需要数据库中的 Sequence，适用于支持 Sequence 的数据库，如Oracle
increment	主键按数值顺序递增。此方式的实现机制为在当前应用实例中维持一个变量，以保存着当前的最大值，之后每次需要生成主键的时候将此值加1作为主键。这种方式可能产生的问题是：不能在集群下使用
identity	采用数据库提供的主键生成机制。如DB2、SQL Server、MySQL 中的主键生成机制
sequence	采用数据库提供的 sequence 机制生成主键。如 Oralce 中的Sequence
native	由 Hibernate 根据使用的数据库自行判断采用 identity、hilo、sequence 其中一种作为主键生成方式
uuid.hex	由 Hibernate 基于128 位 UUID 算法 生成16 进制数值（编码后以长度32 的字符串表示）作为主键
uuid.string	与uuid.hex 类似，只是生成的主键未进行编码（长度16），不能应用在 PostgreSQL 数据库中

2.1.2 where属性

利用where属性可以选出hibernate感兴趣的数据，在提取时只将这些数据映射为类的实例导出。

例如：

<class name="Container" where="size &lt; 1000">

下面的代码检索出的结果是size < 1000 的记录。

package com.weportal.container;

import java.util.Iterator;
import java.util.List;

import org.apache.log4j.PropertyConfigurator;
import org.hibernate.Session;
import org.hibernate.SessionFactory;
import org.hibernate.cfg.Configuration;

public class ContainerView ...{

    public static void main(String[] args) ...{
        PropertyConfigurator.configure("log4j.Properties");
        Configuration cfg = new Configuration();
        cfg.configure();
        SessionFactory sf = cfg.buildSessionFactory();
        Session sess = sf.openSession();
        List pcs = sess.createQuery("from Container").list();
        if (pcs.isEmpty())
            System.out.println("没数据");
        for (Iterator it = pcs.iterator(); it.hasNext();) ...{
            Container cter = (Container) it.next();
            //System.out.println(cter.getClass().getName());
            System.out.println("id : " + cter.getContainerId());
            System.out.println("name : " + cter.getName());
            System.out.println("size : " + cter.getSize());
        }
        sess.close();
    }
}