WebService教程详解（二）

使用工具的原因：

1、使用工具可以更好的了解WebService请求的过程

2、使用工具WsExplore可以获取SOAP数据发送和接收的格式

3、使用工具Tcp/Ip Monitor可以监控拦截器请求头和响应头的具体数据

什么是SOAP？

SOAP是一种基于XML编码规范的文本协议，简单的说SOAP就是在HTTP的基础上传输XML数据，以实现远程调用【无论你的服务端是什么语言书写的，只要接收SOAP协议的XML数据，并返回SOAP协议的XML数据，就可以被任何语言调用】

使用WsExplorer实例：验证qq是否在线

采用qqOnlineWebServiceSoap中的qqCheckOnLine验证时，返回的是

qqCheckOnlineResponse
qqCheckOnlineResult (string): N

点击source可以看到详细信息，信息如下：

1：这是发出的消息格式：

复制代码代码如下:

http://schemas.xmlsoap.org/soap/envelope/" xmlns:q0="http://WebXml.com.cn/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
-
-
870931520

2：以下是接收到的XML格式

复制代码代码如下:

http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
-
- http://WebXml.com.cn/">
N

采用qqOnlineWebServiceHttpGet或qqOnlineWebServiceHttpPost中的qqCheckOnline验证时，返回的都是

Nhttp://WebXml.com.cn/">N>

使用Tcp/Ip Monitor

TCP/IP Monitor不仅可以看到SOAP数据，还可以获取HTTP请求和接收的头信息。

1、位置：此工具位于：window>show view>other>MyEclipse Common(常用工具)>TCP/IP Monitor

2、此工具，相当于一个代理商，启动后它将监听本地的某个端口，然后再将请求转发给指定的目标IP和端口。
获取到数据后，再将数据原封不动的返回给客户。在客户看来，永远首先访问的都应该是这个代理，否则我们将看不到数据传输的过程。

3、配置选项：

在打开的TCP/IP Monitor界面上：view Menu(右上方向下的小箭头)>Properties>Add(右侧添加)

设置成以下属性：

第一步：

1）local monitoring port(监听本地的端口号)：9876，随意设置一个4位的端口号，一会将通过http://127.0.0.1:9876的形式访问

2）host name（要监听的服务器，如www.jb51.net）：127.0.0.1 –因为本机发布了一个WebService所以监听本机IP.也可以是任意的主机。

3）Port(要监听的目标服务器的端口)：6666 - 因为我们发布的WebService为http://127.0.0.1:6666/helloworld所以，6666是需要监听的端口号。

4）Type(监听的类型)：
-- TCP/IP ：将使用原始地址继续访问下一个请求，如用户输入：http://127.0.0.1:9876/helloworld?wsdl此时将返回wsdl服务访问地址同前。

-- HTTP ：将使用目标地址继续访问下一个请求。如用户输入： http://127.0.0.1:9876/helloworld?wsdl在请求方法时将使用http://127.0.0.1:6666 /helloworld来访问sayHi方法。此种方式将不再会被代理。因为已经不是正在监听的端口号了。

在监听类型处，我选择了TCP/IP，然后通过在地址栏输入：http://127.0.0.1:9876/helloworld?wsdl，在返回的wsdl文件中查看：处地址的变化情况。

time out：设置访问不成功的连接时间，保持为0,即不设置。

在设置好后，点OK按扭，然后再点右方的Start按扭，监听便已经启动。

第二步：

在MyEclipse的WebService上配置WSDL URL为：http://127.0.0.1:9876/helloworld?wsdl，注意使用的是MyEclipse TCP/IP Monitor的端口。而不是直接去访问我们发布的http://127.0.0.1:6666/helloworld?wsdl

如何修改wsdl文件的内容？

使用WebService的注解。

1、 @WebService-定义服务

2、 @WebMethod-定义方法

3、 @WebResult-定义返回值

4、@WebParam-定义参数

注意：对于注解，不同的版本支持程度不相同：

1、1.5不支持.

2、1.6.0_20前版本必须使用完整注解.

3、1.6.0_21以后可以只使用@WebService对类进行注解.

注释的作用：

通过WebService的注解，可以更加形像的描述Web服务。从而生成WSDL文档。

当修改了WebService注解之后，同时会影响客户端生成的代码。

调用的方法名和参数名也发生了变化。

示例：

@WebService(name="myName",//对应portType name="myName"

portName="myPort", //对应服务中的port name="myPort"

serviceName="myService",//对应service name="myService"

targetNamespace="http://leaf.com/mynamespace")//可以随意书写类似于java中的package

public class HelloWorld{

private static SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");

@WebMethod(action="myAction",//定义一个soapAction="myAction"用于找到这个方法以执行

operationName="myOperationName")//定义可以调用的方法，会生成相应类的具体方法，operation name=".."

public @WebResult(name="mySayHelloResult")String//定义返回值的名称

sayHello(){

return "HelloWorld";

}

@WebMethod(action="mySayHiAction",operationName="mySayHiOperationName")

public @WebResult(name="mySayHiResult")String sayHi(@WebParam(name="myParaName",

//将参数放到头信息中，用于保护参数，默认在body中

header=true,

mode=Mode.IN)

String name){

String str = "你好："+name+"，当前时间是："+sdf.format(new Date());

return str;

}

public static void main(String[] args) {

Endpoint.publish("http://127.0.0.1:6666/helloworld",new HelloWorld());

}

3:将上面的程序对外发布以后，我们通过MyEclipse的WebService Explorer来访问

你会发现和以前不一样的提示信息，但其实，仍然还是调用的那同一个方法。

4：再次使用wsimport –s . http://127.0.0.1:6666/helloworld?wsdl生成java代码然后调用
以下是调用代码（可以用面目全非来形容，但完成的还是同样的工作。）

package com.leaf.mynamespace;

public class Main {

public static void main(String[] args) {

//通过分析wsdl可知从myService中调用getMyPort返回myName

MyName myName = new MyService().getMyPort();

//通过myName的mySayHiOperationName来调用sayHi方法

String str = myName.mySayHiOperationName("王健");

System.err.println(str);

}

来源：oschina

链接：https://my.oschina.net/u/2632055/blog/702862

标签

wsdl

string

myname

科技新闻