MyEclipse Blue Edition 6.1中使用的Eclipse Platform為3.3.2。因此本人下載了多個Eclipse 3.3.2版本的STP插件進行測試。最后發(fā)現(xiàn)STP R200710161054版可以和MyEclipse Blue Edition 6.1版完美集成。
具體安裝其實超簡單,將下載的ZIP包解壓到MyEclipse安裝目錄下的myeclipse目錄中。此處需要特別小心,注意:eclipse,feature和plugins目錄可以覆蓋;但是feature和plugins中的同名目錄不能覆蓋。
此外,由于STP插件中的文件的目錄和文件名比較長,解壓后可能會發(fā)生超過系統(tǒng)目錄文件長度的錯誤。解決方法是將MyEclipse安裝到磁盤根目錄下的一個短名稱的目錄中,比如C:\Blue等。
啟動MyEclipse Blue Edition 6.1。選擇菜單Window->Preferences,在對話框左側(cè)的SOA Tools分支下,可以進行STP插件的設置。
1. 添加CXF Runtime
瀏覽至apache-cxf-2.0.5-incubator的解壓目錄,點擊Finish。注意此處的JRE是插件運行的JRE,最好選擇Sun的JRE1.5(我選IBM JRE的時候插件出錯)。
2. 其他設置
選中JAX-WS,選擇使用向?qū)В?/div>
設定生成WSDL文件的Soap協(xié)議版本;
點擊OK,完成插件的設置。
二、開發(fā)WebService
使用CXF開發(fā)WebService有兩種模式:從Java接口開始;從WSDL文件開始。
這里介紹從Java接口開始開發(fā)(從WSDL文件開始開發(fā)的方法,看完本文自然可以領悟了。)
1. 新建項目
選擇菜單File->New->Project...,選擇SOA Tools下的JAX-WS Java First Project;
輸入項目名稱,JavaFirst;
選擇Runtime;
點擊Finish即可建立項目。
新建的項目最好手動建一個lib目錄,然后將所有的cxf庫文件都拷貝進來,然后刪除項目build path中由向?qū)砑拥膸?,自己手動將lib中的庫添加進項目的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后的代碼如下:
此時,需要對wsdl文件進行編輯。需要修改的地方有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://<服務器URL>:<服務器端口>/<項目名>
<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ā)布到應用服務器,即可。
這里所謂context root在WAS中就是發(fā)布WAR包時的上下文根,在tomcat中默認就是項目名。
因此,可以將wsdl文件中的地址和端口做相應的改動,注意修改了此處,如果用生成的Client來測試的話,Client中的相應地址也要改為和此處一致。
<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ā)布成功。
發(fā)表于 @ 2008年04月22日
(#)