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.2cto.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); 
} 
}