SqlResultSetMapping (Jakarta EE Platform API)

@RepeatableSE(valueSE=SqlResultSetMappings.class)
 @TargetSE(valueSE=TYPESE)
 @RetentionSE(valueSE=RUNTIMESE)
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")}
    )

導入:: 1.0
関連事項:: Query, StoredProcedureQuery, NamedNativeQuery, NamedStoredProcedureQuery

必須定数のサマリー

必須要素
修飾子と型	必須要素と説明
`StringSE`	`name` 結果セットのマッピングに付けられた名前で、`Query` および `StoredProcedureQuery` API のメソッドでそれを参照するために使用されます。

オプション要素のサマリー

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

- 要素の詳細
  - name
```
public abstract StringSE name
```
    結果セットのマッピングに付けられた名前で、Query および StoredProcedureQuery API のメソッドでそれを参照するために使用されます。
- - entities
```
public abstract EntityResult[] entities
```
    エンティティへの結果セットのマッピングを指定します。
    デフォルト:
    {}
- - classes
```
public abstract ConstructorResult[] classes
```
    コンストラクターへの結果セットのマッピングを指定します。
    導入:
    2.1
    デフォルト:
    {}
- - columns
```
public abstract ColumnResult[] columns
```
    スカラー値への結果セットのマッピングを指定します。
    デフォルト:
    {}

アノテーション型 SqlResultSetMapping

必須定数のサマリー

オプション要素のサマリー

要素の詳細

name

entities

classes

columns