@ReturnInsert

@ReturnInsertを使用して、INSERT操作で書込み中のオブジェクトに値を戻します。これにより、表のデフォルト値、トリガー、またはストアド・プロシージャの計算された値をオブジェクトに戻して設定できます。

注意:

戻りは、Oracle Databaseでのみサポートされ、INSERT RETURNING句が必要です。

他のデータベースで戻りを使用する場合、出力パラメータを持つストアド・プロシージャを挿入問合せに使用します。

注釈要素

表2-61は、この注釈の要素を示しています。

表2-61 @ReturnInsertの注釈要素

注釈要素	説明	デフォルト
`returnOnly`	(オプション)指定した場合(trueの場合)、マッピング・フィールドはSQL生成中に`INSERT`句から除外されます。	false

使用方法

@ReturnInsert注釈は、Basicマッピングにのみ指定できます。

例

例2-99に、@ReturnInsert注釈を使用する方法を示します。引数を使用しない場合、Oracle TopLinkはデフォルト値falseを受け入れます。

例2-99 @ReturnInsert注釈の使用

@ReturnInsert(returnOnly=true)
 public String getFirstName() {
     return firstName;
 }

例2-100に、eclipselink-orm.xmlファイルの<return-insert>要素を使用する方法を示します。

例2-100 <return-insert> XMLの使用

<basic name="firstName">
    <column name="FIRST_NAME"/>
    <return-insert read-only="true"/>
</basic>