メインコンテンツまでスキップ
バージョン: 3.15
Features and pricing

Kotlin を使って ScalarDB をはじめよう

注記

このページは英語版のページが機械翻訳されたものです。英語版との間に矛盾または不一致がある場合は、英語版を正としてください。

この入門チュートリアルでは、ScalarDB で好みのデータベースを設定し、Kotlin を使用して基本的な電子マネーアプリケーションをセットアップする方法について説明します。Kotlin は Java との相互運用性を備えているため、Kotlin から直接 ScalarDB を使用できます。

警告

電子マネーアプリケーションはこのチュートリアル用に簡略化されており、実稼働環境には適していません。

このサンプルアプリケーションの前提条件​

ScalarDB は Java で記述されているため、環境に次のいずれかの Java Development Kit (JDK) がインストールされている必要があります。

ScalarDB サンプルリポジトリのクローンを作成する​

Terminal を開き、次のコマンドを実行して ScalarDB サンプルリポジトリのクローンを作成します。

git clone https://github.com/scalar-labs/scalardb-samples

次に、次のコマンドを実行して、サンプルアプリケーションが含まれているディレクトリに移動します。

cd scalardb-samples/scalardb-kotlin-sample

データベースをセットアップする​

以下の手順に従って、ScalarDB 用にデータベースを設定してください。

ScalarDB がサポートするデータベースの一覧については、データベースを参照してください。

リレーショナルデータベースを選択します。

MariaDB をローカルで実行する

scalardb-samples/scalardb-kotlin-sample ディレクトリの docker-compose.yml ファイルを使用して、Docker Compose で MariaDB を実行できます。

MariaDB を起動するには、次のコマンドを実行します。

docker compose up -d mariadb

ScalarDB を設定する

scalardb-samples/scalardb-kotlin-sample ディレクトリの database.properties ファイルには、データベース設定が含まれています。database.properties ファイル内の MariaDB のプロパティのコメントを解除して、設定が次のようになるようにしてください。

# For MariaDB
scalar.db.storage=jdbc
scalar.db.contact_points=jdbc:mariadb://localhost:3306
scalar.db.username=root
scalar.db.password=mariadb

データベーススキーマをロードする​

アプリケーションでデータベーススキーマ (データを整理する方法) を定義する必要があります。サポートされているデータ型の詳細については、データベースアダプターを参照してください。

このチュートリアルでは、schema.json というファイルが scalardb-samples/scalardb-kotlin-sample ディレクトリに既に存在します。スキーマを適用するには、scalardb Releases ページに移動し、使用している ScalarDB のバージョンに一致する ScalarDB Schema Loader を scalardb-samples/scalardb-kotlin-sample ディレクトリにダウンロードします。

次に、データベースに基づいて、<VERSION> をダウンロードした ScalarDB Schema Loader のバージョンに置き換えて、次のコマンドを実行します。

リレーショナルデータベースを選択します。

java -jar scalardb-schema-loader-<VERSION>.jar --config database.properties --schema-file schema.json --coordinator
注記

スキーマ内に transaction が true に設定されたテーブルが存在するため、--coordinator オプションが指定されています。スキーマの設定とロードの詳細については、ScalarDB Schema Loader を参照してください。

基本的な電子マネーアプリケーションでトランザクションを実行し、データを取得します​

スキーマをロードした後、クローンしたリポジトリに含まれる基本的な電子マネーアプリケーションでトランザクションを実行し、データを取得できます。

アプリケーションは、次の種類のトランザクションをサポートしています:

  • アカウントを作成します。
  • アカウントに資金を追加します。
  • 2つのアカウント間で資金を送信します。
  • アカウント残高を取得します。
注記

初めて Gradle コマンドを実行すると、Gradle によって必要なライブラリが自動的にインストールされます。

残高のあるアカウントを作成する​

アカウント間で資金を送金するには、残高のあるアカウントが必要です。

customer1 の残高が 500 のアカウントを作成するには、次のコマンドを実行します。

./gradlew run --args="-action charge -amount 500 -to customer1"

残高のないアカウントを作成する​

残高のあるアカウントを設定したら、資金を送金するための別のアカウントが必要です。

残高が 0 の merchant1 のアカウントを作成するには、次のコマンドを実行します。

./gradlew run --args="-action charge -amount 0 -to merchant1"

アカウントに資金を追加する​

残高のあるアカウントを作成するでアカウントを作成して資金を追加したのと同じ方法で、アカウントに資金を追加できます。

customer1 のアカウントに 500 を追加するには、次のコマンドを実行します。

./gradlew run --args="-action charge -amount 500 -to customer1"

customer1 のアカウントの残高は 1000 になります。

2つのアカウント間で電子マネーを送金する​

これで 2つのアカウントが作成され、少なくとも1つのアカウントに残高があるので、一方のアカウントからもう一方のアカウントに資金を送金できます。

customer1 が merchant1 に 100 を支払うようにするには、次のコマンドを実行します。

./gradlew run --args="-action pay -amount 100 -from customer1 -to merchant1"

アカウント残高を取得する​

あるアカウントから別のアカウントに資金を送金した後、各アカウントの残高を確認できます。

customer1 の残高を取得するには、次のコマンドを実行します。

./gradlew run --args="-action getBalance -id customer1"

次の出力が表示されます。

...
The balance for customer1 is 900
...

merchant1 の残高を取得するには、次のコマンドを実行します。

./gradlew run --args="-action getBalance -id merchant1"

次の出力が表示されます。

...
The balance for merchant1 is 100
...

データベースを停止する​

データベースを停止するには、次のコマンドを実行して Docker コンテナを停止します。

docker compose down

参照​

このチュートリアルで使用されている電子マネーアプリケーションのソースコードを確認するには、ElectronicMoney.kt を参照してください。

テクニカルサポートに問い合わせ
商用ライセンスをご契約のお客様のみご利用いただけます。
ドキュメントの問題を報告
このページについて何かお気づきの点がありましたら、こちらから報告いただけます。