Hibernate Annotations(1)

今天有时间大体看了一下Hibernate Annotations,决定放弃xdoclet生成hbm的想法，开始学习annotation.

首先大体的来看一下：

一：Class Level:
1:通过@Entity声明当前pojo为实体Bean
2:通过@Table定义对应数据库表的属性
   name：表名，默认实体类名
   uniqueConstraints：定义表的唯一性约束

例：定义表名为tb_user,并且用户名唯一，不能重复

@Entity
@Table(
        name = "tb_user",
        uniqueConstraints =
                {@UniqueConstraint(columnNames = "userName")}
)
public class User implements Serializable {
    private Integer id;
    private String userName;
}

二：Method Level:
@Basic
@Transient
@Column
所有非static非transient都会被持久化，也就是说所有加@Transient是不会被保存到数据库中的，所有没有加注的默认为@Basic,通过Column我们可以更一步的定义列名，是否为空，长度，是否可更新等等属性值，

例：

    @Column(name = "userName", nullable = false, length = 80, unique = true)
    public String getUserName() {
        return userName;
    }

    public void setUserName(String userName) {
        this.userName = userName;
    }

    @Transient
    public String getPassword() {
        return password;
    }

默认的列名就是属性名，上面的name="userName"只是演示而已。
password加注为@Transient，所以通过SchemaExport导入Schema，查看表结构是没有这个字段的。

@Temporal
日期类型，分三种，Time,Date,Timestamp
例：

    @Temporal(TemporalType.TIMESTAMP)
    public Date getBirthday() {
        return birthday;
    }

@Lob
1:所有的Clob，Character，char，String都会被转为Clob
2:所有的Blob，Byte[]，byte[]，serializable都会被转为Blob
例：

    @Lob
    public Clob getResume() {
        return resume;
    }

    @Lob
    public Blob getImage() {
        return image;
    }

@Id
就是标识了，暂时还没有详读文档，看了一下test
最简单方式如下：

    @Id
    @GeneratedValue
    public String getId() {
        return id;
    }

我看了一下mysql生成的sql
 

id integer not null auto_increment,
primary key (id),

应该是hibernate根据数据库类型自动选择的(说了一句废话 )，我猜是生成方式native
当然我们可以根据我们需要选择其他的生成方式，例如常用的uuid

    @Id
    @GeneratedValue(generator = "system-uuid")
    @GenericGenerator(name = "system-uuid", strategy = "uuid")
    public Integer getId() {
        return id;
    }

@Version
乐观锁

三：跑起来
和Hibernate官方网站一样，来个HibernateUtil

/**
 * @author martin
 */
public class HibernateUtil {
    private static final SessionFactory sessionFactory;

    static {
        AnnotationConfiguration cfg =
                new AnnotationConfiguration().addAnnotatedClass(User.class);
        new SchemaExport(cfg).execute(true, true, false, true);
        sessionFactory = cfg.buildSessionFactory();
    }

    public static Session getSession() {
        return sessionFactory.openSession();
    }
}

注意这里的 new AnnotationConfiguration()！

Test:

/**
 * @author martin
 */
public class HibernateUtilTest extends TestCase {
    public void testAddUser() {
        User user = new User();
        user.setUserName("martin");
        save(user);
        assertNotNull(user.getId());
    }

    public void testUpdateUser() {
        Session session = HibernateUtil.getSession();
        Query query =
                session.createQuery("from User as user where user.userName=:name");
        query.setParameter("name", "martin");
        List list = query.list();
        session.close();
        assertEquals(1, list.size());

        User user = (User) list.get(0);
        user.setUserName("martin xus");
        save(user);
        assertEquals(new Integer(1), user.getVersion());
    }

    private void save(User user) {
        Session session = HibernateUtil.getSession();
        Transaction tx = session.beginTransaction();
        session.saveOrUpdate(user);
        session.flush();
        tx.commit();
        session.close();
    }
}

创建的表结构为：

   create table tb_user (
        id varchar(32) not null,
        birthday datetime,
        resume text,
        image blob,
        optlock integer,
        password varchar(255),
        userName varchar(80) not null unique,
        primary key (id),
        unique (userName)
    )

完整User代码(省掉了所有属性的setter)：

import org.hibernate.annotations.GenericGenerator;

import javax.persistence.*;
import java.io.Serializable;
import java.util.Date;
import java.sql.Clob;
import java.sql.Blob;

/** *//**
 * @author martin
 */
@Entity
@Table(
        name = "tb_user",
        uniqueConstraints =
                {@UniqueConstraint(columnNames = "userName")}
)
public class User implements Serializable {
    private String id;
    private String userName;
    private String password;
    private Date birthday;
    private Clob resume;
    private Blob image;
    private Integer version;

    @Id
    @GeneratedValue(generator = "system-uuid")
    @GenericGenerator(name = "system-uuid", strategy = "uuid")
    @Column(length = 32)
    public String getId() {
        return id;
    }

    @Column(nullable = false, length = 80, unique = true)
    public String getUserName() {
        return userName;
    }


    public String getPassword() {
        return password;
    }


    @Temporal(TemporalType.TIMESTAMP)
    public Date getBirthday() {
        return birthday;
    }


    @Version
    @Column(name = "optlock")
    public Integer getVersion() {
        return version;
    }


    @Lob
    public Clob getResume() {
        return resume;
    }

    @Lob
    public Blob getImage() {
        return image;
    }
     
    //setter
}

四：next,明天的学习计划.

参考
    Hibernate Annotations Refrence

分享到：

It is time to stop listening to James Go ... | 应需求添加每天定时生成索引

• 2006-03-09 22:50
• 浏览 2428
• 评论(0)
• 查看更多