JPA 注解（一）

1、 @Entity(name="EntityName")

      表示该类是一个可持化的实体。当在容器中时，服务器将会首先加载所有标注了@Entity注释的实体类，其中@Entity中的“name”属性表示实体名称，若不作设置，默认为标注实体类的名称（注意大小写与系统的关系。）。 @Entity标注是必需的 ，name属性为可选。 

@Entity(name="person_1")
public class Person implements Serializable {
	
	
	public Person(){
		id=System.currentTimeMillis();
	}

	public Person(Long id){
		this.id = id;
	}
}

 

 @Entity标注的实体类至少需要有一个无参的构造方法。这是因为，在使用类反射机制 Class.newInstance()方法创建实例时，必需要有一个默认的无参数构造方法，否则会执出实例化异常（InstantiationException）。

   如果指定name属性后，在执行JPQL时应该使用name属性所指的名称。像上面的标注后，在执行JPQL时要像下面这样：

SELECT p FROM person_1 AS p

 name属性为默认值时就使用类名称：

SELECT p FROM Person AS p; 

    有两点须要注意：

      （1）实体可继承，非实体类可以继承自实体类，实体类也要中以继承自非实类。

      （2）抽象类（abstract）也可以标注为实体类。

 

2、@Table

     在使用@Table标记时，需要注意以下几个问题。

     （1） 此标记需要标注在类名前，不能标注在方法或属性前。

     （2） name 属性表示实体所对应表的名称，默认表名为实体名称。

     （3） catalog 和schema 属性表示实体指定的目录名或数据库名，这个根据不同的数据类型有所不同。

     （4） uniqueConstraints 属性表示该实体所关联的唯一约束条件，一个实体可以有多个唯一的约束，默认没有约束条件。

     （5）若使用uniqueContraints 属性时，需要配合标记UniqueContraint标记来使用。

 

package model;

import java.io.Serializable;

import javax.persistence.Entity;
import javax.persistence.Table;
import javax.persistence.UniqueConstraint;

@Entity
@Table(name = "tb_contact", schema = "test", uniqueConstraints = { 
		@UniqueConstraint(columnNames = {"name", "email" }),
		@UniqueConstraint(columnNames = {"col1", "col2" })
})
public class ContactEO implements Serializable {

	private Long id;

	private String name;

	private String email;

	private String col1;

	private String col2;

}

 以上的@Table注释表示指定数据库名“test”，表名为“tb_contact”，并创建了两组唯一索引。

3、@Column

        @Column标记表示持久化属性映射表中的字段。此标记可以标注在Getter方法或属性前。

如标注在属性前

public class ContactEO implements Serializable {

	@Column(name = "name")
	private String name;

	public String getName() {
		return name;
	}

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

 或者标注在Getter方法前。

public class ContactEO implements Serializable {

	
	private String name;

    @Column(name = "name")
	public String getName() {
		return name;
	}

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

  （1） unique 属性表示该字段是否为唯一标识，默认为false。如果表中有一个字段需要唯一标识，则既可以使用@Column标记也可以使用@Table标记中的@UniqueConstraint。

  （2）nullable 属性表示该字段是否可以为null值，默认为true（允许为null值）。

  （3）insertable 属性表示在使用“INSERT” SQL语脚本插入数据时，是否需要插入该字段的值。

  （4）updatable 属性表示在使用“UPDATE”脚本插入数据时，是否需要更新该字段的值。insertable和updatable属性一般多用于只读属性，例如主键和外键等。这些字段值通常是自动生成的。

  （5）columnDefinition 属性表示创建表时，该字段创建的SQL语句，一般用于通过Entity生成表定义时使用。

  （6）table 属性表示当映射多个表时，指定表中的字段。默认值为主表的表名。

  （7）length 属性表示该字段的长度，当字段的类型为varchar时，该属性才有效，默认为255个字符。

  （8）precision 属性和scale 属性表示精度，当字段类型为double时，precision表示数值的总长度，scale表示小数点所占的位数。

示例一、

	private String name;

	@Column(name = "name",nullable=false,length=512)
	public String getName() {
		return name;
	}

 生成的SQL脚本为

CREATE TABLE contact(
      id integer not null,
      name varchar(512) not null,
      primary key(id)
);

  示例二、为double型指定精度为12位，小数点位数为2位。

	private BigDecimal monthlyIncome;
	
	@Column(name="monthly_income",precision=12,scale=2)
	public BigDecimal getMonthlyIncome() {
		return monthlyIncome;
	}

	public void setMonthlyIncome(BigDecimal monthlyIncome) {
		this.monthlyIncome = monthlyIncome;
	}

 生成的SQL脚本为

CREATE TABLE contact(
      id integer not null,
      monthly_income double(12,2),
      primary key(id)
);

 示例三、自定义生成CLOB类型字段的SQL语句

	@Column(name = "contact_name",columnDefinition=" clob not null" )
	private String name;
	
	public String getName() {
		return name;
	}

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

  生成的SQL脚本为

CREATE TABLE contact(
      id integer not null,
      contact_name clob(200) not null,












      primary key(id)
);

  其中加粗的部份为columnDefinition属性设置的值。若不指定该属笥，通常使用默认的类型建表，若此时需要自定义建表的类型时，可以在该属性设置。

 

可持久化的数据类型

分类	类型
Java的基本数据类型	byte、int、short、long、boolean、char、float、double
Java的基本数据类型对应的封装类	Byte、Int、Short、Long、Boolean、Character、Float、Double
字节和字符型数组	byte[]、Byte[]、char[]、Character[]
大数值类型	java.math.BigInteger java.math.BigDecimal
字符串类型	java.lang.String
日期时间类型	java.util.Date java.util.Calendar java.sql.Date java.sql.Time java.sql.Timestamp
枚举型	用户自定义的枚举型
Entity类型	标注为@Entity的类
包含Entity类型的集合Collection类	java.util.Collection java.util.Set java.util.List java.util.Map
嵌入式（embeddable）类

 Java数据类型与数据库中的类型转换是由JPA实现框架自动转换的，所以不同的JPA实现框架转换的规则也不太一样。

     例如MySQL中，varchar和char类型都转化为String类型。Blob和Clob类型可以转化成Byte[]型。由于类型转化是JPA底层来实现的，这就遇到一个问题，很有可能在将表中的数据转换成Java的数据类型时出现异常。

       我们知道对于可以持久化的Java类型中，即可以映射基本的数据类型，如byte、int、short、long、boolean、char、float、double等，也可以映射成 Byte、Int、Short、Long、Boolean、Character、Float、 Double类型。那么选择哪种类型比较合适呢？

举下面的例子进行说明。

CREATE TABLE contact(
      id integer not null,
      monthly_income double(12,2),
      primary key(id)
);

      对于表字段id，它的值不能为null，所以映射成int型和Integer型都是可以的。

      但对于表字段monthly_income来说，它的值可能为null。当为null时，若此时java的Enity类的对应属性的类型int，则将一个null值转化成int型必定产生转换异。但此时java的Entity类对应的属性为Integer，它是一个对象，对象可以为null，所以不会产生问题。

4、@Basic

    在默认情况下，Entity中属笥加载方式都是即时加载（EAGER）的，当Enity对象实例化时，就加截了实体中相应的属性值。

    但对于一些特殊属笥，比如大文本型text、字节流型blob型的数据，在加载Entity时，这些属性对应的数据量比较大，有时创建实体时如果也加载的话，可能造成资源严重占用。那么就可以为这些特殊的实体属性设置加载方式为惰性加载（LAZY）

   （1）fetch属性表示获取值的方式，它的值定义的枚举型，可选值为LAZY、EAGER。其中EAGER表示即时加载、LAZY表示惰性加载。默认为即时加载。

   （2）optional表示属性是否可以为null，不能用于java基本数据型（ byte、int、short、long、boolean、char、float、double ）。

如：

	@Basic(fetch=FetchType.LAZY)
	@Column(name = "contact_name",columnDefinition=" clob not null" )
	private String name;
	
	public String getName() {
		return name;
	}

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

 

5、@Id

       主键是实体的唯一标识，调用EntityManager的find方法，可以获得相应的实体对象。每一个实体类至少要有一个主键（Primary key）。

       一旦使用@Id 标记属性为主键，该实体属性的值可以指定，也可以根据一些特定的规则自动生成。这就涉及另一个标记@GeneratedValue 的使用。

       @GeneratedValue 标注有以两个属性：

       （1）strategy 属性表示生成主键的策略 ，有4种类型，分别定义在枚举型GenerationType中，其中有 GenerationType.TABLE 、 GenerationType.SEQUENCE 、 GenerationType.IDENTITY 、 GenerationType.AUTO ,其中，默认为AUTO，表示自动生成。

       （2）generator 为不同策略类型所对应的生成规则名，它的值根据不同的策略有不同的设置。

       （3）能够标识为主键的属性类型，有如表5-2所列举的几种。

分类	类型
Java的基本数据类型	byte、int、short、long、char
Java的基本数据类型对应的封装类	Byte、Integer、Short、Long、Character
大数值类型	java.math.BigInteger
字符串类型	java.lang.String
时间日期型	java.util.Date java.sql.Date

 

 

 

 

 

 

 

 

 

 

 

 

 

       double和float浮点类型和它们对应的封装类不能作为主键，这是因为判断是否唯一是通过equals方法来判断的，浮点型的精度太大，不能够准确地匹配。

       例一，自增主键 。在不同的数据库，自增主键的生成策略可能有所不同。例如MySQL的自增主键可以通过IDENTITY来实现，而Oracle可能需要创建Sequence来实现自增。JPA的实现将会根据不同的数据库类型来实现自增的策略。

	@Id
	@GeneratedValue(strategy = GenerationType.AUTO)
	public Long getId() {
		return id;
	}

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

        例二，表生成器 。将当前主键的值单独保存到一个数据库的表中，主键的值每次都是从指定的表中查询来获得，这种生成主键的方式也是很常用的。这种方法生成主键的策略可以适用于任何的数据库，不必担心与同数据库不兼容造成问题。

         配置的Customer类

package model;

import java.io.Serializable;

import javax.persistence.Basic;
import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.persistence.Table;
import javax.persistence.TableGenerator;

@Entity
@Table(schema = "open_jpa", name = "customer")
public class Customer implements Serializable
{
    private static final long serialVersionUID = -8480590552153589674L;

    private Integer           id;

    private String            name;

    @Id
    @GeneratedValue(strategy = GenerationType.TABLE, generator = "customer_gen")
    @TableGenerator(schema = "open_jpa", 
            name = "customer_gen", 
            table = "tbl_generator", 
            pkColumnName = "gen_name", 
            pkColumnValue = "CUSTOMER_PK", 
            valueColumnName = "gen_value", 
            allocationSize = 1, 
            initialValue = 0)
    public Integer getId()
    {
        return id;
    }

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

    @Basic
    @Column(name = "name")
    public String getName()
    {
        return name;
    }

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

 （1）在Entity标记的主键的位置，指定主键生成策略为“GenerationType.TABLE ”。

 （2）指定生成主键策略的名称，例如这里命名为“generator = "customer_gen" ”。

 （3）使用@TableGenerator标定义表生成策略的具体设置：

 @TableGenerator(schema = "open_jpa", 
            name = "customer_gen", 
            table = "tbl_generator", 
            pkColumnName = "gen_name", 
            pkColumnValue = "CUSTOMER_PK", 
            valueColumnName = "gen_value", 
            allocationSize = 1, 
            initialValue = 0)

 可以看到数据生成tbl_generator 的结构及添加的数据：

CREATE TABLE `tbl_generator` (
  `GEN_NAME` varchar(255) NOT NULL,
  `GEN_VALUE` bigint(20) default NULL,
  PRIMARY KEY  (`GEN_NAME`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
INSERT INTO tbl_generator VALUES ('CUSTOMER_PK', 1);

 

使用Oracle的sequence方式生成ID值。  

 

    @Id  
    @GeneratedValue(strategy = GenerationType.SEQUENCE,generator="payablemoney_seq")  
    @SequenceGenerator(name="payablemoney_seq", sequenceName="seq_payment")  

 

@SequenceGenerator定义

@Target({TYPE, METHOD, FIELD})   
@Retention(RUNTIME)  
public @interface SequenceGenerator {  
 String name();  
 String sequenceName() default "";  
 int initialValue() default 0;  
 int allocationSize() default 50;  
} 

 name属性表示该表主键生成策略的名称，它被引用在@GeneratedValue中设置的“generator”值中。
sequenceName属性表示生成策略用到的数据库序列名称。
initialValue表示主键初识值，默认为0。
allocationSize表示每次主键值增加的大小，例如设置成1，则表示每次创建新记录后自动加1，默认为50。