躺在沙滩上的小猪

快乐的每一天

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(truetruefalsetrue);
        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(32not null,
        birthday 
datetime,
        resume 
text,
        
image blob,
        optlock 
integer,
        password 
varchar(255),
        userName 
varchar(80not 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

posted on 2006-03-09 22:50 martin xus 阅读(1073) 评论(0)  编辑  收藏 所属分类: javahibernate