映射集合（Mapping collections）

XFire開發時，在返回數據類型時遇到了一些麻煩，查到這樣一篇文單，非常不錯，故收藏之。

翻譯： zilong3927 原文地址： http://docs.codehaus.org/display/XFIRE/Mapping+collections

調用 Web Services 時，經常需要返回集合（ collection ）作爲結果，或者接受 collection 型的參數。 SOAP 本身就支持這一點。

但是這一機制的問題在於， java 語言的 collections 是無類型的（ untyped ） . 因此，如果要在 Java 1.4 當中支持 collections ，就需要做一些額外的工作。

Java 5 & 範型（ Generics ）

首先而且是推薦的做法是在 JDK5 當中使用範型（ generics ）。範型能夠使你在代碼當中爲你的 collections 指定類型信息，從而允許 xfire 自動地推導出 collection 類型，生成正確的 wsdl 等等。

下面示例瞭如何寫這樣的一個方法：

Java 1.4 & 集合（ Collections ）

有些情況下並不總能夠使用範型（ generics ） . 例如，如果你的部署環境使用 JDK 1.4 ，或者你想暴露一些遺留的服務，而同時又不打算修改任何代碼也不打算進行移植。

對於這樣的一些情況而言，你需要生成一個 xml 映射文件，來指定方法和它們對應的集合類型（ collection types ） .

這個 xml 文件的名字必須是 <className>.aegis.xml ，其中 className 是你的服務（ service ）的接口類（ unqualified class ）的名字。

下面最好通過一個例子來展示這個 xml 文件的格式。我們想要展現的服務有這樣的一個接口 :

既然代碼中的 collections 沒有指定類型，我們劇需要生成一個 xml 文件來指定所需要的類型。這個文件的路徑應該和 MyService1.class 在同一個包（ package ）當中，並且它的名字應該是 MyService1.aegis.xml

對於這個接口來說，一個最簡單的映射文件如下 :

注意這個映射文件確切地指定了所需要的信息，不包含任何冗餘。例如， getFoo 方法沒有被指定，這是由於它沒有包含任何 collections ，因此能夠在沒有任何映射信息的情況下暴露給使用者。

其次， setCollection 方法沒有指定索引爲 0 的參數。這是由於該參數類型爲 int ，因此不需要任何映射

如果我們有多個方法，都匹配指定的映射又該怎麼辦 ? 這種情況下，映射就對所有匹配的方法均有效。

所以，如果在我們的接口中增加以下的方法：

那麼現在我們的映射定義對於兩個 setList 方法都有作用。這種情況下，我們不必爲額外的參數（譯者注：此處指 boolean persist ）指定兩次映射 . 映射文件就指定了所有那些第二個參數爲 List 的方法，並假定 List 中包含的都是 strings 。

如果我們想讓那個具有 3 個參數的方法，其中的 list 不包含 Strings ，而是實際上包含 Dates? 這種情況下，就需要一個更確切的映射來覆蓋（ override ）原先那個更一般的，所以我們的映射文件需要添加下面這個定義 :

注意一下類型屬性。現在這個映射將對所有那些第二個參數爲 List ，第三個參數爲 boolean 型的方法適用。在我們的接口當中，這個映射唯一地確定了一個特定的方法，使用這個映射就能夠解釋方法當中的 List 參數。

在優先順序方面，更確切的映射總是優先於更一般的。

讓我們考慮下面這個複雜一些的例子 :

映射文件的內容爲 :

這個文件的格式是不需要做過多解釋的。但有幾點還是需要加以說明。

先來看一下第一個映射 (mapping 1) 。這個映射指定了所有 getCollection 方法所返回的 collections contain 均包含 java.lang.Doubles 。如果沒有指定其他的 getCollection 映射，那麼這個映射將對方法 1 ， 2 ， 3 都適用。

但是，第二個映射更加明確地指定了它所適用的方法。即如果 getCollection 方法的第一個參數是 int 型，那麼該方法所返回的 collection 包含的是 Float 型。由於這條規則更加明確，它將爲方法 2 覆蓋掉第一個映射，這是滿足映射約束標準的。

使用以上的規則，不難推導出方法 4 和方法 5 返回的 collections 結果的組件類型（ component types ）。

Collections on Javabeans

對於使用 collections 的 java beans 來說，語法也是類似的。例如，比方說我們有一個 Company bean ，包含了一個 List ，其中的對象是 employees:

除了可以使用 <method> & <parameter> 元素外，也可以使用 <property> 元素 :

Handling Maps

Java Maps 並不能很好地映射到 XML Schema (no pun intended) ，因爲 XML Schema 中沒有 Map 的概念，客戶端也是這樣， Maps 被轉換成 {key ， value} 元組的集合。除了要提供 value 的類型以外，你還必須爲 Aegis 提供 key 的類型 :

映射文件應該像下面這樣 :

這將生成下面的類型 :

<xsd:complexType name=  "NiceChild2PresentMap"  >
  <xsd:sequence>
    <xsd:element name= "entry" minOccurs= "0" maxOccurs= "unbounded" >
      <xsd:complexType>
        <xsd:sequence>
          <xsd:element name= "key" type= "ns1:NiceChild" minOccurs= "0" maxOccurs= "1" />
          <xsd:element name= "value" type= "ns1:Present" minOccurs= "0" maxOccurs= "1" />
        </xsd:sequence>
      </xsd:complexType>
    </xsd:element>
  </xsd:sequence>
</xsd:complexType>

Collections of Collections of Collections of....

在某些情況下，你可能想要傳遞 Collections of Collections 。比方說你有一個返回 List of a List of Doubles 的服務 ( 不要問爲什麼你要做這樣一件事情 ...):

要處理這種情況，我們需要引進一個新的 <component> 元素。下面是一個很好的例子 :

正像你在這裏所看到的，返回類型的 componentType 是一個指向 <component> 的引用，而不是一個類。組件類型 "#someDoubles" 引用到名字爲 "someDoubles" 的 <component> 。

Aegis 將會自動給這些 collections 命名爲 ArrayOfDouble 和 ArrayOfArrayOfDouble 。你也可以改變這些名字。要設置你自己的名字，提供一個 "typeName" 屬性即可 :

public class ListService
{
  public List getListOfListOfDoubles
  {
    List l = new ArrayList();
    List doubles = new ArrayList();
    doubles.add( new Double (1.0));
    l.add(doubles);
    return l;
  }
}

public class GiftService {
Map getGiftList() { /* returns a map of NiceChild => Present */ }
}

public class Company
{
    private Collection employees;
    Collection getEmployees() { return employees; }
    public void setEmployees(Collection employees) { this .employees = employees };
}

public    interface   MyService2
{
    Collection getCollection(); //method 1
    Collection getCollection( int id); //method 2
    Collection getCollection( String id); //method 3
    Collection getCollectionForValues( int value ， Collection c); //method 4
    Collection getCollectionForValues( String id ， Collection c); //method 5
}

void setList(int id ，java.util.List，boolean persist);

public interface MyService1{
    String getFoo();
    Collection getCollection();
    void setList( int id ， java.util.List);
}

public Collection< String > getValuesForIds(Collection< Integer >);

映射集合（Mapping collections）

24-5-18 X

Hibernate!

嵌入式開發前景

JAVA對數字證書的常用操作

""

Struts2.1.6+Spring2.5.6+Hibernate3.3.1全註解實例詳解（五）

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結