Oracle Service RegistryのXML2UDDIデモ・セットでは、Oracle Service RegistryのApplication Programming Interface(API)の機能のデモンストレーションを行い、XML2UDDI APIを使用してXML文書を操作する方法を示します。
このデモ・セットに含まれるデモは次のとおりです。
FindXml
FindXmlMapping
GetXmlDetail
PublishXml
UnpublishXml
Oracle Service Registryがすでにインストールされ、環境変数REGISTRY_HOMEにレジストリのインストール場所が設定されていることを想定しています。
Oracle Service Registryのデモを実行するには、レジストリが実行中である必要があります。
デモを構成する必要があります。構成システムには、グローバルとローカルの2つのレベルがあります。グローバル・レベルで定義されたプロパティは、ローカル・レベルで上書きできます。グローバル・プロパティは、次のファイルにあります。
Windows: | %REGISTRY_HOME%¥demos¥env.properties |
UNIX: | $REGISTRY_HOME/demos/env.properties |
Oracle Service Registryのインストール中に設定された値はそのまま使用でき、値の変更はすべてのデモに影響を与えます。単一のデモについて(つまりローカル・レベルで)一部のプロパティの値を再定義する必要がある場合は、env.propertiesを編集してください。このファイルは、ファイルrun.sh(run.bat)と同じディレクトリにあります。XML2UDDIデモのローカル・レベルのプロパティは、次のファイルからロードされます。
Windows: | %REGISTRY_HOME%¥demos¥resources¥xml¥env.properties |
UNIX: | $REGISTRY_HOME/demos/resources/xml/env.properties |
表18 デモで使用されるプロパティ
名前 | デフォルト値 | 説明 |
---|---|---|
uddi.demos.user.john.name | demo_john | 1人目のユーザーの名前 |
uddi.demos.user.john.password | demo_john | 1人目のユーザーのパスワード |
uddi.demos.url.xml2uddi | http://localhost:8888/registry/uddi/xml2uddi | xml2uddi Webサービス・ポートのURL |
uddi.demos.url.security | http://localhost:8888/registry/uddi/security | セキュリティWebサービス・ポートのURL |
この項では、すべてのデモで使用されるプログラミング・パターンを、PublishXmlデモを例にして説明します。ソース・コードは次のファイルにあります。
Windows: | %REGISTRY_HOME%¥demos¥resources¥xml¥src¥demo¥uddi¥xml¥PublishXml.java |
UNIX: | $REGISTRY_HOME/demos/resources/xml/src/demo/uddi/xml/PublishXml.java |
ヘルパー・メソッドcreatePublishXmlによって、次のようにPublish_xml構造が作成されます。
public Publish_xml createPublishXml(String location, String publishingMethod, String nsPublishMethod, String nsPublishPolicy, String authInfo) throws InvalidParameterException { System.out.println("location = " + location); Publish_xml publish = new Publish_xml(); publish.setLocation(location); publish.setPublishingMethod(XmlPublishingMethod.getXmlPublishingMethod(publishingMethod)); publish.setPolicy(PublishPolicy.getPublishPolicy(nsPublishMethod)); publish.setNamespacePublishingMethod(NsPublishingMethod.getNsPublishingMethod(nsPublishPolicy)); publish.setAuthInfo(authInfo); return publish; }
publishXmlResourceメソッドによって、次のように公開操作が実行されます。
public XmlResourceDetail publishXmlResource(Publish_xml publish) throws UDDIException, SOAPException { System.out.print("Check structure validity .. "); try { publish.check(); } catch (InvalidParameterException e) { System.out.println("Failed!"); throw new UDDIException(e); } System.out.println("OK"); Xml2uddiApi xmlApi = getXml2UddiStub(); System.out.print("Publishing in progress ..."); XmlResourceDetail xmlDetail = xmlApi.publish_xml(publish); System.out.println(" done"); return xmlDetail; }
この項では、Oracle Service RegistryのXML2UDDIデモ・セットをビルドして実行する方法を示します。引き続きPublishXmlデモを使用します。
デモが適切に構成され、Oracle Service Registryが実行中であることを確認してください。
次のディレクトリに移動します。
Windows | %REGISTRY_HOME%¥demos¥resources¥xml |
UNIX | $REGISTRY_HOME/demos/resources/xml |
次のコマンドを使用して、すべてのデモをビルドします。
Windows: | run.bat make |
UNIX: | ./run.sh make |
![]() | 注意 |
---|---|
Windowsプラットフォームでデモをコンパイルすると、次のテキストが表示されることがあります。 A subdirectory or file ..\..\common\.\build\classes already exists. . これは予想される現象であり、問題を示すものではありません。 |
利用可能なすべてのデモのリストを表示するには、次のコマンドを実行します。
Windows: | run.bat help |
UNIX: | ./run.sh help |
選択したデモを実行するには、runコマンドのパラメータにデモの名前を指定して実行します。 たとえば、PublishXmlデモを実行するには、次のように起動します。
Windows: | run.bat PublishXml |
UNIX: | ./run.sh PublishXml |
このデモの出力は次のようになります。
Publishing an XML document with the following parameters: Enter XML location (URI) [http://localhost:8888/registry/uddi/doc/demos/employees.xml]: Enter publishing method (update,create) [update]: Enter import publishing policy (automatic,explicit,locations) [automatic]: Enter import publishing method (reuse,create,ignore) [reuse]: Using Security at url https://localhost:8443/registry/uddi/security .. done Logging in .. done location = http://localhost:8888/registry/uddi/doc/demos/employees.xml Check structure validity .. OK Using XML2UDDI at url https://localhost:8443/registry/uddi/xml2uddi .. done Publishing in progress ... done XML http://localhost:8888/registry/uddi/doc/demos/employees.xml <xmlResourceDetail xmlns="http://systinet.com/uddi/xml2uddi/v3/5.5"> <xmlResourceInfo> <location>http://localhost:8888/registry/uddi/doc/demos/employees.xml</location> <tModelKey xmlns="urn:uddi-org:api_v3">uddi:systinet.com:demo:xml:employees</tModelKey> <name xmlns="urn:uddi-org:api_v3">employees.xml</name> </xmlResourceInfo> <namespace> <uri>http://systinet.com/uddi/demo/employeeList</uri> <namespaceModel> <name xmlns="urn:uddi-org:api_v3">employees.xsd</name> <tModelKey xmlns="urn:uddi-org:api_v3">uddi:systinet.com:demo:xsd:employees</tModelKey> </namespaceModel> </namespace> </xmlResourceDetail> Logging out .. done