Web Service定义了一套标准的调用过程:
- 服务器端首先用一套标准的方法向外界描述它所提供的服务的内容,这属于WSDL的范畴。
- 客户端需要以一种标准的协议来调用此服务,这属于SOAP的范畴。
- 服务提供者将服务内容放在一个公共的网址上让人查询,这属于UDDI的范畴。
WSDL:服务内容的标准化描述
WSDL的目的是告诉外界自己能提供什么样的服务,有点类似于java的接口。
WSDLd的全称是Web Service Description Language,是一种基于XML的关于Web服务的描述,主要目的在于将自己的Web服务的所有相关内容如提供服务的传输方式,服务方法接口,接口参数,服务路径等,生成相应的完全的文档,发布给使用者。使用者可以通过这个WSDL文档,创建相应的SOAP请求消息,通过HTTP传递给Web服务提供者;Web服务提供者在完成请求服务后,将SOAP返回消息传回给请求者,服务请求者再根据WSDL文档将SOAP返回消息解析成程序能够理解的内容。
SOAP:标准的传输协议
SOAP是标准化的消息协议,是客户端送给服务器希望调用的类和方法的一种消息格式,也包括服务返回的消息格式。之所以有SOAP是因为只有大家都遵守一套消息格式的标准,相互之间才能明白对方想要干什么。
SOAP是Web Service的标准传输协议,是Simple Object Application Propotol的简写,是一种标准化的传输消息的XML格式。
SOAP请求消息将客户端的服务请求消息发给服务器,比如想调用什么接口,以及接口的参数值等。SOAP答复消息是从服务器返回给客户端的消息,如接口实现类调用后的返回值或是调用服务时的错误信息等。定义WSDL是很重要的,一旦WSDL定义好了,再根据WSDL的输入变量和输出变量的结构就可以知道SOAP的请求消息和响应消息的格式了。
UDDI:服务的公共网址
UDDI是Universal Description Discovery and Intergretion的缩写,是一种创建注册服务的规范,以便大家将自己的Web Service进行注册发布供使用者查找。
当服务提供者想将自己的Web Service发布,以便外部能找到其服务时,那么服务提供这可以将自己的Web Service注册到相应的UDDI商用注册网站。
UDDI并非一个必须的Web Service组件,服务方完全可以不进行UDDI的注册。因为WSDL文件中已经给出了Web Service的地址URI,外部可以通过它进行相应的Web Service调用。
以下是一个Web Service示例程序,主要参考了梁爱虎的《SOA 思想,技术与系统集成应用详解》中的例子:
发布Web服务的类接口:
package com.heyang;
/**
* 生成序列号的接口
* @author: 何杨(heyang78@gmail.com)
* @date: 2009-9-29-下午12:37:55
*/
public interface ISerial{
/**
* 传入类型,返回序列号
* @param type
* @return
*/
public String getSN(String type);
}
发布web服务的类:
package com.heyang;
import java.text.MessageFormat;
/**
* ISerial的实现类
* @author: 何杨(heyang78@gmail.com)
* @date: 2009-9-29-下午12:40:05
*/
public class SerialService implements ISerial{
private static int number;
/**
* 产生SN:CD-000001的序列号
* MessageFormat的用法可参考http://hi.baidu.com/gacmotor/blog/item/372b4a3a0b010de314cecb0b.html
*/
public String getSN(String type) {
number++;
Object[] arr=new Object[]{type,number};
String result=MessageFormat.format("SN:{0}-{1,number,000000}",arr);
return result;
}
public static void main(String[] args){
SerialService s=new SerialService();
System.out.println(s.getSN("CD"));
}
}
Web.xml:
<?xml version="1.0" encoding="UTF-8"?>
<web-app >
<servlet>
<servlet-name>AxisServlet</servlet-name>
<servlet-class>
org.apache.axis.transport.http.AxisServlet
</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>AxisServlet</servlet-name>
<url-pattern>/servlet/AxisServlet</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>AxisServlet</servlet-name>
<url-pattern>*.jws</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>AxisServlet</servlet-name>
<url-pattern>/services/*</url-pattern>
</servlet-mapping>
</web-app>
wsdd文件server-config.wsdd
<?xml version="1.0" encoding="UTF-8"?>
<deployment xmlns="http://xml.apache.org/axis/wsdd/"
xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
<handler type="java:org.apache.axis.handlers.http.URLMapper"
name="URLMapper" />
<service name="fetchSerialNumber" provider="java:RPC">
<parameter name="className" value="com.heyang.SerialService" />
<parameter name="allowedMethods" value="getSN" />
</service>
<transport name="http">
<requestFlow>
<handler type="URLMapper" />
</requestFlow>
</transport>
</deployment>
测试类:
package com.heyang.client;
import java.net.MalformedURLException;
import java.rmi.RemoteException;
import javax.xml.rpc.ServiceException;
import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
/**
* WebServiceClientTest
* @author: 何杨(heyang78@gmail.com)
* @date: 2009-9-29-下午01:03:05
*/
public class WebServiceClientTest {
public static void main(String[] args) throws ServiceException,
MalformedURLException, RemoteException {
// 标识Web Service的具体路径
/**
* SerialNumber:发布到Tomcat上的war的名称,采用工程名
* services:固定写法,与Web.xml中设定对应
* fetchSerialNumber:server-config.wsdd中设定的service名
*/
String endpoint = "http://localhost:8080/SerialNumber/services/fetchSerialNumber";
// 创建 Service实例
Service service = new Service();
// 通过Service实例创建Call的实例
Call call = (Call) service.createCall();
// 将Web Service的服务路径加入到call实例之中.
call.setTargetEndpointAddress(new java.net.URL(endpoint));// 为Call设置服务的位置
// 调用Web Service的方法
call.setOperationName("getSN");
// 调用Web Service,传入参数
String retval = (String) call.invoke(new Object[] { "CD" });
System.out.println(retval);
}
}
输出示例:
SN:CD-000004
例程下载(使用Axis,注意Tomcat的lib目录中要包括mail.jar和activation.jar):
http://www.blogjava.net/Files/heyang/SerialNumber20090929130453.rar
使用说明:
使用Ant脚本将jar包打好,再部署到Tomcat中,可以用http://localhost:8080/SerialNumber/services来测试一下是否有输出,有则表示部署成功,之后执行WebServiceClientTest。
主要参考资料:
梁爱虎著《SOA 思想,技术与系统集成应用详解》