WSDL starter

一个WSDL中，definition是整个文档的根元素，一个文档中可能存在多个Service元素，service是服务的入口点。 Service 中可能有多个port，每个port对应一个PortType，PortType可能对应一组operation

总体来说，WSDL有两部分功能，客户端Stub（存根）和服务器端Skeleton（）的生成。

其中客户端Stub负责根据用户参数打包成SOAP消息；服务器端Skeleton的生成是可选的，负责具体的类调用的外包

先说第一部分，WSDL2JAVA处理WSDL生成前端Stub的过程。

通常WSDL文件包含：

1、类型：定义复合数据类型

2、消息：由类型组合成消息（可以作为下面操作的参数）（疑问？：分为类型和消息，直接放在一个组为啥不行）

3、操作：其中定义可以调用的操作，每个操作的参数。操作的集合对外呈现一个接口

4、绑定：定义每个操作具体的调用方式，数据的编码方式（）

5、服务：对外呈现服务，可以包含多个绑定

6、端口：远程地址

其中，1，2，3被称为逻辑的描述； 4，5，6用来描述具体的服务地址和参数编码方式

1、类型定义的转换

把WSDL中类型的定义部分，转化成对应JAVA类。

public class Phone implements java.io.Serializable {...}

WSDL2JAVA生成了一个新的类和WSDL中定义的类型对应，并且为每个成员定义get和set函数，还把每个字段的首字母大写。

2、接口

生成一个接口，对外呈现描述的各个接口。message代表输入输出参数，生成的代码将把message的各个部分罗列在参数表中。

public interface AddressBook extends java.rmi.Remote {

public void addEntry(String name, Address address) throws java.rmi.RemoteException;

}

3、绑定

从其父类可以看出，他继承自org.apache.axis.client.Stub和具体实现类。

在stub中将把方法调用转化为SOAP调用，另一面它也继承了具体类的所有接口。

public class AddressBookSOAPBindingStub extends org.apache.axis.client.Stub

implements AddressBook {

public AddressBookSOAPBindingStub() throws org.apache.axis.AxisFault

{...}

4、服务

将形成一个接口：

public interface AddressBookService extends javax.xml.rpc.Service {

public String getAddressBookAddress();

public AddressBook getAddressBook() throws javax.xml.rpc.ServiceException;

public AddressBook getAddressBook(URL portAddress) throws 

javax.xml.rpc.ServiceException;

}

还会产生一个Locator实现上面的接口：

public class AddressBookServiceLocator extends org.apache.axis.client.Service

implements AddressBookService {

...

}

下面是一个具体的调用过程：

public static void main(String [] args) throws Exception {

// 生成一个locator

AddressBookService service = new AddressBookServiceLocator();

// 生成一个具体的生成Service的类

AddressBook port = service.getAddressBook();

// 现在可以调用了

Address address = new Address(...);

port.addEntry("Russell Butek", address);

}