今天有时间大体看了一下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