javax.persistence

注釈型 SqlResultSetMapping

@Repeatable(value=SqlResultSetMappings.class)
 @Target(value=TYPE)
 @Retention(value=RUNTIME)
public @interface SqlResultSetMapping

ネイティブSQLクエリーやストアドプロシージャーの結果のマッピングを指定します。

    Example:

    Query q = em.createNativeQuery(
        "SELECT o.id AS order_id, " +
            "o.quantity AS order_quantity, " +
            "o.item AS order_item, " +
            "i.name AS item_name, " +
        "FROM Order o, Item i " +
        "WHERE (order_quantity > 25) AND (order_item = i.id)",
    "OrderResults");
    
    @SqlResultSetMapping(name="OrderResults", 
        entities={ 
            @EntityResult(entityClass=com.acme.Order.class, fields={
                @FieldResult(name="id", column="order_id"),
                @FieldResult(name="quantity", column="order_quantity"), 
                @FieldResult(name="item", column="order_item")})},
        columns={
            @ColumnResult(name="item_name")}
    )
 

導入されたバージョン:

Java Persistence 1.0

関連項目:

Query, StoredProcedureQuery, NamedNativeQuery, NamedStoredProcedureQuery

必須要素のサマリー

必須要素

修飾子とタイプ	必須要素と説明
java.lang.String	name 結果セットのマッピングに与えられる名前で、QueryおよびStoredProcedureQuery APIのメソッドでそれを参照するために使用されます。

任意要素のサマリー

任意要素

修飾子とタイプ	任意要素と説明
ConstructorResult[]	classes コンストラクタへの結果セットのマッピングを指定します。
ColumnResult[]	columns スカラー値への結果セットのマッピングを指定します。
EntityResult[]	entities エンティティへの結果セットのマッピングを指定します。

要素の詳細

name

public abstract java.lang.String name

結果セットのマッピングに与えられる名前で、QueryおよびStoredProcedureQuery APIのメソッドでそれを参照するために使用されます。

entities

public abstract EntityResult[] entities

エンティティへの結果セットのマッピングを指定します。

デフォルト:

{}

classes

public abstract ConstructorResult[] classes

コンストラクタへの結果セットのマッピングを指定します。

導入されたバージョン:

Java Persistence 2.1

デフォルト:

{}

columns

public abstract ColumnResult[] columns

スカラー値への結果セットのマッピングを指定します。

デフォルト:

{}