org.seasar.doma
注釈型 Procedure

@Target(value=METHOD)
@Retention(value=RUNTIME)
public @interface Procedure

ストアドプロシージャーの呼び出しを示します。

このアノテーションが注釈されるメソッドは、Dao が注釈されたインタフェースのメンバでなければいけません。 注釈されるメソッドは、次の制約を満たす必要があります。

• パラメータは0個以上である。
• パラメータには、パラメータの種別を示す In 、 InOut 、 Out 、 ResultSet のいずれかのアノテーションが指定される。これらは、ストアドファンクションの定義に合わせて注釈しなければいけない。
  • Inは、INパラメータを表す。
  • InOutは、INOUTパラメータを表す。
  • Outは、 OUTパラメータを表す。
  • ResultSet は、カーソルのOUTパラメータ、もしくはストアドファンクションが返す結果セットを表す。
• 戻り値は void である。

例:

 @Dao(config = AppConfig.class)
 public interface EmployeeDao {
 
     @Procedure
     void updateSalary(@In Integer id, @InOut Reference<BigDecimal> salary);
 }
 

注釈されるメソッドは、次の例外をスローすることがあります。

• DomaNullPointerException パラメータに nullを渡した場合
• MappedPropertyNotFoundException ResultSet を使用していて結果セットに含まれるカラムにマッピングされたプロパティが見つからなかった場合
• JdbcException JDBCに関する例外が発生した場合

作成者:

taedium

関連項目:

In, InOut, Out, ResultSet

任意要素の概要

String	catalog カタログ名です。
MapKeyNamingType	mapKeyNaming 結果セットを @code{Map} もしくは @code{List>} として取得する場合のマップのキーに対するネーミング規約です。
String	name ストアドプロシージャーの名前です。
int	queryTimeout クエリタイムアウト（秒）です。
String	schema スキーマ名です。

catalog

public abstract String catalog

カタログ名です。

デフォルト:

""

schema

public abstract String schema

スキーマ名です。

デフォルト:

""

name

public abstract String name

ストアドプロシージャーの名前です。

指定しない場合、注釈されたメソッドの名前が使用されます。

デフォルト:

""

queryTimeout

public abstract int queryTimeout

クエリタイムアウト（秒）です。

指定しない場合、Config.getQueryTimeout()が使用されます。

関連項目:

Statement.setQueryTimeout(int)

デフォルト:

-1

mapKeyNaming

public abstract MapKeyNamingType mapKeyNaming

結果セットを @code{Map} もしくは @code{List>} として取得する場合のマップのキーに対するネーミング規約です。

導入されたバージョン:

1.7.0

デフォルト:

org.seasar.doma.MapKeyNamingType.NONE