SCA(Tascany)环境搭建和使用范例

1. 概述
本文档描述了基于Eclipse3.5和Apache Tascany基础之上的开发环境搭建以及快速入门的使用范例。
文中的内容基本上来源于对网络信息的搜集，大多数内容源自于http://tuscany.apache.org。在编写过程中希望通过更加快捷、更加简便的方式，并部分结合我们的开发现状，使读者能够快速上手。如有问题请联系MSN：[email protected]，并注明意图。
2. 开发环境
2.1. 环境准备
为了在实践中完成下面文中描述的内容，您需要以下工具：


2.2. 环境搭建
2.2.1. 使用Tuscany Eclipse Plugin
从表1所示的环境中，获取tuscany1.6 Eclipse Plugin，将其放置到Eclipse3.5目录下，如下图所示：


图1-Tuscany Eclipse插件放置到Eclipse3.5目录中
接下来我们通过建立一个Link文件，找Eclipse3.5找到，并加载这个Tuscany插件。
首先，如果您的Eclipse3.5中没有Link这个文件夹，您需要手动建一个。然后在这个文件夹下建立一个名为“com.ruijie.tuscany.eclipse.link”文件（文件名可任意）。如下图所示



图2-使用link文件加载Tuscany Eclipse插件
文件中的内容如下：

path=d:\\eclipse3.5\\tuscany1.6 Eclipse Plugin\\

下面我们来打开Eclipse3.5看看会有什么变化。打开Eclipse3.5的工作区后，在“New Wiazrd”对话框中可以看到如下图所示的Tuscany的插件加载情况。


图3-Tuscany Plugin加载

2.2.2. 使用OSOA工具包
下载如表1中的apache-tuscany-sca-1.6.zip文件，并对其解压。解压后的效果如下图所示：




图-4 解压后的apache-tuscany-sca-1.6.zip
在实际开发过程中我们需要使用lib目录下的jar包，因此在工程中，需要引用lib下的包。（初始环境中加载所有的jar包）。
2.3. 示例程序一
接下来我们开发一个基于Apache Tuscany并成功发布WebService的示例。
2.3.1. 创建工程
首先我们在d:\TuscanyWorkspace\工作区下，创建一个名为Web的工程。并按照如下图的方式加载TuscanyLibrary。


图5 加载Tuscany Library

第2步：我们需要加载OSOA的工具包。找到前面的下载apache-tuscany-sca-1.6.zip的解压文件，并加载所有的.jar文件。


图5-加载OSOA工具包
以上是一个Java Application中对OSOA包的使用。当然对于Java Web Application需要将这些包加到Web Application的lib目录下。
2.3.2. 代码
下面的我们要实现的是基于Apache Tomcat来发布一个tuscany的SCA组件。
程序代码的包结构如下图所示：


图6-示例程序的包结构
定义Service接口
package user.service;

import java.util.List;

import org.osoa.sca.annotations.Remotable;
@Remotable
public interface IUserService {
//if service is distribute,it need to decalre "@Remotable"
List <User>getAll();
}

定义接口实现
package user.service;

import java.util.ArrayList;
import java.util.List;

public class UserServiceImpl implements IUserService{

private static List<User> users = null;
    static {
        users = new ArrayList<User>();
        for (int i = 0; i < 10; i++) {
            User user = new User();
            user.setId("id" + i);
            user.setName("name" + i);
            user.setPassword("password" + i);
            Address address = new Address();
            address.setStreet("street" + i);
            user.setAddress(address);
            users.add(user);
        }
    }

    public List<User> getAll() {
        return users;
    }
}

User Pojo类代码
package user.service;

public class User {
private String id;
private String name;
private String password;
private Address address;
public String getId() {
return id;
}
public void setId(String id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
public Address getAddress() {
return address;
}
public void setAddress(Address address) {
this.address = address;
}
}


Address POJO类代码
package user.service;

public class Address {
private String street;

public String getStreet() {
return street;
}

public void setStreet(String street) {
this.street = street;
}
}

META-INF/sca-deployables下的default.compostie
<?xml version="1.0" encoding="UTF-8"?>
<composite xmlns="http://www.osoa.org/xmlns/sca/1.0"
    xmlns:tuscany="http://tuscany.apache.org/xmlns/sca/1.0" name="test"
    targetNamespace="http://serivce.web.com">
    <component name="UserServiceImpl">
        <implementation.java class="user.service.UserServiceImpl"></implementation.java>
    </component>
    <service name="UserService" promote="UserServiceImpl">
        <interface.java interface="user.service.IUserService" />
        <binding.ws></binding.ws>
    </service>
</composite>



WebContent/META-INF/sca-contribution.xml
<?xml version="1.0" encoding="UTF-8"?>
<contribution xmlns="http://www.osoa.org/xmlns/sca/1.0"
             
              xmlns:Web="http://serivce.web.com">
<deployable composite="Web:test"/> 
</contribution>

Web.xml中的tuscany过滤器设置
<filter>
<filter-name>tuscany</filter-name>
<filter-class>org.apache.tuscany.sca.host.webapp.TuscanyServletFilter
</filter-class>
</filter>
<filter-mapping>
<filter-name>tuscany</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>

2.3.3. 运行效果
查看http://localhost:8080/Web/UserService?wsdl得到如下画面



图7-发布后的SCA组件
2.4. 示例程序二
下面我们根据tuscany的calculator Sample，来实现从页面前端对SCA组件的引用。本示例基于示例程序一的工程之上建立。新建一个classpath，并建立如同下图的包结构的类代码。



2.4.1. 代码
关键类的代码，如CalculatorService代码如下：
package calculator;
/**
* The Calculator service interface.
*/
public interface CalculatorService {

    double add(double n1, double n2);

    double subtract(double n1, double n2);

    double multiply(double n1, double n2);

    double divide(double n1, double n2);

}

CalculatorServiceImpl.java
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements.  See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership.  The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License.  You may obtain a copy of the License at
*
*   http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied.  See the License for the
* specific language governing permissions and limitations
* under the License.   
*/
package calculator;

import org.osoa.sca.annotations.Reference;


/**
* An implementation of the Calculator service.
*/
public class CalculatorServiceImpl implements CalculatorService {

    private AddService addService;
    private SubtractService subtractService;
    private MultiplyService multiplyService;
    private DivideService divideService;

    @Reference
    public void setAddService(AddService addService) {
        this.addService = addService;
    }

    @Reference
    public void setSubtractService(SubtractService subtractService) {
        this.subtractService = subtractService;
    }

    @Reference
    public void setDivideService(DivideService divideService) {
        this.divideService = divideService;
    }

    @Reference
    public void setMultiplyService(MultiplyService multiplyService) {
        this.multiplyService = multiplyService;
    }

    public double add(double n1, double n2) {
        return addService.add(n1, n2);
    }

    public double subtract(double n1, double n2) {
        return subtractService.subtract(n1, n2);
    }

    public double multiply(double n1, double n2) {
        return multiplyService.multiply(n1, n2);
    }

    public double divide(double n1, double n2) {
        return divideService.divide(n1, n2);
    }
}

Calculator.composite文件
<?xml version="1.0" encoding="UTF-8"?>

<composite xmlns="http://www.osoa.org/xmlns/sca/1.0"
           targetNamespace="http://Web"
           xmlns:sample="http://Web"
           name="Calculator">

    <component name="CalculatorServiceComponent">
<implementation.java class="calculator.CalculatorServiceImpl"/>
        <reference name="addService" target="AddServiceComponent"></reference>
        <reference name="subtractService" target="SubtractServiceComponent"></reference>
        <reference name="multiplyService" target="MultiplyServiceComponent"></reference>
        <reference name="divideService" target="DivideServiceComponent"></reference>
    </component>

    <component name="AddServiceComponent">
        <implementation.java class="calculator.AddServiceImpl"/>
    </component>

    <component name="SubtractServiceComponent">
        <implementation.java class="calculator.SubtractServiceImpl"/>
    </component>

    <component name="MultiplyServiceComponent">
        <implementation.java class="calculator.MultiplyServiceImpl"/>
    </component>

    <component name="DivideServiceComponent">
        <implementation.java class="calculator.DivideServiceImpl"/>
    </component>

</composite>


sca-contribution.xml内容
<?xml version="1.0" encoding="UTF-8"?>
<contribution xmlns="http://www.osoa.org/xmlns/sca/1.0"
             
              xmlns:Web="http://serivce.web.com">
<deployable composite="Web:test"/> 
<deployable composite="Web:Calculator"/>
</contribution>


Calc.jsp文件
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@ taglib uri="http://www.osoa.org/sca/sca_jsp.tld" prefix="sca" %>
<sca:reference name="CalculatorServiceComponent" type="calculator.CalculatorService" />
<html>
<head><title>Calculator sample</title></head>
<body>
<table>
    <tr>
        <th>Expression</th><th>Result</th>
    </tr>
    <tr>
        <td>2 + 3</td><td><%= CalculatorServiceComponent.add(2, 3) %></td>
    </tr>
    <tr>
        <td>3 - 2</td><td><%= CalculatorServiceComponent.subtract(3, 2) %></td>
    </tr>
    <tr>
        <td>3 * 2</td><td><%= CalculatorServiceComponent.multiply(3, 2) %></td>
    </tr>
    <tr>
        <td>3 / 2</td><td><%= CalculatorServiceComponent.divide(3, 2) %></td>
    </tr>   
</table>
</body>
</html>

2.4.2. 运行效果