UDDIPublish 工具參照

您可以從指令行中,利用 UDDIPublish 工具將 Web 服務當作商業實體或服務發佈在 UDDI 登錄中。您可以發佈在公開或私密 UDDI 登錄中。設定好指令行之後,您可以利用下列語法和引數來執行工具:

語法

如果要發佈商業實體:

如果要發佈商業服務:

引數

商業實體

強制引數:

-business
指定要在登錄中建立的新商業實體。
-businessName <name>
指定新商業給人閱讀的名稱。如果 <name> 含有空格,請用引號括住它。

選用引數:

-inquiryURL<inquiry API URL>
將 URL 設為 UDDI 登錄的查詢 API。如果沒有指定這個引數,預設值是 http://localhost:6080/uddisoap/inquiryapi。
附註:如果您以預設值來使用 Unit Test UDDI 登錄,請將 -inquiryURL 設成 http://localhost:9080/uddisoap/inquiryapi。
-publishURL<publish API URL>
設定 UDDI 登錄發佈 API 的 URL。如果沒有指定這個引數,預設值是 https://localhost:6443/uddisoap/publishapi。
附註:如果您以預設值來使用 Unit Test UDDI 登錄,請將 -publishURL 設成 http://localhost:9080/uddisoap/publishapi。
-businessKey <key>
指定第一次發佈商業時,UDDI 登錄產生的商業的唯一商業金鑰。如果您試圖取消發佈名稱重複出現在登錄中的商業,這個選項就是強制的。這時會傳回失敗訊息,指出含指定商業名稱的現有商業數它們的唯一索引鍵。 這時您應該設定這個引數來重試指令。
-businessDescription <description>
指定新商業的文字說明。如果 <description> 含有空格,請用引號括住它。
-username <name>
指定要傳給私密 UDDI 登錄的使用者名稱。
-password <password>
指定提供的使用者名稱的 UDDI 登錄密碼。
-uddiprops <location of properties file>
指定含有用等號分開的名稱值配對的傳統 Java™ 內容檔。請參閱其他內容
-verbose
在執行工具時,顯示額外資訊。
-help
顯示說明資訊。
 

商業服務

強制引數:

-service
指定要在登錄中建立的新商業服務。
-serviceName <name>
指定新商業服務給人閱讀的名稱。如果 <name> 含有空格,請用引號括住它。
-businessName <name>
指定含有新服務之商業實體給人閱讀的名稱。如果 <name> 含有空格,請用引號括住它。
-wsdlLocation <描述新服務之 WSDL 的 URI>
指定指向含服務說明的 WSDL 文件之 URI。將 URI 設為這個工具自動建立的新服務相關 tModel 中的 <overviewURL> 元素值。
-accessPoint <新服務在網路上之位置的 URL>
指定新服務的網路存取點。將 URL 設為這個工具自動建立的新服務相關連結範本中的 <accessPoint> 元素值。提供的存取點必須是服務 WSDL 文件中的 <port> 定義中所指定的相同位址。

選用引數:

-inquiryURL <查詢 API URL>
設定 UDDI 登錄的查詢 URL。如果沒有指定這個引數,預設值就是 http://localhost:6080/uddisoap/inquiryapi。
附註:如果您以預設值來使用 Unit Test UDDI,請將 -inquiryURL 設成 http://localhost:9080/uddisoap/inquiryapi。
-publishURL <publish API URL>
設定 UDDI 登錄的發佈 URL。如果沒有指定這個引數,預設值是 https://localhost:6443/uddisoap/publishapi。
附註:如果您以預設值來使用 Unit Test UDDI,請將 -publishURL 設成 http://localhost:9080/uddisoap/publishapi。
-businessKey <key>
指定含有要刪除的服務之商業實體的唯一商業金鑰。如果您試圖取消發佈屬於在登錄中有重複實例的具名服務之商業服務,這就是強制的。在這個情況下,商業名稱本身不足以識別儲存器商業。 這時會傳回失敗訊息,指出含指定商業實體名稱的現有商業數及它們的唯一索引鍵。 這時您應該設定這個引數來重試指令。
-serviceKey <key>
指定第一次發佈服務時,UDDI 登錄產生的服務的唯一服務金鑰。如果您試圖取消發佈名稱重複出現在登錄中的商業服務,這就是強制的。如果是這樣,就會傳回失敗訊息,指出含指定服務名稱的現有商業服務數及它們的唯一索引鍵。 這時您應該設定這個引數來重試指令。
-serviceDescription <description>
指定新商業服務的文字說明。如果 <description> 含有空格,請用引號括住它。
-username <name>
指定要傳給私密 UDDI 登錄的使用者名稱。
-password <password>
指定提供的使用者名稱的 UDDI 登錄密碼。
-uddiprops <location of properties file>
指定含有用等號分開的名稱值配對的傳統 Java 內容檔。請參閱其他內容
-verbose
在執行工具時,顯示額外資訊。
-help
顯示說明資訊。

其他內容

您可以利用 UDDIPublish 的 -uddiprops 引數,來指定含有其他輸入資訊之 Java 內容檔的位置。您可以在登錄中,將這個其他分類資訊與商業和服務關聯起來,以協助探索程序。您可以採用索引鍵參照的形式,將這項資訊加入發佈項目的種類袋結構中。種類袋可含有許多索引鍵參照,每個索引鍵參照都含有發佈項目所屬之種類的名稱和值。

UDDIPublish 使用下列內容:

內容 用途
wsdk.uddi.publish.url 將 URL 置換為遠端 UDDI 登錄的發佈 API。除非已設定這個內容,否則,工具會發佈至私密登錄中。
wsdk.uddi.inquiry.url 將 URL 置換為遠端 UDDI 登錄的查詢 API。除非已設定這個內容,否則,工具會將查詢傳送給私密登錄。
wsdk.uddi.publish.bs.keyref.name.<id> 索引鍵參照結構的名稱部分。內容名稱的 <id> 部分用來將特定索引鍵參照所要套用的檔案中之個別內容項目鏈結起來。<id> 可以是沒有包含可解譯為內容定界字元的任何字串。
wsdk.uddi.publish.bs.keyref.value.<id> 索引鍵參照結構的值部分。內容名稱的 <id> 部分用來將特定索引鍵參照所要套用的檔案中之個別內容項目鏈結起來。<id> 可以是沒有包含可解譯為內容定界字元的任何字串。
wsdk.uddi.publish.bs.keyref.tmodelkey.<id> 索引鍵參照結構中的選用 tModel 索引鍵。 這個內容的值應該是含有對應的索引鍵參照所支援的種類化規格之目標目錄的 tModel 文件的 UUID。內容名稱的 <id> 部分用來將特定索引鍵參照所要套用的檔案中之個別內容項目鏈結起來。<id> 可以是沒有包含可解譯為內容定界字元的任何字串。

您可以利用 UDDIPublish 來使用 <WS-install-dir>\wstools\eclipse\plugins\com.ibm.etools.webservice.was.creation.core_5.1.0\properties\speedstart.properties 這個內容檔, 作為 IBM® Speed Start 程式中,建立和分類公用 IBM 測試登錄中的商業和服務。以下說明這個檔案:

# Properties specific to IBM Speed Start

# URLs pointing to IBM test registry
wsdk.uddi.publish.url=https://uddi.ibm.com/testregistry/publishapi
wsdk.uddi.inquiry.url=http://uddi.ibm.com/testregistry/inquiryapi

# Added to category bags belonging to published services
wsdk.uddi.publish.bs.keyref.name.1=Web service information for the
developerWorks Web services community
wsdk.uddi.publish.bs.keyref.value.1=General
wsdk.uddi.publish.bs.keyref.tmodelkey.1=UUID:8F497C50-EB05-11D6-B618-000629DC0A53
wsdk.uddi.publish.bs.keyref.name.2=Web service information for the
developerWorks Speed Start community
wsdk.uddi.publish.bs.keyref.value.2=Speed Start
wsdk.uddi.publish.bs.keyref.tmodelkey.2=UUID:8F497C50-EB05-11D6-B618-000629DC0A53

# Added to category bags belonging to published business
wsdk.uddi.publish.be.keyref.name.1=Web service information for the
developerWorks Web services community
wsdk.uddi.publish.be.keyref.value.1=General
wsdk.uddi.publish.be.keyref.tmodelkey.1=UUID:8F497C50-EB05-11D6-B618-000629DC0A53
wsdk.uddi.publish.be.keyref.name.2=Web service information for the
developerWorks Speed Start community
wsdk.uddi.publish.be.keyref.value.2=Speed Start
wsdk.uddi.publish.be.keyref.tmodelkey.2=UUID:8F497C50-EB05-11D6-B618-000629DC0A53

您可以利用 UDDI Publish 來使用 <WS-install-dir>\wstools\eclipse\plugins\com.ibm.etools.webservice.was.creation.core_5.1.0\properties\testregistry.properties 這個內容檔,將您的商業和服務發佈在 IBM UDDI 第 2 版 Business Test Registry。同樣地,您也可以利用 <WS-install-dir>\wstools\eclipse\plugins\com.ibm.etools.webservice.was.creation.core_5.1.0\properties\businessregistry.properties 檔案來使用 IBM UDDI 第 2 版 Business Registry

使用條款 | 讀者意見
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.