SCA导航2-用Tuscany构建你的第一个web service

2.   用Tuscany构建你的第一个web service

这篇导航文章将一步步地介绍如何使用Tuscany构建web service。第一部分将介绍如何将Tuscany运行环境添加到Eclipse开发环境，第二部分将介绍如何利用Tuscany简单地创建web service。

2.1. 安装最新的Tuscany的Eclipse插件

本节将介绍Tuscany的Eclipse插件安装方法，它能够使你在Package Explorer中运行SCA组合构件。

从Eclipse菜单Help->Software Updates…->Find and Install，选择“Search for new features to install”，然后按下一步，在此步中点击“new Remote site…”按钮，输入name为“Tuscany”，站点URL为http://archive.apache.org/dist/tuscany/java/sca/1.4/tuscany-sca-1.4-updatesite/，添加完后选择刚才新增的远程站点，右击鼠标在弹出菜单中选择“Install”，在接下来的界面点击接收协议，按下一步即可完成安装。

2.2. 创建你的服务业务逻辑

2.2.1.    创建一个Java Project

在这一小节中你将创建一Eclipse的Java Project，用于构建组合构件应用。点击“New Java Project”按钮，加载新建Java Project对话框。输入Project Name为“ws”，Project Layout选择“Create separate folders for sources and class files.”

图-5

按提示到下一步，在Libraries选项卡中点击“Add Library...”按钮，把Tuscany Library添加到此Project中。

图-6

接着按提示完成新建ws工程。

图-7

2.2.2.    构建web service

首先新建个helloworld包

图-8

下一步新建个helloworld服务接口，接口内容如下

package helloworld;

import org.osoa.sca.annotations.Remotable;

@Remotable

public interface HelloWorld {

    String sayHello(String name);

}

然后创建此接口的实现

 

package helloworld;

public class HelloWorldImpl implements HelloWorld {

       public String sayHello(String name) {

              return "Hello " + name;

       }

}

2.2.3.    装配服务

现在服务接口跟实现都已经有了，接下来把它装配起来，提供组合服务。装配的信息都包含在.composite文件中。在src目录下新建helloworld.composite文件，其内容如下

<?xml version="1.0" encoding="UTF-8"?>

<composite xmlns="http://www.osoa.org/xmlns/sca/1.0"

    xmlns:t="http://tuscany.apache.org/xmlns/sca/1.0"

    xmlns:c="http://helloworld"

    targetNamespace="http://helloworld"

    name="helloworld">

 

       <component name="HelloWorldComponent">

              <implementation.java class="helloworld.HelloWorldImpl"/>

              <service name="HelloWorld">

                     <binding.ws uri="http://localhost:8080/HelloWorld"/>

              </service>

       </component>

</composite>

此时ws工程内容如图-9

图-9

服务已经装配好，接下来我们来运行它。

2.3. 运行服务

在这一节中你将加载，刚刚装配的helloworld web service服务。在helloworld.composite文件上右击鼠标，选择“Run as->Tuscany”。之后Tuscany运行环境将启动，helloworld组合构件被加入它的域中，然后发布helloworld web service服务。

Eclipse控制台消息如图-10

图-10

你可以在浏览器中，输入http://localhost:8080/HelloWorld?wsdl，可以看到此web service的wsdl内容。

 

<?xml version="1.0" encoding="UTF-8"?>

<wsdl:definitions targetNamespace="http://helloworld" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" xmlns:ns0="http://helloworld" xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/" xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" xmlns:ns1="http://org.apache.axis2/xsd" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">

  <wsdl:types>

    <xs:schema attributeFormDefault="qualified" elementFormDefault="qualified" targetNamespace="http://helloworld" xmlns:ns="http://helloworld">

         <xs:element name="sayHello">

            <xs:complexType>

               <xs:sequence>

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

               </xs:sequence>

            </xs:complexType>

 

         </xs:element>

         <xs:element name="sayHelloResponse">

            <xs:complexType>

               <xs:sequence>

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

               </xs:sequence>

            </xs:complexType>

         </xs:element>

      </xs:schema>

 

  </wsdl:types>

  <wsdl:message name="sayHelloRequest">

    <wsdl:part name="parameters" element="ns0:sayHello">

    </wsdl:part>

  </wsdl:message>

  <wsdl:message name="sayHelloResponse">

    <wsdl:part name="parameters" element="ns0:sayHelloResponse">

    </wsdl:part>

  </wsdl:message>

 

  <wsdl:portType name="HelloWorldPortType">

    <wsdl:operation name="sayHello">

      <wsdl:input message="ns0:sayHelloRequest" wsaw:Action="urn:sayHello">

    </wsdl:input>

      <wsdl:output message="ns0:sayHelloResponse" wsaw:Action="urn:sayHelloResponse">

    </wsdl:output>

    </wsdl:operation>

  </wsdl:portType>

  <wsdl:binding name="HelloWorldHttpBinding" type="ns0:HelloWorldPortType">

 

    <http:binding verb="POST"/>

    <wsdl:operation name="sayHello">

      <http:operation location="HelloWorld/sayHello"/>

      <wsdl:input>

        <mime:content part="sayHello" type="text/xml"/>

      </wsdl:input>

      <wsdl:output>

        <mime:content part="sayHello" type="text/xml"/>

      </wsdl:output>

 

    </wsdl:operation>

  </wsdl:binding>

  <wsdl:binding name="HelloWorldSOAP11Binding" type="ns0:HelloWorldPortType">

    <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>

    <wsdl:operation name="sayHello">

      <soap:operation soapAction="urn:sayHello" style="document"/>

      <wsdl:input>

        <soap:body use="literal"/>

      </wsdl:input>

 

      <wsdl:output>

        <soap:body use="literal"/>

      </wsdl:output>

    </wsdl:operation>

  </wsdl:binding>

  <wsdl:service name="HelloWorld">

    <wsdl:port name="HelloWorldSOAP11port_http" binding="ns0:HelloWorldSOAP11Binding">

      <soap:address location="http://192.168.209.1:8080/HelloWorld"/>

    </wsdl:port>

 

    <wsdl:port name="HelloWorldHttpport" binding="ns0:HelloWorldHttpBinding">

      <http:address location="http://192.168.209.1:8080/HelloWorld"/>

    </wsdl:port>

  </wsdl:service>

</wsdl:definitions>

 

 

这样你就已经用Tuscany创建了web service。