Spring與Xfire結合發佈WebService

Web服務的發佈者首先必須提供一個WSDL文件，即Web Services Description Language（Web服務描述語言），這個XML文件定義了調用Web服務的所有信息，包括所有的方法名稱、參數類型、返回類型和數據類型的映射等。 Web服務的調用者只要獲得了該WSDL文件，就可以根據WSDL文件通過相應的工具（比如XFire的WsGen）生成客戶端支持類，因此，無論服務端以任何技術實現該Web服務，客戶端都可以用任何編程語言來調用它。

JavaEE平臺從1.3版本開始就完整地支持Web服務，包括調用和發佈Web服務兩部分。爲了讓Java應用程序獲得訪問和發佈Web服務的能力，SUN定義了一系列相關的API標準，包括SAAJ、JAXB、JAX-RPC和最新的JAX- WS。

SAAJ(SOAP with Attachments API for Java)已經完整地實現了SOAP協議，可以直接使用SAAJ實現Web服務的底層傳輸。JAXB(Java Architecture for XML Binding)則實現了XML數據到Java類的綁定，通常我們不直接使用這兩個API，而是調用高層的JAX-RPC(Java API for XML-Based RPC)和JAX-WS(Java API for XML-Based Web Services)。JAX-WS是JavaEE最新的Web服務標準，不過仍向下兼容JAX-RPC。

SAAJ(SOAP with Attachments API for Java)
JAXB(Java Architecture for XML Binding)
JAX-RPC(Java API for XML-Based RPC)
JAX-WS(Java API for XML-Based Web Services)

爲了在Java中實現Web服務，還必須獲得一個具體的實現。Axis和XFire都是實現了完整的Web服務協議的庫，可以用於訪問和發佈Web服務。

相比其他的Web服務引擎，XFire在實現Web服務上有巨大的配置和性能優勢，因此，XFire應當作爲JavaEE環境下發布Web服務的首選。

Spring框架的另一個子項目Spring Web Services的目標就是提供一個與Spring緊密結合的Web服務模塊，並與Spring的MVC框架集成，這個項目可以作爲Spring框架下發布Web服務的又一個選擇。不過，Spring Web Services項目目前仍處於開發階段，尚未有穩定版本發佈。現在，Java 6已經正式發佈了。Java 6的一個重大特性就是對Web服務的內在支持，發佈和訪問
Web服務都將變得輕而易舉。如果採用Java 6的的Web服務器，那麼不必使用任何第三方Web服務的支持庫，就可以直接將Web服務完美地集成進來。不過，Java 6從正式發佈到各Web服務器對其支持尚需一段較長的時間，目前，在服務器端發佈Web服務的最佳選擇仍是XFire。

[b]
XFire發佈WebService[/b]

public interface BookService {
  Book[] search(String keyword);
}

public class BookServiceImpl implements BookService {
  public Book[] search(String keyword) {
    if ("j2ee".equalsIgnoreCase(keyword)) {
      return new Book[] { new Book("Core J2EE Patterns", "Dan Malks"),
          new Book("The J2EE Tutorial", "Bode Carson"),
          new Book("J2EE Design Patterns", "William Crawford"),
          new Book("J2EE Platform Web Services", "Ray Lai") };
    }
    return new Book[0];
  }
}

public class Book {
  private String name;
  private String author;
  public Book() {
  }
  public Book(String name, String author) {
    this.name = name;
    this.author = author;
  }
  public String getName() {
    return name;
  }
  public void setName(String name) {
    this.name = name;
  }
  public String getAuthor() {
    return author;
  }
  public void setAuthor(String author) {
    this.author = author;
  }
}

編寫XFire必須的Web服務描述文件services.xml
該文件必須放到META-INF/xfire/ 目錄下

<beans>
  <service xmlns="http://xfire.codehaus.org/config/1.0">
    <name>BookService</name>
    <namespace>http://www.livebookstore.net/BookService</namespace>
    <serviceClass>example.chapter8.BookService</serviceClass>
    <implementationClass>example.chapter8.BookServiceImpl</implementationClass>
  </service>
</beans>

最後，在web.xml中加入

<web-app>
  <servlet>
    <servlet-name>XFireServlet</servlet-name>
    <servlet-class>
      org.codehaus.xfire.transport.http.XFireConfigurableServlet
        </servlet-class>
    <load-on-startup>0</load-on-startup>
  </servlet>

  <servlet-mapping>
    <servlet-name>XFireServlet</servlet-name>
    <url-pattern>/servlet/XFireServlet/*</url-pattern>
  </servlet-mapping>

  <servlet-mapping>
    <servlet-name>XFireServlet</servlet-name>
    <url-pattern>/services/*</url-pattern>
  </servlet-mapping>
</web-app>

啓動服務器，瀏覽器中輸入 http://localhost:8080/services/BookService?wsdl
就能看到BookService Web服務的WSDL描述文檔


[b]在Spring中集成XFire[/b]
刪除META-INF/xfire/ 目錄，相關信息在Spring的 dispatcher-servlet.xml中定義

使用JSR 181 Web服務註解來標註Web服務

@WebService(
    name="BookService",
    serviceName="BookService",
    targetNamespace="http://www.livebookstore.net/BookService"
)
public class BookServiceImpl implements BookService {
  @WebMethod
  @WebResult
  public Book[] search(@WebParam String keyword) {
    if("j2ee".equalsIgnoreCase(keyword)) {
      return new Book[] {
        new Book("Core J2EE Patterns", "Dan Malks"),
        new Book("The J2EE Tutorial", "Bode Carson"),
        new Book("J2EE Design Patterns", "William Crawford"),
        new Book("J2EE Platform Web Services", "Ray Lai")
      };
    }
    return new Book[0];
  }
}

和普通Spring Web程序一樣，在web.xml中聲明Dispatcher Servlet

<web-app>
  <servlet>
    <servlet-name>dispatcher</servlet-name>
    <servlet-class>
      org.springframework.web.servlet.DispatcherServlet
        </servlet-class>
    <load-on-startup>0</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>dispatcher</servlet-name>
    <url-pattern>/*</url-pattern>
  </servlet-mapping>
</web-app>

在dispatcher-servlet.xml中

  <!-- 引用XFire預定義的Bean配置 -->
  <import resource="classpath:org/codehaus/xfire/spring/xfire.xml" />
  <!-- Web服務實現類 -->
  <bean id="bookService" class="example.chapter8.BookServiceImpl" />
  <!-- 定義URL映射 -->
  <bean class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
    <property name="urlMap">
      <map>
        <entry key="/BookService" value="bookExporter" />
      </map>
    </property>
  </bean>
  <!-- bookExporter將處理來自客戶端的調用 -->
  <bean id="bookExporter" 
    class="org.codehaus.xfire.spring.remoting.XFireExporter">
    <!-- 對外提供的Web服務的接口 -->
    <property name="serviceClass" value="example.chapter8.BookService" />
    <!-- 實現Web服務的Bean -->
    <property name="serviceBean" ref="bookService" />
    <!-- 下面引用的Bean都已被import引入了 -->
    <property name="serviceFactory" ref="xfire.serviceFactory" />
    <property name="xfire" ref="xfire" />
  </bean>

注意，這個XML配置文件必須首先通過<import>引入XFire的一些預定義的Bean，
這樣就可以直接使用XFireExporter來處理Web服務請求。

此時我們訪問WSDL文件的路徑爲 http://localhost:8080/BookService?wsdl