速動畫教程第二十五集? 使用 xfire 開發 web service 應用
?
下載地址：
http://this.oksonic.cn
在這里請大家幫忙，有那位朋友使用過
xfire
開發客戶端的話，請與我聯系！
聯系方法見文章結尾處
?
制作工具：Eclipse3.2?? MyEclipse5.0m2?? Tomcat5.5.x
?
一、一個簡單的 web service
?
?? 新建一個 web service 工程，名稱為 xfire
?
?? 新建一個 java 文件，名稱為 Hello.java，內容如下：
-------------------------------------------------------------------------------------
package
com.test;
?
public
class
Hello {
?
???
public
String getName(String name){
??????
return
"Hello world "
+ name;
??? }
}
-------------------------------------------------------------------------------------
?
? 修改Web Services目錄下的 services.xml 文件，內容如下：
-------------------------------------------------------------------------------------
<
beans
xmlns
=
"http://xfire.codehaus.org/config/1.0"
>
???
<
service
>
??????
<
name
>
Hello
</
name
>
??????
<
namespace
>
http://www.oksonic.cn/xfire
</
namespace
>
??????
<
serviceClass
>
com.test.Hello
</
serviceClass
>
???
</
service
>
</
beans
>
-------------------------------------------------------------------------------------
?
<
name
>
Hello
</
name
>
?
服務名稱
?
<
serviceClass
>
com.test.Hello
</
serviceClass
>
?
服務類
?
?
現在可以部署項目，使用以下鏈接訪問：
?
http://localhost/xfire/services/Hello?wsdl
?
注：我的端口已經修改為80，如果沒有修改過的話請使用
http://localhost:8080/xfire/services/Hello?wsdl
?
? 網上原有的教程中提到可以使用 http://localhost/xfire/services/ 訪問，但測試時出現無法連接
?
? 頁面中出現 xml 文件內容表示服務正常
?
?
二、使用 jsr181 風格
?
---------------------
介紹 摘抄自 XFire 實戰? ------------------------
? JSR 181通過標準化一個易于學習且可以快速開發的Web服務簡單編程模型，從而刺激了對Web服務的采用。一直以來，J2EE開發人員要開發和部署Web服務就必須掌握相當多的信息。通過使用J2SE 5.0中的新增注釋功能，Java軟件源代碼可以使用JSR 181注釋進行注釋，從而聲明式地定義所需的Web服務行為。這使開發人員可以將注意力集中在Web服務的應用邏輯上而無需擔心復雜的API、協議和部署描述符。
?
BEA官方網站有一篇
“
web服務元數據簡介
”
,對理解JSR 181規范很有幫助。
?
這一節的例子和上一節的例子很相似，或者通過使用java注釋，比上一節的POJO稍微復雜了一點。不是說JSR 181節省了很多的配置信息嗎？鄙人認為可以從這個方面來理解，正常情況下，POJO如果配置到其他webservices框架下，比如axis2、Celtix、weblogic等容器中，必然需要編寫適合這些容器的配置文件，以便這些容器能夠識別這個POJO類是wenservices，并根據配置文件中的比如命名空間、參數類型、web服務的方法等信息提供web服務。而通過jsr 181規范中的定義可以自動識別這些信息，這樣這些信息不必在每個容器中所配置，這些容器通過java注釋就可以得到這些信息，所以說jsr181在這方面進行了簡化。XFire通過services.xml文件得到哪個類被定義為web服務， XFire可以通過java注釋來獲取web服務的相關信息。
-------------------------------------------------------------------------------------
?
? 修改 Hello.java 文件，內容如下：
-------------------------------------------------------------------------------------
package
com.test;
?
import
javax.jws.WebMethod;
import
javax.jws.WebParam;
import
javax.jws.WebResult;
import
javax.jws.WebService;
?
@WebService
(name=
"Hello"
,serviceName=
"Hello"
,
?????? targetNamespace=
"http://www.oksonic.cn/xfire"
)
public
class
Hello {
?
???
@WebMethod
???
@WebResult
???
public
String getName(
@WebParam
String name){
??????
return
"Hello world "
+ name;
??? }
}
-------------------------------------------------------------------------------------
?
? 修改 services.xml 文件，內容如下：
-------------------------------------------------------------------------------------
<
beans
xmlns
=
"http://xfire.codehaus.org/config/1.0"
>
???
<
service
>
??????
<
serviceClass
>
com.test.Hello
</
serviceClass
>
??????
<
serviceFactory
>
jsr181
</
serviceFactory
>
???
</
service
>
</
beans
>
-------------------------------------------------------------------------------------
?
? 啟動服務，現次測試，沒什么變化，服務正常
?
三、對 xfire 進行單元測試
?
---------------------
介紹 摘抄自 XFire 實戰? ------------------------
? 你不必發布到 tomcat 等容器中就可以進行測試，常用的測試類常繼承 AbstractXFireTest 抽像類。
AbstractXFireSpringTest 類又實現了 AbstractXFireTest 類，AbstractXFireTest 類是 TestCase
的子類，所以你可以使用 junit 進行單元測試。
------------------------------------------------------------------------------
?
? 新建一個 JUnit case ，這是為了讓 IDE 自動增加 JUnit 相關的類庫
?
? 新建一個 java 文件，名稱為 HelloTest.java，此類繼承 AbstractXFireSpringTest，
實現一個 createContest 方法，內容如下：
------------------------------------------------------------------------------
package
test.com.test;
?
import
org.apache.xbean.spring.context.ClassPathXmlApplicationContext;
import
org.codehaus.xfire.spring.AbstractXFireSpringTest;
import
org.jdom.Document;
import
org.springframework.context.ApplicationContext;
?
public
class
HelloTest
extends
AbstractXFireSpringTest {
?
???
@Override
???
protected
ApplicationContext createContext() {
??????
return
new
ClassPathXmlApplicationContext(
new
String[] {
?????????????
"/org/codehaus/xfire/spring/xfire.xml"
,
?????????????
"/META-INF/xfire/services.xml"
});
?
??? }
???
???
public
void
testService()
throws
Exception
?
??? {
??????? Document wsdl = getWSDLDocument(
"Hello"
);
??????? printNode(wsdl);
??? }
?
}
------------------------------------------------------------------------------
? 為了讓
createContext
方法可以找到
services.xml
文件，需要把
Web Services
目錄下的
services.xml
拷貝到
src/
META-INF/xfire
目錄下
?
? 不用啟動 tomcat 直接在 HelloTest.java 文件上點擊鼠標右鍵 Run as --> Junit ... 進行測試，結果顯示綠色條，通過測試！
? 關于其它的測試方法請查看《XFire實戰.pdf》
?
四、和 Spring 集成
?
? 新建一個 service 層接口 IHelloService，內容如下：
------------------------------------------------------------------------------
package
com.test.services;
?
public
interface
IHelloService {
?
???
public
String getName(String name);
???
}
------------------------------------------------------------------------------
?
? 創建接口的實現 HelloService,內容如下：
------------------------------------------------------------------------------
package
com.test.services.impl;
?
import
com.test.services.IHelloService;
?
public
class
HelloService
implements
IHelloService {
?
???
public
String getName(String name) {
??????
return
"Hello World "
+ name;
??? }
?
}
------------------------------------------------------------------------------
?
?
添加
spirng
框架，設置將
applicationContext.xml
文件創建到 WEB-INF 目錄下
?
? 修改
applicationContext.xml
文件，內容如下：
------------------------------------------------------------------------------
<?
xml
version
=
"1.0"
encoding
=
"UTF-8"
?>
<!
DOCTYPE
beans
PUBLIC
"-//SPRING//DTD BEAN//EN"
"http://www.springframework.org/dtd/spring-beans.dtd"
>
?
<
beans
>
???
<
bean
id
=
"
helloBean
"
class
=
"com.test.services.impl.HelloService"
/>
</
beans
>
------------------------------------------------------------------------------
?
? 在 WEB-INF 目錄下新建
xfire
-servlet.xml
文件，文件內容如下：
------------------------------------------------------------------------------
<?
xml
version
=
"1.0"
encoding
=
"UTF-8"
?>
<!
DOCTYPE
beans
PUBLIC
"-//SPRING//DTD BEAN//EN"
"http://www.springframework.org/dtd/spring-beans.dtd"
>
<
beans
>
???
<
bean
??????
class
=
"org.springframework.web.servlet.handler.SimpleUrlHandlerMapping"
>
??????
<
property
name
=
"urlMap"
>
??????????
<
map
>
?????????????
<!--
配置
service
名稱和
Service Bean -->
?????????????
<
entry
key
=
"/Hello"
>
?????????????????
<
ref
bean
=
"
hello
"
/>
?????????????
</
entry
>
??????????
</
map
>
??????
</
property
>
???
</
bean
>
???
<
bean
id
=
"
hello
"
??????
class
=
"org.codehaus.xfire.spring.remoting.XFireExporter"
>
??????
<
property
name
=
"serviceFactory"
>
??????????
<
ref
bean
=
"xfire.serviceFactory"
/>
??????
</
property
>
??????
<
property
name
=
"xfire"
>
??????????
<
ref
bean
=
"xfire"
/>
??????
</
property
>
??????
<
property
name
=
"serviceBean"
>
??????????
<
ref
bean
=
"
helloBean
"
/>
??????
</
property
>
??????
<
property
name
=
"serviceClass"
>
??????????
<
value
>
com.test.services.IHelloService
</
value
>
??????
</
property
>
???
</
bean
>
</
beans
>
------------------------------------------------------------------------------
? 注意：紅色字體部份必需一r致，深紅色字體部份要和 spring 的配置文件部份一致
?
? 修改 web.xml 文件，增加 spring 配置部份，修改 xfire 的名稱
------------------------------------------------------------------------------
<?
xml
version
=
"1.0"
encoding
=
"UTF-8"
?>
<
web-app
xmlns
=
"http://java.sun.com/xml/ns/j2ee"
???
xmlns:xsi
=
"http://www.w3.org/2001/XMLSchema-instance"
version
=
"2.4"
???
xsi:schemaLocation
=
"http://java.sun.com/xml/ns/j2ee?? http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
>
???
<
context-param
>
??????
<
param-name
>
contextConfigLocation
</
param-name
>
??????
<
param-value
>
?????????? /WEB-INF/applicationContext.xml
??????????
classpath:org/codehaus/xfire/spring/xfire.xml
??????
</
param-value
>
???
</
context-param
>
???
<
listener
>
??????
<
listener-class
>
?????????? org.springframework.web.context.ContextLoaderListener
??????
</
listener-class
>
???
</
listener
>
???
<
servlet
>
??????
<
servlet-name
>
xfire
</
servlet-name
>
??????
<
servlet-class
>
??????????
org.springframework.web.servlet.DispatcherServlet
??????
</
servlet-class
>
??????
<
load-on-startup
>
0
</
load-on-startup
>
???
</
servlet
>
???
<
servlet-mapping
>
??????
<
servlet-name
>
xfire
</
servlet-name
>
??????
<
url-pattern
>
/services/*
</
url-pattern
>
???
</
servlet-mapping
>
</
web-app
>
------------------------------------------------------------------------------
?
注：紅色字體部份為新重點關注部份
?
? 重啟服務，進行測試！！！
?
? 一切正常，現在用一個web service測試工具進行一下測試
?
?
本集就到這里了！！！
?
為了制作更多更好的錄像教程，希望大家多多提供相關資料！！！
聯系方法：
? http://www.oksonic.cn
? Email: oksonic@tom.com
? QQ: 71279650
