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

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

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

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

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

mainメソッドは、次のようにわかりやすいものです。

String name = UserInput.readString("Enter business name", "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 name,
	           String description, String authInfo)
  throws InvalidParameterException {
    System.out.println("name = " + name);
    System.out.println("description = " + description);

    BusinessEntity businessEntity = new BusinessEntity();
    businessEntity.setBusinessKey("");
    businessEntity.setName(name);
    businessEntity.addDescription(new Description(description));

    Save_business save = new Save_business();
    save.addBusinessEntity(businessEntity);
    save.setAuthInfo(authInfo);
    save.setGeneric(Constants.GENERIC_1_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デモを使用します。