第2章 ソフトウェア開発キットの使用

この章では、Java ソフトウェア開発キットの使用方法のいくつかの例について概説します。この章のすべての例では、特に明記されていない限り、ソフトウェア開発キットのバージョン 3 を使用しています。

2.1. バージョン 4 の Red Hat Virtualization への接続

Java ソフトウェア開発キットの V4 では、Connection クラスは、Red Hat Virtualization 環境でオブジェクトに接続して操作するために使用するメインクラスです。このクラスのインスタンスを宣言するには、ConnectionBuilder クラスのインスタンスを宣言し、ビルダーメソッドを使用してこのインスタンスに必要な引数を渡してから、インスタンスで build メソッドを呼び出す必要があります。build メソッドは、Connection クラスのインスタンスを返します。このインスタンスを変数に割り当てて、後続のアクションを実行するために使用できます。

以下は、ソフトウェア開発キットのバージョン 4 を使用して、Red Hat Virtualization 環境との接続を作成する単純な JavaSE プログラムの例になります。

例2.1 Red Hat Virtualization Manager への接続

package rhevm;

import org.ovirt.engine.sdk4.Connection;
import org.ovirt.engine.sdk4.ConnectionBuilder;

public class rhevm {

    public static void main(String[] args) {

            ConnectionBuilder myBuilder = ConnectionBuilder.connection()

            .url("https://rhevm.example.com/ovirt-engine/api")
            .user("admin@internal")
            .password("p@ssw0rd")
            .trustStoreFile("/home/username/server.truststore")
            .trustStorePassword("p@ssw0rd");

        try (Connection conn = myBuilder.build()) {

            // Requests

        } catch (Exception e) {

            // Error handling

        }
    }
}

この例では、Basic 認証を使用して接続を作成しますが、他の認証方法を使用することもできます。ConnectionBuilder クラスのインスタンスに渡すことができる主要な引数のリストについては、付録A ConnectionBuilder メソッド を参照してください。