オントロジー SDK を使用する新しい Java アプリケーションをセットアップする

このページでは、オントロジー SDK を使用して Java アプリケーションを作成する手順を説明します。

Developer Console アプリケーションを作成する

オントロジー SDK を使用して新しい Java アプリケーションを作成するには、まず新しい Developer Console アプリケーションを作成する必要があります。これにより、アプリケーションの権限を設定し、Java アプリケーションで使用するオブジェクトを選択します。

個人用アクセストークンを設定する

次に、ローカル環境で個人用アクセストークンをエクスポートします。このトークンは Palantir のユーザーまたはアプリケーションに関連付けられており、サードパーティアプリケーションや API を通じて Foundry リソースにアクセスできます。以下はサンプルの個人用アクセストークンを使用した例ですが、Developer Console で有効期間がより長いトークンを生成できます。

セキュリティ上の脆弱性につながる可能性があるため、このトークンをソース管理にチェックインしないでください。たとえば、個人用アクセストークンを Git リポジトリに含めないでください。

Copied!1
export FOUNDRY_TOKEN=<YOUR-TOKEN-FROM-GETTING-STARTED-PAGE>

Java のバージョンを確認する

Java オントロジー SDK には、17から21までの Java バージョンが必要です。使用している Java のバージョンを確認するには、以下のコマンドを実行し、必要に応じて Java をアップグレードします。

Copied!1
java --version

オントロジー SDK の最新バージョンをインストールする

SDK の最新バージョンをインストールするには、以下のリポジトリと依存関係を build.gradle ファイル（別のビルドツールを使用している場合は、それに相当するファイル）に追加します。すべての < > を、Developer Console のアプリケーションの概要ページに記載されている、アプリケーション固有の値に置き換えます。

repositories {
    maven {
        credentials {
            username ''
            password System.getenv('FOUNDRY_TOKEN')
        }
        url 'https://<APPLICATION-URL>'
    }

    maven {
        credentials {
            username ''
            password System.getenv('FOUNDRY_TOKEN')
        }
        url 'https://<GENERATOR-URL>'
    }
}

dependencies {
    implementation '<YOUR-PACKAGE-NAME>'
}

Java アプリケーションを開発する

アプリケーション内で Foundry クライアントを初期化し、開発を開始します。既存の Java サービスに Java SDK を統合する際の一般的なユースケースとして、バックエンドアプリケーションをホストするためにサービスユーザーを作成する必要がある場合は、必要な OAuth 情報を取得するためのガイドを参照してください。

ユーザートークンで Foundry クライアントを初期化する

Copied!1
2
3
4
5
6
7
8
9
10
11
12
13
14
import <PACKAGE-NAME>.FoundryClient;
import <PACKAGE-NAME>.objects.Aircraft;
import com.palantir.osdk.api.Auth;
import com.palantir.osdk.api.UserTokenAuth;
import com.palantir.osdk.internal.api.FoundryConnectionConfig;

Auth auth = UserTokenAuth.builder().token(System.getenv("FOUNDRY_TOKEN")).build();
FoundryClient client = FoundryClient.builder()
        .auth(auth)
        .connectionConfig(FoundryConnectionConfig.builder()
                .foundryUri("<YOUR-FOUNDRY-URL>")
                .build())
        .build();
System.out.println(client.ontology().objects().<ANY-OBJECT>.fetch(1));

OAuth で Foundry クライアントを初期化する

Copied!1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
import <PACKAGE-NAME>.FoundryClient;
import <PACKAGE-NAME>.objects.Aircraft;
import com.palantir.osdk.api.Auth;
import com.palantir.osdk.api.UserTokenAuth;
import com.palantir.osdk.internal.api.FoundryConnectionConfig;

Auth auth = ConfidentialClientAuth.builder()
                .clientId("<YOUR-CLIENT-ID>")
                .clientSecret("<YOUR-SECURELY-STORED-CLIENT-SECRET>")
                .build();
FoundryClient client = FoundryClient.builder()
        .auth(auth)
        .connectionConfig(FoundryConnectionConfig.builder()
                .foundryUri("<YOUR-FOUNDRY-URL>")
                .build())
        .build();
System.out.println(client.ontology().objects().<ANY-OBJECT>.fetch(1));

オントロジーのAPI名をオーバーライドする

ある Foundry 環境で生成したオントロジー SDK パッケージを別の環境にデプロイする場合、クライアントビルダーの ontologyApiName() メソッドを使用してオントロジーのAPI名をオーバーライドできます。

Copied!1
2
3
4
5
6
7
8
9
10
11
12
13
import <PACKAGE-NAME>.FoundryClient;
import com.palantir.osdk.api.Auth;
import com.palantir.osdk.api.UserTokenAuth;
import com.palantir.osdk.internal.api.FoundryConnectionConfig;

Auth auth = UserTokenAuth.builder().token(System.getenv("FOUNDRY_TOKEN")).build();
FoundryClient client = FoundryClient.builder()
        .auth(auth)
        .connectionConfig(FoundryConnectionConfig.builder()
                .foundryUri("<YOUR-FOUNDRY-URL>")
                .build())
        .ontologyApiName("<YOUR-TARGET-ONTOLOGY-API-NAME>")
        .build();

これは、オントロジー SDK パッケージの生成対象となった Foundry 環境とは異なる環境にアプリケーションが接続し、その環境で異なるオントロジーのAPI名が使用されている場合に便利です。

←

PREVIOUSPythonアプリケーションをブートストラップ

NEXTバックエンドのTypeScriptアプリケーションをブートストラップ

→