パッケージ jakarta.persistence

アノテーション型 SqlResultSetMapping

  • @RepeatableSE(SqlResultSetMappings.class)
@TargetSE(TYPESE)
@RetentionSE(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

    • 必須定数のサマリー

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

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

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

    • 要素の詳細

      • name

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

      • entities

        EntityResult[] entities
        エンティティへの結果セットのマッピングを指定します。
        デフォルト:
        {}

      • classes

        ConstructorResult[] classes
        コンストラクターへの結果セットのマッピングを指定します。
        導入:
        2.1
        デフォルト:
        {}

      • columns

        ColumnResult[] columns
        スカラー値への結果セットのマッピングを指定します。
        デフォルト:
        {}