Java:Web Service初入門_ZenDei技術網路在線

Java:Web Service初入門

-Advertisement-

Web Service技術在我第一次接觸，又沒有實際使用時完全不理解這是什麼。以為是一種類似Spring，Shiro的編程框架。後來漸漸理解，WS(即Web Service縮寫)是一種通用的介面規範，並按照該規範編寫介面對外提供服務。 ...

前言

Web Service技術在我第一次接觸，又沒有實際使用時完全不理解這是什麼。以為是一種類似Spring，Shiro的編程框架。後來漸漸理解，WS(即Web Service縮寫)是一種通用的介面規範，並按照該規範編寫介面對外提供服務。

一啥是WS

這個問題在我沒有編寫WS代碼時可是困擾了我很久，甚至第一次需要寫WS介面都不知道老大到底要我寫什麼。因為我習慣於去網上尋找資料自學並實踐某些知識點，而我在百度時查到的WS介紹基本都是這樣的。

百度百科：

Web service是一個平臺獨立的，低耦合的，自包含的、基於可編程的web的應用程式，可使用開放的XML（標準通用標記語言下的一個子集）標準來描述、發佈、發現、協調和配置這些應用程式，用於開發分散式的互操作的應用程式。

百度搜索WS排名前列的博客：

Web Service技術，能使得運行在不同機器上的不同應用無須藉助附加的、專門的第三方軟體或硬體，就可相互交換數據或集成。依據Web Service規範實施的應用之間，無論它們所使用的語言、平臺或內部協議是什麼，都可以相互交換數據。

這種解釋對於不瞭解WS的人來看完全是一頭霧水，後來在實踐中漸漸明白了什麼是WS。自我總結如下：

Web Service就是一種跨編程語言和跨操作系統平臺的遠程調用技術。所謂跨編程語言和跨操作平臺，就是說服務端程式採用Java編寫，客戶端程式則可以採用其他編程語言編寫，反之亦然。跨操作系統平臺則是指服務端程式和客戶端程式可以在不同的操作系統上運行。遠程調用，就是一臺電腦的應用可以調用其他電腦上的應用，也可以直接理解為介面。例如：支付寶，支付寶並沒有銀行卡等數據，它只是去調用銀行提供的介面來獲得數據。還有天氣預報等，也是氣象局把自己的系統服務以webservice服務的形式暴露出來，讓第三方網站和程式可以調用這些服務功能。

所以Web Servic就是一種跨語言跨平臺的介面技術。

二 Spring整合CXF

Web Service只是一套介面規範，實際運用中實現Web Service的方法有很多種，Java本身在jdk1.7之後也對webservice有了預設的實現（Oracle JAX-WS RI），但是在我們實際開發中一般還是會使用框架來，比如這裡所提到的CXF就有著廣泛的應用。
CXF單獨發佈就不說了，直接講Spring整合CXF，畢竟現在的JavaEE開發是離不開Spring了。

2.1 maven配置

加入maven依賴

<!--cxf-->
<!-- https://mvnrepository.com/artifact/org.apache.cxf/cxf-rt-frontend-jaxws -->
<dependency>
    <groupId>org.apache.cxf</groupId>
    <artifactId>cxf-rt-frontend-jaxws</artifactId>
    <version>3.1.6</version>
</dependency>
<!-- https://mvnrepository.com/artifact/org.apache.cxf/cxf-rt-transports-http -->
<dependency>
    <groupId>org.apache.cxf</groupId>
    <artifactId>cxf-rt-transports-http</artifactId>
    <version>3.1.6</version>
</dependency>

2.2 配置 web.xml

<!--定義一個cxf的servlet-->
<servlet>
    <servlet-name>CXFServlet</servlet-name>
    <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>
</servlet>
<servlet-mapping>
    <servlet-name>CXFServlet</servlet-name>
    <url-pattern>/webservice/*</url-pattern>
</servlet-mapping>

2.3 寫一個WS介面及其實現

非常簡潔的介面和實現
介面：HelloWorld.java

package com.erictao.cxf;
import javax.jws.WebService;
@WebService
public interface HelloWorld {
    public String say(String str);
}

實現：HelloWorldImpl.java

package com.erictao.cxf.impl;
import com.erictao.cxf.HelloWorld;
import org.springframework.stereotype.Component;
import javax.jws.WebService;
@Component("helloWorld")
@WebService
public class HelloWorldImpl implements HelloWorld {
    public String say(String str) {
        return "Hello"+str;
    }
}

2.4 修改Spring配置文件

在spring主配置文件spring.xml中添加引入spring-cxf.xml

<!-- lang: xml -->
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
 
http://www.springframework.org/schema/beans/spring-beans-4.0.xsd
 
 
http://www.springframework.org/schema/context
 
 
http://www.springframework.org/schema/context/spring-context-4.0.xsd">
 
    <context:component-scan base-package="com.erictao"/>
    <!-- 省略其他配置內容 -->
    <import resource="spring-cxf.xml"/>
</beans>

並且創建配置文件spring-cxf.xml

<!-- lang: xml -->
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:jaxws="http://cxf.apache.org/jaxws"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
 
http://www.springframework.org/schema/beans/spring-beans-4.0.xsd
 
 
http://cxf.apache.org/jaxws
 
 
http://cxf.apache.org/schemas/jaxws.xsd">
 
    <!-- 定義webservice的發佈介面  -->
    <jaxws:endpoint implementor="#helloWorld" address="/HelloWorld">
 
</beans>

更加具體的配置可以查看官方給出的文檔:http://cxf.apache.org/docs/how-do-i-develop-a-service.html。
#helloWorld指的是我們在HelloWorldImpl類中所自定義的名字,即@Component("helloWorld")定義的bean id，/HelloWorld則是我們定義的介面地址。

三運行發佈WS

之後我們運行項目輸入該地址：http://127.0.0.1:8080/ssm/webservice/HelloWorld?wsdl如果出現如下界面：

則說明我們的webservice發佈成功了。接下來只需要通過客戶端調用這個介面即可獲得返回結果了。客戶端的代碼可以直接使用工具生成，可參考：https://blog.csdn.net/andyliulin/article/details/53680915。

總結
以上就是一個簡單的Web Service入門實例，更多的關於CXF攔截器，客戶端調用就沒有做過多介紹，後續有時間的話再接著更新，明白了Web Service服務端和客戶端怎麼構建，後續只需要當做普通介面編寫業務代碼即可。

您的分享是我們最大的動力!