最近項目中需要用到CXF,但是本人使用的MyEclipse Blue Edition
6.1居然沒有集成CXF的支持。因此抽時間研究了下將Eclipse SOA Tools Platform插件集成到其中。
MyEclipse Blue Edition 6.1中使用的Eclipse
Platform為3.3.2。因此本人下載了多個Eclipse 3.3.2版本的STP插件進(jìn)行測試。最后發(fā)現(xiàn)STP
R200710161054版可以和MyEclipse Blue Edition 6.1版完美集成。
此處可以下載STP
R200710161054 all in one版。
具體安裝其實超簡單,將下載的ZIP包解壓到MyEclipse安裝目錄下的myeclipse目錄中。此處需要特別小心,注
意:eclipse,feature和plugins目錄可以覆蓋;但是feature和plugins中的同名目錄不能覆蓋。
此外,由于STP插件中的文件的目錄和文件名比較長,解壓后可能會發(fā)生超過系統(tǒng)目錄文件長度的錯誤。解決方法是將MyEclipse安裝到磁盤根目錄下的
一個短名稱的目錄中,比如C:"Blue等。
這次來講下如何利用該工具快速開發(fā)一個簡單的WebService。
本文中使用的CXF為apache-cxf-2.0.5-incubator。
一、對STP插件進(jìn)行設(shè)置:
啟動MyEclipse Blue Edition 6.1。選擇菜單Window->Preferences,
在對話框左側(cè)的SOA Tools分支下,可以進(jìn)行STP插件的設(shè)置。
1. 添加CXF Runtime
選中分支中的Installed Runtimes,點擊Add;

選擇Apache CXF 2.0,然后Next;

瀏覽至apache-cxf-2.0.5-incubator的解壓目錄,點擊Finish。注意此處的JRE是插件運(yùn)行的JRE,最好選擇Sun的
JRE1.5(我選IBM JRE的時候插件出錯)。

2. 其他設(shè)置
選中JAX-WS,選擇使用向?qū)В?/p>

設(shè)定生成WSDL文件的Soap協(xié)議版本;


點擊OK,完成插件的設(shè)置。
二、開發(fā)WebService
使用CXF開發(fā)WebService有兩種模式:從Java接口開始;從WSDL文件開始。
這里介紹從Java接口開始開發(fā)(從WSDL文件開始開發(fā)的方法,看完本文自然可以領(lǐng)悟了。)
1. 新建項目
選擇菜單File->New->Project...,選
擇SOA Tools下的JAX-WS Java First Project;

輸入項目名稱,JavaFirst;

選擇Runtime;

點擊Finish即可建立項目。
新建的項目最好手動建一個lib目錄,然后將所有的cxf庫文件都拷貝進(jìn)來,然后刪除項目build
path中由向?qū)砑拥膸?,自己手動將lib中的庫添加進(jìn)項目的build path中。此外,JRE最好也換一下。
2. 創(chuàng)建包
選擇菜單File->New->Package,創(chuàng)建一個叫com.javafirst.pk的包。
3. 創(chuàng)建接口
在剛剛創(chuàng)建的包下面,通過File->New->Interface,創(chuàng)建一個叫Hello的接口。
接口中代碼如下:

public interface Hello {
public String echo(String msg);
}
4. 添加WebService annotation
在Package
Explorer中,選中剛剛定義的接口,通過菜單SOA->JAX-WS->Create Web Service來添加;
或者右鍵點擊接口,在右鍵菜單中的JAX-WS Tools->Create Web
Service來添加。

保留向?qū)У娜笔?shù),生成WebService Annotaion。

添加annotation后的代碼如下:
@WebService(targetNamespace="http://pk.javafirst.com/", name="Hello")

public interface Hello {
public String echo(String msg);
}
5. Save(此處需要預(yù)先選擇Project->Build
Automaticly)之后,插件會自動生成wsdl文件和一堆垃圾src。

此時,需要對wsdl文件進(jìn)行編輯。需要修改的地方有3處:
a. 為了便于發(fā)布以及便于編程人員理解,下面代碼中的arg0可以修改為接口中定義的msg;注意,一旦修改,則不能
通過后面生成的Client來測試了 。
<xs:complexType name="echo">
<xs:sequence>
<xs:element minOccurs="0" name="arg0" type="xs:string" />
</xs:sequence>
</xs:complexType>
<xs:complexType name="echo">
<xs:sequence>
<xs:element minOccurs="0" name="msg" type="xs:string" />
</xs:sequence>
</xs:complexType>
b. 為了兼容.net需要將parameters等替換。
<wsdl:message name="echoResponse">
<wsdl:part name="parameters" element="tns:echoResponse">
</wsdl:part>
</wsdl:message>
<wsdl:message name="echo">
<wsdl:part name="parameters" element="tns:echo"></wsdl:part>
</wsdl:message>
<wsdl:message name="echoResponse">
<wsdl:part name="echoOutput" element="tns:echoResponse">
</wsdl:part>
</wsdl:message>
<wsdl:message name="echo">
<wsdl:part name="echoInput" element="tns:echo"></wsdl:part>
</wsdl:message>
c. wsdl發(fā)布的端口
修改格式為 http://<服務(wù)器URL>:<服務(wù)器端口>/<項目名>
<wsdl:service name="HelloService">
<wsdl:port name="HelloPort" binding="tns:HelloServiceSoapBinding">
<soap12:address location="http://localhost:9090/hello" />
</wsdl:port>
</wsdl:service>
<wsdl:service name="HelloService">
<wsdl:port name="HelloPort" binding="tns:HelloServiceSoapBinding">
<soap12:address location="http://localhost:8088/JavaFirst" />
</wsdl:port>
</wsdl:service>
6. 刪除所有的垃圾src。

7. 右鍵點擊wsdl文件,通過JAX-WS Tools->Generate
Code生成新的接口和實現(xiàn)代碼。

其中的Client和Server是用于脫離容器測試WebService的,一般都選上。
最后生成的文件列表如圖所示:

8. 編輯HelloImpl.java文件
簡單的返回輸入值:

public class HelloImpl implements Hello {

private static final Logger LOG = Logger.getLogger(HelloImpl.class.getName());


/* (non-Javadoc)
* @see com.javafirst.pk.Hello#echo(java.lang.String msg )*
*/

public java.lang.String echo(java.lang.String msg) {
LOG.info("Executing operation echo");
System.out.println(msg);

try {
java.lang.String _return = msg;
return _return;

} catch (Exception ex) {
ex.printStackTrace();
throw new RuntimeException(ex);
}
}

}
9. 發(fā)布
右鍵點擊wsdl文件,選擇菜單Build Package...即可生成war包。
注意此war包中沒有包含任何的庫文件,因此需要手動打包(比如用winrar之類),將lib目錄添加到war包中的WEB-INF目錄下。
將此war包發(fā)布到應(yīng)用服務(wù)器,即可。
此時,發(fā)布的wsdl的端口是http://<server>:<port>/<context
root>/services/<項目名>
這里所謂context root在WAS中就是發(fā)布WAR包時的上下文根,在tomcat中默認(rèn)就是項目名。
因此,可以將wsdl文件中的地址和端口做相應(yīng)的改動,注意修改了此處,如果用生成的Client來測試的話,Client中的相應(yīng)地址也要改為和此處一
致。
<wsdl:service name="HelloService">
<wsdl:port name="HelloPort" binding="tns:HelloServiceSoapBinding">
<soap12:address location="http://localhost:8088/Hello/services/Hello" />
</wsdl:port>
</wsdl:service>
然后再重新打包,發(fā)布一次。
至此,一個簡單的WebSerive已經(jīng)發(fā)布成功。