㈠ 如何編寫.service文件
本Guide利用Eclipse以及Ant建立一個簡單的Web Service,以演示Web Service的基本開發過程:
1.系統條件:
Eclipse java EE IDE for Web Developers
Java SE 6
Windows XP
2.基本環境搭建:
1)Java SE6 JDK的安裝:下載Java SE6 JDK,雙擊,安裝默認選項進行安裝即可。
2)Eclipse的安裝與配置:
安裝時直接解壓。
配置處有兩點,Window>Preferences>Java>Installed JREs確保如下設置:
安裝路徑可能略有不同。
Window>Preferences>Java>Compiler 確保如下設置:
3.建立Server端工程和相關包與類:
創建一個Java Project,命名為wsServerHelloWorld:
在這個項目下建立包:org.gnuhpc.wsServer
在這個包下邊建立類:SayHello
在SayHello.java文件中輸入以下代碼:
package org.gnuhpc.wsServer;
import javax.jws.WebService;
@WebService
public class SayHello {
private static final String SALUTATION = "Hello";
public String getGreeting(String name) {
return SALUTATION + " " + name;
}
}
其中注意到@WebService ,這個稱作annotation或者metadata,Java SE 5中的Web Services Metadata Specification引入的。Java SE 6中對於Web Services規范的升級以及JAX-WS(Java API for XML Web Services)2.0規范,這些升級使得我們Web Services的創建和調用變得更加容易。使用這些新功能,我們可以僅僅使用簡單的Annotations注釋從一個Java類創建Web Services。開發者將其類和方法之前用該annotations指定,類告訴runtime engine以Web Service的方式和操作來使能該類和方法。這個annotations可以產生一個可布署的Web Service,是一個WSDL映射annotations,將Java源代碼與代表Web Service的WSDL元素連接在了一起。
4.使用Ant產生Server端代碼:
首先在項目中新建一個文件:build.xml,然後使用OpenWith>AntEditor打開,輸入以下腳本代碼:
<project default="wsgen">
<target name="wsgen">
<exec executable="wsgen">
<arg line="-cp ./bin -keep -s ./src -d ./bin
org.gnuhpc.wsServer.SayHello"/>
</exec>
</target>
</project>
default指定了默認執行的Target為wsgen,wsgen可以創建一個能夠使用WebService的類,它生成所有用於WebService發布的源代碼文件和經過編譯過的二進制類文件。它還生成WSDL和符合規范的該類的WebService。
Target名稱為wsgen,具體執行的命令的參數:
-cp 為類路徑
-keep後產生的java文件
-s 產生的源文件放在哪
-d 產生的輸出問價放在哪
然後使用Ant Build選項運行:
在成功執行的提示後,我們刷新一下Project
我們在Project區域可以看到,結果如下:
5.分布Web Service
org.gnuhpc.wsServer下建立一個類RunService:
package org.gnuhpc.wsServer;
import javax.xml.ws.Endpoint;
public class RunService {
/**
*@paramargs
*/
public static void main(String[] args) {
System.out.println("SayHello Web Service started.");
Endpoint.publish("http:// localhost:8080/wsServerExample" ,
new SayHello());
}
}
運行Run As>Java Application。我們得到結果,說明這個web service的Server端已經啟動。