Oracle Service Registryがすでにインストールされ、環境変数REGISTRY_HOMEにレジストリのインストール場所が設定されていることを想定しています。

Oracle Service Registryのデモを実行するには、レジストリが実行中である必要があります。

デモを構成する必要があります。構成システムには、グローバルとローカルの2つのレベルがあります。グローバル・レベルで定義されたプロパティは、ローカル・レベルで上書きできます。グローバル・プロパティは、次のファイルにあります。

Oracle Service Registryのインストール中に設定された値はそのまま使用でき、値の変更はすべてのデモに影響を与えます。単一のデモについて（つまりローカル・レベルで）プロパティの値を再定義する必要がある場合は、env.propertiesを編集してください。このファイルは、ファイルrun.sh（run.bat）と同じディレクトリにあります。Custodyデモのローカル・レベルのプロパティは、次のファイルからロードされます。

この項では、Custody（管理）デモのプログラミング・パターンについて説明します。ソース・コードは次のファイルにあります。

デモの使用を容易にするために、ファイルには2つのユースケースが含まれています。1つ目のユースケースでは、UDDI構造の所有者が自分のUDDI構造を他のユーザーに転送する必要のある場合について示します。2つ目のユースケースでは、その同じ構造を2人目のユーザーが自分の管理に転送します。1つ目のユースケースから始めます。

初めにユーザー入力を収集する必要があります。ユーザーの資格証明およびユーザーが所有する構造の鍵を読み取る必要があります。デフォルト値を使用する場合は、ユーザーdemo_johnがsystinet.com:departmentID tModelの管理をユーザーdemo_janeに転送します。ユーザーはログインし、任意のUDDI鍵の転送トークンを生成します。この転送トークンには、レジストリ、有効期限および秘密のopaqueTokenに関する情報が含まれています。これらのデータを知っているユーザーは、この転送トークンで保護される構造を転送できます。

String user = UserInput.readString("Enter first user name",
	           DemoProperties.getProperty(USER_JOHN_NAME));
String password = UserInput.readString("Enter password",
                   DemoProperties.getProperty(USER_JOHN_PASSWORD));
String uddiKey = UserInput.readString("Enter UDDI key",
                                       "uddi:systinet.com:demo:departmentID");
System.out.println();

UDDI_Security_PortType security = getSecurityStub();
String authInfo = getAuthInfo(user, password, security);
Get_transferToken get = createGetTransferToken(uddiKey, authInfo);
TransferToken token = getTransferToken(get);
printTransferToken(token);
discardAuthInfo(authInfo, security);

ヘルパー・メソッドgetCustodyStub()によって、URL_CUSTODYプロパティで指定されたURLでリスニングするWebサービスのUDDI Custodyスタブが返ります。

public static UDDI_CustodyTransfer_PortType getCustodyStub() throws SOAPException {
    // you can specify your own URL in property - uddi.demos.url.custody
    String url = DemoProperties.getProperty(URL_CUSTODY, "http://localhost:8888/registry/uddi/custody");
    System.out.print("Using Custody at url " + url + " ..");
    UDDI_CustodyTransfer_PortType custody = UDDICustodyStub.getInstance(url);
    System.out.println(" done");
    return custody;
}

createGetTransferToken()メソッドを使用して、このUDDIコールのパラメータをカプセル化するGet_transferTokenオブジェクトを作成します。この例では、authInfoと、2人目のユーザーの管理に転送されるUDDI構造の単一鍵を設定します。

public static Get_transferToken createGetTransferToken(String uddiKey, String authInfo)
  throws InvalidParameterException {
    System.out.println("uddiKey = " + uddiKey);
    Get_transferToken get = new Get_transferToken();
    get.addKey(uddiKey);
    get.setAuthInfo(authInfo);
    return get;
}

次に、get_transferToken UDDIコールを起動して、結果を取得します。この結果が転送トークンになります。

public static TransferToken getTransferToken(Get_transferToken get)
  throws UDDIException, SOAPException {
    UDDI_CustodyTransfer_PortType custody = getCustodyStub();
    System.out.print("Get in progress ...");
    TransferToken token = custody.get_transferToken(get);
    System.out.println(" done");
    return token;
}

この時点で、1人目のユーザーであるJohn Demoによって、転送トークンが生成されています。John Demoは、この転送トークンを破棄することも、2人目のユーザーであるJane Demoに転送して、Jane Demoがエンティティを自分の管理に転送できるようにすることもできます。この転送トークンは秘密にしておく必要があります。そのため、暗号化されていない電子メールなどプレーン・テキストでの転送は、この目的には適しません。Jane Demoはすでに転送トークンを受信していると想定します。Jane Demoはログインし、Transfer_entitiesオブジェクトを作成して、UDDIコールtransfer_entitiesを起動します。

user = UserInput.readString("Enter second user name",
	                                DemoProperties.getProperty(USER_JANE_NAME));
password = UserInput.readString("Enter password", DemoProperties.getProperty(USER_JANE_PASSWORD));
System.out.println();

authInfo = getAuthInfo(user, password, security);
Transfer_entities transfer = createTransferEntities(uddiKey, token, authInfo);
transferEntities(transfer);
discardAuthInfo(authInfo, security);

createTransferEntities()メソッドを使用して、同じ名前のUDDIコールのパラメータをカプセル化するTransfer_entitiesオブジェクトを作成します。この例では、JaneのauthInfo、転送するUDDI鍵、およびJohnが生成したTransferTokenを設定します。

public static Transfer_entities createTransferEntities(String uddiKey,
	                                                          TransferToken token, String authInfo)
  throws InvalidParameterException {
    Transfer_entities transfer = new Transfer_entities();
    transfer.addKey(uddiKey);
    transfer.setTransferToken(token);
    transfer.setAuthInfo(authInfo);
    return transfer;
}

最後に、transfer_entities UDDIコールを行います。正常に応答が返されると、2人目のユーザー（Jane）がUDDI構造systinet.com:demo:departmentIDの所有者になります。

public static void transferEntities(Transfer_entities transfer)
  throws UDDIException, SOAPException {
    UDDI_CustodyTransfer_PortType custody = getCustodyStub();
    System.out.print("Transfer in progress ...");
    custody.transfer_entities(transfer);
    System.out.println(" done");
}

この項では、Oracle Service RegistryのCustody（管理）デモをビルドして実行する方法を示します。