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

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

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

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

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

mainメソッドは単純です。ユーザーの入力（tModelの名前とfindQualifierの名前）を収集し、メソッドをコールしてFind_tModelオブジェクトを初期化し、find_tModel UDDIコールを実行し、見つかったtModelのリストを表示します。

String name = UserInput.readString("Enter name", "demo%");
String findQualifier = UserInput.readString("Enter findQualifier", "approximateMatch");
Find_tModel find_tModel = createFindByTModel(name, findQualifier);
TModelList result = findTModel(find_tModel);
printTModelList(result);

createFindTModel()メソッドを使用して、Find_tModelクラスの新規インスタンスを作成し、各パラメータからの値で初期化します。

public static Find_tModel createFindByTModel(String name, String findQualifier)
        throws InvalidParameterException {
    System.out.println("findQualifier = " + findQualifier);
    System.out.println("name = " + name);
    Find_tModel find_tModel = new Find_tModel();
    find_tModel.setName(new Name(name));
    find_tModel.setMaxRows(new Integer(MAX_ROWS));
    find_tModel.addFindQualifier(findQualifier);
    return find_tModel;
}

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

public static UDDI_Inquiry_PortType getInquiryStub()
        throws SOAPException {
    // you can specify your own URL in property - uddi.demos.url.inquiry
    String url = DemoProperties.getProperty(URL_INQUIRY, "http://localhost:8888/registry/uddi/inquiry");
    System.out.print("Using Inquiry at url " + url + " ..");
    UDDI_Inquiry_PortType inquiry = UDDIInquiryStub.getInstance(url);
    System.out.println(" done");
    return inquiry;
}

UDDI APIコールfind_tModelが、メソッドfindTModelで次のように実行されます。

public static TModelList findTModel(Find_tModel find_tModel)
        throws UDDIException, SOAPException {
    UDDI_Inquiry_PortType inquiry = getInquiryStub();
    System.out.print("Search in progress ..");
    TModelList tModelList = inquiry.find_tModel(find_tModel);
    System.out.println(" done");
    return tModelList;
}

見つかったtModelのリストは、メソッドprintTModelListによって出力されます。 Oracle Service RegistryのクライアントAPIで重要な点は、それぞれのUDDIオブジェクトにメソッドtoXML()が含まれ、それによってそのXML表現が、判読可能な書式化されたリストで返されることです。

public static void printTModelList(TModelList tModelList) {
    System.out.println();
    ListDescription listDescription = tModelList.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);
    }

    TModelInfoArrayList tModelInfoArrayList = tModelList.getTModelInfoArrayList();
    if (tModelInfoArrayList==null) {
        System.out.println("Nothing found");
        return;
    }

    int position = 1;
    for (Iterator iterator = tModelInfoArrayList.iterator(); iterator.hasNext();) {
        TModelInfo tModelTemplate = (TModelInfo) iterator.next();
        System.out.println("TModel "+position+" : "+tModelTemplate.getTModelKey());
        System.out.println(tModelTemplate.toXML());
        System.out.println();
        System.out.println("********************************************************");
        position++;
    }
}

この項では、Oracle Service RegistryのBasicのInquiryデモ・セットをビルドして実行する方法を示します。引き続きFindTModelデモを例に使用します。