java webservice 总结（学会读别人的webservice并且通过代理模式访问）
公司做的系统之间的交互用到了webservice做交互，现在对webservice做一个总结。
1.配置已有的webservice
webservice主要包括
- xml/json：作为传输数据的格式
- soap：（simple object access protocol）对于http做的封装，是webservice用的服务协议。也有一种说法是：http+xml+soap = webservice
- wsdl:webservice define language:这是webservice的规范文件。
一般webservice的访问包括四种格式：
- http-get
- http-post
- soap-get
- soap-post
java对webservice的支持没有.net做的那么好，只能支持其中一种（soap-post），下面就用http-get使用HttpURLConnection做的webservice的调用
首先登陆http://www.webxml.com.cn/zh_cn/index.aspx右边有个最新webservice
这里用中文<>英文双向翻译web服务作为例子，打开页面点击其中的服务说明，如图所示(不好意思，qq截图不知道怎么的打不了中文，我就用简单的英文代替了)
打开：是关于这个webservice的WSDL文件，这个文件我们等下再去分析，我们此时只需要拖到最下面，找到http-get 所需要用的URL，最下面应该会有四种访问方式的URL，我们只需要http-get的就可以了。
url应该是：http://fy.webxml.com.cn/webservices/EnglishChinese.asmx，然后我们回到上一个页面，选择：TranslatorSentenceString
这里不选上一个是因为java对webservice没有.net支持的那么好，没法用dataset去接，如图所示：
打开之后，发现需要输入参数wordkey：
我们可以开始写代码了，用HttpURLConnection写一个调用http-get方法的访问类。
package com.mz.webservice.b; import java.io.ByteArrayOutputStream; import java.io.InputStream; import java.net.HttpURLConnection; import java.net.URL; public class TransLatorService { public void translate(String keyWord) { //我们要调用的webservice的url地址，我们用拼接字符串的形式用?wordKey=xxx来进行拼接 String httpUrl = "http://fy.webxml.com.cn/webservices/EnglishChinese.asmx/Translator?wordKey="+keyWord; try { URL url = new URL(httpUrl); HttpURLConnection conn = (HttpURLConnection)url.openConnection(); //设置访问时间 conn.setConnectTimeout(5000); //访问方式为get conn.setRequestMethod("GET"); //如果连接成功，则把返回的数据读入buffer中 if(conn.getResponseCode() == HttpURLConnection.HTTP_OK) { InputStream is = conn.getInputStream(); ByteArrayOutputStream boas = new ByteArrayOutputStream(); byte[] buffer = new byte[10240]; int len = -1; while((len = is.read(buffer)) != -1) { boas.write(buffer, 0, len); } System.out.println("the output is:" + boas.toString("UTF-8")); boas.close(); is.close(); } } catch (Exception e) { // TODO Auto-generated catch block e.printStackTrace(); } } public static void main(String[] args) { TransLatorService ts = new TransLatorService(); ts.translate("death"); } }
返回值应该是一个关于单词“death”的xml
the output is:<?xml version="1.0" encoding="utf-8"?> <DataSet xmlns="http://WebXml.com.cn/"> <xs:schema id="Dictionary" xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata"> <xs:element name="Dictionary" msdata:IsDataSet="true" msdata:UseCurrentLocale="true"> <xs:complexType> <xs:choice minOccurs="0" maxOccurs="unbounded"> <xs:element name="Trans"> <xs:complexType> <xs:sequence> <xs:element name="WordKey" type="xs:string" minOccurs="0" /> <xs:element name="Pron" type="xs:string" minOccurs="0" /> <xs:element name="Info" type="xs:string" minOccurs="0" /> <xs:element name="Translation" type="xs:string" minOccurs="0" /> <xs:element name="Mp3" type="xs:string" minOccurs="0" /> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="Refer"> <xs:complexType> <xs:sequence> <xs:element name="Rel" type="xs:string" minOccurs="0" /> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="Sentence"> <xs:complexType> <xs:sequence> <xs:element name="Orig" type="xs:string" minOccurs="0" /> <xs:element name="Trans" type="xs:string" minOccurs="0" /> </xs:sequence> </xs:complexType> </xs:element> </xs:choice> </xs:complexType> </xs:element> </xs:schema> <diffgr:diffgram xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1"> <Dictionary xmlns=""> <Trans diffgr:id="Trans1" msdata:rowOrder="0"> <WordKey>death</WordKey> <Pron>deθ</Pron> <Info /> <Translation>n. 死,死亡；死神</Translation> <Mp3>1694.mp3</Mp3> </Trans> <Sentence diffgr:id="Sentence1" msdata:rowOrder="0"> <Orig>That motorbike will be the death of you.</Orig> <Trans>那辆摩托车就会要了你的命。</Trans> </Sentence> <Sentence diffgr:id="Sentence2" msdata:rowOrder="1"> <Orig>That defeat meant the death of all my hopes.</Orig> <Trans>那次失败毁灭了我所有的希望。</Trans> </Sentence> <Sentence diffgr:id="Sentence3" msdata:rowOrder="2"> <Orig>Car accident caused many deaths.</Orig> <Trans>车祸造成很多人死亡。</Trans> </Sentence> </Dictionary> </diffgr:diffgram> </DataSet>
我们剩下需要做的就是对这个xml进行解析，自己封装一个解析类和方法，这样做是很费时费力的，所以java提供了一套自己的机制。
我们可以直接封装成实体类，直接调用方法，传递实体类返回实体类的方法来进行调用。
通过wsimport 命令进行生成相应的webservice的实体类。(提醒：必须配置java的环境变量，请自行上网参考，如果不会配置，并且需要jdk1.6_21的版本以上，否则会报错！并且，请保持项目中的jre和控制台版本的一致性！)
语法 wsimport [opations] <wsdl_uri>
- wsdl_uri:wsdl 的统一资源标识符
- d ：指定要输出的文件的位置
- s ：表示要解析java的源码 ，默认解析出的是class字节码
- p ： 指定输出的包名
好比我们如果要把刚刚的webservice服务进行相应的实体类的转换，就是：
wsimport http://fy.webxml.com.cn/webservices/EnglishChinese.asmx?WSDL
这里只会生成字节码文件，没有.java文件，并且字节码文件会出现在你控制台目前的路径下，所以这里先cd到了桌面，如图所示：
这里报错了，说明不能把相应的WSDL转为我们需要的代理类，那么我们就可以把相应的网页的xml报错到本地，命名随意，我就命名的a.xml(因为其实命令是解析一个wsdl文件，那么不管是解析网页的还是本地的其实是一样的)
找到相应的错误的地方（line 19 line 105）如图所示
既然没有办法解析，那么就把这一行删除掉，然后重新解析，命令如下：
cd Desktop（先转移到桌面，因为xml文件是报错在桌面的）
wsimport a.xml
warning是对其他几种方式的不能解析，所以没有error就算是解析成功了，如图所示：
如果需要相应的指定，需要:
wsimport -s ./ -p com.hp.webservice.getTranslatorInfo a.xml
这里的-s是指的要生成的源码地址，-p是包名，如下图所示：
这个时候就可以新建一个项目，然后把上面生成的java文件拷到src目录下（此处不截图了，因为我们要分析一个最重要的东西，就是WSDL文件）
首先必须说明WSDL文件是从下往上看的：
往回找，如图所示：
接着往上找：
接着向上找
最后找到参数类型：
tips：我知道有人会说那上面有的地方有中文解释为什么还要找，我只想说很多时候很多公司内部的WSDL文件没那么友好，至少我们公司就没有！所以还是一步一步的
找上去吧，还有一个是最后的返回类型是TranlatorResult，有人说找不到，这个是定义在别的xml文件里的，就不去找了，反正知道返回的是一个List就可以了，下一篇我们自己来创建webservice项目会再说明的
综上的WSDL文档所述：
- 这个webservice的service name：EnglishChinese
- 我们所用的soap：EnglishChineseSoap
- 调用方法名：TranslatorString
- 输入类型：String
- 输出类型：TransLatorResult（在生成的代理文件里是AraayOfString）
好了，下面我们写一个测试类：
package com.hp.webservice.getTranslatorInfo.test; import java.util.List; import com.hp.webservice.getTranslatorInfo.ArrayOfString; import com.hp.webservice.getTranslatorInfo.EnglishChinese; import com.hp.webservice.getTranslatorInfo.EnglishChineseSoap; public class GetTranslatorTest { public static void main(String[] args) { //首先先获得一个服务 EnglishChinese eng = new EnglishChinese(); //通过服务获取其中一种的soap方式 EnglishChineseSoap soap = eng.getEnglishChineseSoap(); //调用translatorString方法，并且传递一个英文单词作为参数 ArrayOfString arrays = soap.translatorString("death"); //返回是一个webservice自定义的类型，我们需要通过getString方法获得List List<String> infos = arrays.getString(); //通过xml文档分析，list中的第四个元素是单词释义，输出单词释义 System.out.println(infos.get(3)); } }
输出结果应该是：
n. 死,死亡；死神
好了，到这里我们基本可以去使用别人的webservice了，自己建一个webservice项目下次再讲
