用Tuscany、Axis、groovy来发布和调试Web Service

Posted on 2007-09-11 14:10 YanHua 阅读(1301) 评论(0)  编辑  收藏 所属分类: SOA AND BPM
Tuscany--是一个符合SCA标准的开源实现,他能够很容易地将一个服务绑定为一个Web Service:
<composite xmlns="http://www.osoa.org/xmlns/sca/1.0" name="Employee">
    
<service name="HelloWorldService"
        promote
="HelloWorldServiceComponent">
        
<interface.wsdl
            interface
="http://helloworld#wsdl.interface(HelloWorld)" />
        
<binding.ws uri="http://localhost:8085/HelloWorldService" />
    
</service>
    
<component name="HelloWorldServiceComponent">
        
<implementation.java class="helloworld.HelloWorldImpl" />
    
</component>
</composite>

要使服务发布成功,要保证有以下几个文件:
  1. 一个预定义的wsdl文件,只要保证这个文件在classpath下就可以了。
  2. 一个java接口。
  3. 一个java类。
下面列依次列出这几个文件:
* helloworld.wsdl
<wsdl:definitions targetNamespace="http://helloworld"
xmlns:tns
="http://helloworld" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:wsdlsoap
="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:xsd
="http://www.w3.org/2001/XMLSchema"
    name
="helloworld">
    
<wsdl:types>
        
<schema elementFormDefault="qualified" targetNamespace="http://helloworld"
         xmlns
="http://www.w3.org/2001/XMLSchema">
            
<element name="getGreetings">
                
<complexType>
                    
<sequence>
                        
<element name="name" type="xsd:string"/>
                    
</sequence>
                
</complexType>
            
</element>

            
<element name="getGreetingsResponse">
                
<complexType>
                    
<sequence>
                        
<element name="getGreetingsReturn" type="xsd:string"/>
                    
</sequence>
                
</complexType>
            
</element>
          
        
</schema>
    
</wsdl:types>
    
<wsdl:message name="getGreetingsRequest">
        
<wsdl:part element="tns:getGreetings" name="parameters"/>
    
</wsdl:message>
    
<wsdl:message name="getGreetingsResponse">
        
<wsdl:part element="tns:getGreetingsResponse" name="parameters"/>
    
</wsdl:message>

    
<wsdl:portType name="HelloWorld">
        
<wsdl:operation name="getGreetings">
            
<wsdl:input message="tns:getGreetingsRequest" name="getGreetingsRequest"/>
            
<wsdl:output message="tns:getGreetingsResponse" name="getGreetingsResponse"/>
        
</wsdl:operation>
    
</wsdl:portType>

    
<wsdl:binding name="HelloWorldSoapBinding" type="tns:HelloWorld">
        
<wsdlsoap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
        
<wsdl:operation name="getGreetings">
            
<wsdlsoap:operation soapAction=""/>
            
<wsdl:input name="getGreetingsRequest">
                
<wsdlsoap:body use="literal"/>
            
</wsdl:input>
            
<wsdl:output name="getGreetingsResponse">
                
<wsdlsoap:body use="literal"/>
            
</wsdl:output>
        
</wsdl:operation>
    
</wsdl:binding>

    
<wsdl:service name="HelloWorldService">
        
<wsdl:port binding="tns:HelloWorldSoapBinding" name="HelloWorldSoapPort">
            
<wsdlsoap:address location="http://localhost:8085/HelloWorldService"/>
        
</wsdl:port>
    
</wsdl:service>

</wsdl:definitions>


* HelloWorldService.java
package helloworld;
import org.osoa.sca.annotations.Remotable;
@Remotable
public interface HelloWorldService {
    
public String getGreetings(String name);
}

* HelloWorldImpl.java
package helloworld;
import org.osoa.sca.annotations.Service;
@Service(HelloWorldService.
class)
public class HelloWorldImpl implements HelloWorldService {
    
public String getGreetings(String name) {
        
return "hello "+name;
    }
}


这样我们就可以写一个类来创建一个SCA中的Domain,并由它来创建组件并发布为一个web服务。
public class HelloWorldServer {
    
public static void main(String[] args) {
        SCADomain scaDomain 
= SCADomain.newInstance("","","Calculator.composite","Employee.composite");
        
try {
            System.out.println(
"HelloWorld server started (press enter to shutdown)");
            System.in.read();
        } 
catch (IOException e) {
            e.printStackTrace();
        }
        scaDomain.close();
        System.out.println(
"HelloWorld server stopped");
    }
}

运行这个类,也就启动了一个SCA的Domain,打开浏览器输入http://localhost:8085/HelloWorldService? wsdl(注意这个是以binding.ws的uri为准的,和wsdl文件中的wsdlsoap:address的location无关,当然在这里它 们俩个是一致的),就可以看到发布的服务的wsdl描述,应该和前面的helloworld.wsdl的内容一样。

下面我们写一个groovy的客户端来测试一下这个web服务,代码大概象这样(更多的信息可以参考http://docs.codehaus.org/display/GROOVY/Groovy+SOAP ,要运行下面的代码需要先安装一个groovy的用来除了soap的类库):

import groovy.net.soap.SoapClient
def proxy 
= new SoapClient("http://localhost:8085/HelloWorldService?wsdl")
println proxy.getGreetings(
"yanhua")


运行它,在控制台可以看到hello yanhua了吗?

有时候我们想查看一下客户端和服务器之间来往的soap消息,我们可以用AXIS提供的一个叫TCPMonitor的工具。先下载AXIS,解压后在AXIS的目录下运行如下的命令:java -classpath ./lib/axis.jar org.apache.axis.utils.tcpmon,这样会打开TCPMonitor这个工具。我们新建一个Listener,设置如下图:


我们把刚才的groovy代码改一下:
import groovy.net.soap.SoapClient
def proxy 
= new SoapClient("http://localhost:8081/HelloWorldService?wsdl")
println proxy.getGreetings(
"yanhua")


运行它,在TCPMonitor中就可以看到往返的soap消息了,对这个例子来说分别是:
发送到服务器的soap消息:
POST /HelloWorldService HTTP/1.1
SOAPAction: ""
Content-Type: text/xml; charset=UTF-8
User-Agent: Mozilla/4.0
(compatible; MSIE 6.0; Windows NT 5.0; XFire Client +http://xfire.codehaus.org)
Host: 127.0.0.1:8081
Expect: 100-continue
Content-Length: 308

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd
="http://www.w3.org/2001/XMLSchema"
xmlns:xsi
="http://www.w3.org/2001/XMLSchema-instance">
<
soap:Body>
  <
getGreetings xmlns="http://helloworld">
    <
name xmlns="http://helloworld">yanhua</name>
  </
getGreetings>
</
soap:Body>
</
soap:Envelope>


返回给客户端的soap消息:
POST /HelloWorldService HTTP/1.1
SOAPAction: ""
Content-Type: text/xml; charset=UTF-8
User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0; XFire Client +http://xfire.codehaus.org)
Host: 127.0.0.1:8081
Expect: 100-continue
Content-Length: 308

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd
="http://www.w3.org/2001/XMLSchema"
xmlns:xsi
="http://www.w3.org/2001/XMLSchema-instance">
<
soap:Body>
  <
getGreetings xmlns="http://helloworld">
    <
name xmlns="http://helloworld">yanhua</name>
   </
getGreetings>
</
soap:Body>
</
soap:Envelope>


只有注册用户登录后才能发表评论。


网站导航: