包包的雲端語意小說

UDDI

為了處理這些關係，還增加了兩種新的 UDDI 構件︰發布者聲明和服務投影。發布者聲明是由企業的發布者作出的表明兩個企業之間存在關係的聲明。當每個發布者都聲明了同樣的關係之后，就建立了兩個企業之間的關係。當 UDDI 註冊中心收到一個聲明時，它將關係置於未決狀態。當收到來自另一個企業的發布者的匹配的聲明之后，它們就建立了企業關係。共定義了三種類型的關係。父子關係描述分級關聯，如子公司或部門。對等關係代表兩個企業都不被認定為父企業的關聯。等同關係表明兩個企業實體都代表相同的企業，這類似于創建企業的一個別名。 

一旦兩個企業之間建立了關係，其中一個企業中定義的服務就可以被另一個企業引用。當其中一個企業中出現另一個企業的服務時，這就是所謂的服務投影。公用 UDDI v2 企業註冊中心目前還不支持服務投影。不久以後將增加這種支持。 

使用發布者聲明 
UDDI4J 在實現 API 時嚴格遵循 UDDI 規範。理解 UDDI4J 所需的最好的、唯一的參考就是UDDI 規範本身，您可以從 UDDI 組織站點（請參閱參考資料）獲得它。UDDI 版本 2 規範的附錄 J 中有關於如何使用企業關係的參考資料。 

下面幾個與企業關係有關的新的 API 已經在 UDDI 版本 2 中得到定義。這些 API 在UDDI4J 中是作為 UDDIProxy 類上的新方法表現的。 

RelatedBusinessesList find_relatedBusinesses (FindQualifiers findQualifiers, 
String businessKey 
KeyedReference keyedReference); 

DispositionReport add_publisherAssertions (String authInfo, 
PublisherAssertion publisherAssertion); 
DispositionReport add_publisherAssertions (String authInfo,Vector publisherAssertion); 

DispositionReport delete_publisherAssertions (String authInfo, 
PublisherAssertion publisherAssertion); 
DispositionReport delete_publisherAssertions (String authInfo,Vector publisherAssertion); 

AssertionStatusReport get_assertionStatusReport (String authInfo, 
CompletionStatus completionStatus); 
AssertionStatusReport get_assertionStatusReport (String authInfo, 
String completionStatus); 

PublisherAssertions get_publisherAssertions (String authInfo); 

PublisherAssertions set_publisherAssertions (String authInfo,Vector publisherAssertion); 
PublisherAssertions set_publisherAssertions (String authInfo,PublisherAssertion pub); 

下面的示例將說明第一個發布者如何創建發布者聲明。首先要創建一個用鍵值標識的引用來描述要建立的關係。鍵值表明要聲明的關係的類型。定義的值類型為對等、父子或等同類型，它們在 UDDI 數據架構規範中定義。在使用父子類型時，from key 代表父企業，to key 代表子企業。要創建發布者聲明，您需要兩個發布者，每一個發布者都有自己的註冊中心用戶標識。 

// Follows example in v2 spec appendix J 
KeyedReference kr = new KeyedReference("Holding Company", // Key name 
"parent-child", // Key value 
TModel.RELATIONSHIPS_TMODEL_KEY);// Tmodelkey 
PublisherAssertion pa = new PublisherAssertion(bk1, // from key 
bk2, // to key 
kr); // keyed reference 
// Add publisher assertion linking two businesses 
DispositionReport dr = proxy.add_publisherAssertions(token1.getAuthInfoString(),pa); 

當一個發布者添加聲明時，註冊中心將關係置為未決狀態，等待受到影響的企業附應，作出相同的聲明，表明雙方都同意該關係聲明。第二個發布者的回應是添加相同的聲明。一旦雙方都聲明了相同的關係，UDDI 註冊中心將創建它們的企業關係。下面的代碼片段中執行了一個查詢，尋找影響該發布者的未決聲明。來自聲明報告的企業鍵值用來重新創建最初與之匹配的聲明。 

// List available assertions (relationships) 
AssertionStatusReport asr = proxy.get_assertionStatusReport(token2.getAuthInfoString(), 
CompletionStatus.TOKEY_INCOMPLETE); 
Vector v = asr.getAssertionStatusItemVector(); 
for (int i = 0; i < v.size(); i++) { 
AssertionStatusItem asi = (AssertionStatusItem)v.elementAt(i); 
PublisherAssertion pa = new PublisherAssertion(asi.getFromKeyString(), 
asi.getToKeyString(), 
asi.getKeyedReference()); 
DispositionReport dr = proxy.add_publisherAssertions(pa); 
} 

使用服務投影 
請注意，在撰寫本文之時，公用 UDDI 企業註冊中心還不支持服務投影。下面的訊息供您將來參考。 

在下面的代碼片段中，第二個發布者創建一個服務投影。我們在相關的（第一個）企業上執行查詢，這個企業中包含要投影的服務。代碼將存儲 BusinessService 對象，在之后的save_business() 調用中被用來向第二個企業添加該服務作為投影。 

BusinessDetail bd1 = proxy.get_businessDetail(bk1); 
BusinessEntity be1 = (BusinessEntity)bd1.getBusinessEntityVector().elementAt(0); 
BusinessServices bss1 = be1.getBusinessServices(); 
BusinessService serviceProjection = bss1.get(0); // Desired service 

// Update a business and include the service projection 
BusinessDetail bd2 = proxy.get_businessDetail(bk2); 
BusinessEntity be2 = (BusinessEntity)bd2.getBusinessEntityVector().elementAt(0); 
BusinessServices bs = new BusinessServices(); 
bs.add(serviceProjection); 
be2.setBusinessServices(bs); 
Vector entities = new Vector(); 
entities.addElement(be2); 
proxy.save_business(token2.getAuthInfoString(),entities); 

您可以檢查服務，以確定它們是否為使用下面代碼的投影。在本示例中，您將檢索關於企業實體的訊息，包括其服務的列表。您可以檢查服務，以確定它們是否屬于企業本身還是屬于相關的企業。投影產生的服務會指定被投影的企業（而不是被查詢的企業）的 businesskey（企業鍵值）。 

// How to look at services and see if one is a service projection 
BusinessDetail bd = proxy.get_businessDetail("businessKey"); 
BusinessEntity be = (BusinessEntity)bd.getBusinessEntityVector().elementAt(0);
BusinessServices bss = be.getBusinessServices(); 
for (int i = 0; i < bss.size(); i++) { 
BusinessService bs = bss.get(i); 
String businessKey = bs.getBusinessKey(); 
if (!businessServiceKey.equals(businessKey)) { 
System.out.println("Service " + bs.getName() + " is a projection"); 
} 
} 

國際化 
我們還實現了若干描述性字元串，作為允許使用特定于語言的標識符的對象。UDDI 透過允許用戶指定這些對象的集合來處理國際化，每個對象中有一個值和語言標識符。如果提供的是一個單值，那么語言標識符缺省為創建發布者帳戶時註冊中心決定的語言，通常為英語。語言值是那些允許在 xml:lang 屬性中使用的值，在 RFC 1766 中指定。 

造成混淆的一個常見原因是錯誤地認為多個值將被連接起來，從而能夠使用更長的字元串。事實並非如此。提供的每個對象都只有唯一的語言。將一個以上的對象指定為相同（或沒有指定）語言標識符是錯誤的做法。UDDI4J 不會驗証這些值。UDDI 註冊中心將產生錯誤。 

加入了新的 NLS 功能，那就是向 Name 類增加了語言標識符。 

Name(string, language) 
UDDIProxy 上的 find_business 和 find_service 方法現下接受“Name”對象的集合，而不是只接受一個單值。 

自 UDDI 版本 1 出現就可以使用的 org.uddi4j.datatype.Description 類也有同樣的行為和使用情況。 

增強的查詢 
查詢操作得到了鞏固，這樣我們就能夠使用單獨的 find_business() 調用來根據DiscoveryURLs、IdentifierBag、CategoryBag 和 TmodelBag 進行搜索，而不必循環進行多個搜索。 

UDDIProxy 上的 find_business() 方法的新簽名是︰ 

BusinessList find_business (FindQualifiers findQualifiers, 
Vector names, 
DiscoveryURLs discoveryBag, 
IdentifierBag identifierBag, 
CategoryBag categoryBag, 
TmodelBag tModelBag 
Int maxRows); 

如 UDDI v2 規範的文檔所示，還增加了另外的 findQualifier。