WebService客户端三种调用方式整理

1 WebService基础
1.1 作用
1,       WebService是两个系统的远程调用,使两个系统进行数据交互,如应用:


天气预报服务、银行ATM取款、使用邮箱账号登录各网站等。


2,       WebService之间的调用是跨语言的调用。Java、.Net、php,发送Http请求,使用的数据格式是XML格式。


3,       webxml.com.cn上面有一些免费的WebService服务,可以进去看看。


1.2 应用基础
4,       基础概念:


(1),理解服务:


现在的应用程序变得越来越复杂,甚至只靠单一的应用程序无法完成全部的工作。更别说只使用一种语言了。因此需要访问别人写的服务,以获得感兴趣的数据。


在写应用程序查询数据库时,并没有考虑过为什么可以将查询结果返回给上层的应用程序,甚至认为,这就是数据库应该做的,其实不然,这是数据库通过TCP/IP协议与另一个应用程序进行交流的结果,而上层是什么样的应用程序,是用什么语言,数据库本身并不知道,它只知道接收到了一份协议,这就是SQL92查询标准协议。


目前的云计算、云查杀都是一种服务,现在比较流行的说法是SOA(面向服务的框架)。


既然数据库可以依据某些标准对外部其他应用程序提供服务、而且不关心对方使用什么语言,那我们为什么就不能实现跨平台、跨语言的服务呢?


只要我们用Java写的代码,可以被任意的语言所调用,我们就实现了跨平台,跨语言的服务!---WebService


因此,WebService,顾名思义就是基于Web的服务。它使用Web(HTTP)方式,接收和响应外部系统的某种请求。从而实现远程调用.


我们可以调用互联网上查询天气信息Web服务,然后将它嵌入到我们的程序(C/S或B/S程序)当中来,当用户从我们的网点看到天气信息时,他会认为我们为他提供了很多的信息服务,但其实我们什么也没有做,只是简单调用了一下服务器上的一段代码而已。


学习WebService可以将你的服务(一段代码)发布到互联网上让别人去调用,也可以调用别人机器上发布的WebService,就像使用自己的代码一样。


(2),基础概念:XML


XML Extensible Markup Language -扩展性标记语言


XML,用于传输格式化的数据,是Web服务的基础。


namespace-命名空间。


(3),基础概念:WSDL


WSDL – WebService Description Language – Web服务描述语言。


通过XML形式说明服务在什么地方-地址。address location


通过XML形式说明服务提供什么样的方法 – 如何调用。operation


(4),基础概念:SOAP


SOAP-Simple Object Access Protocol(简单对象访问协议)


SOAP作为一个基于XML语言的协议用于网上传输数据。


SOAP = 在HTTP的基础上+XML数据。


SOAP是基于HTTP的。


SOAP的组成如下:


Envelope – 必须的部分。以XML的根元素出现。


Headers – 可选的。


Body – 必须的。在body部分,包含要执行的服务器的方法。和发送到服务器的数据。


传递的数据格式:


<Envelope>


      <Header></Header>


      <Body>


                <方法名>


                          方法参数


        </方法名>


      </Body>


</Envelope>


(5),请求示例:


          以下发出HTTP请求,但不同的是向服务器发送的是XML数据!






  说明:(1),因为是在HTTP上发数据,所以必须先遵循HTTP协议


          (2),XML部分即SOAP协议,必须包含Envelope和Body元素。


(6),响应示例:






1.3 应用说明
1,WebService通过HTTP协议完成远程调用


(1),WebService只采用HTTP POST方式传输数据,不使用GET方式;  -- 握手,WSDL-get,(基于soap协议,传输数据格式是XML)


普通http post的contentType为


application/x-www-form-urlencoded


WebService的contentType为-即在Http的基础上发SOAP协议


text/xml 这是基于soap1.1协议。


application/soap+xml 这是基于soap1.2协议。


 (2),WebService从数据传输格式上作了限定。WebService所使用的数据均是基于XML格式的。目前标准的WebService在数据格式上主要采用SOAP协议。SOAP协议实际上就是一种基于XML编码规范的文本协议。


 (3),SOAP – Simple Object Access protocol 简单对像访问协议。是运行在HTTP协议基础之上的协议。其实就是在HTTP协议是传输XML文件,就变成了SOAP协议。


 (4),SOAP1.1和SOAP1.2的 namespace不一样。可以通过查看类


javax.xml.ws.soap.SOAPBinding来查看里面的常量


默认情况下,Jdk1.6只支持soap1.1


即:@BindingType(value=javax.xml.ws.soap.SOAPBinding.SOAP11HTTP_BINDING)


1.4 WebService与Web的区别与联系
可以把WebService看作是Web服务器上应用;反过来说,Web服务器是WebService运行时所必需的容器。这就是它们的区别和联系。


 


1.5 WebService的特点
       WebService通过HTTP POST方式接受客户的请求(如果基于soap协议,传输数据格式是XML),只能是POST方式,因为GET方式没有请求体。


WebService与客户端之间一般使用SOAP协议传输XML数据.


它本身就是为了跨平台或跨语言而设计的。


(1)               SOAP1.2注意:当使用SOAP12以后,wsimport和Eclipse和WSExplorer都不可以正常使用了,必须使用cxf提供的wsdl2java工具生成本地代码。


(2)               客户端最好发送1.1请求,而服务端最好使用1.2高版本。


2 应用示例
2.1 发布WebService服务(使用Jdk1.6.0_21以后的版本)
1,使用Jdk1.6.0_21以后的版本发布一个WebService服务(使用注解方式)


与Web服务相关的类,都位于javax.jws.*包中。


主要类有:


@WebService - 它是一个注解,用在类上指定将此类发布成一个ws。


Endpoint – 此类为端点服务类,它的方法publish用于将一个已经添加了@WebService注解对象绑定到一个地址的端口上。


(1)一个简单的Java项目,HelloService


①建立如下包结构:


 


 ②新建带有main方法的类HelloService.java,并在类上加@WebService的注释。


在类中使用EndPoint类的publish方法:


还需要至少提供一个可以发布的方法:(方法不能是静态并且是非final的),只有这样的方法才可被发布。


@WebService


public class HelloService {


     public String sayHello(String name){


          System.out.println("sayHello Called...");


          return "hello   "+name;


     }


     public static void main(String[] args){


          //参数1:绑定服务的地址


          //参数2:提供服务的实例


     Endpoint.publish("http://124.205.244.130:5678/hello", new HelloService());


          System.out.println("server ready...");


     }


}


使用EndPoint.publish()方法将会新开启一个线程,所以并不会影响主线程的运行,所以运行主方法时,控制台仍然可以看到有输出:server ready的信息。


③服务发布成功后,在客户端调用:


启动服务后,在浏览器中输入绑定的服务地址+”?wsdl”即可查看服务的说明书。wsdl- WebService Description Language,是以XML文件形式来描述WebService的”说明书”,有了说明书,我们才可以知道如何使用或是调用这个服务.


④使用wsimport –s . http://124.205.244.130:5678/hello?wsdl


即可生成客户端代码。(包含.class文件和.java文件)


此处注意:是生成而不是下载,服务器上并没有所生成的所有的类和方法。


⑤新建一个Java项目HelloService_Client做客户端,将.java文件打包一起放在此项目下,调用:


public class App {


    public static void main(String[] args) {


         /**


          * wsdl:<service name = "HelloServiceService">


          */


         HelloServiceService has = new HelloServiceService();


         /**


*wsdl:<port name="HelloServicePort" bind="tns:HelloServicePortBinding">


          */


         HelloService soap = has.getHelloServicePort();


         String str= soap.sayHello("zhangan");


         System.out.println(str);


    }


}


即可在客户端的控制台上可见:hello   zhangsan,完成客户端的调用


说明:


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://192.168.0.100/one?wsdl


C:/> wsimport –s . –p com.sitech.web


http://192.168.0.100/one?wsdl


注意:-s不能分开,-s后面有个小点,用于指定源代码生成的目录。点即当前目录。


如果使用了-s参数则会在目录下生成两份代码,一份为.class代码。一份为.java代码。


.class代码,可以经过打包以后使用。.java代码可以直接Copy到我们的项目中运行。


 


2,通过wsimport生成本地代码,调用网络上的web服务,比如手机号码归属地服务。


进入xml.com.cn找到手机号码归属地服务的wsdl:


复制使用wsimport命令,将生成的java代码拷贝到MobileService项目下。


 


在客户端的调用:


public static void main(String[] args) {


          MobileCodeWS mc = new MobileCodeWS();


          MobileCodeWSSoap soap = mc.getMobileCodeWSSoap();


          String str = soap.getMobileCodeInfo("13011286707", null);


          System.out.println(str);


}


客户端控制台打印:


北京  联通


说明:在WebService客户端和服务端都使用了代理类,因此客户端访问服务端的是代理对象,客户端和服务端交互时都使用代理对象。


3,使用wsimpot生成客户端调用代码时,若wsdl使用的是本地文件,那么生成客户端代码后若将wsdl本地文件删除,则在调用过程中,会出现本地文件找不着的错误。这时候只需要将引用本地wsdl文件的代码替换成wsdl的url地址即可。


2.2 客户端调用WebService的方式
通过wsimport生成客户端代码


通过客户端编程的方式调用


通过ajax调用 (js+XML)


通过URLConnection调用


2.2.1 通过wsimport生成客户端代码


参见2.1


2.2.2 通过客户端编程的方式调用


(1),使用javax.xml.ws.Service类用于访问web服务


(2),关键类Service


方法create – 用户创建Service对像,提供wsdlurl和服务名。


getPort-用于通过指定namespace,portName和接口的范型。


在客户端需要一个与服务器接口完全相同的类。(仍然使用工具生成。但只需要一个接口。并需要简单修改。如果返回的是复杂数据类型如POJO,还需要将POJO一并放到项目中)。


         App.class文件:


     Service s =


Service.create(new URL(“http://192.168.1.108:5678/hello?wsdl”),


                     new QName(targetNamespace,serviceName)


);


HelloService hs = s.getPort(portName,serviceEndpointInterface);


(注意:这里portName=new QName(targetNamespace,portName))


String str = hs.sayHello(“Lisi”,10);


System.out.println(str);                    //打印hello Lisi


说明 :关键类QName – 被称为完全限定名即:Qualified Name的缩写。


QName 的值包含名称空间 URI、本地部分和前缀。


客户端编程的方式不常用。


 


2.2.3 通过Ajax调用(js+XML)


(1),写一个页面,发送Ajax请求,请求的URL即服务的地址,请求方式是POST,另外,还需要设置请求头,以及手动构造请求体。


<body>


          <input type="text" id="msg" />


          <input type="button" οnclick="sendAjaxWS();" value="通过ajax调用webservice服务"/>


</body>


 <head>


          <title>通过ajax调用webservice服务</title>


          <script>


               var xhr;


               function sendAjaxWS(){


                    xhr = new ActiveXObject("Microsoft.XMLHTTP");                 


                   //指定ws的请求地址


                    var wsUrl = "http://192.168.1.108:5678/hello";


                    //手动构造请求体


      var requestBody = '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" ' + '         xmlns:q0="http://service.itcast.cn/" xmlns:xsd="http://www.w3.org/2001/XMLSchema "'+


' xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">'+


     '<soapenv:Body><q0:sayHello><arg0>'+


document.getElementById("msg").value+'</arg0> <arg1>10</arg1> </q0:sayHello></soapenv:Body></soapenv:Envelope>';


      //打开连接


                 xhr.open("POST",wsUrl,true);


                //重新设置请求头       xhr.setRequestHeader("content-type","text/xml;charset=utf8");


               //设置回调函数


                xhr.onreadystatechange = _back;


                //发送请求


                xhr.send(requestBody);


            }


               //定义回调函数


               function _back(){


                    if(xhr.readyState == 4){


                         if(xhr.status == 200){


                              var ret = xhr.responseXML;


                              //解析xml


                              var eles = ret.getElementsByTagName("return")[0];


                              alert(eles.text);


                         }


                    }


               }


          </script>


     </head>


由于使用ajax – js调用web服务完成不同于使用java代码调用。所以,必须要对SOAP文件非常的了解。


一般使用ajax调用,应该是在已经获知了以下信息以后才去调用:


获知请求(request)的soap文本。


获知响应(response)的soap文本。


请求文件和响应文本格式,一般会随web服务的发布一同发布。


我们可以通过WSExplorer获取上面两段文本。


2.2.4 通过URLConnection调用


         1,指定WebService服务的请求地址:


        String wsUrl = "http:// 124.205.244.130:5678/hello";


     2,创建URL:URL url = new URL(wsUrl);


       3,建立连接,并将连接强转为Http连接


URLConnection conn = url.openConnection();


          HttpURLConnection con = (HttpURLConnection) conn;


       4,设置请求方式和请求头:


          con.setDoInput(true);                  //是否有入参


          con.setDoOutput(true);                //是否有出参


          con.setRequestMethod("POST");   // 设置请求方式


          con.setRequestProperty("content-type", "text/xml;charset=UTF-8");


      5,// 手动构造请求体


               String requestBody = "<soapenv:Envelope xmlns:soapenv=\"http://schemas.xmlsoap.org/soap/envelope/\" "


                         + " xmlns:q0=\"http://service.itcast.cn/\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema \" "


                         + " xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\">"


                         + "<soapenv:Body><q0:sayHello><arg0>lisi</arg0> <arg1>10</arg1> </q0:sayHello></soapenv:Body></soapenv:Envelope>";


   6,通过流的方式将请求体发送出去:


         //获得输出流


         OutputStream out = con.getOutputStream();


         out.write(requestBody.getBytes());


         out.close();


    7,服务端返回正常:


   int code = con.getResponseCode();


       if(code == 200){//服务端返回正常


         InputStream is = con.getInputStream();


         byte[] b = new byte[1024];


         StringBuffer sb = new StringBuffer();


         int len = 0;


         while((len = is.read(b)) != -1){


             String str = new String(b,0,len,"UTF-8");


             sb.append(str);


        }


        System.out.println(sb.toString());


        is.close();


       }


       con.disconnect();


}
  • 0
    点赞
  • 3
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值