JAX-WS集成Web工程的Web Service的創建和發佈簡單入門(1)

 

      首先, 爲了我們這個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了。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章