B データ・アクセスに関する廃止JavaBeans

この章では、データベース・アクセスに関するカスタムJavaBeansクラスのうち廃止されたクラスをまとめています。

データ・アクセスJavaBeans

データベース・アクセスのためにOC4Jで提供される次のカスタムJavaBeansは、Oracle Application Server 10gリリース3（10.1.3）以降は廃止されます。oracle.jsp.dbutilパッケージには、次のBeanが含まれています。

• ConnCacheBeanでは、データベース接続にOracle JDBCの接続キャッシング実装が使用されます。

• DBBeanは、データベースの問合せを実行します。それ自体に接続機能がありますが、データ・ソースはサポートしません。

ConnCacheBeanが拡張するOracleConnectionCacheImplも廃止されます。

次の説明は、Oracle JDBCの操作知識があることを前提にしています。必要に応じて、『Oracle Database JDBC開発者ガイドおよびリファレンス』を参照してください。

データ・アクセスJavaBeansを使用するには、ojsputil.jarファイルがインストール済で、クラスパスに存在していることを確認してください。このファイルは、OC4Jのインストール時にインストールされます。XML関連のメソッドおよび機能については、xsu12.jar（JDK 1.2.x）またはxsu111.jar（JDK 1.1.x）のファイルも必要です。これらのファイルはOracle Application Serverに含まれています。

また、Oracle DatabaseおよびJDK 1.2以上の場合は、classes12.zipなどの適切なJDBCドライバ・クラスがインストール済で、クラスパスに存在している必要があります。

データ・アクセスJavaBeanの説明

次の各項では、データ・アクセスJavaBeans（ConnBean、ConnCacheBean、DBBeanおよびCursorBean）の属性とメソッドについて、データ・ソースを使用する例を含めて説明します。

• 接続キャッシング用ConnCacheBean

• 問合せ専用DBBean

接続キャッシング用ConnCacheBean

データベース接続には、oracle.jsp.dbutil.ConnCacheBeanを使用して、Oracle JDBCの接続キャッシング機能を使用し、JDBC 2.0の接続プーリングを使用します。接続キャッシングの詳細は、『Oracle Database JDBC開発者ガイドおよびリファレンス』を参照してください。

注意 データ・ソースや単純な接続オブジェクトを使用するには、かわりにConnBeanを使用します。 ConnCacheBeanはOracleConnectionCacheImplを拡張し、これはさらにOracleDataSourceを拡張します（両方ともOracle JDBCパッケージoracle.jdbc.poolにあります）。

ConnCacheBeanには、次のプロパティがあります。

• user: データベース・スキーマのユーザーID

• password: ユーザー・パスワード

• URL: データベース接続文字列

• maxLimit: このキャッシュによる許容最大接続数

• minLimit: このキャッシュに存在する最小接続数

  使用接続数がこの最小接続数に満たない場合は、キャッシュのアイドル・プールにも接続があります。

• stmtCacheSize: Oracle JDBCの文のキャッシング用キャッシュ・サイズ

  stmtCacheSizeを設定すると、Oracle JDBCの文のキャッシング機能を有効にできます。Oracle JDBCの文のキャッシング機能と制限の詳細は、『Oracle Database JDBC開発者ガイドおよびリファレンス』を参照してください。

• cacheScheme: キャッシュのタイプ

  これは、次のいずれかのint型定数によって示されます。

  • DYNAMIC_SCHEME: 最大制限を超えて新規のプール接続を作成できます。ただし、各接続は、用意した論理的な接続インスタンスが使用されなくなり次第、自動的にクローズおよび解放されます。

  • FIXED_WAIT_SCHEME: 最大制限に達すると、新規接続は、既存の接続オブジェクトが解放されるまで待機します。

  • FIXED_RETURN_NULL_SCHEME: 最大制限に達すると、接続オブジェクトが解放されるまで、新規接続は失敗します（nullが戻ります）。

ConnCacheBeanクラスは、Oracle JDBC OracleConnectionCacheImplクラスに定義されているメソッドをサポートします。これにはプロパティに対する次のgetterメソッドとsetterメソッドも含まれます。

• void setUser(String)

• String getUser()

• void setPassword(String)

• String getPassword()

• void setURL(String)

• String getURL()

• void setMaxLimit(int)

• int getMaxLimit()

• void setMinLimit(int)

• int getMinLimit()

• void setStmtCacheSize(int)

• int getStmtCacheSize()

• void setCacheScheme(int)

  ConnCacheBean.DYNAMIC_SCHEME、ConnCacheBean.FIXED_WAIT_SCHEMEまたはConnCacheBean.FIXED_RETURN_NULL_SCHEMEを指定します。

• int getCacheScheme()

  ConnCacheBean.DYNAMIC_SCHEME、ConnCacheBean.FIXED_WAIT_SCHEMEまたはConnCacheBean.FIXED_RETURN_NULL_SCHEMEを戻します。

ConnCacheBeanクラスは、oracle.jdbc.pool.OracleDataSourceクラスから、プロパティおよび関連するgetterメソッドとsetterメソッドも継承します。これによって、databaseName、dataSourceName、description、networkProtocol、portNumber、serverNameおよびdriverTypeの各プロパティのgetterメソッドとsetterメソッドが提供されます。これらのプロパティおよびそのgetterメソッドとsetterメソッドの詳細は、『Oracle Database JDBC開発者ガイドおよびリファレンス』を参照してください。

注意 JSPページで使用するJavaBeanと同様に、ConnCacheBeanプロパティは、setterメソッドを直接使用しないで、jsp:setProperty操作で設定できます。

次のメソッドを使用して、接続をオープンおよびクローズします。

• Connection getConnection()

  ConnCacheBeanプロパティの設定を使用して、接続のキャッシュから接続を取得します。

• void close()

  接続とオープン中のカーソルをすべてクローズします。

ConnCacheBeanクラスは、Oracle JDBCのバッチ更新および行のプリフェッチを直接サポートしていませんが、getConnection()メソッドで取得するConnectionオブジェクトのsetDefaultExecuteBatch(int)メソッドおよびsetDefaultRowPrefetch(int)メソッドをコールすることで、これらの機能を有効にできます。Connectionオブジェクトから作成したJDBCの文オブジェクトのsetExecuteBatch(int)メソッドおよびsetRowPrefetch(int)メソッドを使用することもできます。（バッチ更新は、プリコンパイルされたSQL文でのみサポートされます。）これらの機能の詳細は、『Oracle Database JDBC開発者ガイドおよびリファレンス』を参照してください。

注意 ConnCacheBeanの機能はOracleConnectionCacheImplクラスと同じです。詳細は、『Oracle Database JDBC開発者ガイドおよびリファレンス』を参照してください。 ConnBeanとは異なり、ConnCacheBeanを使用する場合は、標準のConnectionオブジェクトの機能を使用して、文オブジェクトを作成および実行します。

問合せ専用DBBean

問合せのみを実行するには、oracle.jsp.dbutil.DBBeanを使用します。

注意 DBBean自体にも接続機能がありますが、データ・ソースはサポートしません。データ・ソースが必要な場合は、ConnBeanを使用します。 その他のDML操作（UPDATE、INSERT、DELETEまたはストアド・プロシージャ・コール）については、CursorBeanを使用します。

DBBeanには、次のプロパティがあります。

• user: データベース・スキーマのユーザーID

• password: ユーザー・パスワード

• URL: データベース接続文字列

DBBeanには、次のようなプロパティのsetterメソッドとgetterメソッドが用意されています。

• void setUser(String)

• String getUser()

• void setPassword(String)

• String getPassword()

• void setURL(String)

• String getURL()

  注意 JSPページで使用するJavaBeanと同様に、DBBeanプロパティは、setterメソッドを直接使用しないで、jsp:setProperty文で設定できます。

次のメソッドを使用して、接続をオープンおよびクローズします。

• void connect()

  DBBeanプロパティの設定を使用して、データベース接続を確立します。

• void close()

  接続とオープン中のカーソルをクローズします。

次のいずれかのメソッドを使用して、問合せを実行します。

• String getResultAsHTMLTable(String)

  SELECT文が含まれた文字列を入力します。このメソッドは、HTML表として結果セットを出力するために必要なHTMLで文字列を戻します。SQL列名（または別名）は、表の列ヘッダーに使用されます。

• String getResultAsXMLString(String)

  SELECT文が含まれた文字列を入力します。このメソッドは、XMLタグとしてSQL列名（または別名）を使用して、結果セットをXML文字列として戻します。