WebService(二)

WsExplorer和Tcp/Ip Monitor工具本身就存在于eclipse和MyEclipse中
使用工具的原因：
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：这是发出的消息格式：
<soapenv:Envelope xmlns:soapenv="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">
- <soapenv:Body>
- <q0:qqCheckOnline>
  <q0:qqCode>870931520</q0:qqCode> 
  </q0:qqCheckOnline>
  </soapenv:Body>
  </soapenv:Envelope>
2：以下是接收到的XML格式
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
- <soap:Body>
- <qqCheckOnlineResponse xmlns="http://WebXml.com.cn/">
  <qqCheckOnlineResult>N</qqCheckOnlineResult> 
  </qqCheckOnlineResponse>
  </soap:Body>
  </soap:Envelope>

采用qqOnlineWebServiceHttpGet或qqOnlineWebServiceHttpPost中的qqCheckOnline验证时，返回的都是
<?xml version="1.0" encoding="utf-8"?>
<string xmlns="http://WebXml.com.cn/">N</string>

使用Tcp/Ip Monitor
TCP/IP Monitor不仅可以看到SOAP数据，还可以获取HTTP请求和接收的头信息。
1、位置：此工具位于：window>show view>other>MyEclipse Common(常用工具)>TCP/IP Monitor
2、此工具，相当于一个代理商，启动后它将监听本地的某个端口，然后再将请求转发给指定的目标IP和端口。
获取到数据后，再将数据原封不动的返回给客户。在客户看来，永远首先访问的都应该是这个代理，否则我们将看不到数据传输的过程。
4、	配置选项：
在打开的TCP/IP Monitor界面上：view Menu(右上方向下的小箭头)>Properties>Add(右侧添加)
设置成以下属性：
第一步：
1）local monitoring port(监听本地的端口号)：9876，随意设置一个4位的端口号，一会将通过http://127.0.0.1:9876的形式访问
2）host name（要监听的服务器，如www.baidu.com）：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文件中查看：<soap:address location=“http:……”/>处地址的变化情况。
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);
}
}