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

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

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

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

この項では、すべてのデモで使用されるプログラミング・パターンを、WhereIAmデモを例にして説明します。このデモのソース・コードは次のファイルにあります。

mainメソッドは、ユーザーからの構成情報の収集で始まります。1つ目の情報であるログイン名を使用してコマンドが実行され、2つ目はwhere_amI操作の引数になります。次にユーザーがレジストリにログインし、Where_amIオブジェクトが作成されてSOAP経由で送信され、ログインが属するグループのリストが出力されます。

String user = UserInput.readString("Enter login to authenticate",
	               DemoProperties.getProperty(USER_JOHN_NAME));
String password = UserInput.readString("Enter password",
                       DemoProperties.getProperty(USER_JOHN_PASSWORD));
String login = UserInput.readString("Enter login to search", user);
System.out.println();

UDDI_Security_PortType security = getSecurityStub();
String authInfo = getAuthInfo(user, password, security);
Where_amI save = createWhereAmI(login, authInfo);
GroupList groups = whereAmI(save);
printGroupList(groups);
discardAuthInfo(authInfo, security);

メソッドcreateWhereAmIを使用して、where_amI操作を表すオブジェクトが作成されます。

public static Where_amI createWhereAmI(String login, String authInfo)
  throws InvalidParameterException {
    System.out.println("login = " + login);

    Where_amI find = new Where_amI();
    find.setLoginName(login);
    find.setAuthInfo(authInfo);

    return find;
}

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

public static GroupApi getGroupStub() throws SOAPException {
    // you can specify your own URL in property - uddi.demos.url.group
    String url = DemoProperties.getProperty(URL_GROUP, "http://localhost:8888/registry/uddi/group");
    System.out.print("Using Group API at url " + url + " ..");
    GroupApi account = GroupStub.getInstance(url);
    System.out.println(" done");
    return account;
}

Oracle Service RegistryのAPIコールwhere_amIが、whereAmIメソッドで実行されます。

public static GroupList whereAmI(Where_amI find)
  throws SOAPException, GroupException {
    GroupApi groupApi = getGroupStub();
    System.out.print("Search in progress ...");
    GroupList groups = groupApi.where_amI(find);
    System.out.println(" done");
    return groups;
}

最後にメソッドprintGroupListを使用して、見つかったグループがコンソールに出力されます。

public static void printGroupList(GroupList groups) {
    System.out.println();
    ListDescription listDescription = groups.getListDescription();
    if (listDescription != null) {
        // list description is mandatory part of result, if the resultant list is subset of available data
        int includeCount = listDescription.getIncludeCount();
        int actualCount = listDescription.getActualCount();
        int listHead = listDescription.getListHead();
        System.out.println("Displaying " + includeCount + " of " + actualCount + ",
	                                                  starting at position " + listHead);
    }

    GroupInfoArrayList groupInfoArrayList = groups.getGroupInfoArrayList();
    if (groupInfoArrayList == null) {
        System.out.println("Nothing found");
        return;
    }

    int position = 1;
    for (Iterator iterator = groupInfoArrayList.iterator(); iterator.hasNext();) {
        GroupInfo group = (GroupInfo) iterator.next();
        System.out.println("Group " + position);
        System.out.println(group.toXML());
        System.out.println();
        System.out.println("********************************************************");
        position++;
    }
}

この項では、Oracle Service Registryのグループ・デモをビルドして実行する方法を示します。