Oracle DatabaseによるJavaアプリケーションのクイックスタート(オンプレミス)
このクイック・スタート・ガイドでは、TCP接続を使用するOracle Database(オンプレミス)またはOracle Cloud Databaseへの接続を正常に確立する方法を説明します。Oracle Autonomous Databaseへの接続をご希望の場合は、Oracle Autonomous Database向けJavaアプリケーションの開発 を参照してください。
前提条件
すべて開くすべて閉じる-
-
1. Oracle AI Databaseのインストール
Oracle AI Database Freeをインストールするには、このページに記載されている手順に従ってください。データベースをインストール済みで、データベースの認証情報がある場合は、このステップを省略できます。
-
2. JDKのインストール
JDKをインストールします。長期サポート・リリースとなっているのは、JDK8、JDK11、JDK17、JDK21およびJDK25です。これらのバージョンのいずれかを使用するようにしてください。
* 「java -version」を使用して、インストールしたJDKのバージョンを確認してください。"java -jar ojdbc8.jar"を使用してJDBCドライバのバージョンを確認します。
-
3. データベース・ユーザーの作成(オプション)
注意: 既にデータベース・ユーザーとパスワードをお持ちの場合は、このステップを省略できます。
データベース接続を確認する際には、新しいデータベース・ユーザーを使用することをお勧めします。データベース・ユーザーの作成や権限の割当てに慣れていない場合は、 CreateUser.java を使用して新しいデータベース・ユーザーを作成できます。
— ファイル CreateUser.java を編集し、接続文字列、管理者ユーザー、管理者パスワード、および作成する新しいデータベース・ユーザーとパスワードを指定します。
— 最新の Oracle JDBCドライバとUCPをダウンロードします。
— サンプルをコンパイルして実行する前に、Oracle Databaseが実行中であることを確認します。
# Javaプログラムのコンパイル
javac -classpath ./test/ojdbc8.jar:./test/ucp.jar CreateUser.java
# Javaプログラムの実行
java -classpath ./test/ojdbc8.jar:./test/ucp.jar:. CreateUser
Dockerを使用している場合は、以下のコマンドを使用して新しいデータベース・ユーザーを作成することもできます。
# These are instructions to create a new database user
#Step 1: Make sure docker is running before running the below docker command
#Step 2: Enter the admin password for your database on the console
#Step 3: Provide the new database user and password to be created
# Create a session within the container with Oracle as user
docker exec -it --user oracle \
-e 'ORACLE_HOME=/opt/oracle/product/18c/dbhomeXE' \
$(docker ps --format '{{.ID}}') \
/bin/bash -c 'exec ${ORACLE_HOME}/bin/sqlplus "sys@xepdb1 as sysdba"'
# Create a new database user and grant required privileges.
# Replace "{newdbuser}" and "{newdbpassword}" with the new DB user and password that you want to create
grant CREATE SESSION, CREATE VIEW, CREATE SEQUENCE,CREATE PROCEDURE, CREATE TABLE,
CREATE TRIGGER, CREATE TYPE, CREATE MATERIALIZED VIEW to {newdbuser} identified by {newdbpassword};
-
4.Githubからサンプルプログラムをダウンロード
- GithubからQuickStart.javaをダウンロードします。このサンプル・アプリケーションは、タスクとタスク完了ステータスを含む表「todoitem」を作成し、いくつかの行を挿入し、表の内容を表示します。
-
QuickStart.javaを編集して、データベース接続情報を含めます。
- DB_USER: ステップ3のデータベース・ユーザーを使用します。
- DB_PASSWORD: ステップ3のデータベース・パスワードを使用します。
- DB_URL: Oracle Databaseの接続文字列を入力します。
例:
DB_URL = "jdbc:oracle:thin:@//localhost:152/FREEPDB1" - QuickStart.javaへの変更の保存
-
MavenおよびGradle
すべて開くすべて閉じる-
Maven
-
1.Mavenプロジェクトの設定
-
前提条件:: 前提条件セクションのすべてのステップを必ず完了してください。
-
Mavenプロジェクトの作成:: Apache Mavenをダウンロードし、mvnコマンドを使用する前に必ずPATHを設定します。次のMavenコマンドを使用してプロジェクトを作成します。
mvn archetype:generate -DgroupId=com.oracle.jdbctest -DartifactId=jdbc-test-project -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
-
ADBQuickStart.javaを
srcディレクトリにコピー: ADBQuickStart.javaをsrc/main/java/com/oracle/jdbctestディレクトリにコピーします。 -
次の変更で
pom.xmlを修正:
依存関係としてOracle JDBCドライバを追加します。 注: ojdbc8-productionは、Oracle JDBCドライバ(ojdbc8.jar)と合わせ、ucp.jar(クライアント側の接続プールとしてUCPを使用する際に必要なJAR)や、oraclepki.jar, osdt_core.jar, osdt_cert.jar(Autonomous Databaseに接続する際にOracle Walletを使用するために必要なJAR)などのその他の関連JARをダウンロードします。詳細については、 Maven Centralガイド を参照してください。
<dependencies>
<dependency>
<groupId>com.oracle.database.jdbc</groupId>
<artifactId>ojdbc8-production</artifactId>
<version>23.26.2.0.0</version>
<type>pom</type>
</dependency>
</dependencies>
-
-
2. サンプルJavaプログラムの構築と実行
pom.xmlが存在するディレクトリにあることを確認してください。-
Javaコードのクリーンアップとコンパイル: 次のコマンドを使用します。
mvn clean
mvn compile -
サンプルJavaプログラムの実行
mvn exec:java -Dexec.cleanupDaemonThreads=false -Dexec.mainClass="com.oracle.jdbctest.QuickStart" - 出力例:
下のスクリーンショットのように、クエリの行が新しい表「todoitem」から返され、 完了しました。Oracle Databaseを正常に使用できましたというメッセージが表示されます。
-
-
-
Gradleプロジェクト
-
1. Gradleプロジェクトの設定
- 前提条件:: 前提条件セクションのすべてのステップを必ず完了してください。
-
Gradleプロジェクトの作成 : Gradleのダウンロードとビルド手順については Gradleガイド の指示に従い、gradleコマンドを使用する前にPATHを設定してください。まず最初に、以下のコマンドでgradleプロジェクトを作成します。「生成するプロジェクトの種類を選択する」で「2: アプリケーション」を選択していることを確認してください。また、「Source package (default: temp): 」には
com.oracle.jdbctestを使用します。
gradle init -
QuickStart.javaを
srcディレクトリにコピーします : 必ず QuickStart.java をsrc/main/java/com/oracle/jdbctestディレクトリに必ずコピーしてください。 -
build.gradleを以下のように変更します。- リポジトリとして、
mavenCentral()を追加します。 - Oracle JDBCドライバを依存関係として追加します。
注意: ojdbc8-productionは、Oracle JDBCドライバ(ojdbc8.jar)とクライアント側の接続プールであるUCP(ucp.jar)を合わせてダウンロードします。詳細については、 Maven Centralガイド を参照してください。 - 'mainClassName'をQuickStartに更新します。
repositories {
// Maven Central
mavenCentral()
}
dependencies {
// Get the 23.26.2.0.0 Oracle JDBC driver along with other companion jars
implementation("com.oracle.database.jdbc:ojdbc8-production:19.9.0.0")
}
application {
// Define the main class for the application
mainClassName ='{your_project_directory}.QuickStart'
}
- リポジトリとして、
-
2.Gradleアプリケーションの構築および実行
build.gradleが存在するディレクトリにあることを確認してください。-
Javaコードのコンパイル: 以下のコマンドを使用します。
./gradlew build
-
サンプルJavaプログラムの実行
./gradlew run
- 出力例:
下のスクリーンショットのように、クエリの行が新しい表「todoitem」から返され、 完了しました。Oracle Databaseを正常に使用できましたというメッセージが表示されます
-
-
EclipseおよびIntelliJ
すべて開くすべて閉じる-
Eclipse
-
1.Mavenプロジェクトの設定
-
前提条件:: 前提条件セクションのすべてのステップを必ず完了してください。
-
Mavenプロジェクトの作成:
- 「ファイル」→「新規」→「プロジェクト」→「Mavenプロジェクト」を選択します。maven archetypeを使用するか、'Create simple project (skip archetype selection)' をチェックします。
- MavenプロジェクトのGAVを選択します。これらはプロジェクトの pom.xml に反映されます。
グループID: com.oracle
アーティファクトID: JDBCquickstart
バージョン: 0.0.1-SNAPSHOTのままにします
-
QuickStart.javaの作成:
src/main/javaを右クリックし、「新規」 -> 「クラス」の順にクリックします。次の値を入力します。
パッケージ: com.oracle.jdbctest
名前: QuickStartと入力し、「完了」をクリックします。
必ず QuickStart.java の内容を、作成したこの新しいファイルにコピーしてください。 -
以下の変更で
pom.xmlを修正します:
依存関係としてOracle JDBCドライバを追加します。 注意: ojdbc8-production は、Oracle JDBCドライバ(ojdbc8.jar)を、ucp.jarなどのその他のコンパニオンJARとともにダウンロードします(クライアント側の接続プールとしてUCPを使用するために必要なJARです)。詳細については、 Maven Centralガイド を参照してください。
<dependencies>
<dependency>
<groupId>com.oracle.database.jdbc</groupId>
<artifactId>ojdbc8-production</artifactId>
<version>23.26.2.0.0</version>
<type>pom</type>
</dependency>
</dependencies>
-
-
2. サンプルJavaプログラムの構築と実行
Javaコードにコンパイル・エラーがなく、Eclipseで最新のJDKバージョンを使用していることを確認してください。また、Oracle DatabaseがDockerで実行されていることを確認します。
-
サンプルJavaプログラムの実行: QuickStart.javaを右クリックし、「名前を付けて実行」->「Javaアプリケーション」の順に選択します。
- 出力例:
下のスクリーンショットのように、クエリの行が新しい表「todoitem」から返され、 完了しました。Oracle Databaseを正常に使用できましたというメッセージが表示されます。
-
-
-
IntelliJ
-
1.Mavenプロジェクトの設定
- 前提条件:: 前提条件セクションのすべてのステップを必ず完了してください。
-
Mavenプロジェクトの作成:
- 「ファイル」→「新規」→「プロジェクト」をクリックします。
- 左側で「Maven」を選択し、最新バージョンのJDKを「Project SDK」として選択します。任意のmavenアーキタイプを使用することも、独自のアーキタイプを追加することもできます。「Next」をクリックします。
- クイックスタートとして「名前」を指定
- 「ファイル」→「新規」→「プロジェクト」をクリックします。
-
QuickStart.javaの作成:
src /main/javaを右クリックします。「新規」→「Javaクラス」をクリックします。com.oracle.jdbctest.QuickStart.javaと入力すると、必要なパッケージ構造も作成されます。必ず QuickStart.java の内容を、この新しいファイルにコピーしてください。 -
次の変更で
pom.xmlを修正:
依存関係としてOracle JDBCドライバを追加します。 注意: ojdbc8-production は、Oracle JDBCドライバ(ojdbc8.jar)をucp.jarとともにダウンロードします(UCPをクライアント側接続プールとして使用するために必要なJARです)。詳細については、 Maven Centralガイド を参照してください。
<dependencies>
<dependency>
<groupId>com.oracle.database.jdbc</groupId>
<artifactId>ojdbc8-production</artifactId>
<version>23.26.2.0.0</version>
<type>pom</type>
</dependency>
</dependencies>
-
2. 構築とQuickstartの実行
-
Javaコードのコンパイル: QuickStart.javaを右クリック ->「モジュールのビルド『QuickStart』」の順に選択します。コンパイル・エラーがないことを確認します。Oracle DatabaseがDockerで実行され、アクセス可能であることを確認します。
-
サンプルJavaプログラムの実行: QuickStart.javaを右クリック ->「『QuickStart.main()』の実行」の順に選択します。
- 出力例:
問合せ対象の行がデータベースから返され、Congratulations! Oracle Databaseを正常に使用できましたというメッセージが表示されます
-
-
ビルド・ツールなし
すべて開くすべて閉じる-
-
1.JDBCドライバおよびその他のjarのダウンロード
-
前提条件のセクションにある全てのステップを完了するようにしてください。
-
OTNから ojdbc8-full.tar.gz をダウンロードし、その内容をクラスパスに解凍します。
注意: ojdbc8-full.tar.gz には最新のJDBCドライバ (ojdbc8.jar) とクライアント側接続プールとしてのUCP (ucp.jar)が含まれています。
-
-
2. サンプルJavaプログラムの構築と実行
-
Javaプログラムのコンパイル
クラスパスに必要なJARファイルの正しいパスを指定してください。
javac -classpath ./lib/ojdbc8.jar:./lib/ucp.jar com/oracle/jdbctest/QuickStart.java
-
サンプルJavaプログラムの実行
出力例:
クラスパスに必要なJARの正しいパスを指定してください。
java -classpath ./lib/ojdbc8.jar:./lib/ucp.jar:. com.oracle.jdbctest.QuickStart
下のスクリーンショットのように、クエリの行が新しい表「todoitem」から返され、 完了しました。Oracle Databaseを正常に使用できましたというメッセージが表示されます。
-
-