JPA 批注5
来源:互联网 发布:知世图片 编辑:程序博客网 时间:2024/05/29 17:12
@QueryHint
默认情况下,JPA 持续性提供程序假设 @NamedQuery 或 @NamedNativeQuery 应完全按照查询 String
指定的方式执行。
使用 @QueryHint
批注指定供应商特定的 JPA 查询扩展,以:
提高查询性能
利用供应商的 JPA 持续性提供程序实现中的特定特性
表 1-6 列出了此批注的属性。有关更多详细信息,请参阅 API。
表 1-39 @QueryHint 属性
name
要指定提示名称,请将 name
设置为 String
提示名称。
有关提示的详细信息,请参阅 JPA 持续性提供程序文档。
value
要指定提示的值,请将 value
设置为所需的 String
提示值。
有关提示值的详细信息,请参阅 JPA 持续性提供程序文档。
示例 1-77 显示了如何使用 @QueryHint
批注自定义查询以利用由 TopLink Essentials 提供的供应商 JPA 扩展:在该示例中,提示确保在执行查询时始终刷新 TopLink 缓存。有关详细信息,请参阅“TopLink JPA 查询提示扩展”。
示例 1-77 @QueryHint
@Entity
@NamedQuery(
name="findAllEmployees",
query="SELECT * FROM EMPLOYEE WHERE MGR=1"
hints={@QueryHint={name="toplink.refresh", value="true"}}
)
public class Employee implements Serializable {
...
}
@SecondaryTable
默认情况下,JPA 持续性提供程序假设实体的所有持久字段均存储到一个名称为实体名称的数据库表中:该表称作主表(请参阅 @Table)。
如果希望 JPA 分别将实体的某些持久字段持久保存到主表和其他数据库表,请使用 @SecondaryTable
批注将实体与其他数据库表关联。在该示例中,您使用 @Column 批注将实体的持久字段与表关联。
如果要将两个或更多辅助表与实体关联,则可以使用 @SecondaryTables。
表 1-40 列出了此批注的属性。有关更多详细信息,请参阅 API。
表 1-40 @SecondaryTable 属性
姓名
如果实体使用辅助表,请将 name
设置为 String
表名。
catalog
默认值:JPA 持续性提供程序使用任何适用于数据库的默认目录。
如果默认目录不适合于应用程序,请将 catalog
设置为要使用的 String
目录名。
pkJoinColumns
默认值:JPA 持续性提供程序假设实体的数据库表中的任何列均不用于主键连接。
如果对该表中的主键连接使用一个或多个列,请将 pkJoinColumns
设置为一个或多个 @PrimaryKeyJoinColumn
实例的数组。有关详细信息,请参阅 @PrimaryKeyJoinColumn。
schema
默认值:JPA 持续性提供程序使用任何适用于数据库的默认模式。
如果默认模式不适合于应用程序,请将 schema
设置为要使用的 String
模式名。
uniqueConstraints
默认值:JPA 持续性提供程序假设实体的数据库表中的任何列均没有唯一约束。
如果唯一约束应用于该表中的一列或多列,请将 uniqueContraints
设置为一个或多个 UniqueConstraint
实例的数组。有关详细信息,请参阅 @UniqueConstraint。
示例 1-78 显示了如何使用此批注指定一个名为 EMP_HR
的辅助表。在该示例中,默认情况下,JPA 将实体持久字段 empId
持久保存到名为 Employee
的主表中的列 empId
,并将 empSalary
持久保存到辅助表 EMP_HR
中的列 empSalary
。有关详细信息,请参阅 @Column。
示例 1-78 @SecondaryTable
@Entity
@SecondaryTable(name="EMP_HR")
public class Employee implements Serializable {
...
private Long empId;
@Column(table="EMP_HR", name="EMP_SALARY"))
private Float empSalary;
...
}
@SecondaryTables
如果需要指定多个 @SecondaryTable,可以使用一个 @SecondaryTables
批注指定所有辅助表。
表 1-41 列出了此批注的属性。有关更多详细信息,请参阅 API。
表 1-41 @SecondaryTables 属性
value
要指定两个或更多辅助表,请将 value
设置为 SecondaryTable
实例的数组(请参阅 @SecondaryTable)。
示例 1-79 显示了如何使用此批注指定两个名为 EMP_HR
和 EMP_TR
的辅助表。在该示例中,默认情况下,JPA 将实体持久字段 empId
持久保存到名为 Employee
的主表中的列 empId
。JPA 将 empSalary
持久保存到辅助表 EMP_HR
中的列 empSalary
,并将 empClass
持久保存到辅助表 EMP_TR
中的列 EMP_HR
。有关详细信息,请参阅 @Column。
示例 1-79 @SecondaryTables
@Entity
@SecondaryTables({
@SecondaryTable(name="EMP_HR"),
@SecondaryTable(name="EMP_TR")
})
public class Employee implements Serializable {
...
private Long empId;
@Column(table="EMP_HR", name="EMP_SALARY"))
private Float empSalary;
@Column(table="EMP_TR", name="EMP_CLASS"))
private Float empClass;
...
}
@SequenceGenerator
如果使用 @GeneratedValue 批注指定一个 SEQUENCE
类型的主键生成器,则可以使用 @SequenceGenerator
批注微调该主键生成器以:
更改分配大小以匹配应用程序要求或数据库性能参数
更改初始值以匹配现有的数据模型(例如,如果基于已经为其分配或保留了一组主键值的现有数据集构建)
使用现有数据模型中预定义的序列
表 1-42 列出了此批注的属性。有关更多详细信息,请参阅 API。
表 1-42 @SequenceGenerator 属性
name
SequenceGenerator
的名称必须匹配其 startegy
设置为 SEQUENCE
的 GeneratedValue
的名称。
allocationSize
默认值: 50.
默认情况下,JPA 持续性提供程序使用的分配大小为 50。
如果此分配大小与应用程序要求或数据库性能参数不匹配,请将 allocationSize
设置为所需的 int
值。
initialValue
默认值: 0.
默认情况下,JPA 持续性提供程序假设持续性提供程序将所有主键值的起始值设置为 0。
如果这与现有数据模型不匹配,请将 initialValue
设置为所需的 int
值。
sequenceName
默认值:JPA 持续性提供程序分配它自己创建的序列名。
如果要使用事先存在或预定义的序列,请将 sequenceName
设置为所需的 String
名称。
示例 1-80 显示了如何使用此批注为名为 CUST_SEQ
的 SEQUENCE
主键生成器指定分配大小。
示例 1-80 @SequenceGenerator
@Entity
public class Employee implements Serializable {
...
@Id
@SequenceGenerator(name="CUST_SEQ", allocationSize=25)
@GeneratedValue(strategy=SEQUENCE, generator="CUST_SEQ")
@Column(name="CUST_ID")
public Long getId() {
return id;
}
...
@SqlResultSetMapping
执行 @NamedNativeQuery 时,它可以返回实体(包括不同类型的实体)、标量值或实体和标量值的组合。
默认情况下(如示例 1-81 所示),JPA 持续性提供程序假设原生 SQL 查询中的 SELECT
语句:
返回一个实体类型
包含与返回的实体的所有字段或属性相对应的所有列
使用与字段或属性名(未使用
AS
语句)相对应的列名
示例 1-81 简单的原生 SQL 查询
Query q = entityManager.createNativeQuery(
"SELECT o.id, o.quantity, o.item " +
"FROM Order o, Item i " +
"WHERE (o.item = i.id) AND (i.name = "widget")",
Order.class
);
List resultList = q.getResultList();
// List of Order entity objects:{Order, Order, ...}
如果原生 SQL 查询满足以下条件,请使用 @SqlResultSetMapping
批注控制 JPA 持续性提供程序如何将 JDBC 结果集映射到实体字段或属性以及标量:
返回多个类型的实体
只返回标量值或实体和标量值的组合
使用列别名(
AS
语句)
如果有多个 @SqlResultSetMapping
,则必须使用 @SqlResultSetMappings。
表 1-8 列出了此批注的属性。有关更多详细信息,请参阅 API。
表 1-43 @SqlResultSetMapping 属性
name
将 name
设置为此 @SqlResultSetMapping
的 String
名称。
这是用于将 @SqlResultSetMapping
与原生 SQL 查询关联的名称(请参阅示例 1-84)。
columns
默认值:空 ColumnResult
数组。
默认情况下,JPA 持续性提供程序假设 SELECT
语句只返回实体。
如果 SELECT
语句返回标量值,则将 columns
设置为 ColumnResult
实例的数组,每个标量结果一个 @ColumnResult。
entities
默认值:空 EntityResult
数组。
默认情况下,JPA 持续性提供程序假设 SELECT 语句返回一个类型的实体。
如果 SELECT 语句返回多个类型的实体,请将实体设置为 EntityResult
实例的数组,每个返回的实体类型一个 @EntityResult。
示例 1-82 显示了如何使用此批注将 Order
和 Item
(请参阅示例 1-83)实体和标量 name
包含在结果列表(请参阅示例 1-84)中。在该示例中,结果列表将为 Object
数组的 List
,如:{[Order, Item, "Shoes"], [Order, Item, "Socks"], ...}
。
示例 1-82 使用 @SqlResultSetMapping 的 Order 实体
@SqlResultSetMapping(
name="OrderResults",
entities={
@EntityResult(
entityClass=Order.class,
fields={
@FieldResult(name="id", column="order_id"),
@FieldResult(name="quantity", column="order_quantity"),
@FieldResult(name="item", column="order_item")
}
),
@EntityResult(
entityClass=Item.class,
fields={
@FieldResult(name="id", column="item_id"),
@FieldResult(name="name", column="item_name"),
}
)
}
columns={
@ColumnResult(
name="item_name"
)
}
)
@Entity
public class Order {
@Id
protected int id;
protected long quantity;
protected Item item;
...
}
示例 1-83 Item 实体
@Entity
public class Item {
@Id
protected int id;
protected String name;
...
}
示例 1-84 将 @SqlResultSetMapping 与 @EntityResult 一起使用的原生查询
Query q = entityManager.createNativeQuery(
"SELECT o.id AS order_id, " +
"o.quantity AS order_quantity, " +
"o.item AS order_item, " +
"i.id AS item_id, " +
"i.name AS item_name, " +
"FROM Order o, Item i " +
"WHERE (order_quantity > 25) AND (order_item = i.id)",
"OrderResults"
);
List resultList = q.getResultList();
// List of Object arrays:{[Order, Item, "Shoes"], [Order, Item, "Socks"], ...}
@SqlResultSetMappings
如果需要指定多个 @SqlResultSetMapping,则必须使用一个 @SqlResultSetMappings
批注指定所有 SQL 结果集映射。
表 1-5 列出了此批注的属性。有关更多详细信息,请参阅 API。
表 1-44 @SqlResultSetMappings 属性
value
要指定两个或更多 SQL 结果集映射,请将 value
设置为 @SqlResultSetMapping 实例的数组。
示例 1-85 显示了如何使用此批注指定两个 @SqlResultSetMapping 实例。
示例 1-85 @SqlResultSetMappings
SqlResultSetMappings({
@SqlResultSetMapping(
name="OrderItemItemNameResults",
entities={
@EntityResult(entityClass=Order.class),
@EntityResult(entityClass=Item.class)
}
columns={
@ColumnResult(name="item_name")
}
),
@SqlResultSetMapping(
name="OrderItemResults",
entities={
@EntityResult(entityClass=Order.class),
@EntityResult(entityClass=Item.class)
}
)
})
@Entity
public class Order {
@Id
protected int id;
protected long quantity;
protected Item item;
...
}
- JPA 批注5
- JPA 批注
- JPA 批注
- JPA 批注索引
- JPA生命周期事件批注
- JPA 批注6
- JPA 批注4
- JPA 批注3
- JPA 批注2
- JPA 批注1
- Jpa批注参考01
- Jpa批注参考02
- Jpa批注参考03
- Jpa批注参考04
- Jpa批注参考05
- Jpa批注参考06
- Jpa批注参考07
- EJB JPA 批注
- mysql 字段类型说明
- JPA 批注索引
- 最好的阻止SSH暴力破解的方法(DenyHosts)
- JPA生命周期事件批注
- JPA 批注6
- JPA 批注5
- 替换js中函数的参数
- JPA 批注4
- 〖天涯头条〗《失业七个月,面试六十家公司》的深圳体验
- 使用 Richfaces/Ajax4Jsf 创建 Web 应用
- asp.net(c#)常用正则表达式实例
- 从ZipInputStream找出给定文件夹下的所有文件,存放在Map中,key=filename ,value=file content string
- I saw your tear(拜伦,Terry译)
- Struts2使用validator验证框架的问题