（转）Hibernate框架基础——映射普通属性

http://blog.csdn.net/yerenyuan_pku/article/details/52739871

持久化对象与OID

对持久化对象的要求

1. 提供一个无参的构造器。使Hibernate可以使用Constructor.newInstance()来实例化持久化类。
2. 提供一个标识属性（identifier property）。通常映射为数据库表的主键字段。如果没有该属性，一些功能将不起作用，如：Session.saveOrUpdate()。
3. 为类的持久化字段声明访问方法（get/set）。Hibernate对JavaBean风格的属性实行持久化。
4. 使用非final类。在运行时生成代理是Hibernate的一个重要的功能。如果持久化类没有实现任何接口，Hibnernate使用CGLIB生成代理。如果使用的是final类，则无法生成CGLIB代理。
5. 重写eqauls()和hashCode()方法。如果需要把持久化类的实例放到Set中（当需要进行关联映射时），则应该重写这两个方法。

例，我们可在cn.itcast.c_hbm_property包下创建这样一个持久化类——User.java。

/**
 * 实体
 */
public class User {
    private int id;
    private String name;

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    @Override
    public String toString() {
        return "[User: id=" + id + ", name=" + name + "]";
    }
}

OID

为了在系统中能够找到所需对象，需要为每一个对象分配一个唯一的标识号。在关系数据库中称之为主键，而在对象术语中，则叫做对象标识(Object identifier-OID)。

对象/关系数据库映射文件（hbm.xml）

Hibernate采用XML格式的文件来指定对象和关系数据之间的映射。在运行时Hibernate将根据这个映射文件来生成各种SQL语句。映射文件的扩展名为”.hbm.xml”。 
映射文件示例： 

持久化类的属性及属性映射（普通属性）

对应于cn.itcast.c_hbm_property包下的持久化类——User.java，我们应在该包下创建出对象/关系数据库映射文件——User.hbm.xml。

<?xml version="1.0"?>
<!DOCTYPE hibernate-mapping PUBLIC
        "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
        "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">

<hibernate-mapping package="cn.itcast.c_hbm_property">
    <!--
        name属性：哪个类
        table属性：对应哪个表，如果不写，默认的表名就是类的简单名称
    -->
    <class name="User" table="t_user">
        <id name="id" type="int" column="id">
            <generator class="native"/>
        </id>
        <property name="name" type="string" column="name" length="20" not-null="true" />
    </class>
</hibernate-mapping>

映射配置：

<property name="name" type="string" column="name" length="20" not-null="true" /> 

即为映射的普通属性，普通属性指数据库中的基本类型，如字符串、日期、数字等。下面我们就来详解<property ... />元素中的各个属性：

• name属性：对象中的属性名，必须要有。
• type属性：类型，如果不写，Hibernate会自动检测。可以写java中类的全名或是写hibernate类型。
• column属性：对应表中的列名，如果没写，默认为属性名。
• length属性：长度，不是所有的类型都有长度属性，比如varchar有，但int没有，如果不写默认为255。
• not-null属性：非空约束，默认为false。

所以上面的映射配置，直接写成这样干巴巴的配置：

<property name="name" />

也是可以的。 
单单是编写上面这样一个映射文件——User.hbm.xml，涉及到的知识点还是蛮多的，下面我们一一讲解。

Hibernate的映射类型

内置映射类型

Hibernate	java	sql	取值范围
integer/int	java.lang.Integer/int	INTEGER	4
long	java.lang.Long/long	BIGINT	8
short	java.lang.Short/short	SMALLINT	2
byte	java.lang.Byte/byte	TINYINT	1
float	java.lang.Float/float	FLOAT	4
double	java.lang.Double/double	DOUBLE	8
big_decimal	java.math.BigDecinimal	NUMERIC	8位含2位小数部分
character	char/java.lang.Character/java.lang.String	CHAR(1)	定长字符
string	java.lang.String	VARCHAR	变长串
boolean	boolean/java.lang.Boolean	BIT	布尔
yes_no	boolean/java.lang.Boolean	CHAR(1)	布尔
true_fasle	boolean/java.lang.Boolean	CHAR(1)	布尔

java时间和日期类性

Hibernate	java	sql	取值范围
date	java.util.Date/java.sql.Date	DATE	YYYY-MM-DD
time	java.util.Date/java.sql.Time	TIME	HH:MM:SS
timestamp	java.util.Date/java.sql.timestamp	TIMESTAMP	YYYYMMDDHHMMSS
calendar	java.util.Calendar	TIMESTAMP	YYYYMMDDHHMMSS
calendar_date	java.util.Calendar	DATE	YYYY-MM-DD

大对象类型的映射

Hibernate	java	sql
binary	byte[]	VARBINARY(BLOB)
text	String	CLOB
serializable	实现类	BARBINARY(BLOB)
clob	java.sql.Clob	CLOB
blob	java.sql.Blob	BLOB

JDK自带的个别java类的映射类型

Hibernate	java	sql
class	java.lang.Class	VARCHAR
locale	java.util.Locale	VARCHAR
timezone	java.util.TimeZone	VARCHAR
currency	java.util.Currency	VARCHAR

设置类的包名

如果在一个映射文件中包含多个类，并且这些类位于同一个包中，可以设置<hibernate-mapping>元素的package属性，以避免为每个类提供完整的类名。 
指定类的全限定名： 
 
在<hibernate-mapping>元素中指定package属性，就只需指定简单类名了： 

处理sql引用表示符

在实际开发中，我们要编写的持久化类不会这么简单，也就是说User类不会只有

private int id;
private String name;

这两个字段。通常它含有的字段挺多的，例如：

/**
 * 实体
 */
public class User {
    private int id;
    private String name;
    private Integer age;
    private Date birthday; // 生日
    private String desc; // 一大段说明

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

    public Date getBirthday() {
        return birthday;
    }

    public void setBirthday(Date birthday) {
        this.birthday = birthday;
    }

    public String getDesc() {
        return desc;
    }

    public void setDesc(String desc) {
        this.desc = desc;
    }

    @Override
    public String toString() {
        return "[User: id=" + id + ", name=" + name + "]";
    }
}

我们接下来就要修改映射文件——User.hbm.xml了。

<?xml version="1.0"?>
<!DOCTYPE hibernate-mapping PUBLIC
        "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
        "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">

<hibernate-mapping package="cn.itcast.c_hbm_property">
    <!--
        name属性：哪个类
        table属性：对应哪个表，如果不写，默认的表名就是类的简单名称
    -->
    <class name="User" table="t_user">
        <id name="id" type="int" column="id">
            <generator class="native"/>
        </id>

        <property name="name" type="string" column="name" length="20" not-null="true" /> 

        <property name="age" type="int" column="age_" />

        <property name="birthday" type="date" column="birthday_" />

        <!-- 指定使用text类型时，最好再指定length，以确定生成的SQL类型是能够存放指定数量的字符的。 -->
        <property name="desc" type="text" length="5000" column="`desc`"/>
    </class>
</hibernate-mapping>

我们从中可以看到User持久化类的属性desc的映射配置为：

<property name="desc" type="text" length="5000" column="`desc`"/>

思考一个问题：column属性为何要写成column=”`desc`”？可参考下面这段话： 
在SQL语法中，表示符是指用于数据库表、视图、字段或索引等名字的字符串，常规表示符不包括空格，也不包含特殊字符，因此无需使用引用符号。如果数据库表名或列名包含特殊字符，可以使用引用表示符(键盘~下面的字符)。 
用更通俗易懂的话说就是：当列名与关键字冲突时，可以通过column属性指定一个其他的列名，或是使用反引号包围起来(不建议使用)。 
现在我们编写单元测试来进行测试，在cn.itcast.c_hbm_property包下编写一个单元测试类——App.java。

public class App {
    private static SessionFactory sessionFactory;

    static {
        sessionFactory = new Configuration() //
                .configure() // 读取配置文件
                .addClass(User.class) //
                .buildSessionFactory();
    }

    @Test
    public void testSave() throws Exception {
        // 创建对象实例
        User user = new User();
        user.setName("张三");
        user.setAge(20);
        user.setBirthday(new Date());
        user.setDesc("一大段的说明，此处省略5000字...");

        // 保存
        Session session = sessionFactory.openSession(); // 打开一个新的Session
        Transaction tx = session.beginTransaction(); // 开启事务

        session.save(user);

        tx.commit(); // 提交事务
        session.close(); // 关闭Session，释放资源
    }

    @Test
    public void testGet() throws Exception {
        Session session = sessionFactory.openSession();
        Transaction tx = session.beginTransaction();

        User user = (User) session.get(User.class, 1); // 获取？
        System.out.println(user.getId());
        System.out.println(user.getName());
        System.out.println(user.getDesc());

        tx.commit();
        session.close();
    }
}

运行testSave()方法，再去查看t_user表结构： 
 
发现t_user表desc列的数据类型是longtext，而若是一定要让desc列的数据类型是text，也是有法子的，可以将

<property name="desc" type="text" length="5000" column="`desc`"/>

修改为：

<property name="desc">
    <column name="desc_" length="5000" sql-type="text"></column>
</property>

这时再次运行testSave()方法，再去查看t_user表结构： 
 
发现t_user表desc列的数据类型是text了，我们的目的达到了。虽说可以这样写，但是一般不建议这样写。 
最后，我们在持久化类——User.java中加入一个字段：

private byte[] photo; // 头像图片(二进制内容)

映射文件中增加：

<!-- 头像，二进制类型，最好指定长度 -->
<property name="photo" type="binary" length="102400"></property>

这时我们修改单元测试类——App.java的代码为：

public class App {
    private static SessionFactory sessionFactory;

    static {
        sessionFactory = new Configuration() //
                .configure() // 读取配置文件
                .addClass(User.class) //
                .buildSessionFactory();
    }

    @Test
    public void testSave() throws Exception {
        // 读取图片文件
        InputStream in = new FileInputStream("c:/1.jpg");
        byte[] photo = new byte[in.available()];
        in.read(photo);
        in.close();

        // 创建对象实例
        User user = new User();
        user.setName("张三");
        user.setAge(20);
        user.setBirthday(new Date());
        user.setDesc("一大段的说明，此处省略5000字...");
        user.setPhoto(photo);

        // 保存
        Session session = sessionFactory.openSession(); // 打开一个新的Session
        Transaction tx = session.beginTransaction(); // 开启事务

        session.save(user);

        tx.commit(); // 提交事务
        session.close(); // 关闭Session，释放资源
    }

    @Test
    public void testGet() throws Exception {
        Session session = sessionFactory.openSession();
        Transaction tx = session.beginTransaction();

        User user = (User) session.get(User.class, 1); // 获取？
        System.out.println(user.getId());
        System.out.println(user.getName());
        System.out.println(user.getDesc());
        System.out.println(user.getPhoto());

        OutputStream out = new FileOutputStream("c:/copy.png");
        out.write(user.getPhoto());
        out.close();

        tx.commit();
        session.close();
    }
}

测试，通过，大发！！！