S-JIS[2024-07-12/2024-08-31]

Iceaxe TsurugiConnector

TsurugiのIceaxe（Javaライブラリー）のTsurugiConnectorのメモ。

概要

IceaxeのTsurugiConnectorは、エンドポイント（接続先）を保持し、セッションを作成する為のクラス。

ひとつのTsurugiConnectorから複数のセッションを作成できる。

TsurugiConnectorの生成

TsurugiConnectorインスタンスはofメソッドで生成する。

import java.net.URI;

import com.tsurugidb.iceaxe.TsurugiConnector;
import com.tsurugidb.iceaxe.session.TgSessionOption;

import com.tsurugidb.tsubakuro.channel.common.connection.NullCredential;

    var endpoint = URI.create("tcp://localhost:12345");
    var credentail = NullCredential.INSTANCE; // 認証情報
    var sessionOption = TgSessionOption.of();
    var connector = TsurugiConnector.of(endpoint, credential, sessionOption);
    connector.setApplicationName("application name"); // Iceaxe 1.4.0

// Iceaxe 1.6.0 [2024-08-31]
    var connector = TsurugiConnector.of("application name", endpoint, credential, sessionOption);

なお、認証情報はTsubakuroのCredentialクラスをそのまま使用する。

ofメソッドの引数の認証情報（Credential）やセッションオプションは必須ではない。
ofメソッドで渡さない場合はcreateSessionメソッドで渡す。
これは、以下の2つの考え方があるので、どちらにするかをユーザーが選べるようになっている。

• ひとつのTsurugiConnectorから複数のセッションを作成する場合、認証情報は共通なのでTsurugiConnectorに持たせておく。
• 認証情報は（長く）保持しておくべきではないので、TsurugiConnectorには持たせない。

var connector = TsurugiConnector.of(endpoint);
try (var session = connector.createSession(credential, sessionOption)) {
    〜
}

var connector = TsurugiConnector.of(endpoint, credential);
try (var session = connector.createSession(sessionOption)) {
    〜
}

var connector = TsurugiConnector.of(endpoint, credential, sessionOption);
try (var session = connector.createSession()) {
    〜
}

TsurugiConnectorのメソッド