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项目下次再讲