SCA概念与应用实践(7.SCA装配模型--7.5属性 property)

7.5. 属性 （Property）
7.5.1. 解释
通过属性可以对实现内的变量进行设置。一个实现可以定义0个或多个属性。每个属性都有一个类型，可以是简单类型也可以是复杂类型。实现内可以为属性设置一个默认值。在运行时，实现会查看对应的component是否定义了该属性，如果定义了，那么实现使用component上定义的属性值。属性也可以定义在composite上，component可以通过source直接使用composite上定义的属性。
7.5.2. 一个简单的例子
打开TipServiceImpl, 会发现这个定义了一个property tipRate， 缺省值是10，这里计算含小费的价格公式是price * this.tipRate/100 + price。我们在component TipServiceInnerComponent上定义一个属性tipRate， 然后把值设为0， 那么最后价格就不包含tip。
Ø 在palette上选择property


图7_5_1
Ø 点到component上，给属性填上名字为tipRate



图7_5_2
Ø 在property的属性上，value上填入0



图7_5_3
Ø 运行TipServiceServer和RestaurantServiceServer, 用soapUI测试，运行后得到到的结果是38.5.而之前含小费的账单是42.35。



图7_5_4
7.5.3. property的属性
打开TipServiceInnerComponent，会看到属性定义的行
<sca:component name="TipServiceInnerComponent">
<sca:implementation.java class="restaurant2.lib.TipServiceImpl"/>
<sca:service name="TipService">
<sca:interface.java callbackInterface="restaurant2.api.TipServiceCallback" interface="restaurant2.api.TipService"/>
<sca:binding.ws uri="http://localhost:8086/TipServiceComponent"/>
</sca:service>
<sca:property name="tipRate">0</sca:property>
</sca:component>
这个是最简单的属性定义，只有名称和值。看上面那个property的属性的图，会看到它有其他的属性。
Name，必填。
Type，属性的类型 –XML schema类型的限定名
Element，属性的类型为某个XML schema全局元素的类型
Many，false属性的值是一个值；false属性的值是多个值. 多值情况下，在实现中的属性变量类型一定是集合。
mustSupply， 是否必须有值
file，定义属性值的文件
source，引用的属性来源，component可以引用composite上的property
value，属性值

7.5.4. 一个复杂的例子
Ø 在Restaurant2TipInner的Composite上添加属性allTipRatesComposite. 由于eclipsse sca tools不支持复杂类型的属性定义，所以这个只能直接编辑Restaurant2Tip.composite文件
<sca:property element="foo:PropertyRate" many="true" name="allTipRatesComposite">
<PropertyRate xmlns="">
<country>China</country>
<tipSet>
<low>0</low>
<normal>0</normal>
<high>0</high>
</tipSet>
</PropertyRate>
<PropertyRate>
<country>US</country>
<tipSet>
<low>5</low>
<normal>10</normal>
<high>15</high>
</tipSet>
</PropertyRate>
<PropertyRate xmlns="">
<country>Canada</country>
<tipSet>
<low>5</low>
<normal>10</normal>
<high>15</high>
</tipSet>
</PropertyRate>
</sca:property>

Ø Component上添加属性country，值使用文件country.property
<sca:property file="country.property" name="country"/>
Ø Component 上添加属性allTipRates，引用composite上定义的属性
<sca:property name="allTipRates" source="$allTipRatesComposite"/>
Ø 最后结果为



图7_5_5
<?xml version="1.0" encoding="UTF-8"?>
<sca:composite xmlns:foo="http://foo" xmlns:sca="http://www.osoa.org/xmlns/sca/1.0" xmlns:tip="http://eclipse.org/Restaurant2Tip/src/Restaurant2Tip" name="Restaurant2TipInner" targetNamespace="http://eclipse.org/Restaurant2Tip/src/Restaurant2Tip">
<sca:component name="TipServiceInnerComponent">
<sca:implementation.java class="restaurant2.lib.TipServiceImpl"/>
<sca:service name="TipService">
<sca:interface.java callbackInterface="restaurant2.api.TipServiceCallback" interface="restaurant2.api.TipService"/>
<sca:binding.ws uri="http://localhost:8086/TipServiceComponent"/>
</sca:service>
<sca:property name="tipRate">0</sca:property>
<sca:property file="country.property" name="country"/>
<sca:property name="allTipRates" source="$allTipRatesComposite"/>
</sca:component>
<sca:property element="foo:PropertyRate" many="true" name="allTipRatesComposite">
<PropertyRate xmlns="">
<country>China</country>
<tipSet>
<low>0</low>
<normal>0</normal>
<high>0</high>
</tipSet>
</PropertyRate>
<PropertyRate>
<country>US</country>
<tipSet>
<low>10</low>
<normal>15</normal>
<high>20</high>
</tipSet>
</PropertyRate>
<PropertyRate xmlns="">
<country>Canada</country>
<tipSet>
<low>5</low>
<normal>10</normal>
<high>15</high>
</tipSet>
</PropertyRate>
</sca:property>
</sca:composite>
Ø 在项目Restaurant2Tip的src添加文件country.property
内容为：
<country>China</country>
Ø 在项目Restaurant2Tip下的包restaurant2.api下添加一个java bean TipPropertyBean来传递属性值
package restaurant2.api;

public class TipPropertyBean {

private String country;
private double low;
private double normal;
private double high;

private TipPropertyBean[] tipSet;

public String getCountry() {
return country;
}

public void setCountry(String country) {
this.country = country;
}

public double getLow() {
return low;
}

public void setLow(double low) {
this.low = low;
}

public double getNormal() {
return normal;
}

public void setNormal(double normal) {
this.normal = normal;
}

public double getHigh() {
return high;
}

public void setHigh(double high) {
this.high = high;
}

public TipPropertyBean[] getTipSet() {
return tipSet;
}

public void setTipSet(TipPropertyBean[] tipSet) {
this.tipSet = tipSet;
}
}
Ø 修改TipServiceImpl 来使用这些属性。新添加两个属性变量country 和allTipRates，在方法getPriceWithTip里，利用country的值，去allTipRates里找相应的tip值，然后利用这个tip值进行计算。

package restaurant2.lib;

import org.osoa.sca.annotations.Callback;

import org.osoa.sca.annotations.ConversationAttributes;

import org.osoa.sca.annotations.Property;

import org.osoa.sca.annotations.Scope;

import org.osoa.sca.annotations.Service;

import restaurant2.api.TipPropertyBean;

import restaurant2.api.TipService;

import restaurant2.api.TipServiceCallback;

@Service(TipService.class)

@Scope("CONVERSATION")

@ConversationAttributes(maxAge="1 seconds")

public class TipServiceImpl implements TipService {

@Property

public double tipRate;

@Property

public String country;

@Property

public TipPropertyBean[] allTipRates;

private TipServiceCallback tipServiceCallback;

/**

* The setter used by the runtime to set the callback reference

* @param tipServiceCallback

*/

@Callback

public void setTipServiceCallback(TipServiceCallback tipServiceCallback) {

System.out.println("setTipServiceCallback on thread " + Thread.currentThread());

this.tipServiceCallback = tipServiceCallback;

}

public TipServiceImpl(){

this.tipRate=10;

}

public void getPriceWithTip(double price) {

//return price * this.tipRate/100 + price;

System.out.println("getPriceWithTip on thread " + Thread.currentThread());

// invoke the callback

try {

//Thread.sleep(100);

if(country != null && allTipRates != null && allTipRates.length > 0){

for(TipPropertyBean tip : allTipRates){

if(tip.getCountry().equals(country)){

this.tipRate = tip.getTipSet()[0].getNormal();

break;

}

}

}

tipServiceCallback.receiveResult(price * this.tipRate/100 + price);

} catch(RuntimeException e) {

System.out.println("RuntimeException invoking receiveResult: " + e.toString());

e.printStackTrace();

} catch(Exception e) {

System.out.println("Exception invoking receiveResult: " + e.toString());

e.printStackTrace();

}

}

}

Ø 运行TipServiceServer和RestaurantServiceServer, 用soapUI测试，运行后得到到的结果是38.5
Ø 修改文件country.property
内容为：
<country>Canada</country>
运行TipServiceServer和RestaurantServiceServer, 用soapUI测试，运行后得到到的结果是42.35
Ø 修改文件country.property
内容为：
<country>US</country>
运行TipServiceServer和RestaurantServiceServer, 用soapUI测试，运行后得到到的结果是44.275

7.5.5. 属性值支持xpath表达式
修改tipRate的属性值为
<sca:property name="tipRate" source="$allTipRatesComposite/PropertyRate[country='US']/tipSet/normal"/>
那么在TipServiceImpl里面获得的tipRate的值就为15.0