WebService基礎學習(二)—三要素

時間  2019-11-08
標籤 webservice 基礎 學習 要素 欄目 WebService 简体版
原文   原文鏈接

1、Java中WebService規範

     JAVA 中共有三種WebService 規範，分別是JAX-WS、JAX-RS、JAXM&SAAJ(廢棄)。html

 

1.JAX-WS規範

     JAX-WS 的全稱爲Java API for XML-Based Webservices ，早期的基於SOAP 的JAVA 的Web 服務規範JAX-RPC(Java API For XML-Remote Procedure Call)目前已經被JAX-WS 規範取代。從java5開始支持JAX-WS2.0版本，Jdk1.6.0_13之後的版本支持2.1版本，jdk1.7支持2.2版本。java

    採用標準SOAP(Simple Object Access Protocol) 協議傳輸，soap屬於w3c標準。Soap協議是基於http的應用層協議，soap協議傳輸是xml數據。mysql

     採用wsdl做爲描述語言即webservice使用說明書，wsdl屬w3c標準。web

     xml是webservice的跨平臺的基礎，XML主要的優勢在於它既與平臺無關，又與廠商無關。sql

     XSD，W3C爲webservice制定了一套傳輸數據類型，使用xml進行描述，即XSD(XML Schema Datatypes)，任何編程語言寫的webservice接口在發送數據時都要轉換成webservice標準的XSD發送。數據庫

 

2.JAX-RS規範

     JAX-RS 是JAVA 針對REST(Representation State Transfer)風格制定的一套Web 服務規範，因爲推出的較晚，該規範（JSR 311，目前JAX-RS 的版本爲1.0）並未隨JDK1.6 一塊兒發行。編程

支持JAX-RS服務規範的框架有：服務器

      CXF——XFire和Celtix的合併（一個由IONA贊助的開源ESB，最初寄存在ObjectWeb上）。架構

     Jersey——Sun公司的JAX-RS參考實現。app

     RESTEasy——JBoss的JAX-RS項目。

     Restlet——也許是最先的REST框架了，它JAX-RS以前就有了。

注：REST 是一種軟件架構模式，只是一種風格，rest服務採用HTTP 作傳輸協議。

 

2、WebService(jax-ws)三要素

SOAP: 基於HTTP協議，採用XML格式，用來傳遞信息的格式。

WSDL: 用來描述如何訪問具體的服務。

UDDI: 用戶本身能夠按UDDI標準搭建UDDI服務器，用來管理，分發，查詢WebService 。其餘用戶能夠本身註冊發佈WebService調用。

 

1.SOAP(通信協議)

     Simple Object Accrss Protocol，簡單對象訪問協議是在分散或分佈式的環境中交換信息的簡單的協議，是一個基於XML的協議，它包括四個部分:

(1)SOAP封裝(envelop)，封裝定義了一個描述消息中的內容是什麼，是誰發送的，誰應當接受並處理它，以及如何處理它們的框架;

(2)SOAP編碼規則，用於表示應用程序須要使用的數據類型的實例。

(2)SOAP RPC 表示遠程過程調用和應答的協定。

(4)SOAP綁定(binding)，使用底層協議交換信息。

 

(1)請求的協議體

POST /weather HTTP/1.1

Accept: text/xml, multipart/related

Content-Type: text/xml; charset=utf-8

SOAPAction: "http://weather.itheima.com/WeatherInterface/getWeatherByCityNameRequest"

User-Agent: JAX-WS RI 2.2.4-b01

Host: 127.0.0.1:54321

Connection: keep-alive

Content-Length: 235

<?xml version="1.0" ?>

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">

       <S:Body>

             <ns2:getWeatherByCityName xmlns:ns2="http://weather.itheima.com">

                  <cityName>北京</cityName>

             </ns2:getWeatherByCityName>

       </S:Body>

</S:Envelope>

 

(2)響應的協議體

HTTP/1.1 200 OK

Transfer-encoding: chunked

Content-type: text/xml; charset=utf-8

Date: Fri, 09 Oct 2015 07:23:29 GMT

<?xml version="1.0" ?>

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">

         <S:Body>

                 <ns2:getWeatherByCityNameResponse xmlns:ns2="http://weather.itheima.com">

                           <WeatherInfo>今天風很大</WeatherInfo>

                 </ns2:getWeatherByCityNameResponse>

         </S:Body>

</S:Envelope>

 

(3)發佈基於soap1.2協議的服務

在SEI實現類上添加以下註解

@BindingType(javax.xml.ws.soap.SOAPBinding.SOAP12HTTP_BINDING)

發佈基於soap1.2協議的服務，須要jax-ws包要求2.2.8以上版本。

 

(4)soap1.2請求的協議體

POST /weather HTTP/1.1

Accept: application/soap+xml, multipart/related

Content-Type: application/soap+xml; charset=utf-8;

action="http://weather.itheima.com/WeatherInterface/getWeatherByCityNameRequest"

User-Agent: JAX-WS RI 2.2.4-b01

Host: 127.0.0.1:54321

Connection: keep-alive

Content-Length: 233

<?xml version="1.0" ?>

<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">

              <S:Body>

                    <ns2:getWeatherByCityName xmlns:ns2="http://weather.itheima.com">

                          <cityName>北京</cityName>

                    </ns2:getWeatherByCityName>

              </S:Body>

</S:Envelope>

 

(5)soap1.2響應的協議體

HTTP/1.1 200 OK

Transfer-encoding: chunked

Content-type: application/soap+xml; charset=utf-8

Date: Fri, 09 Oct 2015 07:54:53 GMT

<?xml version='1.0' encoding='UTF-8'?>

<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">

        <S:Body>

                  <ns2:getWeatherByCityNameResponse xmlns:ns2="http://weather.itheima.com">

                          <WeatherInfo>今天風很大</WeatherInfo>

                  </ns2:getWeatherByCityNameResponse>

        </S:Body>

</S:Envelope>

 

2.WSDL

     WSDL(Web Service Description Language)，是一個用來描述Web服務（Web Service）和說明如何與Web服務通訊的XML語言。由於是基於XML的，因此WSDL既是機器可閱讀的，又是人可閱讀的，這將是一個很大的好處。

     image

(1)wsdl的閱讀方法

是從下往上讀。

每一個wsdl有且只有一個Service節點。

一、先找Service節點

二、Service節點中找port節點。每一個port對應一個PortType。

三、Port節點對應一binding節點。每一個binding節點對應一個PortType

四、PortType中有operation 節點就是服務的方法。

五、operation 中有Input（參數）和output（返回值）

六、Input（參數）和output（返回值）對應message節點

七、Message對應element節點。Element節點對應complexType節點描述了參數及返回值的數據類型。

 

(2)使用註解規範wsdl

@WebService: 定義服務，在public class上邊。

   targetNamespace:指定命名空間。

   name:portType的名稱。

   portName:port的名稱。

  serviceName:服務名稱。

 

@WebResult:定義返回值。

   name:返回結果值的名稱。

 

@WebParam:定義參數。

   name:指定參數的名稱。

 

@WebMethod

exclude:排除指定的方法。

默認狀況下，SEI實現類中因此的public方法會發布成服務方法。

若是不想把public方法發佈成服務方法，須要使用@WebMethod註解。把此方法排除。在實現類中至少有一個方法發佈爲服務方法。

 

image

http://127.0.0.1:12345/weather?wsdl

image

image

 

http://127.0.0.1:12345/weather?xsd=1

image

做用: 經過註解，能夠更加形像的描述Web服務。對自動生成的wsdl文檔進行修改，爲使用者提供一個更加清晰的wsdl文檔。

當修改了WebService註解以後，會影響客戶端生成的代碼。調用的方法名和參數名也發生了變化。

 

3.UDDI

     UDDI 是一種目錄服務，經過它，企業可註冊並搜索 Web services。企業將本身提供的Web Service註冊在UDDI，也可使用別的企業在UDDI註冊的web service服務，從而達到資源共享。

     UDDI旨在將全球的webservcie資源進行共享，促進全球經濟合做。

     可是使用webservice並非必須使用UDDI，由於用戶經過WSDL知道了web service的地址，能夠直接經過WSDL調用webservice。

 

3、區域查詢系統

1.需求分析

     建立區域查詢服務系統，對外發布WebService服務，供客戶端調用，根據parentid查詢區域信息，返回區域信息列表，並支持分頁。

     image

 

2.服務端

第一步：建立一java工程

第二步：導入mysql的數據庫驅動。

第三步：建立一個dao。根據parentid查詢區域列表。返回區域pojo的list。支持分頁。

第四步：建立一個SEI

第五步：建立SEI實現類。@Webservice註解不要忘。

第六步：發佈服務。

AreaDao.java

public class AreaDao{
	
	public List<Area> getAreaList(String parentId,int page,int rows){
		
		//JDBC查詢數據庫
		Connection con = null;
		PreparedStatement ps = null;
		ResultSet rs = null;
		List<Area> list = new ArrayList<Area>();
		
		try{
			//加載數據庫驅動
			Class.forName("com.mysql.jdbc.Driver");
			//建立一個鏈接
			con = DriverManager.getConnection("jdbc:mysql://localhost:3306/webservice","root","123456");
			//建立Preparement
			String sql = "SELECT * FROM area WHERE PARENTID=? LIMIT ?,?";
			ps = con.prepareStatement(sql);
			ps.setString(1,parentId);
			ps.setInt(2,(page - 1) * rows);
			ps.setInt(3,rows);
			//執行查詢
			rs = ps.executeQuery();
			//取查詢結果
			while(rs.next()){ 
				Area a = new Area();
				a.setAreaCode(rs.getString("AREACODE"));
				a.setAreaFullName(rs.getString("AREAFULLNAME"));
				a.setAreaLevel(rs.getString("AREALEVEL"));
				a.setAreaName(rs.getString("AREANAME"));
				a.setParentId(rs.getString("PARENTID"));
				a.setShortName(rs.getString("SHORTNAME"));
				list.add(a);
			}
			return list;
		}catch(Exception e){
			e.printStackTrace();
		}
		finally{
			try{
				rs.close();
				ps.close();
				con.close();
			}catch(SQLException e){
				e.printStackTrace();
			}
		}
		return list;
	}
}

 

AreaInterface.java

/*
 * 區域查詢SEI
 */
public interface AreaInterface{

	List<Area> getAreaList(String parentId,int page,int rows);
}

 

AreaInterfaceImpl.java

/*
 *SEI實現類 
 */
@WebService
public class AreaInterfaceImpl implements AreaInterface{

	@Override
	public List<Area> getAreaList(String parentId,int page,int rows){
		
		//使用Dao查詢區域列表
		AreaDao dao = new AreaDao();
		List<Area> list = dao.getAreaList(parentId,page,rows);
		return list;
	}

}

 

AreaServer.java

/*
 * 區域查詢服務發佈
 */
public class AreaServer{

	public static void main(String[] args){
		
		Endpoint.publish("http://127.0.0.1:12345/area",new AreaInterfaceImpl());
		
	}
}

 

3.客戶端

第一步：建立一個java工程

第二步：基於wsdl生成客戶端調用代碼

第三步：建立服務視圖

第四步：得到PortType對象

第五步：調用服務端方法。

AreaClient.java

/*
 * 客戶端調用代碼
 */
public class AreaClient{

	public static void main(String[] args){
		
		//建立服務視圖
		AreaInterfaceImplService service = new AreaInterfaceImplService();
		//從服務視圖獲取PortType
		AreaInterfaceImpl port = service.getAreaInterfaceImplPort();
		List<Area> list = port.getAreaList("1.1.",1,5);
		for(Area area : list){
			System.out.println(area.getAreaName());
		}
	}
}
相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程