この例では、JFinalアプリケーションをTomcat上にデプロイし、DruidPlugin を使用してデータベース接続プールを管理し、OceanBase Connector/J を通じてOceanBaseデータベースにアクセスします。
前提条件
- OceanBase Cloudのアカウントを登録し、クラスタインスタンスとOceanBase CloudのOracleモードテナントを作成していること。詳細については、クラスタインスタンスの作成およびテナントの作成を参照してください。
- 対象のOracle互換モードテナントの接続文字列を取得済みであること。詳細な操作については、接続文字列の取得を参照してください。
- JDK 1.8とMavenをインストール済みであること。
- IntelliJ IDEAをインストール済みであること。
説明
このドキュメントでコードを実行するために使用したツールはIntelliJ IDEA 2021.3.2 (Community Edition)ですが、個人の好みに応じて適切なツールを選択してサンプルコードを実行することもできます。
手順
説明
本記事で示す操作手順は、Windows環境に基づいています。他のOS環境やコンパイラを使用している場合は、手順が若干異なる場合があります。
ステップ1:tomcat-oceanbase-client プロジェクトをIDEAにインポートする
IntelliJ IDEA を開き、File > Open... オプションを選択します。
表示された Open File or Project ウィンドウで、対応するプロジェクトファイルを選択し、OK をクリックしてプロジェクトファイルのインポートを完了します。
IntelliJ IDEAは、プロジェクト内のさまざまなファイルの種類を自動的に認識し、Project ツールウィンドウで、プロジェクトのディレクトリ構造、ファイルリスト、モジュールリスト、依存関係などの情報を確認できます。Project ツールウィンドウは通常、IntelliJ IDEA画面の左側にあり、デフォルトでは開いています。Project ツールウィンドウが閉じている場合は、メニューバーの View > Tool Windows > Project をクリックするか、ショートカットキー Alt + 1 を使用して再表示できます。
説明
IntelliJ IDEAでプロジェクトをインポートすると、IntelliJ IDEAはプロジェクト内のpom.xmlファイルを自動的に検出し、ファイルに記述されている依存関係に基づいて必要な依存ライブラリを自動的にダウンロードし、プロジェクトに追加します。
プロジェクトの状況を確認します。
ステップ2:tomcat-oceanbase-client プロジェクトのデータベース接続情報を修正する
前提条件で取得した接続文字列情報に基づいて、application.properties ファイル内のデータベース接続情報を修正します。
例:
# DruidPlugin configuration
#Database Connection Pool Driver Class Name
db.app.pool.driverClassName=com.oceanbase.jdbc.Driver
#Database URL
db.app.pool.url=jdbc:oceanbase://t5******.********.oceanbase.cloud:1521/SYS?characterEncoding=UTF-8
#Database username
db.app.pool.username=test_user
#Database password
db.app.pool.password=******
#Initial size of connection pool
db.app.pool.initialSize=3
# Prepared statement cache limit per connection
db.app.pool.maxTotal=10
# Unused by UserConfig
db.app.pool.maxIdle=20
# Unused by UserConfig
db.app.pool.minIdle=5
# Delay between connection attempts after an error (ms)
db.app.pool.maxWaitMillis=5000
# Validation SQL is set directly in UserConfig
db.app.pool.validationQuery=select 1 from dual
- データベースドライバーの名前:
com.oceanbase.jdbc.Driver - 接続アドレスは
t5******.********.oceanbase.cloudです。 - アクセスポートは1521を使用します。
- アクセスするスキーマは
sysです。 - テナントの接続アカウントは
test_userです。 - パスワードは
******です。
ステップ3:tomcat-oceanbase-client プロジェクトのTomcat実行環境を構築する
Tomcat 8.5.95をダウンロードします。
Apache Tomcat公式サイトからTomcat 8.5.95の圧縮ファイルをダウンロードします。ダウンロードした圧縮ファイルを、Tomcatをインストールしたいディレクトリに解凍します。
IDEAでTomcatを設定します。
IntelliJ IDEAを開き、File メニューから Settings > Plugins を選択します。Settings ウィンドウ中央の検索ボックスで Smart Tomcat を検索し、ダウンロード後に Apply を選択します。すると、Settings ウィンドウの左下に Tomcat Server タブが表示されます。Tomcat Server タブに移動し、右側の + ボタンをクリックして、解凍したTomcatディレクトリを選択します。Apply をクリックしてから OK をクリックし、設定を完了します。
Tomcat実行構成を作成します。
IDEAの上部ツールバーで、Run > Edit Configurations を選択します。Run/Debug Configurations ウィンドウで、+ ボタンをクリックして Tomcat Server を選択し、実行サーバー名 Name を入力します。Configuration 選択ボックスで、インストールしたバージョンの Tomcat Server を選択し、Context path の値を
/に変更します。SSL port の値を8080に入力します。Before launch 選択ボックスで、+ をクリックして Launch Web Browser を選択します。Edit をクリックしてURLにhttp://localhost:8080/hello/getDataを入力し、Apply をクリックしてから OK をクリックし、設定を完了します。Tomcatサーバーを実行します。
IDEAの上部ツールバーで、先ほど作成したTomcatの実行構成を選択します。緑色の三角形の実行ボタンをクリックしてTomcatサーバーを起動します。IDEAのRunウィンドウでTomcatサーバーの起動ログを確認できます。
ステップ4:tomcat-oceanbase-client プロジェクトを実行する
実行パス。
IDEAの上部ツールバーで、先ほど作成したTomcatの実行構成を選択します。緑色の三角形の実行ボタンをクリックしてTomcatサーバーを起動します。Google ChromeまたはIEブラウザでパス
http://localhost:8080/hello/getDataを開き、実行結果を確認します。実行結果。
IDEAのコンソールウィンドウで、プロジェクトのログ情報と出力結果を確認します。
データ挿入後の結果。
tomcat 接続プールテスト0 tomcat 接続プールテスト1 tomcat 接続プールテスト2 tomcat 接続プールテスト3 tomcat 接続プールテスト4 tomcat 接続プールテスト5 tomcat 接続プールテスト6 tomcat 接続プールテスト7 tomcat 接続プールテスト8 tomcat 接続プールテスト9データ変更後の結果。
-----変更後----- POOl 接続プールテスト0 POOl 接続プールテスト1 POOl 接続プールテスト2 POOl 接続プールテスト3 POOl 接続プールテスト4 POOl 接続プールテスト5 POOl 接続プールテスト6 POOl 接続プールテスト7 POOl 接続プールテスト8 POOl 接続プールテスト9Webインターフェースに返す結果。
プロジェクトコードについて
tomcat-oceanbase-client をクリックしてプロジェクトコードをダウンロードします。これは tomcat-oceanbase-client という名前の圧縮ファイルです。
解凍すると、tomcat-oceanbase-client という名前のフォルダが作成されます。ディレクトリ構造は以下のとおりです:
│--pom.xml
│
├─.idea
│
├─src
│ ├─main
│ │ ├─java
│ │ │ └─com
│ │ │ └─oceanbase
│ │ │ └─testtomcat
│ │ │ ├─config
│ │ │ │ └─UserConfig.java
│ │ │ │
│ │ │ ├─controller
│ │ │ │ └─UserController.java
│ │ │ │
│ │ │ └─pojo
│ │ │ └─User.java
│ │ │
│ │ ├─resources
│ │ │ └─application.properties
│ │ │
│ │ └─webapp
│ │ └─WEB-INF
│ │ └─web.xml
│ │
│ │
│ │
│ └─test
│ └─java
│
│
└─target
ファイルの説明:
pom.xml:Mavenプロジェクトの設定ファイルで、プロジェクトの依存関係、プラグイン、ビルドなどの情報が含まれます。.idea:IDE(統合開発環境)で使用されるディレクトリで、プロジェクト関連の設定情報を格納します。src:プロジェクトのソースコードを格納するディレクトリです。main: 主要なソースコードとリソースファイルを格納するディレクトリ。java: Javaソースコードを格納するディレクトリ。com: Javaパッケージのルートディレクトリ。oceanbase: プロジェクトのルートディレクトリ。testtomcat:JFinalフレームワーク関連のコードを格納します。config:設定ファイルディレクトリで、アプリケーションの設定クラスファイルが含まれます。UserConfig.java:ユーザー設定クラスファイル。controller:コントローラーディレクトリで、アプリケーションのコントローラークラスファイルが含まれます。UserController.java:ユーザーコントローラークラスファイル。pojo: JavaBeanまたはエンティティクラスを格納します。User.java:ユーザーエンティティクラスを格納します。resources: リソースファイルを格納するディレクトリで、設定ファイルやSQLファイルなどが含まれます。application.properties: データベース接続情報を格納する設定ファイル。webapp:Webアプリケーションディレクトリで、Webアプリケーションの静的リソースと設定ファイルが含まれます。WEB-INF:WebアプリケーションのWEB-INFディレクトリで、設定ファイルやその他の保護されたリソースファイルを格納します。web.xml:Webアプリケーションのデプロイメント記述子ファイル。test: テストコードとリソースファイルを格納するディレクトリ。target: コンパイル済みのClassファイル、Jarパッケージなどのファイルを格納するディレクトリ。
pom.xmlコードの紹介
説明
例を確認するだけの場合は、デフォルトのコードを使用し、変更は不要です。以下の説明に従って、ご自身の要件に応じて pom.xml ファイルを変更することもできます。
pom.xml 設定ファイルの内容は以下のとおりです:
ファイル宣言ステートメント。
このファイルがXMLファイルであり、使用しているXMLバージョンが
1.0、文字エンコーディング方式がUTF-8であることを宣言します。コード:
<?xml version="1.0" encoding="UTF-8"?>POMの名前空間とPOMモデルバージョンの設定。
xmlnsを使用して、POMの名前空間をhttp://maven.apache.org/POM/4.0.0と指定します。xmlns:xsiを使用して、XML名前空間をhttp://www.w3.org/2001/XMLSchema-instanceと指定します。xsi:schemaLocationを使用して、POMの名前空間をhttp://maven.apache.org/POM/4.0.0、POMのXSDファイルの場所をhttp://maven.apache.org/xsd/maven-4.0.0.xsdと指定します。<modelVersion>要素を使用して、このPOMファイルで使用するPOMモデルバージョンを4.0.0と指定します。
コード:
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
</project>
基本情報の設定。
<groupId>を使用して、プロジェクト識別子をcom.oceanbaseと指定します。<artifactId>を使用して、プロジェクトの依存関係をtomcat-oceanbase-clientと指定します。<version>を使用して、プロジェクトのバージョン番号を1.0-SNAPSHOTと指定します。<packaging>を使用して、プロジェクトのパッケージング方式をWARファイル(Webアプリケーションアーカイブファイル)と指定します。
コード:
<groupId>com.oceanbase</groupId>
<artifactId>tomcat-oceanbase-client</artifactId>
<version>1.0-SNAPSHOT</version>
<!-- Packaging method (default to jar) -->
<packaging>war</packaging>
- Mavenバージョンの設定。
<maven.compiler.source> と <maven.compiler.target> を使用して、コンパイラのソースコードバージョンとターゲットコードバージョンをどちらもJava 8と指定します。
コード:
<properties>
<maven.compiler.source>8</maven.compiler.source>
<maven.compiler.target>8</maven.compiler.target>
</properties>
コア依存関係の設定。
依存関係が属する組織を com.jfinal、名前を jfinal、バージョン番号を 5.0.6 と指定します。この依存関係により、JFinalフレームワークの機能を利用できます。
コード:
<dependency> <groupId>com.jfinal</groupId> <artifactId>jfinal</artifactId> <version>5.0.6</version> </dependency>依存関係の所属組織を
com.alibaba、名前をdruid、バージョン番号を1.2.8と指定します。この依存関係により、Druidライブラリを使用できます。Druidは、データベース接続の取得と解放を管理および最適化するために使用されます。コード:
<dependency> <groupId>com.alibaba</groupId> <artifactId>druid</artifactId> <version>1.2.8</version> </dependency>依存関係の所属組織を
org.apache.commons、名前をcommons-dbcp2、バージョン番号を2.9.0と指定します。この依存関係により、Apache Commons DBCP2ライブラリを使用できます。Apache Commons DBCP2は、データベース接続の取得と解放を管理および最適化するために使用されます。コード:
<dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-dbcp2</artifactId> <version>2.9.0</version> </dependency>依存関係の所属組織を
com.oceanbase、名前をoceanbase-client、バージョン番号を2.4.3と指定します。この依存関係により、OceanBaseが提供するクライアント機能(接続、クエリ、トランザクションなど)を使用できます。コード:
<dependencies> <dependency> <groupId>com.oceanbase</groupId> <artifactId>oceanbase-client</artifactId> <version>2.4.3</version> </dependency> </dependencies>
application.propertiesファイルの紹介
application.properties ファイルは、OceanBaseデータベースへの接続情報を設定します。データベースドライバーのクラス名、接続URL、ユーザー名、パスワード、および接続プールに関する設定が含まれます。これらの構成パラメータは、アプリケーション内でデータベース接続を取得および管理し、データベース操作を実行するために使用されます。
db.app.pool.driverClassNameを使用して、データベースドライバーをcom.oceanbase.jdbc.Driverと指定し、OceanBaseデータベースとの接続を確立します。db.app.pool.urlを使用して、データベース接続用のURLを指定します。db.app.pool.usernameを使用して、データベース接続用のユーザー名を指定します。db.app.pool.passwordを使用して、データベース接続用のパスワードを指定します。db.app.pool.initialSizeを使用して、接続プールの初期サイズを3に指定します。初期状態で3つのデータベース接続が作成されます。db.app.pool.maxTotal:各接続のプリペアドステートメントキャッシュの上限。db.app.pool.maxIdle:サンプルコードではこのプロパティは読み取りません。db.app.pool.minIdle:サンプルコードではこのプロパティは読み取りません。db.app.pool.maxWaitMillis:接続エラー後のリトライ間隔(ミリ秒)。db.app.pool.validationQuery:サンプルコードでは検証SQLを直接select 1 from dualに設定します。コード:
# DruidPlugin configuration #Database Connection Pool Driver Class Name db.app.pool.driverClassName=com.oceanbase.jdbc.Driver #Database URL db.app.pool.url=jdbc:oceanbase:////host:port/schema_name?characterEncoding=UTF-8 #Database username db.app.pool.username=user_name #Database password db.app.pool.password=****** #Initial size of connection pool db.app.pool.initialSize=3 # Prepared statement cache limit per connection db.app.pool.maxTotal=10 # Unused by UserConfig db.app.pool.maxIdle=20 # Unused by UserConfig db.app.pool.minIdle=5 # Delay between connection attempts after an error (ms) db.app.pool.maxWaitMillis=5000 # Validation SQL is set directly in UserConfig db.app.pool.validationQuery=select 1 from dual
プロジェクトのPOMではDBCP 2依存関係を宣言していますが、UserConfig.createDruidPlugin()はDruid接続プールを作成および設定します。
web.xmlコードの紹介
web.xml ファイルは、Webアプリケーションのフィルターを設定するために使用されます。
web.xml 設定ファイルの内容は以下のとおりです:
ファイル宣言ステートメント。
このファイルがXMLファイルであり、使用しているXMLバージョンが
1.0、文字エンコーディング方式がUTF-8であることを宣言します。コード:
<?xml version="1.0" encoding="UTF-8"?>XMLの名前空間とXMLモデルバージョンの設定。
xmlns:xsiを使用して、XML名前空間をhttp://www.w3.org/2001/XMLSchema-instanceと指定します。xmlnsを使用して、XMLの名前空間をhttp://java.sun.com/xml/ns/javaeeと指定します。xsi:schemaLocationを使用して、XMLの名前空間をhttp://java.sun.com/xml/ns/javaeeと指定し、XMLのXSDファイルの場所をhttp://java.sun.com/xml/ns/javaee/web-app_3_0.xsdと指定します。<id>と<version>要素を使用して、WebアプリケーションのIDをWebApp_ID、バージョン番号を3.0と指定します。
コード:
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://java.sun.com/xml/ns/javaee"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
id="WebApp_ID"
version="3.0">
JFinalフィルターの設定。
WebアプリケーションでJFinalフレームワークを使用するために、
jfinalという名前のフィルターを設定します。フィルターのクラスをcom.jfinal.core.JFinalFilterと指定します。初期化パラメータconfigClassを指定することで、JFinalフレームワークの設定クラスの場所をcom.oceanbase.testtomcat.config.UserConfigと指定します。JFinalフィルターは、WebアプリケーションでJFinalフレームワークを使用し、指定された設定クラスに基づいてJFinalフレームワークの動作を設定するために使用されます。
コード:
<filter>
<filter-name>jfinal</filter-name>
<filter-class>com.jfinal.core.JFinalFilter</filter-class>
<init-param>
<param-name>configClass</param-name>
<!-- your jfinal configuration location -->
<param-value>com.oceanbase.testtomcat.config.UserConfig</param-value>
</init-param>
</filter>
JFinalフィルターマッピングの設定。
jfinalフィルターをすべてのリクエストパスに適用します。つまり、このフィルターはアプリケーション内のすべてのリクエストに適用されます。
コード:
<filter-mapping>
<filter-name>jfinal</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
UserConfig.javaファイルの紹介
UserConfig.java ファイルは、アプリケーションのルーティング、プラグイン、データベース接続などの関連情報を設定するために使用されます。
UserConfig.java ファイルのコードは、主に以下の部分で構成されています:
他のクラスとインターフェースのインポート。
このファイルには以下のインターフェースとクラスが含まれていることを宣言します:
StatFilterクラス:データベースアクセスのパフォーマンス統計に使用されます。JdbcConstantsクラス:データベースタイプを表す定数を定義します。WallFilterクラス:SQLインジェクション攻撃を防ぐために使用されます。PropKitクラス:設定ファイルを読み取るために使用されます。ActiveRecordPluginクラス:データベース操作に使用されます。Dbクラス:データベース操作を実行するために使用されます。OracleDialectクラス:データベースの方言を指定するために使用されます。DruidPluginクラス:データベース接続に使用されます。Engineクラス:テンプレートエンジンを設定するために使用されます。UserControllerクラス:ユーザー関連のリクエストを処理するために使用されます。Userクラス:ユーザーデータの受け渡しと保存に使用されます。
コード:
import com.alibaba.druid.filter.stat.StatFilter; import com.alibaba.druid.util.JdbcConstants; import com.alibaba.druid.wall.WallFilter; import com.jfinal.config.*; import com.jfinal.kit.PropKit; import com.jfinal.plugin.activerecord.ActiveRecordPlugin; import com.jfinal.plugin.activerecord.Db; import com.jfinal.plugin.activerecord.dialect.OracleDialect; import com.jfinal.plugin.druid.DruidPlugin; import com.jfinal.template.Engine; import com.oceanbase.testjfinal.controller.UserController; import com.oceanbase.testjfinal.pojo.User;UserConfigクラスを定義します。JFinalConfigクラスの各メソッドをオーバーライドすることで、定数、ルーティング、プラグイン、データベース接続などの情報を設定できます。configConstantメソッドを定義します。JFinalフレームワークの定数を設定するために使用され、
PropKitを使用して設定ファイルから設定を読み取ります。コード:
@Override public void configConstant(Constants constants) { PropKit.use("application.properties"); }configRouteメソッドを定義します。ルーティングマッピングを設定するために使用され、
routes.addメソッドを使用して"/hello"パスをUserControllerクラスのデフォルトアクセスページにマッピングします。コード:
@Override public void configRoute(Routes routes) { routes.add("/hello", UserController.class, "/"); }configEngineメソッドを定義します。テンプレートエンジンを設定するために使用されます。
コード:
@Override public void configEngine(Engine engine) { }configPluginメソッドを定義します。アプリケーションのプラグインを設定するために使用されます。
initメソッドを呼び出してデータベース接続とテーブル構造を初期化し、DruidPluginとActiveRecordPluginプラグインを作成してpluginsに追加します。同時に、activeRecordPluginのaddMappingメソッドを呼び出してデータベーステーブルとエンティティクラスのマッピング関係を追加し、TEST_USERテーブルをUserクラスにマッピングします。コード:
@Override public void configPlugin(Plugins plugins) { init(); DruidPlugin druidPlugin = createDruidPlugin(); plugins.add(druidPlugin); ActiveRecordPlugin activeRecordPlugin = createActiveRecordPlugin(druidPlugin); activeRecordPlugin.addMapping("TOMCAT_TEST", User.class); plugins.add(activeRecordPlugin); }createDruidPluginメソッドを定義します。DruidPluginプラグインを作成し、接続プールサイズ、SQLファイアウォール、接続エラー処理などの関連パラメータを設定するために使用されます。PropKitのgetメソッドを呼び出して、設定ファイルからURL、ユーザー名、パスワード、ドライバークラスなどのデータベース接続関連のプロパティ値を取得します。次に、DruidPluginオブジェクトを作成し、取得したプロパティ値で初期化します。addFilterメソッドを呼び出して、DruidPluginにStatFilterインスタンスを追加し、データベースアクセスのパフォーマンス統計に使用します。WallFilterインスタンスを作成し、setDbTypeメソッドでデータベースタイプをOceanBaseに設定してDruidPluginに追加し、SQLファイアウォールフィルタリングを実行します。このメソッドは、接続プールの初期サイズ、接続あたりのプリペアドステートメントキャッシュの上限、接続エラー後のリトライ間隔、および検証SQLを設定し、
DruidPluginを返します。コード:
private DruidPlugin createDruidPlugin() { DruidPlugin druidPlugin = new DruidPlugin( PropKit.get("db.app.pool.url"), PropKit.get("db.app.pool.username"), PropKit.get("db.app.pool.password"), PropKit.get("db.app.pool.driverClassName") ); druidPlugin.addFilter(new StatFilter()); WallFilter wallFilter = new WallFilter(); wallFilter.setDbType(JdbcConstants.OCEANBASE); druidPlugin.addFilter(wallFilter); druidPlugin.setInitialSize(PropKit.getInt("db.app.pool.initialSize")); druidPlugin.setMaxPoolPreparedStatementPerConnectionSize(PropKit.getInt("db.app.pool.maxTotal")); druidPlugin.setTimeBetweenConnectErrorMillis(PropKit.getInt("db.app.pool.maxWaitMillis")); druidPlugin.setValidationQuery("select 1 from dual"); return druidPlugin; }
initメソッドを定義します。データベース接続の初期化とデータベーステーブルの作成に使用されます。
initDbConnectionメソッドを呼び出してデータベース接続を初期化し、ActiveRecordPluginインスタンスを返します。次に、SQLステートメントを実行して、ユーザーテーブルTOMCAT_TESTが存在するかどうかを確認します。テーブルTOMCAT_TESTが存在する場合、SQLステートメントDROP TABLE TOMCAT_TESTを実行してこのテーブルを削除します。その後、CREATE TABLEステートメントを実行して、IDとUSERNAMEの2つのフィールドを持つTOMCAT_TESTという名前のデータベーステーブルを作成します。最後に、ActiveRecordPluginプラグインの接続を閉じてデータベース接続を解放します。コード:
public void init() { ActiveRecordPlugin arp = initDbConnection(); // Check if table exists boolean tableExists = Db.queryInt("SELECT COUNT(*) FROM USER_TABLES WHERE TABLE_NAME = 'TOMCAT_TEST'") > 0; // Drop table if it exists if (tableExists) { Db.update("DROP TABLE TOMCAT_TEST"); } // Create table String sql = "CREATE TABLE TOMCAT_TEST (ID NUMBER(10), USERNAME VARCHAR2(50))"; Db.update(sql); arp.stop(); }initDbConnectionメソッドを定義します。データベース接続の初期化に使用されます。まず、
createDruidPluginメソッドを呼び出してDruidPluginオブジェクトを作成し、変数druidPluginに代入します。このメソッドは、データベース接続プールの管理に使用されるDruidPluginの作成と設定を担当します。次に、createActiveRecordPluginメソッドを呼び出してActiveRecordPluginオブジェクトを作成し、DruidPluginオブジェクトをパラメータとしてこのメソッドに渡します。このメソッドは、データベース操作の管理に使用されるActiveRecordPluginの作成と設定を担当します。その後、druidPlugin.startメソッドを呼び出してDruidPluginを起動し、データベース接続プールを初期化します。最後に、activeRecordPlugin.startメソッドを呼び出してActiveRecordPluginを起動します。このメソッドは、設定に基づいてデータベース操作に関する設定を初期化します。コード:
private ActiveRecordPlugin initDbConnection() { DruidPlugin druidPlugin = createDruidPlugin(); ActiveRecordPlugin activeRecordPlugin = createActiveRecordPlugin(druidPlugin); druidPlugin.start(); activeRecordPlugin.start(); return activeRecordPlugin; }ConfigInterceptorおよびConfigHandlerメソッドを定義します。システム初期化プロセス中にグローバル設定を行うために使用されます。
コード:
@Override public void configInterceptor(Interceptors interceptors) { } @Override public void configHandler(Handlers handlers) { }
UserController.javaファイルの紹介
UserController.java ファイルは、getData メソッドを使用してデータベースにデータを挿入し、データをクエリして、その結果をJSON形式でクライアントに返します。JFinalフレームワークが提供する Db クラスを使用してデータベース操作を実行し、カスタムの User クラスを使用してデータマッピングを行うことで、データベース操作とデータ返却機能を実現しています。
UserController.java ファイルのコードは、主に以下の部分で構成されています:
他のクラスとインターフェースのインポート。
このファイルには以下のインターフェースとクラスが含まれていることを宣言します:
Controllerクラス:リクエストとレスポンスを処理するために使用されます。Dbクラス:データベース操作を実行するために使用されます。Recordクラス:データのクエリ、挿入、更新、削除などのデータベース操作を行うために使用されます。ArrayListクラス:空のリストを作成するために使用されます。Userクラス:データベーステーブルにマッピングするために使用されます。Listインターフェース:クエリ結果の集合を操作するために使用されます。
コード:
import com.jfinal.core.Controller; import com.jfinal.plugin.activerecord.Db; import com.jfinal.plugin.activerecord.Record; import java.util.ArrayList; import java.util.List;UserControllerクラスの定義。JFinalフレームワークにコントローラーを提供し、
getDataメソッドを使用してデータベースへのデータ挿入とデータクエリ操作を行うために使用されます。データの挿入。10個の
Recordオブジェクトを含むリストdataListを作成します。各Recordオブジェクトは、異なるIDとUSERNAMEフィールド値を持ちます。次に、Db.batchSaveメソッドを使用して、dataListリスト内のレコードをTOMCAT_TESTという名前のデータベーステーブルに一括保存します。コード:
for (int i = 0; i < 10; i++) { Record record = new Record().set("ID", i).set("USERNAME", "tomcat 接続プールテスト" + i); dataList.add(record); } Db.batchSave("TOMCAT_TEST", dataList, dataList.size());データのクエリ。
Db.findメソッドを使用してSQLクエリを実行し、結果をresultListリストに格納します。拡張forループを使用して、resultListリスト内の各Recordオブジェクトを走査します。getStrメソッドを使用してRecordオブジェクトの指定フィールドの値を取得し、System.out.printlnメソッドを使用して出力します。コード:
List<Record> resultList = Db.find("SELECT * FROM TOMCAT_TEST"); for (Record result : resultList) { System.out.println(result.getStr("USERNAME")); }データの更新。ループを使用して10回繰り返し、各繰り返しで1つの更新ステートメントを実行します。更新ステートメントは
Db.updateメソッドを使用して実行され、TOMCAT_TESTという名前のデータベーステーブル内のレコードを条件に基づいて更新します。コード:
for (int i = 0; i < 10; i++) { Db.update("UPDATE TOMCAT_TEST SET USERNAME = 'POOl 接続プールテスト" + i + "' WHERE ID = " + i); }変更後のデータをクエリします。
TOMCAT_TESTという名前のデータベーステーブルをクエリし、結果をmodifiedListに格納します。-----変更後-----のメッセージを出力します。modifiedListを走査し、各レコードのUSERNAMEフィールドの値を出力します。renderJsonメソッドを使用して、応答メッセージData retrieved successfullyをJSON形式でレンダリングし、クライアントに返します。コード:
List<Record> modifiedList = Db.find("SELECT * FROM TOMCAT_TEST"); System.out.println("-----変更後-----"); for (Record modified : modifiedList) { System.out.println(modified.getStr("USERNAME")); } renderJson("Data retrieved successfully");
User.javaファイルの紹介
User.java ファイルは、データベーステーブルとJavaオブジェクトのマッピングを実装するために使用されます。
User.java ファイルのコードは、主に以下の部分で構成されています:
Modelクラスのインポート。Modelクラスは、データベーステーブルのマッピングとデータ操作に使用されます。Userクラスの定義。Userクラスは、継承したModelクラスが提供するメソッドを使用してデータベース操作を行います。コード:
import com.jfinal.plugin.activerecord.Model; public class User extends Model<User> { public static final User dao = new User(); }
全コード表示
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.oceanbase</groupId>
<artifactId>tomcat-oceanbase-client</artifactId>
<version>1.0-SNAPSHOT</version>
<!-- Packaging method (default to jar) -->
<packaging>war</packaging>
<properties>
<maven.compiler.source>8</maven.compiler.source>
<maven.compiler.target>8</maven.compiler.target>
</properties>
<dependencies>
<dependency>
<groupId>com.jfinal</groupId>
<artifactId>jfinal</artifactId>
<version>5.0.6</version>
</dependency>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>1.2.8</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-dbcp2</artifactId>
<version>2.9.0</version>
</dependency>
<dependency>
<groupId>com.oceanbase</groupId>
<artifactId>oceanbase-client</artifactId>
<version>2.4.3</version>
</dependency>
</dependencies>
</project>
# DruidPlugin configuration
#Database Connection Pool Driver Class Name
db.app.pool.driverClassName=com.oceanbase.jdbc.Driver
#Database URL
db.app.pool.url=jdbc:oceanbase://host:port/schema_name?characterEncoding=UTF-8
#Database username
db.app.pool.username=user_name
#Database password
db.app.pool.password=******
#Initial size of connection pool
db.app.pool.initialSize=3
# Prepared statement cache limit per connection
db.app.pool.maxTotal=10
# Unused by UserConfig
db.app.pool.maxIdle=20
# Unused by UserConfig
db.app.pool.minIdle=5
# Delay between connection attempts after an error (ms)
db.app.pool.maxWaitMillis=5000
# Validation SQL is set directly in UserConfig
db.app.pool.validationQuery=select 1 from dual
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" id="WebApp_ID" version="3.0">
<filter>
<filter-name>jfinal</filter-name>
<filter-class>com.jfinal.core.JFinalFilter</filter-class>
<init-param>
<param-name>configClass</param-name>
<!-- your jfinal configuration location -->
<param-value>com.oceanbase.testjfinal.config.UserConfig</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>jfinal</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
</web-app>
package com.oceanbase.testtomcat.config;
import com.alibaba.druid.filter.stat.StatFilter;
import com.alibaba.druid.util.JdbcConstants;
import com.alibaba.druid.wall.WallFilter;
import com.jfinal.config.*;
import com.jfinal.kit.PropKit;
import com.jfinal.plugin.activerecord.ActiveRecordPlugin;
import com.jfinal.plugin.activerecord.Db;
import com.jfinal.plugin.activerecord.dialect.OracleDialect;
import com.jfinal.plugin.druid.DruidPlugin;
import com.jfinal.template.Engine;
import com.oceanbase.testtomcat.controller.UserController;
import com.oceanbase.testtomcat.pojo.User;
public class UserConfig extends JFinalConfig {
@Override
public void configConstant(Constants constants) {
// Read properties configuration
PropKit.use("application.properties");
}
@Override
public void configRoute(Routes routes) {
// Set the default access page for project startup, which does not need to be set in the web.
routes.add("/hello", UserController.class);
}
@Override
public void configEngine(Engine engine) {
}
@Override
public void configPlugin(Plugins plugins) {
init();
DruidPlugin druidPlugin = createDruidPlugin();
plugins.add(druidPlugin);
ActiveRecordPlugin activeRecordPlugin = createActiveRecordPlugin(druidPlugin);
activeRecordPlugin.addMapping("TOMCAT_TEST", User.class);
plugins.add(activeRecordPlugin);
}
private DruidPlugin createDruidPlugin() {
DruidPlugin druidPlugin = new DruidPlugin(
PropKit.get("db.app.pool.url"),
PropKit.get("db.app.pool.username"),
PropKit.get("db.app.pool.password"),
PropKit.get("db.app.pool.driverClassName")
);
druidPlugin.addFilter(new StatFilter());
WallFilter wallFilter = new WallFilter();
wallFilter.setDbType(JdbcConstants.OCEANBASE);
druidPlugin.addFilter(wallFilter);
druidPlugin.setInitialSize(PropKit.getInt("db.app.pool.initialSize"));
druidPlugin.setMaxPoolPreparedStatementPerConnectionSize(PropKit.getInt("db.app.pool.maxTotal"));
druidPlugin.setTimeBetweenConnectErrorMillis(PropKit.getInt("db.app.pool.maxWaitMillis"));
druidPlugin.setValidationQuery("select 1 from dual");
return druidPlugin;
}
private ActiveRecordPlugin createActiveRecordPlugin(DruidPlugin druidPlugin) {
ActiveRecordPlugin activeRecordPlugin = new ActiveRecordPlugin(druidPlugin);
activeRecordPlugin.setDialect(new OracleDialect());
return activeRecordPlugin;
}
public void init() {
ActiveRecordPlugin arp = initDbConnection();
// Check if table exists
boolean tableExists = Db.queryInt("SELECT COUNT(*) FROM USER_TABLES WHERE TABLE_NAME = 'TOMCAT_TEST'") > 0;
// Drop table if it exists
if (tableExists) {
Db.update("DROP TABLE TOMCAT_TEST");
}
// Create table
String sql = "CREATE TABLE TOMCAT_TEST (ID NUMBER(10), USERNAME VARCHAR2(50))";
Db.update(sql);
arp.stop();
}
private ActiveRecordPlugin initDbConnection() {
DruidPlugin druidPlugin = createDruidPlugin();
ActiveRecordPlugin activeRecordPlugin = createActiveRecordPlugin(druidPlugin);
druidPlugin.start();
activeRecordPlugin.start();
return activeRecordPlugin;
}
@Override
public void configInterceptor(Interceptors interceptors) {
}
@Override
public void configHandler(Handlers handlers) {
}
}
package com.oceanbase.testtomcat.controller;
import com.jfinal.core.Controller;
import com.jfinal.plugin.activerecord.Db;
import com.jfinal.plugin.activerecord.Record;
import java.util.ArrayList;
import java.util.List;
public class UserController extends Controller {
public void getData() {
try {
List<Record> dataList = new ArrayList<>();
// データの挿入
for (int i = 0; i < 10; i++) {
Record record = new Record().set("ID", i).set("USERNAME", "tomcat 接続プールテスト" + i);
dataList.add(record);
}
Db.batchSave("TOMCAT_TEST", dataList, dataList.size());
// データのクエリ
List<Record> resultList = Db.find("SELECT * FROM TOMCAT_TEST");
for (Record result : resultList) {
System.out.println(result.getStr("USERNAME"));
}
// データの更新
for (int i = 0; i < 10; i++) {
Db.update("UPDATE TOMCAT_TEST SET USERNAME = 'POOl 接続プールテスト" + i + "' WHERE ID = " + i);
}
// 更新後のデータのクエリ
List<Record> modifiedList = Db.find("SELECT * FROM TOMCAT_TEST");
System.out.println("-----変更後-----");
for (Record modified : modifiedList) {
System.out.println(modified.getStr("USERNAME"));
}
renderJson("Data retrieved successfully");
} catch (Exception e) {
e.printStackTrace();
renderJson("Error occurred");
}
}
}
package com.oceanbase.testtomcat.pojo;
import com.jfinal.plugin.activerecord.Model;
public class User extends Model<User> {
public static final User dao = new User();
}
関連ドキュメント
OceanBase Connector/Jの詳細については、OceanBase JDBCドライバを参照してください。