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

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

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

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

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

mainメソッドは非常に単純です。ユーザーの入力を収集した後、Securityスタブを取得してユーザーを認可します。結果として得られるauthInfo文字列は、Publishリクエストに渡される秘密鍵です。Publishリクエストは、createPublish()メソッドで作成され、初期化されます。

ユーザーによるWSDLの選択は、publishWSDL()メソッド内で、選択されたbusinessEntityに公開されます。

正常に処理されると、UDDIレジストリからWsdlDetailオブジェクトが返されて出力されます。

最後の手順で、authInfo文字列を廃棄します。これにより、悪質なユーザーがこの文字列を利用して他のユーザーのアカウントの安全性を損なうことができなくなります。

String businessKey = UserInput.readString("Enter businessKey",
	      "d7222f66-08aa-3a6e-a299-2ed4ac785682");
String url = UserInput.readString("Enter WSDL URL",
            "http://localhost:8888/registry/uddi/doc/demos/EmployeeList.wsdl");
System.out.println();

UDDI_Security_PortType security = getSecurityStub();
String authInfo = getAuthInfo(user, password, security);
Publish_wsdl publish = createPublish(businessKey, url, authInfo);
WsdlDetail result = publishWSDL(publish);
printWsdlDetail(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;
}

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

public static Wsdl2uddiApi getWsdl2uddiStub() throws SOAPException {
    // you can specify your own URL in property - uddi.demos.url.wsdl2uddi
    String url = DemoProperties.getProperty(URL_WSDL2UDDI,
                                           "http://localhost:8888/registry/uddi/wsdl2uddi");
    System.out.print("Using WSDL2UDDI at url " + url + " ..");
    Wsdl2uddiApi inquiry = Wsdl2uddiStub.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;
}

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

public static Publish_wsdl createPublish(String businessKey,
	                                                   String url, String authInfo)
  throws InvalidParameterException {
    System.out.println("businessKey = " + businessKey);
    System.out.println("url = " + url);

    WsdlMapping wsdlMapping = new WsdlMapping();
    wsdlMapping.setBusinessKey(businessKey);
    Wsdl wsdl = new Wsdl(url);
    WsdlDetail wsdlDetail = new WsdlDetail(wsdl, wsdlMapping);
    Publish_wsdl publish = new Publish_wsdl(wsdlDetail, authInfo);
    return publish;
}

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

public static WsdlDetail publishWSDL(Publish_wsdl save)
  throws UDDIException, SOAPException {
    Wsdl2uddiApi publishing = getWsdl2uddiStub();
    System.out.print("Save in progress ...");
    WsdlDetail wsdlDetail = publishing.publish_wsdl(save);
    System.out.println(" done");
    return wsdlDetail;
}

返されたWsdlDetailは、printWsdlDetail()メソッドによって表示されます。

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

public static void printWsdlDetail(WsdlDetail wsdlDetail) {
    System.out.println();
    System.out.println(wsdlDetail.toXML());
}

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