SCA概念与应用实践(7.SCA装配模型--7.2 实现 implementation)

7.2. 实现 implementation
这个对应规范SCA Assembly Model V1.00（http://www.osoa.org/display/Main/Service+Component+Architecture+Specifications） 的1.4节

7.2.1. 解释
每个component都应该有一个implementation，它是实现具体业务逻辑的地方。所有component对外提供的service，component的reference对外的引用，component自己内部的逻辑都在这里实现。一个composite也可以是implementation。
Tuscany支持java，bpel，script等很多实现。也就是说component的implementation可以用java代码写，也可以用script来写。
打开Restaurant2.composite，就可以看到component的定义。

<sca:component name="RestaurantServiceComponent">
<sca:implementation.java class="restaurant2.lib.RestaurantServiceImpl"/>
<sca:service name="RestaurantService">
<sca:interface.java interface="restaurant2.api.RestaurantService"/>
</sca:service>
<sca:reference name="menuService"/>
<sca:reference name="billService"/>
</sca:component>
在component下有一个子元素implementation
<sca:implementation.java class="restaurant2.lib.RestaurantServiceImpl"/>
这个表示这个component是java实现的，类名是restaurant2.lib.RestaurantServiceImpl。

7.2.2. 改变implementation
前面说component可以使用其他的实现，现在我们用前面的例子演示一下使用script 实现VatServiceComponent。
在diagram中删掉component VatServiceComponent的实现，选中左上角那个图标，然后右键，选择Delete from Model.



图7_2_1

然后添加script implementation，使用palette来添加。因为在工具条上有两个Add ScriptImplementation，一个是FraSCAti运行环境的，一个tuscany运行环境，要选后者。点Script（Tuscany），然后再点在VatServiceComponent上。



图7_2_2



图7_2_3

在properties的script中填入restaurant2/lib/VatServiceImpl.js



图7_2_4

在目录 src/restaurant2/lib 添加新文件 VatServiceImpl.js.内容为：

var vatRate=10
function getPriceWithVat(price) {
return price * vatRate/100 + price;
}

[/code]

运行client，结果为，之前的价格是65.78. 因为这里我们定义的vatRate不同了。

图7_2_5

现在我们再看Restaurant2.composite文件，VatServiceComponent的定义变为
<sca:component name="VatServiceComponent">
<tuscany:implementation.script script="restaurant2/lib/VatServiceImpl.js"/>
<sca:service name="VatService">
<sca:interface.java interface="restaurant2.api.VatService"/>
</sca:service>
</sca:component>

修改之前的样子是
<sca:component name="VatServiceComponent">
<sca:implementation.java class="restaurant.lib.VatServiceImpl"/>
<sca:service name="VatService">
<sca:interface.java interface="restaurant.api.VatService"/>
</sca:service>
</sca:component>

这个implementation是可以自己定义新的implementation，而且一定会自己定义。在系统实施之前一定预先开发出一些implementation，这样在实施的时候可以减少大部分的代码工作。

7.2.3. Component Type
service,reference和property是在实现里可配置的方面。SCA将这三个东西的配置整体叫做component type。他们的属性在component定义里描述。通过component type，实现可以声明他包含的service,reference和property，同时实现也能为所有service,reference和property的属性设置值。
service,reference和property的属性都可以通过implementation对应的component的配置来覆盖，component也可以决定并不覆盖那些属性。某些属性是不能覆盖的，比如意图。



图7_2_6

做个简单的例子，说明什么是component type。
7.2.3.1. 演示例子
Ø 创建一个component，叫做HelloWorldServiceComponent



图7_2_7

Ø 添加java implementation，class name是helloworld.HelloWorldImpl
Ø Helloworld.composite内容
<?xml version="1.0" encoding="UTF-8"?>
<composite xmlns="http://www.osoa.org/xmlns/sca/1.0" xmlns:hw="http://helloworld" name="helloworld" targetNamespace="http://helloworld">
<component name="HelloWorldServiceComponent">
<implementation.java class="helloworld.HelloWorldImpl"/>
</component>
</composite>
Ø 添加接口类

package helloworld;

import org.osoa.sca.annotations.Remotable;

/**

* This is the business interface of the HelloWorld greetings service.

*/

@Remotable

public interface HelloWorldService{

public String getGreetings(String name);

}

Ø 实现类

package helloworld;

import org.osoa.sca.annotations.Property;

import org.osoa.sca.annotations.Service;

/**

* This class implements the HelloWorld service.

*/

@Service(HelloWorldService.class)

public class HelloWorldImpl  {

@Property

private String welcomeMsg = "You are welcome, ";

public String getGreetings(String name) {

return welcomeMsg +  name;

}

}

Ø 测试类

package test;

import helloworld.HelloWorldService;

import org.apache.tuscany.sca.host.embedded.SCADomain;

public class Client {

public static void main(String[] args) throws Exception {

SCADomain scaDomain = SCADomain.newInstance("helloworld.composite");

HelloWorldService hwService = scaDomain.getService(

HelloWorldService.class, "HelloWorldServiceComponent");

String msg = hwService.getGreetings("Neo");

System.out.println("====" + msg );

scaDomain.close();

}

}

Ø 运行client。

输出为====You are welcome, Neo



图7_2_8

7.2.3.2. 例子说明
在实现类HelloWorldImpl里，
@Service(HelloWorldService.class)
@Property
这两个就是component type定义，一个是定义service，一个是定义Property。他是通过java的annotation来实现。其他类型的实现，有其他的方式定义。这里演示的只是针对java implementation. 再去看Helloworld.composite的定义，你会发现这个component的定义只有implementation，没有service的定义。但我们在测试类里可以获得service，那个这个service就是implementation类HelloWorldImpl通过 @service 定义的。如果删掉@Service(HelloWorldService.class)，再运行client，你会看到：
Exception in thread "main" org.osoa.sca.ServiceRuntimeException: No matching operation for getGreetings is found in service HelloWorldServiceComponent#HelloWorldImpl

7.2.3.3. component的配置来覆盖Implementation中定义
在component上定义属性welcomeMsg。
Ø 在palette上选择property



图7_2_9

Ø 添加到component上，命名为welcomeMsg



图7_2_10

Ø 设置值为How are you,



图7_2_11

Ø 运行client，
输出结果变为====How are you,Neo



图7_2_12

7.2.4. .componentType文件
7.2.4.1. 说明
前面提到一个component type由service，reference，property组成。Component type是通过两步来确定。第一步是inspection方式，SCA自己通过代码中的annotation来计算获得component type，像前面的Service的定义。。第二步是解决那些通过第一种方式不可能定义的情况，或者通过第一种方式不能定义完整的信息，第二步是第一步的补充。在理想的情况下，component type是通过第一步完全定义。第二步是通过一个.componentType文件来实现定义。 SCA在解析component的时候，如果.componentType文件存在，会同时解析这个文件。在component type文件定义的Component type信息必须与从inspection方式获得的信息兼容。

7.2.4.2. 例子
拿前面那个project继续。前面我们测试过，如果删掉HelloWorldImpl里的@service，运行时就会抛出No matching operation Exception。下面我们通过.componentType文件来定义component type。
Ø 删掉HelloWorldImpl里的@service
Ø 添加.componentType文件，在package helloworld上右键，选择【new > other】,选择SCA Component Type，点next



图7_2_13

Ø 在file name上填 HelloWorldImpl.componentType, 这个文件的名字一定要和实现类的名字相同。点finish



图7_2_14

Ø Eclipse会自动打开component type编辑器



图7_2_15

Ø 填入
<service name="HelloWorldImpl">
<interface.java interface="helloworld.HelloWorldService"/>
</service>



图7_2_16

Ø 运行client，得到结果



图7_2_17

这里你可能注意到service的名字是HelloWorldImpl，这个目前只能是这个名字，原则上讲这个可以定义其他名字，但tuscany目前这里有个问题。在tuscany的实现里，当构建runtime的component的时候，如果一个实现类没有定义@service，那么它自动加一个service给component，名字为实现类的名字。所以如果在.componentType里定义了另外一个serivce名字，tuscany会抛出一个exception：More than one service is declared on component HelloWorldServiceComponent. 另外tuscany对componentyType中的property定义也有问题，无法获得componentyType文件中定义的property的值。