首先, 爲了我們這個WS的實驗能夠順利的完成,最好能到官網上下載到JAX-WS工具的完整版。下載到的是一個jar文件,需要在Windows命令行下運行jar命令解壓安裝的,比如我這邊有個JAXWS2.1.1_20070501.jar。安裝後得到一個目錄,其中有個lib下有許多jar文件。bin目錄下有幾個命令,很有用的,如wsgen和wsimport等,當然,我提過,這兩個命令在JDK6中已經有的了。
現在開始做實驗了。
服務端
1、新建web項目,將來準備發佈到tomcat的。我這裏新建的Web項目名爲myWS2,目錄所在:D:\workspace\myWS2,在這個項目根目錄下新建一個文件夾wsdl
2、爲了方便,先導入這些個包吧:jaxws-rt.jar,jaxb-api.jar,jaxb-impl.jar,jaxb-xjc.jar,streambuffer.jar,stax-ex.jar,這些jar包只是運行下面的最簡單的實驗需要的jar包,實際操作中,如果你需要更多的jar包也是很正常的,這些jar包都是來自JAX-WS。
3、在Web工程中新建類:
package leon.ws;
import javax.jws.WebService;
@WebService
public class Hello {
public String sayHello(String name) {
return ("Welcome, I am Server. Hello, " + name);
}
public int sum(int a, int b) {
return a + b;
}
}
OK,非常簡單,只有一個@WebService註解,類中的兩個方法都沒有使用@WebMethod註解,這樣其實兩個方法都會成爲Web Service方法的。
4、很重要的一步,就是要利用wsgen工具來生成wsdl和服務端輔助類了。打開DOS命令行,進入到服務端web工程的根目錄,運行一下命令:
wsgen -cp D:\workspace\myWS2\WebRoot\WEB-INF\classes leon.ws.Hello -wsdl -s src -r wsdl
注意:這裏的路徑非常重要的,如果你的路徑不一樣一定要改對了。wsgen命令使用的是JDK6裏面的,所以要配置好JDK環境變量,如果你用的JDK版本低,沒有這工具,需要將下載安裝的JAX-WS的bin下面的工具配置到環境變量path下。
運行成功以後,刷新一下web工程目錄下wsdl目錄,可以看到兩個文件了,一個xsd和一個wsdl,刷新一下src看到產生了jaxws包和4個類,也就是上面的Hello.java中,每個方法對應生成兩個類。
5、在WEB-INF下新建一個sun-jaxws.xml,內容如下:
<?xml version="1.0" encoding="UTF-8"?>
<endpoints version="2.0" xmlns="http://java.sun.com/xml/ns/jax-ws/ri/runtime">
<endpoint name="Hello" implementation="leon.ws.Hello" url-pattern="/HelloService" />
</endpoints>
這是定義WS的Endpoint的,實現類與上面定義的Hello.java對應好,兩外兩個屬性name, url-pattern自己定義吧,不過最好合理一點。
6、修改web.xml配置一個監聽器,和一個Servlet將我們的Hello.java及其方法綁定成爲Servlet,內容如下:
<listener>
<listener-class>com.sun.xml.ws.transport.http.servlet.WSServletContextListener</listener-class>
</listener>
<servlet>
<servlet-name>Hello</servlet-name>
<servlet-class>com.sun.xml.ws.transport.http.servlet.WSServlet</servlet-class>
<load-on-startup>2</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>Hello</servlet-name>
<url-pattern>/HelloService</url-pattern>
</servlet-mapping>
現在工程的目錄結構如下:
發佈到tomcat,運行,這個服務端Web工程會被tomcat加載。
tomcat啓動成功後。瀏覽器訪問:http://10.225.112.86:8888/myWS2/HelloService?wsdl
如果瀏覽器呈現出wsdl文件內容,就表示發佈成功了。服務端完成。
說明:我這裏的tomcat是在本機的局域網IP上啓動的,所以訪問的地址也是IP來的,如果你的使用localhost也是可以的,沒問題。
客戶端:
服務端的代碼如何組織創建,可以參考我的另一篇文章:“JAX-WS一個很簡單的RPC風格的Web Service同步調用”
因爲我們已經能訪問到服務端的wsdl文件,所以客戶端就可以有各種途徑來訪問服務端WS了。