jpa开发.txt

jpa开发

 

元数据属性说明：

name:列名。 
referencedColumnName:该列引用列的列名 
columnDefinition: 定义建表时创建此列的DDL 
下面的代码说明Customer映射到两个表，主表CUSTOMER,从表CUST_DETAIL，从表需要建立主键列CUST_ID，该列和主表的主键列id除了列名不同，其他定义一样。 

            
    @Entity
    @Table(name="CUSTOMER")
	@SecondaryTable(name="CUST_DETAIL",pkJoin=@PrimaryKeyJoinColumn(name="CUST_ID"，referencedColumnName="id"))
	public class Customer { 
	 @Id(generate = GeneratorType.AUTO)
	  public Integer getId() {
		  return id;
	  }
	}
    
    下面的代码说明Employee和EmployeeInfo是一对一关系，Employee的主键列id作为外键指向EmployeeInfo的主键列INFO_ID。 

            
    @Table(name = "Employee")
    public class Employee {
	@OneToOne
	@PrimaryKeyJoinColumn(name = "id", referencedColumnName="INFO_ID")
	EmployeeInfo info;
	}
    
    PrimaryKeyJoinColumns
如果entity class使用了复合主键，指定单个PrimaryKeyJoinColumn不能满足要求时，可以用PrimaryKeyJoinColumns来定义多个PrimaryKeyJoinColumn。 

元数据属性说明：

value: 一个PrimaryKeyJoinColumn数组，包含所有PrimaryKeyJoinColumn。 
下面的代码说明了Employee和EmployeeInfo是一对一关系。他们都使用复合主键，建表时需要在Employee表建立一个外键，从Employee的主键列id,name指向EmployeeInfo的主键列INFO_ID和INFO_NAME. 

            
   @Entity
   @IdClass(EmpPK.class)
   @Table(name = "EMPLOYEE")
   public class Employee {

	private int id;

	private String name;

	private String address;

	@OneToOne(cascade = CascadeType.ALL)
	@PrimaryKeyJoinColumns({
	@PrimaryKeyJoinColumn(name="id", referencedColumnName="INFO_ID"),
	@PrimaryKeyJoinColumn(name="name" , referencedColumnName="INFO_NAME")})
	EmployeeInfo info;
    }

    @Entity
    @IdClass(EmpPK.class)
    @Table(name = "EMPLOYEE_INFO")
    public class EmployeeInfo {

	@Id
	@Column(name = "INFO_ID")
	private int id;

	@Id
	@Column(name = "INFO_NAME")
	private String name;
	}
    
    Transient
Transient用来注释entity的属性，指定的这些属性不会被持久化，也不会为这些属性建表。

    
    @Transient
    private String name;
    
    　　
Version
Version指定实体类在乐观事务中的version属性。在实体类重新由EntityManager管理并且加入到乐观事务中时，保证完整性。每一个类只能有一个属性被指定为version，version属性应该映射到实体类的主表上。

下面的代码说明versionNum属性作为这个类的version，映射到数据库中主表的列名是OPTLOCK。

                
    @Version
    @Column("OPTLOCK")
    protected int getVersionNum() { return versionNum; }
    
    Lob
Lob指定一个属性作为数据库支持的大对象类型在数据库中存储。使用LobType这个枚举来定义Lob是二进制类型还是字符类型。

LobType枚举类型说明：

BLOB 二进制大对象，Byte[]或者Serializable的类型可以指定为BLOB。 
CLOB 字符型大对象，char[]、Character[]或String类型可以指定为CLOB。 
元数据属性说明：

fetch： 定义这个字段是lazy loaded还是eagerly fetched。数据类型是FetchType枚举，默认为LAZY,即lazy loaded. 
type： 定义这个字段在数据库中的JDBC数据类型。数据类型是LobType枚举，默认为BLOB。 
下面的代码定义了一个BLOB类型的属性和一个CLOB类型的属性。

                
    @Lob
    @Column(name="PHOTO" columnDefinition="BLOB NOT NULL")
    protected JPEGImage picture;
    
    @Lob(fetch=EAGER, type=CLOB)
    @Column(name="REPORT")
    protected String report;
    
    JoinTable
JoinTable在many-to-many关系的所有者一边定义。如果没有定义JoinTable，使用JoinTable的默认值。

元数据属性说明：

table:这个join table的Table定义。 
joinColumns:定义指向所有者主表的外键列，数据类型是JoinColumn数组。 
inverseJoinColumns:定义指向非所有者主表的外键列，数据类型是JoinColumn数组。 
下面的代码定义了一个连接表CUST和PHONE的join table。join table的表名是CUST_PHONE，包含两个外键，一个外键是CUST_ID，指向表CUST的主键ID，另一个外键是PHONE_ID，指向表PHONE的主键ID。

                
    @JoinTable(
    table=@Table(name=CUST_PHONE),
    joinColumns=@JoinColumn(name="CUST_ID", referencedColumnName="ID"),
    inverseJoinColumns=@JoinColumn(name="PHONE_ID", referencedColumnName="ID")
    )
    
    TableGenerator
TableGenerator定义一个主键值生成器，在Id这个元数据的generate＝TABLE时，generator属性中可以使用生成器的名字。生成器可以在类、方法或者属性上定义。

生成器是为多个实体类提供连续的ID值的表，每一行为一个类提供ID值，ID值通常是整数。

元数据属性说明：

name:生成器的唯一名字，可以被Id元数据使用。 
table:生成器用来存储id值的Table定义。 
pkColumnName:生成器表的主键名称。 
valueColumnName:生成器表的ID值的列名称。 
pkColumnValue:生成器表中的一行数据的主键值。 
initialValue:id值的初始值。 
allocationSize:id值的增量。 
下面的代码定义了两个生成器empGen和addressGen，生成器的表是ID_GEN。

                
    @Entity public class Employee {
    ...
    @TableGenerator(name="empGen",
    table=@Table(name="ID_GEN"),
    pkColumnName="GEN_KEY",
    valueColumnName="GEN_VALUE",
    pkColumnValue="EMP_ID",
    allocationSize=1)
    @Id(generate=TABLE, generator="empGen")
    public int id;
    ...
    }
    
    @Entity public class Address {
    ...
    @TableGenerator(name="addressGen",
    table=@Table(name="ID_GEN"),
    pkColumnValue="ADDR_ID")
    @Id(generate=TABLE, generator="addressGen")
    public int id;
    ...
    }
    
    SequenceGenerator
SequenceGenerator定义一个主键值生成器，在Id这个元数据的generator属性中可以使用生成器的名字。生成器可以在类、方法或者属性上定义。生成器是数据库支持的sequence对象。

元数据属性说明：

name:生成器的唯一名字，可以被Id元数据使用。 
sequenceName:数据库中，sequence对象的名称。如果不指定，会使用提供商指定的默认名称。 
initialValue:id值的初始值。 
allocationSize:id值的增量。 
下面的代码定义了一个使用提供商默认名称的sequence生成器。

                
    @SequenceGenerator(name="EMP_SEQ", allocationSize=25)	
    
    DiscriminatorColumn
DiscriminatorColumn定义在使用SINGLE_TABLE或JOINED继承策略的表中区别不继承层次的列。

元数据属性说明：

name:column的名字。默认值为TYPE。 
columnDefinition:生成DDL的sql片断。 
length:String类型的column的长度，其他类型使用默认值10。 
下面的代码定义了一个列名为DISC，长度为20的String类型的区别列。

                
    @Entity
    @Table(name="CUST")
    @Inheritance(strategy=SINGLE_TABLE,
        discriminatorType=STRING,
       discriminatorValue="CUSTOMER")
    @DiscriminatorColumn(name="DISC", length=20)
    public class Customer { ... }
    
    



6.JPA的查询语言
    JPA的查询语言是面向对象而非面向数据库的，它以面向对象的自然语法构造查询语句，可以看成是Hibernate HQL的等价物。 
    简单的查询 
    你可以使用以下语句返回所有Topic对象的记录： 
    SELECT t FROM Topic t 
    t表示Topic的别名，在Topic t是Topic AS t的缩写。 
    如果需要按条件查询Topic，我们可以使用： 
    SELECT DISTINCT t FROM Topic t WHERE t.topicTitle = ?1 
    通过WHERE指定查询条件，?1表示用位置标识参数，尔后，我们可以通过Query的setParameter(1, "主题1")绑定参数。而DISTINCT表示过滤掉重复的数据。 
    如果需要以命名绑定绑定数据，可以改成以下的方式： 
    SELECT DISTINCT t FROM Topic t WHERE t.topicTitle = :title 
    这时，需要通过Query的setParameter("title", "主题1")绑定参数。 

    关联查询：从One的一方关联到Many的一方 
    返回PollOptions对应的PollTopic对象，可以使用以下语句： 
    SELECT DISTINCT p FROM PollTopic p, IN(p.options) o WHERE o.optionItem LIKE ?1 
    这个语法和SQL以及HQL都有很大的区别，它直接实体属性连接关联的实体，这里我们通过PollTopic的options属性关联到PollOption实体上，对应的SQL语句为： 
    SELECT DISTINCT t0.TOPIC_ID, t0.TOPIC_TYPE, t0.TOPIC_TITLE, t0.TOPIC_TIME, t0.TOPIC_VIEWS, t0.MULTIPLE, t0.MAX_CHOICES FROM T_TOPIC t0, T_POLL_OPTION t1 WHERE (((t1.OPTION_ITEM LIKE ?) AND (t0.TOPIC_TYPE = ?)) AND (t1.TOPIC_ID = t0.TOPIC_ID)) 
    该查询语句的另外两种等价的写法分别是： 
    SELECT DISTINCT p FROM PollTopic p JOIN p.options o WHERE o.optionItem LIKE ?1 
和 
SELECT DISTINCT p FROM PollTopic p WHERE p.options.optionItem LIKE ?1 

    关联查询：从Many的一方关联到One的一方 
    从Many一方关联到One一方的查询语句和前面所讲的也很相似。如我们希望查询某一个调查主题下的所示调查项，则可以编写以下的查询语句： 
    SELECT p FROM PollOption p JOIN p.pollTopic t WHERE t.topicId = :topicId 
    对应的SQL语句为： 
    SELECT t0.OPTION_ID, t0.OPTION_ITEM, t0.TOPIC_ID FROM T_POLL_OPTION t0, T_TOPIC t1 WHERE ((t1.TOPIC_ID = ?) AND ((t1.TOPIC_ID = t0.TOPIC_ID) AND (t1.TOPIC_TYPE = ?))) 

    使用其它的关系操作符 
    使用空值比较符，比如查询附件不空的所有帖子对象： 
    SELECT p FROM Post p WHERE p.postAttach IS NOT NULL 
    范围比较符包括BETWEEN..AND和>、>= 、<、<=、<>这些操作符。比如下面的语句查询浏览次数在100到200之间的所有论坛主题： 
    SELECT t FROM Topic t WHERE t.topicViews BETWEEN 100 AND 200 

    集合关系操作符 
    和其它实体是One-to-Many或Many-to-Many关系的实体，通过集合引用关联的实体，我们可以通过集合关系操作符进行数据查询。下面的语句返回所有没有选项的调查论坛的主题： 
    SELECT t FROM PollTopic t WHERE t.options IS EMPTY 
    我们还可以通过判断元素是否在集合中进行查询： 
    SELECT t FROM PollTopic t WHERE :option MEMBER OF t.options 
    这里参数必须绑定一个PollOption的对象，JPA会自动将其转换为主键比较的SQL语句。 

    子查询 
    JPA可以进行子查询，并支持几个常见的子查询函数：EXISTS、ALL、ANY。如下面的语句查询出拥有6个以上选项的调查主题： 
    SELECT t FROM PollTopic t WHERE (SELECT COUNT(o) FROM t.options o) > 6 
    
    可用函数 
    JPA查询支持一些常见的函数，其中可用的字符串操作函数有： 
? CONCAT(String, String)：合并字段串； 
? LENGTH(String)：求字段串的长度； 
? LOCATE(String, String [, start])：查询字段串的函数，第一个参数为需要查询的字段串，看它在出现在第二个参数字符串的哪个位置，start表示从哪个位置开始查找，返回查找到的位置，没有找到返回0。如LOCATE ('b1','a1b1c1',1)返回为3； 
? SUBSTRING(String, start, length)：子字段串函数； 
? TRIM([[LEADING|TRAILING|BOTH] char) FROM] (String)：将字段串前后的特殊字符去除，可以通过选择决定具体的去除位置和字符； 
? LOWER(String)：将字符串转为小写； 
? UPPER(String)：将字符串转为大写。 
数字操作函数有： 
? ABS(number)：求绝对值函数； 
? MOD(int, int)：求模的函数； 
? SQRT(double)：求平方函数； 
? SIZE(Collection)：求集合大小函数。 

    更改语句 
    可以用EntityManager进行实体的更新操作，也可以通过查询语言执行数据表的字段更新，记录删除的操作： 
    下面的语句将某一个调查选项更新为新的值： 
    UPDATE PollOption p SET p.optionItem = :value WHERE p.optionId = :optionId 
    我们使用Query接口的executeUpdate()方法执行更新。下面的语句删除一条记录： 
    DELETE FROM PollOption p WHERE p.optionId = :optionId 

    排序和分组 
    我们还可以对查询进行排序和分组。如下面的语句查询出主题的发表时间大于某个时间值，返回的结果按浏览量降序排列： 
SELECT t FROM Topic t WHERE t.topicTime > :time ORDER BY t.topicViews DESC 
    下面的语句计算出每个调查主题对应的选项数目： 
    SELECT COUNT(p),p.pollTopic.topicId FROM PollOption p GROUP BY p.pollTopic.topicId 
这里，我们使用了计算数量的聚集函数COUNT()，其它几个可用的聚集函数分别为： 
? AVG：计算平均值，返回类型为double； 
? MAX：计算最大值； 
? MIN：计算最小值； 
? SUM：计算累加和； 
我们还可以通过HAVING对聚集结果进行条件过滤： 
SELECT COUNT(p),p.pollTopic.topicId FROM PollOption p GROUP BY p.pollTopic.topicId HAVING p.pollTopic.topicId IN(1,2,3) 

    7.小结 
    在不久的将来，Sun可能会将JPA作为一个单独的JSR对待，同时JPA还可能作为Java SE的一部分。不过这些都不太重要，重要的是，我们现在已经可以在脱离容器的情况下、在Java SE应用中使用JPA了。 
    JPA已经作为一项对象持久化的标准，不但可以获得Java EE应用服务器的支持，来可以直接在Java SE中使用。开发者将无需在现有多种ORM框架中艰难地选择，按照Sun的预想，现有ORM框架头顶的光环将渐渐暗淡，不再具有以往的吸引力。