当柳上原的风吹向天际的时候...

真正的快乐来源于创造

  BlogJava :: 首页 :: 联系 :: 聚合  :: 管理
  368 Posts :: 1 Stories :: 201 Comments :: 0 Trackbacks
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 思想,技术与系统集成应用详解》
posted on 2009-09-29 14:09 何杨 阅读(423) 评论(0)  编辑  收藏