WebService

• 什么是webservice：webservice也可以叫 xml web service webservice，轻量级的独立的通讯技术

1. 基于web的服务：服务端提供的服务接口让客户端访问
2. 跨平台，跨语言的整合方案

• 为什么要使用webservice：跨语言调用的解决方案
• 什么时候要去使用webservice：列如：电商平台中包含的订单物流信息状态，我们需要调用第三方物流系统的接口查询物流信息，但是第三方物流系统是由.net实现的webservice服务接口，我们本身是java语言写的电商平台，那么这时候就可以使用webservice调取第三方服务。
• webservice基本概念：WSDL(web service definition language) ：webservice定义语言。webservice服务需要通过wsdl文件来说明自己有什么服务可以对外调用。并且有哪些方法、方法里面有哪些参数。wsdl基于XML（可扩展标记语言）去定义的。

1. 对应一个.wsdl的文件类型。
2. 定义了webservice的服务器端和客户端应用进行交互的传递数据和响应数据格式和方式。
3. 一个webservice对应唯一一个wsdl文档。

• SOAP(simple object access protocal)：简单对象访问协议（http+xml）。webservice通过http协议发送和接收请求时，发送的内容(请求报文)和接收的内容(响应报文)都是采用xml格式进行封装。这些特定的HTTP消息头和XML内容格式就是SOAP协议。

1. 一种简单，基于HTTP和XML的协议。
2. soap消息：请求和响应消息
3. http+xml报文

• SEI(webservice endpoint interface )：webservice的终端接口。webservice服务端用来处理请求的接口，也就是发布出去的接口。
• 简单实现一个webservice：
  • 服务端：
  • 新建一个接口实现输出入参：　

package com.karat.cn;

import javax.jws.WebMethod;
import javax.jws.WebService;

@WebService//SE和SEI的实现类
public interface HelloWord {

    @WebMethod//SEI中的方法
    public String say(String name);
}

• • 新建一个接口实现该接口的实现类：

package com.karat.cn;

import javax.jws.WebService;

@WebService
public class HelloWordImpl implements HelloWord{

    @Override
    public String say(String name) {
        // TODO Auto-generated method stub
        System.out.println("call say()");
        return "helloword"+name+"i'm word";
    }

}

• • 新建启动项：

package com.karat.cn;

import javax.xml.ws.Endpoint;

public class Bootstrap {

    public static void main(String[] args){
        //发布接口地址
        Endpoint.publish("http://localhost:8080/webservice/say", new HelloWordImpl());
        
        System.out.println("publish success");
    }
}

• • pom文件引入依赖：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.karat.cn</groupId>
  <artifactId>webservice</artifactId>
  <packaging>war</packaging>
  <version>0.0.1-SNAPSHOT</version>
  <name>webservice Maven Webapp</name>
  <url>http://maven.apache.org</url>
  <dependencies>
     <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
    <dependency>
      <groupId>org.apache.zookeeper</groupId>
      <artifactId>zookeeper</artifactId>
      <version>3.4.8</version>
    </dependency>
    <dependency>
      <groupId>com.101tec</groupId>
      <artifactId>zkclient</artifactId>
      <version>0.10</version>
    </dependency>

    <dependency>
      <groupId>org.apache.curator</groupId>
      <artifactId>curator-framework</artifactId>
      <version>2.11.0</version>
    </dependency>

    <dependency>
      <groupId>org.apache.curator</groupId>
      <artifactId>curator-recipes</artifactId>
      <version>2.11.0</version>
    </dependency>

  </dependencies>
  <build>
     <finalName>webservice</finalName>
     <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                </configuration>
            </plugin>
     </plugins>
  </build>
</project>

• • 启动main方法发布成功后在网页端输入：http://localhost:8080/webservice/say?wsdl后可得到wsdl文档如下：

<!--
 Published by JAX-WS RI (http://jax-ws.java.net). RI's version is JAX-WS RI 2.2.9-b130926.1035 svn-revision#5f6196f2b90e9460065a4c2f4e30e065b245e51e. 
-->
<!--
 Generated by JAX-WS RI (http://jax-ws.java.net). RI's version is JAX-WS RI 2.2.9-b130926.1035 svn-revision#5f6196f2b90e9460065a4c2f4e30e065b245e51e. 
-->
<definitions xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:wsp="http://www.w3.org/ns/ws-policy" xmlns:wsp1_2="http://schemas.xmlsoap.org/ws/2004/09/policy" xmlns:wsam="http://www.w3.org/2007/05/addressing/metadata" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://cn.karat.com/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.xmlsoap.org/wsdl/" targetNamespace="http://cn.karat.com/" name="HelloWordImplService">
<types>
<xsd:schema>
<xsd:import namespace="http://cn.karat.com/" schemaLocation="http://localhost:8080/webservice/say?xsd=1"/>
</xsd:schema>
</types>
<message name="say">
<part name="parameters" element="tns:say"/>
</message>
<message name="sayResponse">
<part name="parameters" element="tns:sayResponse"/>
</message>
<portType name="HelloWordImpl">
<operation name="say">
<input wsam:Action="http://cn.karat.com/HelloWordImpl/sayRequest" message="tns:say"/>
<output wsam:Action="http://cn.karat.com/HelloWordImpl/sayResponse" message="tns:sayResponse"/>
</operation>
</portType>
<binding name="HelloWordImplPortBinding" type="tns:HelloWordImpl">
<soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/>
<operation name="say">
<soap:operation soapAction=""/>
<input>
<soap:body use="literal"/>
</input>
<output>
<soap:body use="literal"/>
</output>
</operation>
</binding>
<service name="HelloWordImplService">
<port name="HelloWordImplPort" binding="tns:HelloWordImplPortBinding">
<soap:address location="http://localhost:8080/webservice/say"/>
</port>
</service>
</definitions>

• • 客户端：
  • 通过cmd进入到当前项目demo目录下，在cmd中执行wsimport -keep http://localhost:8080/webservice/say?wsdl如下：

• • 在同级目录下生成一个com文件夹，内部包含文件如下：

• • 将.class文件以及-info.class说明文件去除，引入.java文件到客户端项目中。
  • 新建一个web项目，将生成的com包直接copy到新建的服务端项目中

• • 创建服务端启动项，代码如下：

package com.karat.cn.service;

public class Demo {

    public static void main(String args[]){
        HelloWordImplService service=new HelloWordImplService();
        HelloWordImpl helloWordImpl=service.getHelloWordImplPort();
        System.out.print(helloWordImpl.say("123"));
    }
}