Java建立WebService服務及客戶端實現

時間  2019-12-17
標籤 java 建立 webservice 服務 客戶端 實現 欄目 Java 简体版
原文   原文鏈接

簡介       

       WebService是一種服務的提供方式，經過WebService，不一樣應用間相互間調用變的很方便，網絡上有不少經常使用的WebService服務，如：http://developer.51cto.com/art/200908/147125.htm，不一樣的語言平臺對WebService都有實現，Java的WebService實現，比較流行的有Axis二、Jaxws，本文介紹的是Axis2。html

Axis2下載和部署

       Axis2是Apache開發的一個開源項目，再次感嘆Apache的偉大！java

       下載地址：web

       http://mirror.bit.edu.cn/apache//axis/axis2/java/core/1.6.2/axis2-1.6.2-war.zipapache

       將其內axis2.war解壓到<Tomcat安裝目錄>/webapps下，啓動Tomcat，war包會自動解壓，瀏覽器

       訪問http://localhost:8080/axis2/，若是看到歡迎主頁，則說明部署成功。服務器

配置Axis2

       <Tomcat安裝目錄>/webapps/axis2/WEB-INF/conf/axis2.xml，配置其內兩個屬性，以便調試。網絡

 

[html]  view plain  copy
 
 print?在CODE上查看代碼片派生到個人代碼片
  1. <parameter name="hotdeployment">true</parameter><!-- 開啓熱部署，不須要重啓便可部署服務 -->  
  2. <parameter name="hotupdate">true</parameter><!-- 開啓熱更新，不須要重啓便可更新服務 -->  

 

編寫服務

       所謂服務就是編寫一個類，寫一些方法，方法返回數據，WebService客戶端獲取數據。app

[java]  view plain  copy
 
 print?在CODE上查看代碼片派生到個人代碼片
  1. public class HelloService {  
  2.   
  3.     public String sayHello() {  
  4.         return "hello";  
  5.     }  
  6.       
  7. }  

0配置POJO發佈服務

       服務類建立好後，咱們須要發佈到服務器上，將HelloService.class放到<Tomcat安裝目錄>/webapps/axis2/WEB-INF/pojo下，pojo沒有須要建立。dom

       至此，咱們已經成功的建立了一個WebService服務了，so easy！webapp

       再次訪問http://localhost:8080/axis2/，點擊Services，能夠發現可用services中多了一個HelloService，其內有一個可用操做sayHello，說明發布成功。

 

[java]  view plain  copy
 
 print?在CODE上查看代碼片派生到個人代碼片
  1. HelloService  
  2.   
  3. Service Description : No description available for this service  
  4.   
  5. Service EPR : http://localhost:8080/axis2/services/HelloService  
  6.   
  7. Service Status : Active  
  8.   
  9.   
  10. Available Operations  
  11. sayHello  

       訪問http://localhost:8080/axis2/services/HelloService，頁面輸出正是咱們的返回值。

 

 

[html]  view plain  copy
 
 print?在CODE上查看代碼片派生到個人代碼片
  1. <ns:sayHelloResponse xmlns:ns="http://ws.apache.org/axis2">  
  2. <return>hello</return>  
  3. </ns:sayHelloResponse>  

       這裏有兩點須要注意：

 

       - POJO發佈的類不能放在包裏，既不能使用package關鍵字；

       - 默認的發佈目錄是pojo，能夠在<Tomcat安裝目錄>/webapps/axis2/WEB-INF/conf/axis2.xml中增長目錄，

 

[html]  view plain  copy
 
 print?在CODE上查看代碼片派生到個人代碼片
  1. <deployer extension=".class" directory="<要增長的目錄名稱>" class="org.apache.axis2.deployment.POJODeployer" />  

         要注意多個目錄見WebService要惟一，不然會重名，重名後，先部署的會成功，後部署的會報錯。

services.xml配置文件發佈服務

       雖然POJO的方式不須要配置文件，可是其服務類不能放在包內，顯然是不符合咱們平常開發的，Axis2也容許帶包的類發佈WebService，若是不容許，估計就沒人用了。

       首先寫一個較複雜的服務類，多個方法，帶參數，有返回值的。

 

[java]  view plain  copy
 
 print?在CODE上查看代碼片派生到個人代碼片
  1. package webservice.test;  
  2.   
  3. /** 
  4.  * 計算器運算 
  5.  *  
  6.  * @author gaoshuang 
  7.  */  
  8. public class CalculateService {  
  9.   
  10.     // 加法  
  11.     public float plus(float x, float y) {  
  12.         return x + y;  
  13.     }  
  14.   
  15.     // 減法  
  16.     public float minus(float x, float y) {  
  17.         return x - y;  
  18.     }  
  19.   
  20.     // 乘法  
  21.     public float multiply(float x, float y) {  
  22.         return x * y;  
  23.     }  
  24.   
  25.     // 除法  
  26.     public float divide(float x, float y) {  
  27.         if (y != 0)  
  28.             return x / y;  
  29.         else  
  30.             return -1;  
  31.     }  
  32. }  

       而後編寫services.xml，該文件須要放在META-INF文件夾下。

 

 

[html]  view plain  copy
 
 print?在CODE上查看代碼片派生到個人代碼片
  1. <?xml version="1.0" encoding="UTF-8"?>  
  2. <!-- 服務名稱 -->  
  3. <service name="CalculateService">  
  4.     <!-- 服務描述 -->  
  5.     <description>  
  6.         加減乘除計算服務  
  7.     </description>  
  8.     <!-- 設置服務類 -->  
  9.     <parameter name="ServiceClass">  
  10.         com.runqianapp.webservice.test.CalculateService  
  11.     </parameter>  
  12.     <!-- 方法 -->  
  13.     <operation name="plus">  
  14.         <!-- 方法處理器，RPCMessageReceiver爲帶返回值的處理器，  
  15.                      RPCInOnlyMessageReceiver爲不帶返回值的處理器 -->  
  16.         <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"  
  17.             class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />  
  18.     </operation>  
  19.     <operation name="minus">  
  20.         <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"  
  21.             class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />  
  22.     </operation>  
  23.     <operation name="multiply">  
  24.         <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"  
  25.             class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />  
  26.     </operation>  
  27.     <operation name="divide">  
  28.         <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"  
  29.             class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />  
  30.     </operation>  
  31. </service>  

 

       最後將這兩個文件打成jar包，不論用工具仍是手動打，打的都是最外層的文件夾。

       

       我打的名字是server.jar，更改後綴爲aar，因此最後是server.aar，Axis2建議使用aar發佈WebService，

       將server.aar放到<Tomcat安裝目錄>/webapps/axis2/WEB-INF/services下，訪問http://localhost:8080/axis2/services/listServices，

       多出了一個CalculateService，說明發布成功。

 

[java]  view plain  copy
 
 print?在CODE上查看代碼片派生到個人代碼片
  1. CalculateService  
  2.   
  3. Service Description : CalculateService  
  4.   
  5. Service EPR : http://localhost:8080/axis2/services/CalculateService  
  6.   
  7. Service Status : Active  
  8.   
  9.   
  10. Available Operations  
  11. divide  
  12. plus  
  13. minus  
  14. multiply  

       分別訪問

 

       http://localhost:8080/axis2/services/CalculateService/plus?x=1&y=2

       http://localhost:8080/axis2/services/CalculateService/divide?x=1&y=2

       http://localhost:8080/axis2/services/CalculateService/minus?x=1&y=2

       http://localhost:8080/axis2/services/CalculateService/multiply?x=1&y=2
       也能夠發佈多個WebService，可使用serviceGroup標籤。

 

[html]  view plain  copy
 
 print?在CODE上查看代碼片派生到個人代碼片
  1. <serviceGroup>  
  2. <service name="myService1">  
  3.     ...  
  4. </service>  
  5. <service name="myService2">  
  6.     ...  
  7. </service>  
  8. </serviceGroup>  

客戶端實現

 

       以上介紹的都是WebService服務建立及發佈，那麼有了一個WebService服務後，咱們如何調用呢？只在瀏覽器上訪問是沒有意義的。

       下載Axis2客戶端壓縮包：http://mirror.esocc.com/apache//axis/axis2/java/core/1.6.2/axis2-1.6.2-bin.zip，並解壓。

       新建工程WebServiceClientTest，將<Axis2客戶端安裝目錄>/lib下全部jar包添加到工程中；

       編寫客戶端代碼；

 

[java]  view plain  copy
 
 print?在CODE上查看代碼片派生到個人代碼片
  1. package webservice.client.test;  
  2.   
  3. import javax.xml.namespace.QName;  
  4.   
  5. import org.apache.axis2.AxisFault;  
  6. import org.apache.axis2.addressing.EndpointReference;  
  7. import org.apache.axis2.client.Options;  
  8. import org.apache.axis2.rpc.client.RPCServiceClient;  
  9.   
  10. public class Client1 {  
  11.   
  12.     /** 
  13.      * @param args 
  14.      * @throws AxisFault 
  15.      */  
  16.     public static void main(String[] args) throws AxisFault {  
  17.         // 使用RPC方式調用WebService  
  18.         RPCServiceClient serviceClient = new RPCServiceClient();  
  19.         Options options = serviceClient.getOptions();  
  20.         // 指定調用WebService的URL  
  21.         EndpointReference targetEPR = new EndpointReference(  
  22.                 "http://localhost:8080/axis2/services/CalculateService");  
  23.         options.setTo(targetEPR);  
  24.         // 調用方法的參數值  
  25.         Object[] entryArgs = new Object[] {1, 2};  
  26.         // 調用方法返回值的數據類型的Class對象  
  27.         Class[] classes = new Class[] { float.class };  
  28.         // 調用方法名及WSDL文件的命名空間  
  29.         // 命名空間是http://localhost:8080/axis2/services/CalculateService?wsdl中wsdl:definitions標籤targetNamespace屬性  
  30.         QName opName = new QName("http://test.webservice", "plus");  
  31.         // 執行方法獲取返回值  
  32.         // 沒有返回值的方法使用serviceClient.invokeRobust(opName, entryArgs)  
  33.         Object result = serviceClient.invokeBlocking(opName, entryArgs, classes)[0];  
  34.         System.out.println(result);  
  35.         // out: 3.0  
  36.     }  
  37.   
  38. }  

       以上是實現了一個簡單的WebSerivce客戶端，調用CalculateService中的plus方法，由代碼可見，這種調用方式比較雜亂，代碼不太友好。

 

wsdl2java簡化客戶端

       <Axis2客戶端安裝目錄>/bin目錄，其內有兩個bat，wsdl2java.bat和java2wsdl.bat，能夠實現WSDL文件和Java之間的互相轉換。

       考慮到咱們之後可能常常使用這些命令，設置環境變量，方便之後調用。在系統變量中加入AXIS2_HOME=<Axis2客戶端安裝目錄>，path中追加;%AXIS2_HOME%\bin。

       啓動命令提示符，進入WebServiceTestClient所在目錄，運行

 

[plain]  view plain  copy
 
 print?在CODE上查看代碼片派生到個人代碼片
  1. wsdl2java -uri http://localhost:8080/axis2/services/CalculateService?wsdl -p webservice.client.test -s  

       參數說明：uri - wsdl文件路徑，網絡路徑或本地路徑，p - 打包，這裏和上一個客戶端實現類打在了一個包裏，wsdl2java有不少參數，詳細能夠運行該命令去查看。

 

       執行後，若是沒有報錯，說明運行成功，刷新項目，該包下多出了一個CalculateServiceStub類，裏面的代碼極其複雜，還亂呼呼的，這咱們不用管，調用該類。

 

[java]  view plain  copy
 
 print?在CODE上查看代碼片派生到個人代碼片
  1. package webservice.client.test;  
  2.   
  3. import java.rmi.RemoteException;  
  4.   
  5. import webservice.client.test.CalculateServiceStub.Plus;  
  6.   
  7. public class Client2 {  
  8.   
  9.     /** 
  10.      * @param args 
  11.      * @throws RemoteException  
  12.      */  
  13.     public static void main(String[] args) throws RemoteException {  
  14.         CalculateServiceStub stub = new CalculateServiceStub();  
  15.         Plus plus = new Plus();  
  16.         plus.setX(1);  
  17.         plus.setY(2);  
  18.         float result = stub.plus(plus).get_return();// 返回值自動轉型，這也是強大之處  
  19.         System.out.println(result);  
  20.     }  
  21.   
  22. }  

 

       如此作的好處就是調用時不須要在去查看WSDL，和正常使用一個類同樣，對WebService的封裝都由wsdl2java自動生成，代碼更優雅、簡潔。

利用wsdl2java輕鬆使用第三方WebService服務

       有了wsdl2java，已知一個WSDL文件咱們就能夠輕鬆的生成WebService客戶端供咱們調用，給咱們服務。文章開頭給出的連接包含了一些第三方服務，有一個服務是生成隨機個數中文，WSDL：http://www.webxml.com.cn/WebServices/RandomFontsWebService.asmx?wsdl，一樣，啓動命令提示符，進入項目路徑，執行

 

[plain]  view plain  copy
 
 print?在CODE上查看代碼片派生到個人代碼片
  1. wsdl2java -uri http://www.webxml.com.cn/WebServices/RandomFontsWebService.asmx?wsdl -p webservice.client.test -s  

       調用該類

 

 

[java]  view plain  copy
 
 print?在CODE上查看代碼片派生到個人代碼片
    1. package webservice.client.test;  
    2.   
    3. import java.rmi.RemoteException;  
    4.   
    5. import webservice.client.test.RandomFontsWebServiceStub.ArrayOfString;  
    6. import webservice.client.test.RandomFontsWebServiceStub.GetChineseFonts;  
    7.   
    8. public class ThirdClient {  
    9.   
    10.     /** 
    11.      * @param args 
    12.      * @throws RemoteException  
    13.      */  
    14.     public static void main(String[] args) throws RemoteException {  
    15.         RandomFontsWebServiceStub stub = new RandomFontsWebServiceStub();  
    16.         GetChineseFonts getChineseFonts = new GetChineseFonts();  
    17.         getChineseFonts.setByFontsLength(10);// 無償使用有限制，最多8個  
    18.         ArrayOfString result = stub.getChineseFonts(getChineseFonts).getGetChineseFontsResult();  
    19.         for(String str : result.getString()) {  
    20.             System.out.println(str);  
    21.         }  
    22.     }  
    23.   
    24. }  
相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程