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

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

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

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

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

mainメソッドはわかりやすいものです。初めにユーザーの入力を収集します。具体的には、パブリッシャが任意に割り当てたbusinessKey、ビジネス・エンティティ名とその言語コードの配列、最後にビジネスの説明です。

次に、Securityスタブを取得し、ユーザーを認可します。結果として得られるauthInfo文字列は、すべてのリクエストで渡される秘密鍵です。

次に、Save_businessオブジェクトを作成して入力し、saveBusinessメソッドにパラメータとして渡します。

正常に処理されると、UDDIレジストリからBusinessDetailオブジェクトが返されて出力されます。 最後に、authInfo文字列を廃棄します。これにより、この文字列を利用してユーザーのアカウントの安全性を損なうことができなくなります。

int count = UserInput.readInt("Enter count of names", 1);
String[] names = new String[count];
String[] languageCodes = new String[count];
for (int i = 0; i < count; i++) {
    String tmp = UserInput.readString("Enter language code", "");
    languageCodes[i] = (tmp.length() > 0) ? tmp : null;
    names[i] = UserInput.readString("Enter name in language " + tmp, "Marketing");
}
String description = UserInput.readString("Enter description",
                                 "Saved by SaveBusiness demo");
System.out.println();

UDDI_Security_PortType security = getSecurityStub();
String authInfo = getAuthInfo(user, password, security);
Save_business save = createSaveBusiness(businessKey, names, languageCodes, description, authInfo);
BusinessDetail result = saveBusiness(save);
printBusinessDetail(result);
discardAuthInfo(authInfo, security);

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

public static UDDI_Security_PortType getSecurityStub()
  throws SOAPException {
    // you can specify your own URL in property - uddi.demos.url.security
    String url = DemoProperties.getProperty(URL_SECURITY, "http://localhost:8888/registry/uddi/security");
    System.out.print("Using Security at url " + url + " ..");
    UDDI_Security_PortType security = UDDISecurityStub.getInstance(url);
    System.out.println(" done");
    return security;
}

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

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

getAuthInfo()メソッドを使用して、ユーザーをUDDIレジストリに対して認可し、秘密鍵authInfoを取得します。

public static String getAuthInfo(String userName,
	                   String password, UDDI_Security_PortType security)
  throws InvalidParameterException, UDDIException {
    System.out.print("Logging in ..");
    AuthToken authToken = security.get_authToken(new Get_authToken(userName, password));
    System.out.println(" done");
    return authToken.getAuthInfo();
}

discardAuthInfo()メソッドによって、秘密鍵authInfoが無効化され、使用できなくなります。

public static DispositionReport discardAuthInfo(String authInfo,
	              UDDI_Security_PortType security)
  throws InvalidParameterException, UDDIException {
    System.out.print("Logging out ..");
    DispositionReport dispositionReport = security.discard_authToken(new Discard_authToken(authInfo));
    System.out.println(" done");
    return dispositionReport;
}

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

public static Save_business createSaveBusiness(String[] names,
String[] nameLangCodes, String description, String authInfo)
  throws InvalidParameterException {
    for (int i = 0; i < names.length; i++) {
        System.out.println("lang = " + nameLangCodes[i] + ", name = " + names[i]);
    }
    System.out.println("description = " + description);

    BusinessEntity businessEntity = new BusinessEntity();
    businessEntity.setBusinessKey("");
    for (int i = 0; i < names.length; i++) {
        if (nameLangCodes[i] == null) {
            businessEntity.addName(new Name(names[i]));
        } else {
            businessEntity.addName(new Name(names[i], nameLangCodes[i]));
        }
    }
    businessEntity.addDescription(new Description(description));

    Save_business save = new Save_business();
    save.addBusinessEntity(businessEntity);
    save.setAuthInfo(authInfo);
    save.setGeneric(Constants.GENERIC_2_0);
    return save;
}

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

public static BusinessDetail saveBusiness(Save_business save)
  throws UDDIException, SOAPException {
    UDDI_Publication_PortType publishing = getPublishingStub();
    System.out.print("Save in progress ...");
    BusinessDetail businessDetail = publishing.save_business(save);
    System.out.println(" done");
    return businessDetail;
}

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

public static void printBusinessDetail(BusinessDetail businessDetail) {
    System.out.println();
    BusinessEntityArrayList businessEntityArrayList = businessDetail.getBusinessEntityArrayList();
    int position = 1;
    for (Iterator iterator = businessEntityArrayList.iterator(); iterator.hasNext();) {
        BusinessEntity entity = (BusinessEntity) iterator.next();
        System.out.println("Business " + position + " : " + entity.getBusinessKey());
        System.out.println(entity.toXML());
        System.out.println();
        System.out.println("********************************************************");
        position++;
    }
}

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