Webservice WSDL解析

wsdl解析 

Webservice服务网站：http://www.webxml.com.cn

Wsdl文档从下往上读

Types - 数据类型定义的容器，它使用某种类型系统(一般地使用XML Schema中的类型系统)。（入参和出参的数据类型）
  Message - 通信消息的数据结构的抽象类型化定义。使用Types所定义的类型来定义整个消息的数据结构（入参和出参）。
  Operation - 对服务中所支持的操作的抽象描述，一般单个Operation描述了一个访问入口的请求/响应消息对（方法）。
  PortType- 对于某个访问入口点类型所支持的操作的抽象集合，这些操作可以由一个或多个服务访问点来支持（服务类）。
Binding- 特定服务访问点与具体服务类的绑定（不看内容，看关系）。
Port- 定义为 webservice 单个服务访问点。

 Service- 相关服务访问点的集合。

生成客户端代码

1. wsimport是jdk自带的,可以根据wsdl文档生成客户端调用代码的工具.当然,无论2. 服务器端的WebService是用什么语言写的,都将在客户端生成Java代码.服务器端用什么写的并不重要.

3. wsimport.exe位于JAVA_HOME\bin目录下.

常用参数为:-d<目录>  - 将生成.class文件。默认参数。

•    -s<目录>  -将生成.java文件和class文件。

•    -p<生成的新包名> -将生成的类，放于指定的包下。

•    (wsdlurl) - http://server:port/service?wsdl，必须的参数。

示例：

C:/> wsimport –s . http://192.168.0.100/one?wsdl

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

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

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

调用webservice步骤

1)      打开WSDL文档

2)      从下往上读WSDL文档，先找到Services（服务访问点集合），根据Services里面binding属性找到binding元素，再根据binding元素的type属性找到绑定的portType（服务类）

3)      根据WSDL的地址生成客户端代码wsimport -s . -p com.rl.trans d:/wsCode/EnglishChinese.wsdl

4)      把客户端代码拷贝到项目中

5)      创建服务访问点集合对象

6)      根据服务访问点获得服务类

7)      调用服务类的方法

jdk发布webservice服务

注意：用Jdk1.6.0_21以后的版本发布一个WebService服务.

说明：      在JDK1.6中JAX-WS规范定义了如何发布一个webService服务。

                     JAX-WS是指Java Api for XML –WebService.

与Web服务相关的类，都位于javax.xml.ws.*包中。

主要类有：

a)      @WebService － 它是一个注解，用在类上指定将此类发布成一个webservice服务.

b)      Endpoint – 此类为端点服务类，它的方法publish用于将一个已经添加了@WebService注解对象绑定到一个地址的端口上。Endpoint是jdk提供的一个专门用于发布服务的类，它的publish方法接收两个参数，一个是本地的服务地址，二是提供服务的类。它位于javax.xml.ws.*包中。

static Endpoint.publish(String address,Object implementor) 在给定地址处针对指定的实现者对象创建并发布端点。stop方法用于停止服务。

其他注意事项：

1)      给类添加上@WebService注解后，类中所有的非静态方法都将会对外公布。不支持静态方法，final方法。

2)      如果希望某个方法(非static,非final)不对外公开，可以在方法上添加@WebMethod(exclude=true)，阻止对外公开。

3)      如果一个类上，被添加了@WebService注解，则必须此类至少有一个可以公开的方法，否则将会启动失败。

4)      服务类中不能没有方法

5)      @WebMethod(exclude=true)屏蔽方法