初学webservices

来源:互联网 时间:1970-01-01

首先我把我做webservices应用的流程写出来,有个明了的过程。
编写wsdl生成服务端框架编写功能类在服务端框架内调用功能类发布服务,从生成的deploy.wsdd文件中,拷贝service内容到server-config里面在web.xml中添加axis servlet发布工程使用soapUI测试编写客户端代码
我解释一下,因为一般给你的需求,基本上确定你需要的功能和传入的参数、返回的参数,所以直接编写wsdl,简洁明确。以后的改动若添加功能或者修改参数,仅需要对wsdl文件进行修改。
我使用的是Axis,在ant调用wsdl文件转化成服务框架代码。每次启动时做,就不用自己动手了。
外面工程想调用你本地的功能,去获得相应的结果。这个功能类作用就是把传入的参数封装一下,去调用你本地已经写好的功能,然后把获得结果重新封装一下,返回客户想要的结果。功能类就是HelloHelp。
外部调用你这边的代码,最终是通过该类HelloServiceHttpBindingImpl.java去操作,所以在这里去调用你相应的功能类的方法。因为这个类存在所以不会覆盖该类,这时大家会有疑问,如果我改动了wsdl文件,HelloServiceHttpBindingImpl的内容会变,我是不是又要手动去删除该类。其实只要你的wsdl文件中的功能名字不变,然后定义一个的封装参数类去封装你的传入参数,和传出参数,那样*SoapBindingImpl类就不会变了,你添加或修改参数,都不会影响到*SoapBindingImpl类了。
生成的内容里面会有deploy.wsdd文件,你要把你的服务复制到server-config文件中,这样才能发布出去。server-config你可以复制一个,然后替换掉service。这个文件基本上就只需要你动service这块内容,如有复杂点自己在慢慢该,如handler处理,在这就就不介绍了。或者你用命令java org.apache.axis.client.AdminClient deploy.wsdd 这样也可以生成server-config,记得要把axis放在容器里跑起来,然后考入到与web.xml同级目录
你要想工程处理你的webservice,那么你必须要servlet里面加入axis servlet,这样才会处理你的webservice。
发布工程。
然后你就是用soapUI测试你服务端这边是否弄好了。
最后编写客户端代码。

大家可以看到最后一步操作是在客户端工程里面,前面都是在服务端工程里面。这二个不是同一个工程,服务端工程只要把功能暴露出来,其它工程就可以根据你的wsdl文件去调用。

讲完整个应用的流程后,我具体介绍一下,从上面的步骤大家可以明白,我们主要做的就是2步,写wsdl和写功能类。功能类就需要你自己根据你实际项目去做,我在这里介绍一下编写wsdl。

WSDL文件主要包含一下内容:
Types - 数据类型定义。 也就是定义的要传入传出的参数
Message - 通信消息的数据结构的抽象类型化定义。
PortType - 对于某个访问入口点类型所支持的操作的抽象集合。主要就是里面定义的operation。
Operation - 对服务中所支持的操作的抽象描述。这里就是你写你要得功能。
Binding - 特定端口类型的具体协议和数据格式规范的绑定。通过它暴露你的功能
Service- 相关服务访问点的集合。包含下面的port
Port - 定义为协议/数据格式绑定与具体Web访问地址组合的单个服务访问点。访问的地址和端口号。

举个领子可能大家明白些:

Types:

<element><complexType><sequence><element type="xsd:string" maxOccurs="1"minOccurs="1" /><element ref="ns:hello" /></sequence></complexType></element><element type="ns:Hello" /><complexType><sequence><element type="xsd:string" maxOccurs="1"minOccurs="1" /><element type="xsd:string" maxOccurs="1"minOccurs="1" /></sequence></complexType><element><complexType><sequence><element type="xsd:string" maxOccurs="1"minOccurs="1" /></sequence></complexType></element>

元素helloRequestParameter,hello,helloResponseParameter,用Axis生成java文件后,就生成helloRequestParameter,hello,helloResponseParameter 3个类。

Message:
<message><part element="ns:helloRequestParameter" /></message><message><part element="ns:helloResponseParameter" /></message>

这里用我的意思来讲,就是要把你传入,传出参数声明,你样你的2个参数才能使用。part里面name参数名,element参数类型。

PortType,Operation
<portType><operation><input message="cs:helloRequest" /><output message="cs:helloResponse" /></operation></portType>

定义了功能,sayHello方法名,input,output输入,返回参数。

Binding:
<binding type="cs:HelloServicePortType"><SOAP:binding transport="http://schemas.xmlsoap.org/soap/http" /><operation><SOAP:operation soapAction="urn:helloService:webService:com#sayHello" /><input><SOAP:body use="literal" /></input><output><SOAP:body use="literal" /></output></operation></binding>

基本上固定的,不用你修改什么。

service,port:
<service><port binding="cs:HelloServiceHttpBinding"><SOAP:address location="http://localhost:8080/webServiceTest/services/HelloServiceHttpPort" /></port></service>

定义了你的服务名HelloServiceInterface,端口名HelloServiceHttpPort 和发布的地址http://localhost:8080/webServiceTest/services/HelloServiceHttpPort

调用axis的WSDL2Java,会生成6个类
HelloServicePortType 你发布的services接口文件
HelloServiceHttpBindingImpl 实现了services接口,服务器需补充的内容
HelloServiceHttpBindingSkeleton services的服务端框架代码,实现了services,skeleton接口
HelloServiceInterface 获取services接口文件
HelloServiceInterfaceLocator 实现获取services接口文件
HelloServiceHttpBindingStub services的客户端存根代码,实现services接口
这几个类包含客户端和服务端的,前面3个是服务端的,后面3个加第一个是客户端的。

这是Ant把wsdl文件转换成java文件
<target><java classname="org.apache.axis.wsdl.WSDL2Java" classpathref="lib" fork="true" jvm="${JAVA_JVM}"><arg value="-W" /><arg value="-a" /><arg value="--skeletonDeploy" /><arg value="true" /><arg value="-o" /><arg value="./src" /><arg value="./wsdl/Hello.wsdl" /></java></target>

这里只是简单的转化了一下,还要考虑到其它问题的,以后再更新。

直接在命令行里面转换wsdl
java org.apache.axis.wsdl.WSDL2Java -W -a --skeletonDeploy true -o code Hello.wsdl

需要axis commons-discovery-0.2 commons-loggin-1.04 jaxrpc wsdl4j-1.5.1这几个类写到环境变量里面,才能在命令行里面调用。

遇到的问题:
1. there is no undefined binding problem?
solution:when you reference the tns:HelloServicePortType and tns:HelloServiceHttpBinding,the xmlms:tns should same to your targetNamespace。
2. Invalid element in com.webService.helloService.schema.HelloRequestParameter - arg0
I debug the code, find the operationName is null cause this problem, so i add call.setOperation(_operations[0]), then it work fine. you can refer the code from *BindingStub.java, and copy the code to your project.

webServiceTest这是服务端代码,我没有把run工程也写在ant里面,所以需要你先调用ant,在跑工程。
TestWebService是客户端代码,客户端的代码,可以根据wsdl文件生成,然后调用。本来也想直接创建call调用,可是没成功,就是遇到的第二个问题,暂时没解决。
经过了调试代码终于发现了问题,菜鸟水平的英语大家还看得懂吧,就是operationName为空引起异常,所以我从HelloServiceHttpBindingStub中把call.setOperation(_operations[0])这段代码考了过来发现没问题了。只是很疑惑为什么我从网上看大家写的客户端调用都没这段代码,难道是跟版本有问题嘛,希望大家指出来。
解压密码123456.

简单的ws了解了一下,有些还没具体弄清楚,希望再接再厉,若有错误,大家一定要指出来。

webServiceTest.zip (2 MB) 下载次数: 39 TestWebService.zip (2 MB) 下载次数: 41



相关阅读:
Top