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

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

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

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

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

このデモのmainメソッドは単純です。 ユーザーの入力を収集し、ユーザーをOracle Service Registryにログインさせ、Save_taxonomyのオブジェクトを作成し、それをSOAPを経由してUDDIレジストリに送信し、結果を表示します。

String user = UserInput.readString("Enter user name", "admin");
String password = UserInput.readString("Enter password", "changeit");
String name = UserInput.readString("Enter name", "Demo identifier");
String description = UserInput.readString("Enter description", "Saved by SaveTaxonomy demo");
System.out.println();

UDDI_Security_PortType security = getSecurityStub();
String authInfo = getAuthInfo(user, password, security);
Save_taxonomy save = createSaveTaxonomy(name, description, authInfo);
TaxonomyDetail result = saveTaxonomy(save);
printTaxonomyDetail(result);
discardAuthInfo(authInfo, security);

分類を保存するときは、それを表すtModelを最初に作成する必要があります。パブリッシャが割り当てたtModelKeyおよび他のプロパティを設定できます。唯一の必須プロパティは名前です。分類に関連するkeyedReferencesをcategoryBag内で指定する必要はありません。これらは分類内に設定されます。

分類の使用方法の定義にはカテゴリ化が使用されます。有効な値は、identifier、categorization、categorizationGroupおよびrelationshipです。互換性によってtModelに情報、つまり使用できるUDDI構造のマークが付きます。

この例では、ビジネス・エンティティおよびtModelのcategoryBag内でのみ使用できるuncheckedの識別子（identifier）を作成します。

public static Save_taxonomy createSaveTaxonomy(String name, String description, String authInfo)
  throws InvalidParameterException {
    System.out.println("name = " + name);
    System.out.println("description = " + description);

    TModel tModel = new TModel();
    tModel.setName(new Name(name));
    tModel.addDescription(new Description(description));

    Taxonomy taxonomy = new Taxonomy(tModel);
    taxonomy.setCheck(Boolean.FALSE);
    taxonomy.addCategorization(Categorization.identifier);
    taxonomy.addCompatibility(Compatibility.businessEntity);
    taxonomy.addCompatibility(Compatibility.tModel);

    Save_taxonomy save = new Save_taxonomy();
    save.addTaxonomy(taxonomy);
    save.setAuthInfo(authInfo);

    return save;
}

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

public static TaxonomyApi getTaxonomyStub() throws SOAPException {
    String url = DemoProperties.getProperty(URL_TAXONOMY, "http://localhost:8888/registry/uddi/taxonomy");
    System.out.print("Using Taxonomy at url " + url + " ..");
    TaxonomyApi taxonomy = TaxonomyStub.getInstance(url);
    System.out.println(" done");
    return taxonomy;
}

分類APIコールsave_taxonomyが、メソッドsaveTaxonomy()で実行されます。

public static TaxonomyDetail saveTaxonomy(Save_taxonomy save)
  throws UDDIException, SOAPException {
    TaxonomyApi taxonomy = getTaxonomyStub();
    System.out.print("Save in progress ...");
    TaxonomyDetail taxonomyDetail = taxonomy.save_taxonomy(save);
    System.out.println(" done");
    return taxonomyDetail;
}
      

返されたTaxonomyDetailオブジェクトは、printTaxonomyDetailメソッドに表示されます。

public static void printTaxonomyDetail(TaxonomyDetail taxonomyDetail) {
    System.out.println();

    TaxonomyArrayList taxonomyArrayList = taxonomyDetail.getTaxonomyArrayList();
    int position = 1;
    for (Iterator iterator = taxonomyArrayList.iterator(); iterator.hasNext();) {
        Taxonomy taxonomy = (Taxonomy) iterator.next();
        System.out.println("Taxonomy " + position + " : " + taxonomy.getTModel().getTModelKey());
        System.out.println(taxonomy.toXML());
        System.out.println();
        System.out.println("********************************************************");
        position++;
    }
}
      

この項では、Oracle Service RegistryのAdvancedのTaxonomy（分類）セットをビルドして実行する方法を示します。引き続きSaveTaxonomyデモを使用します。