详细介绍WSDL文档

首先如何生成一个wsdl文档，通过以下的程序暴露一个wsdl文档供大家用

第一步：创建一个接口，该接口有二个函数，一个简单一些，另一个复杂一些。

package yy;

import java.util.List;
import javax.jws.WebService;

import yy.domain.Cat;
import yy.domain.User;

@WebService
public interface HelloWorld {
public String sayHi(String name);
public List<Cat> getCatsByUser(User user);
}

第二步：创建一个实现类，去实现该接口：

package yy.impl;
import java.util.Date;
import java.util.List;
import javax.jws.WebService;
import service.UserService;
import service.impl.UserServiceImpl;
import yy.HelloWorld;
import yy.domain.Cat;
import yy.domain.User;

@WebService(endpointInterface="yy.HelloWorld",serviceName="HelloWorldWS")
public class HelloWorldWS implements HelloWorld{
@Override
public String sayHi(String name) {
return name +"  你好"+"现在的时间是"+new Date();
}
@Override
public List<Cat> getCatsByUser(User user) {
//zai shijixiangmuzhong ,Web Service 自己并不会去实现业务逻辑，
//而去调用已有的业务逻辑
UserService service=new UserServiceImpl();
return service.getCatsByUser(user);
}
}

package yy.domain;
public class Cat {
private Integer id;
private String name;
private String color;
public Cat() {
}
public Cat(Integer id, String name, String color) {
super();
this.id = id;
this.name = name;
this.color = color;
}
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getColor() {
return color;
}
public void setColor(String color) {
this.color = color;
}
}

package yy.domain;
public class User {
private Integer id;
private String name;
private String pass;
private String address;


public User() {
}
public User(Integer id, String name, String pass, String address) {
super();
this.id = id;
this.name = name;
this.pass = pass;
this.address = address;
}
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getPass() {
return pass;
}
public void setPass(String pass) {
this.pass = pass;
}
public String getAddress() {
return address;
}
public void setAddress(String address) {
this.address = address;
}
@Override
public int hashCode() {
final int prime = 31;
int result = 1;
result = prime * result + ((name == null) ? 0 : name.hashCode());
result = prime * result + ((pass == null) ? 0 : pass.hashCode());
return result;
}
@Override
public boolean equals(Object obj) {
if (this == obj)
return true;
if (obj == null)
return false;
if (getClass() != obj.getClass())
return false;
User other = (User) obj;
if (name == null) {
if (other.name != null)
return false;
} else if (!name.equals(other.name))
return false;
if (pass == null) {
if (other.pass != null)
return false;
} else if (!pass.equals(other.pass))
return false;
return true;
}
}

package service;
import java.util.List;
import yy.domain.*;
public interface UserService {
public List<Cat> getCatsByUser(User user);
}

package service.impl;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import service.UserService;
import yy.domain.Cat;
import yy.domain.User;
public class UserServiceImpl implements UserService{
static Map<User,List<Cat>> catDb=new HashMap<User,List<Cat>>();
static{
List<Cat> catList1=new ArrayList<Cat>();
catList1.add(new Cat(1,"garefkds","blcak"));
catList1.add(new Cat(2,"fds","bldascak"));
catDb.put(new User(1,"sun","2233","dad"), catList1);

List<Cat> catList2=new ArrayList<Cat>();
catList2.add(new Cat(3,"garefkds","blcak"));
catList2.add(new Cat(4,"fds","bldascak"));
catDb.put(new User(2,"sun","2233","dad"), catList2);
}
@Override
public List<Cat> getCatsByUser(User user) {
return catDb.get(user);
}
}

第三部：创建一个发布类

package lee;
import javax.xml.ws.Endpoint;
public class ServerMain {
public static void main(String[] args){

HelloWorld hello=new HelloWorldWS();
//发布WebService
Endpoint.publish("http://IP/webservie" ,hello);
}
}

然后访问http://IP/webservice?wsdl 就可以看到以下的WSDL文档了。

<wsdl:definitions xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:tns="http://impl.yy/" x  mlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"xmlns:ns2="http://schemas.xmlsoap.org/soap/http" xmlns:ns1="http://yy/" name="HelloWorldWS" targetNamespace="http://impl.yy/">

<wsdl:import location="http://202.118.212.80/webservie?wsdl=HelloWorld.wsdl" namespace="http://yy/"> </wsdl:import>

<wsdl:binding name="HelloWorldWSSoapBinding" type="ns1:HelloWorld"> ... </wsdl:binding>

<wsdl:service name="HelloWorldWS">

<wsdl:port binding="tns:HelloWorldWSSoapBinding" name="HelloWorldWSPort"> ... </wsdl:port>

</wsdl:service>

</wsdl:definitions>

该文档主要包括二部分：

第一部是就是<wsdl:import />代表Web Service的接口的信息

第二部分就是<wsdl:binding></wsdl:binding><wsdl:service></wsdl:service>

详细介绍第一部分：

<wsdl:import location="http://202.118.212.80/webservie?wsdl=HelloWorld.wsdl" namespace="http://yy/"> </wsdl:import>

其中location代表的就是发出这个wsdl文档的位置 namespace代表在/yy这个命名空间下。

接下来我们详细的介绍一下 这个接口类中有什么信息 就是http://202.118.212.80/webservie?wsdl=HelloWorld.wsdl

<wsdl:definitions xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:ns1="http://yy/" name="HelloWorld" targetNamespace="http://yy/">

<wsdl:types> ... </wsdl:types>

<wsdl:message name="getCatsByUserResponse"> ... </wsdl:message>

<wsdl:message name="sayHiResponse"> ... </wsdl:message>

<wsdl:message name="getCatsByUser"> ... </wsdl:message>

<wsdl:message name="sayHi"> ... </wsdl:message>

<wsdl:portType name="HelloWorld"> ... </wsdl:portType>

</wsdl:definitions>

WebService的接口类中包含主要的三个标签 

----<wsdl:portType name="HelloWorld">...</wsdl:portType> 这个portType代表是哪一个类，它的子元素代表该类有几个方法，每一个方法的输入消息，以及输出消息

<wsdl:portType>

<wsdl:operation name="getCatsByUser">

<wsdl:input message="ns1:getCatsByUser" name="getCatsByUser"> </wsdl:input>

<wsdl:output message="ns1:getCatsByUserResponse" name="getCatsByUserResponse"> </wsdl:output>

</wsdl:operation>

<wsdl:operation name="sayHi">

<wsdl:input message="ns1:sayHi" name="sayHi"> </wsdl:input>

<wsdl:output message="ns1:sayHiResponse" name="sayHiResponse"> </wsdl:output>

</wsdl:operation>

</wsdl:portType>

从上面这段我们可以看出，这个接口的名字叫HelloWorld 该类有二个方法，第一个方法叫sayHi  第二个方法叫getCatsByUser

那么我们就会想知道，每一个方法的参数是什么，返回值是什么？接下来我们要看这个操作对应的输入消息是什么

我们拿sayHi这个操作来说：<wsdl:input message="ns1:sayHi" name="sayHi"></wsdl:input>

因此我们需要找到消息的名字是sayHi的消息，即<wsdl:message name="sayHi">...</wsdl:message>

我们详细的解析一下这个：

<wsdl:message name="sayHi">

<wsdl:part element="ns1:sayHi" name="parameters"> </wsdl:part>

</wsdl:message>

sayHi这个消息有一个元素通过ns1:sayHi，找到对应的类型到<wsdl:types>...</wsdl:types>这个标签下去寻找

<xs:complexType name="sayHi">

<xs:sequence>

<xs:element minOccurs="0" name="arg0" type="xs:string"/>

</xs:sequence>

</xs:complexType>

通过这段我们可以创建一个xml文档片段

传入消息

<sayHi>

  <arg0>字符串</arg0>

</sayHi>

消息传出的xml文档片段

< sayHiResponse>

  <return >字符串</return>

</ sayHiResponse>

<xs:complexType name="getCatsByUser">

<xs:sequence>

<xs:element minOccurs="0" name="arg0" type="tns:user"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="user">

<xs:sequence>

<xs:element minOccurs="0" name="address" type="xs:string"/>

<xs:element minOccurs="0" name="id" type="xs:int"/>

<xs:element minOccurs="0" name="name" type="xs:string"/>

<xs:element minOccurs="0" name="pass" type="xs:string"/>

</xs:sequence>

</xs:complexType>

对于另外一个方法，通过阅读wsdl文档，也可以写出对应的xml文档片段

//消息传入

< getCatsByUser>

    <arg0>

        <address>字符串</address>

        <id>整数</id>

        <name>字符串</name>

        <pass>字符串</pass>

    </arg0>

</ getCatsByUser>

消息传出

<xs:complexType name="getCatsByUserResponse">

<xs:sequence>

<xs:element maxOccurs="unbounded" minOccurs="0" name="return" type="tns:cat"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="cat">

<xs:sequence>

<xs:element minOccurs="0" name="color" type="xs:string"/>

<xs:element minOccurs="0" name="id" type="xs:int"/>

<xs:element minOccurs="0" name="name" type="xs:string"/>

</xs:sequence>

</xs:complexType>

<getCatsByUserResponse>

     <return >

          <color>字符串</color>

        <id>整数</id>

        <name>字符串</name>

       </return>

      <return >

          <color>字符串</color>

        <id>整数</id>

        <name>字符串</name>

       </return>

</getCatsByUserResponse>

下面是简单的wsdl文档结构图：