WebService入门介绍

什么是WebService?
WebService，顾名思义就是基于Web的服务。它使用Web(HTTP)方式，接收和响应外部系统的某种请求。从而实现远程调用.
我们可以调用互联网上查询天气信息Web服务，然后将它嵌入到我们的程序(C/S或B/S程序)当中来，当用户从我们的网点看到天气信息时，他会认为我们为他提供了很多的信息服务，但其实我们什么也没有做，只是简单了调用了一下别人服务器上的一段代码而已。
学习WebSerice可以将你的服务(一段代码)发布到互联网上让别人去调用,也可以调用别人机器上发布的WebService,就像使用自己的代码一样.。

如果说Java是跨平台的语言，那么WebService就是跨语言的技术。
WebService可以让多个进程之间实现数据交换，即进程间通讯。
无论某个进程运行要互联网的任何地点，无论进程是有什么语言写成的，都可以互相访问并传输数据。
最后，WebService是基于HTTP和XML的技术。

那么如何才可以发布一个WebService呢？
用Jdk1.6.0_21以后的版本发布一个WebService服务.
并通过地址栏查看它的wsdl文档.
通过wsimport生成客户端代码,调用并查看运行的结果
从互联网上获取一个WebService并使用步内容3调用并查看结果

WSDL — WebService Description Language – Web服务描述语言。
通过XML形式说明服务在什么地方－地址。
通过XML形式说明服务提供什么样的方法 – 如何调用。

SOAP—Simple Object Access Protocol(简单对象访问协议)
SOAP作为一个基于XML语言的协议用于有网上传输数据。
SOAP = 在HTTP的基础上+XML数据。
SOAP是基于HTTP的。
SOAP的组成如下：
Envelope – 必须的部分。以XML的根元素出现。
Headers – 可选的。
Body – 必须的。在body部分，包含要执行的服务器的方法。和发送到服务器的数据。

那么如何才可以发布一个WebService呢？

在JDK1.6中JAX-WS规范定义了如何发布一个webService服务。JAX-WS是指Java Api for XML – WebService.用Jdk1.6.0_20以后的版本发布一个WebService服务.与Web服务相关的类，都位于javax.ws.*包中。主要类有：@WebService － 它是一个注解，用在类上指定将此类发布成一个ws.Endpoint – 此类为端点服务类，它的方法publish用于将一个已经添加了@WebService注解对象绑定到一个地址的端口上。

在Java项目中开发第一个WS服务：

１、在类上添加@WebService注解。这是jdk1.6提供的一个注解。它位于：javax.jws.*包中。２、通过EndPoint(端点服务)发布一个webService。Endpoint也是jdk提供的一个专门用于发布服务的类，它的publish方法接收两个参数，一个是本地的服务地址，二是提供服务的类。它位于javax.xml.ws.*包中。static Endpoint.publish(String address, Object implementor)在给定地址处针对指定的实现者对象创建并发布端点。stop方法用于停止服务。EndPoint发布完成服务以后，将会独立的线程运行。所以，publish之后的代码，可以正常执行，但整个程序不会终止。其他注意事项：给类添加上@WebService注解后，类中所有的非静态方法都将会对外公布。不支持静态方法，final方法。－如果希望某个方法(非static,非final)不对外公开，可以在方法上添加@WebMethod(exclude=true)，阻止对外公开。如果一个类上，被添加了@WebService注解，则必须此类至少有一个可以公开的方法，否则将会启动失败。

代码示例：

package com.my.ws;import javax.jws.WebService;import javax.xml.ws.Endpoint;//添加注解@WebServicepublic class HelloWorldService {    //至少包含一个可以对外公开的服务    public String saiHi(String name){        return "Hi "+ name;    }    public static void main(String[] args) {        //发布服务，第一个参数称为Binding即绑定地址，第二个参数是实现者，即谁提供服务        Endpoint.publish("http://localhost:8080/hello", new HelloWorldService());    }}

在地址栏输入以下地址获取使用说明书：(注意后面的参数?wsdl)
http://localhost:8080/hello?wsdl
在地址栏输入上面的URL之后，即会显示一个XML文件 ，此文件称为WSDL.因为此文件主要描述了WebService的调用、使用方法 。
目前不是访问webService,只是获取一个用于描述WebService的说明文件,即wsdl文件.
wsdl—-WebService Description Language,是以XML文件形式来描述WebService的”说明书”,有了说明书,我们才可以知道如何使用或是调用这个服务.

<Service name=“MyService”>通常用于描述服务的名称，即new MyService();-通常称为服务名。在<Service>元素内的<port name=“MyServicePort”>即new MyService().getMyServicePort(); - 通常称为服务端口。<portType name=“MyPort”>是服务接口名。即：MyPort myPort = new MyService().getMyServicePort();

使用wsimport生成本地调用代码：

说明书看不懂怎么办？别急JDK能看懂：wsimport是jdk自带的,可以根据wsdl文档生成客户端调用代码的工具.当然,无论服务器端的WebService是用什么语言写的,都将在客户端生成Java代码.服务器端用什么写的并不重要.wsimport.exe位于JAVA_HOME\bin目录下.常用参数为:-d<目录>  - 将生成.class文件。默认参数。-s<目录> - 将生成.java文件。-p<生成的新包名> -将生成的类，放于指定的包下。(wsdlurl) - http://server:port/service?wsdl，必须的参数。示例：C:/> wsimport –s . http://localhost:8080/hello?wsdl注意：-s不能分开，-s后面有个小点，用于指定源代码生成的目录。点即当前目录。如果使用了-s参数则会在目录下生成两份代码，一份为.class代码。一份为.java代码。.class代码，可以经过打包以后使用。.java代码可以直接Copy到我们的项目中运行。

运行示例：

生成文件的结果：

然后删除.class文件，新建一个java工程，然后将com目录整个拷贝到新工程中，如图：

写测试文件进行测试结果如下：

：

WebService通过HTTP协议完成远程调用:

WebService只采用HTTP POST方式传输数据，不使用GET方式;  （仅获取WSDL文件是GET方式）普通http post的contentType为application/x-www-form-urlencodedWebService的contentType为－即在Http的基础上发SOAP协议text/xml 这是基于soap1.1协议。application/soap+xml 这是基于soap1.2协议。WebService从数据传输格式上作了限定。WebService所使用的数据均是基于XML格式的。目前标准的WebService在数据格式上主要采用SOAP协议。SOAP协议实际上就是一种基于XML编码规范的文本协议。SOAP – Simple Object Access protocol 简单对像访问协议。是运行在HTTP协议基础之上的协议。其实就是在HTTP协议是传输XML文件，就变成了SOAP协议。SOAP1.1和SOAP1.2的 namespace不一样。可以通过查看类javax.xml.ws.soap.SOAPBinding来查看里面的常量默认情况下，Jdk1.6只支持soap1.1即：@BindingType(value=javax.xml.ws.soap.SOAPBinding.SOAP11HTTP_BINDING)

WebService和Web服务器有什么区别呢？我们可以把WebService看作是Web服务器上应用；反过来说，Web服务器是WebService运行时所必需的容器。这就是它们的区别和联系。

使用JDK1.6发布的简单Web服务，其内部其实是使用Socket实现。可以查看：SUN公司未对外公布的API类com.sun.xml.internal.ws.transport.http.server. ServerMgr获知，请使用反编译工具。

WebService的特点
WebService通过HTTP POST方式接受客户的请求
WebService与客户端之间一般使用SOAP协议传输XML数据.
它本身就是为了跨平台或跨语言而设计的。

SOAP协议：
SOAP协议与HTTP协议一样，是一种格式化的文本。
也包含请求协议和响应协议。
普通的HTTP协议是指通过GET或是POST方式发送文本串。
而SOAP协议则是指通过POST方式发送XML文本。
所以：SOAP = HTTP + XML。
简单的说：SOAP就是一段XML文件，在XML中定义了调用什么方法及传递什么参数。

调用互联网上WebService查询手机归属地的过程：
首先要从网上查询：手机号归属地的wsdl地址
http://www.webxml.com.cn/zh_cn/web_services.aspx
这个地址上有各种webservice的信息。

查询手机归属地的wsdl:
http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl
运行wsimport生成客户端调用代码：

然后将生成的Java代码拷贝到Java工程中

写测试文件进行测试，结果如下：