详细介绍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 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 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 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> catDb=new HashMap>();
static{
List catList1=new ArrayList();
catList1.add(new Cat(1,"garefkds","blcak"));
catList1.add(new Cat(2,"fds","bldascak"));
catDb.put(new User(1,"sun","2233","dad"), catList1);

List catList2=new ArrayList();
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 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文档了。

 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/">
 location="http://202.118.212.80/webservie?wsdl=HelloWorld.wsdl" namespace="http://yy/">
 name="HelloWorldWS">
该文档主要包括二部分:
第一部是就是代表Web Service的接口的信息
第二部分就是
详细介绍第一部分:
 location="http://202.118.212.80/webservie?wsdl=HelloWorld.wsdl" namespace="http://yy/">
其中location代表的就是发出这个wsdl文档的位置 namespace代表在/yy这个命名空间下。
接下来我们详细的介绍一下 这个接口类中有什么信息 就是http://202.118.212.80/webservie?wsdl=HelloWorld.wsdl
 xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:ns1="http://yy/" name="HelloWorld" targetNamespace="http://yy/">
WebService的接口类中包含主要的三个标签 
---- name="HelloWorld">... 这个portType代表是哪一个类,它的子元素代表该类有几个方法,每一个方法的输入消息,以及输出消息

 name="getCatsByUser">
 message="ns1:getCatsByUser" name="getCatsByUser">
 message="ns1:getCatsByUserResponse" name="getCatsByUserResponse">
 name="sayHi">
 message="ns1:sayHi" name="sayHi">
 message="ns1:sayHiResponse" name="sayHiResponse">
从上面这段我们可以看出,这个接口的名字叫HelloWorld 该类有二个方法,第一个方法叫sayHi  第二个方法叫getCatsByUser

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

我们拿sayHi这个操作来说: message="ns1:sayHi" name="sayHi">

因此我们需要找到消息的名字是sayHi的消息,即 name="sayHi">...

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

 name="sayHi">
 element="ns1:sayHi" name="parameters">
sayHi这个消息有一个元素通过ns1:sayHi,找到对应的类型到...这个标签下去寻找
 name="sayHi">
 minOccurs="0" name="arg0" type="xs:string"/>

通过这段我们可以创建一个xml文档片段
传入消息
  字符串
消息传出的xml文档片段
< sayHiResponse>
  字符串
sayHiResponse>

 name="getCatsByUser">
 minOccurs="0" name="arg0" type="tns:user"/>
 name="user">
 minOccurs="0" name="address" type="xs:string"/>
 minOccurs="0" name="id" type="xs:int"/>
 minOccurs="0" name="name" type="xs:string"/>
 minOccurs="0" name="pass" type="xs:string"/>

对于另外一个方法,通过阅读wsdl文档,也可以写出对应的xml文档片段
//消息传入
< getCatsByUser>
   
       
字符串
        整数
        字符串
        字符串
   
getCatsByUser>

消息传出

 name="getCatsByUserResponse">
 maxOccurs="unbounded" minOccurs="0" name="return" type="tns:cat"/>
 name="cat">
 minOccurs="0" name="color" type="xs:string"/>
 minOccurs="0" name="id" type="xs:int"/>
 minOccurs="0" name="name" type="xs:string"/>

<getCatsByUserResponse>

     

          字符串

        整数

        字符串

       

     

          字符串

        整数

        字符串

       

getCatsByUserResponse>

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

详细介绍WSDL文档_第1张图片

你可能感兴趣的:(webservice)