SCA概念与应用实践(5. 一个例子演示)

5.1.        Application定义

下图是我们要实现的application

 

图5_1

这个只有一层composite, 命名为 restaurant,

它包含5个component

    RestaurantServiceComponent

        显示餐馆菜单

        结帐账单.

    MenuServiceComponent

        提供菜单名字和价格.

    BillServiceComponent

        计算账单，包括消费税和小费.

    VATServiceComponent

        计算包含消费税的账单价格.

    TipServiceComponent

        计算小费的价格.

 

5.2.        过程

5.2.1.       创建一个java project

Ø        选择菜单 【New > Java Project】.

Ø        Project 名字为"Restaurant2". 选择 “Create separate folders for sources and class files”，点击next

Ø        在Libraries里面，添加User Library TUSCANY

              图5_2

Ø        点击”next”和”finish”.

 

5.3.        创建SCA Composite diagram

Ø        在project上右键，选择 【New > Other....】

Ø        在SCA目录下，选择 SCA Composite Diagram，点击next

             

图5_3

Ø        文件名字设为Restaurant2.composite_diagram，点击 Finish.

 

完成后SCA Composite Designer自动打开新创建的文件. 在diagram上右键，选择Show Properties 来打开Properties view

 

图5_4

5.4.        添加component

使用palette创建component

图5_5

图5_6

 

 

 

填入RestaurantServiceComponent作为component的名字。同样创建其他的compoent，MenuServiceComponent, BillServiceComponent, VatServiceComponent, and TipServiceComponent.

 

图5_7 

5.5.        添加Service

       有两种方式给component添加service

       一个是使用palette，在palette上选择service，然后在要添加的component上点一下，一个service就添加到component上

       第二个方法是把鼠标移到component上，一个工具条自动就出现，选择绿色的那个。

 

图5_8

    *在 RestaurantServiceComponent上添加 RestaurantService,

    *在MenuServiceComponent上添加MenuService,

    *在BillServiceComponent上添加BillService,

    *在VatServiceComponent上添加VatService,

    *在TipServiceComponent上添加TipService.

 

图5_9 

5.6.        添加References

类似方法给component添加reference

    * 在RestaurantServiceComponent上添加menuService,

    * 在RestaurantServiceComponent上添加billService,

    * 在BillServiceComponent上添加vatService,

* 在BillServiceComponent上添加tipService

图5_10 

5.7.        wire reference到service

有palette上的wire把reference和service连起来

RestaurantServiceComponent上的reference（menuService）连到MenuServiceComponent的service（MenuService），以此类推，把所有reference都连到相应service

 

图5_11

5.8.        Promote service

       把RestaurantServiceComponent上的serivce（RestaurantService）promote到composite层，这样外面就可以调用这个application提供的功能。

       在RestaurantService绿色图标上右键，选择promot

图5_12

 

5.9.        用SCA Composite Model Editor打开Restaurant2.comosite，在Restaurant2.comosite 右键选open with

 

 图5_13

用Text Editor打开

 

图5_14 

可以在这两个editor里编辑composite，会自动同步

 

5.10.     给service定义java interface

把鼠标移到RestaurantServiceComponent上的service上，会自动有一个工具条出现，选择add JavaInterface

 

图5_15

选中新添加的JavaInterface图标， 在properties中设置Interface的类名，包括package，restaurant2.api.RestaurantService

 

图5_16

以此类推给所有service添加JavaInterface

名字分别为restaurant2.api.MenuService

restaurant2.api.BillService

restaurant2.api.VatService

restaurant2.api.TipService

 

图5_17

5.11.     给component定义java implementation class的名字

鼠标移到RestaurantServiceComponent上，会自动有一个工具条出现，选择add JavaImplementation

 

 

图5_18

选中新添加的JavaImplementation图标， 在properties中设置class，包括package，restaurant2.lib.RestaurantServiceImpl

 

 

图5_19

以此类推，给所有component添加JavaImplementation， 类名分别为

restaurant2.lib.MenuServiceImpl

restaurant2.lib.BillServiceImpl

restaurant2.lib.VatServiceImpl

restaurant2.lib.TipServiceImpl

 

图5_20 

5.12.     生成代码框架

首先在project上右键选择 Add SCA Nature

 

图5_21

然后在Restaurant2.composite上右键 选择SCA>Generate Java Skeleton…

 

图5_22

出现确认窗口，点ok

 

图5_23

生成后项目结构是

 

图5_24

生成的代码只有一个空壳，要在里面添加方法定义和实现。生成的代码的样子

 

 

 

 

5.13.     接口类的定义

• Restaurant Service

 
     
     

      
      
 
       
 
        view plain 
        copy to clipboard 
        print 
        ? 
       
 
      
      
      
package restaurant2.api;  
   
public interface RestaurantService {   
  Menu[] getMenus();  
  double getBill(Menu menu);  
}  
     
     
 

• Menu Service

 
     
     

      
      
 
       
 
        view plain 
        copy to clipboard 
        print 
        ? 
       
 
      
      
      
package restaurant2.api;  
   
public interface MenuService {  
  Menu[] getMenu();  
  double getPrice(Menu menu);  
}  
     
     
 

• Bill Service

 
     
     

      
      
package restaurant2.api;  
   
public interface BillService {  
  double getBill(double menuPrice);  
}  
     
     
 

• Vat Service

 
     
     

      
      
package restaurant2.api;  
   
public interface VatService {  
  double getPriceWithVat(double price);  
}  
     
     
 

• Tip Service

 
     
     

      
      
package restaurant2.api;  
   
public interface TipService {  
  double getPriceWithTip(double price);  
}  
     
     
 

添加DTO Menu:

 

1. package restaurant2.api;  
2.   
3.    
4.   
5. import java.io.Serializable;  
6.   
7.    
8.   
9. public class Menu implements Serializable{  
10.   
11.       private int id;  
12.   
13.       private String details;  
14.       public Menu(){}  
15.   
16.       public Menu(int idC, String detailsC) {  
17.   
18.         this.id = idC;  
19.   
20.         this.details = detailsC;  
21.   
22.       }  
23.       public String printMenu() {  
24.         return this.details;  
25.       }  
26.       public int getId() {  
27.   
28.         return this.id;  
29.   
30.       }  
31.   
32.     public String getDetails() {  
33.   
34.        return details;  
35.     }  
36.     public void setDetails(String details) {  
37.   
38.        this.details = details;  
39.     }  
40.   
41.     public void setId(int id) {  
42.        this.id = id;  
43.     }    
44.     
45.   
46. }  

 

5.14.        实现类

• Restaurant Service

 
     
     

      
      
 
       
 
        view plain 
        copy to clipboard 
        print 
        ? 
       
 
      
      
      
package restaurant2.lib;  
   
import org.osoa.sca.annotations.Reference;  
import org.osoa.sca.annotations.Service;  
   
import restaurant2.api.BillService;  
import restaurant2.api.Menu;  
import restaurant2.api.MenuService;  
import restaurant2.api.RestaurantService;  
   
@Service(RestaurantService.class)  
public class RestaurantServiceImpl implements RestaurantService {  
   
  private MenuService menuService;  
  private BillService billService;  
   
  @Reference  
  public void setMenuService(MenuService menuService) {  
    this.menuService = menuService;  
  }  
   
  @Reference  
  public void setBillService(BillService billService) {  
    this.billService = billService;  
  }  
   
  public double getBill(Menu menu) {  
    double menuPrice = this.menuService.getPrice(menu);  
    return this.billService.getBill(menuPrice);  
  }  
   
  public Menu[] getMenus() {  
    return this.menuService.getMenu();  
  }    
}  
     
     
 

• Menu Service

 

 

• Bill service

 
     
     

      
      
package restaurant2.lib;  
   
import org.osoa.sca.annotations.Reference;  
import org.osoa.sca.annotations.Service;  
   
import restaurant2.api.BillService;  
import restaurant2.api.TipService;  
import restaurant2.api.VatService;  
   
@Service(BillService.class)  
public class BillServiceImpl implements BillService {  
   
  private VatService vatService;  
  private TipService tipService;  
   
  @Reference  
  public void setVatService(VatService vatService) {  
    this.vatService = vatService;  
  }  
   
  @Reference  
  public void setTipService(TipService tipService) {  
    this.tipService = tipService;  
  }  
   
  public double getBill(double menuPrice) {  
    double pricewithTaxRate =   
                   this.vatService.getPriceWithVat(menuPrice);  
    double priceWithTipRate =   
                   this.tipService.getPriceWithTip(pricewithTaxRate);  
    return priceWithTipRate;  
  }  
}  
     
     
 

• Vat Service

 

• Tip service

 

5.15.      测试 Restaurant

创建一个新的测试类 Client。这个client会把Restaurant2发布到tuscany里面，然后调用promote出来的那个service的interface。

 

 

5.16.        运行client:

在class Client上右键选择【Run as > Java Application】

运行结果为

图5_25

 到此一个简单的application就开发完了。后面会使用这个例子，结合SCA里面的概念仔细说明

view plain copy to clipboard print ?

1. package test;  
2.    
3. import org.apache.tuscany.sca.host.embedded.SCADomain;  
4.    
5. import restaurant2.api.Menu;  
6. import restaurant2.api.RestaurantService;  
7.    
8. public class Client {  
9.    
10.   public static void main(String[] args) throws Exception {  
11.     SCADomain scaDomain = SCADomain.newInstance("Restaurant2.composite");  
12.     RestaurantService restaurantService = scaDomain.getService(  
13.     RestaurantService.class, "RestaurantServiceComponent");  
14.     Menu[] menus = restaurantService.getMenus();  
15.     System.out.println("--- Menu ---");  
16.     for (Menu m : menus) {  
17.       System.out.println("- " + m.printMenu());  
18.     }  
19.     System.out.println();     
20.     Menu menu = menus[3];  
21.     System.out.println("My choice: " + menu.printMenu());  
22.     System.out.println();  
23.     double price = restaurantService.getBill(menu);  
24.     System.out.println("Price (" + menu.printMenu() + "): " + price);  
25.     scaDomain.close();  
26.   }  
27. }  

1. package restaurant2.lib;  
2.    
3. import org.osoa.sca.annotations.Property;  
4. import org.osoa.sca.annotations.Service;  
5.    
6. import restaurant2.api.TipService;  
7.    
8. @Service(TipService.class)  
9. public class TipServiceImpl implements TipService {  
10.    
11.   @Property  
12.   public double tipRate;  
13.    
14.   public TipServiceImpl(){  
15.     this.tipRate=10;  
16.   }  
17.    
18.   public double getPriceWithTip(double price) {  
19.     return price * this.tipRate/100 + price;  
20.   }   
21. }  

view plain copy to clipboard print ?

1. package restaurant2.lib;  
2.    
3. import org.osoa.sca.annotations.Service;  
4.    
5. import restaurant2.api.VatService;  
6.    
7. @Service(VatService.class)  
8. public class VatServiceImpl implements VatService {  
9.    
10.   public double vatRate;  
11.    
12.   public VatServiceImpl(){  
13.     this.vatRate=19.6;  
14.   }  
15.    
16.   public double getPriceWithVat(double price) {  
17.     return price * this.vatRate/100 + price;  
18.   }    
19. }  

view plain copy to clipboard print ?

1. package restaurant2.lib;  
2.   
3.    
4.   
5. import org.osoa.sca.annotations.Init;  
6.   
7. import org.osoa.sca.annotations.Service;  
8.   
9.    
10.   
11. import restaurant2.api.Menu;  
12.   
13. import restaurant2.api.MenuService;  
14.   
15.    
16.   
17. @Service(MenuService.class)  
18.   
19. public class MenuServiceImpl implements MenuService {  
20.   
21.    
22.   
23.   private Menu[] menus;  
24.   
25.   private double[] prices;  
26.   
27.    
28.   
29.   @Init  
30.   
31.   public void init() {  
32.   
33.     this.menus = new Menu[] {  
34.   
35.             new Menu(0, "Grilled hamburger with French fries" ),  
36.   
37.             new Menu(1, "Roasted chicken with vegetables"),  
38.   
39.             new Menu(2, "Duck breast in an orange sauce"),  
40.   
41.             new Menu(3, "Duck foie gras & mango chutney") };  
42.   
43.     this.prices = new double[] { 10, 15, 35, 50 };  
44.   
45.   }  
46.   
47.    
48.   
49.   public Menu[] getMenu() {  
50.   
51.     return this.menus;  
52.   
53.   }  
54.   
55.    
56.   
57.   public double getPrice(Menu menu) {  
58.   
59.     return this.prices[((Menu) menu).getId()];  
60.   
61.   }  
62.   
63. }   
64.   public double getPrice(Menu menu) {  
65.     return this.prices[((MenuImpl) menu).getId()];  
66.   }  
67. }  

view plain copy to clipboard print ?

1. /* 
2.  
3.  * Generated from Restaurant2.composite on 06/17/10 at 16:37:42. 
4.  
5.  */  
6.   
7.    
8.   
9. package restaurant2.api;  
10.   
11.    
12.   
13. import org.osoa.sca.annotations.Remotable;  
14.   
15.    
16.   
17. @Remotable  
18.   
19. public interface BillService {  
20.   
21.    
22.   
23.        // TODO: add the service operations.  
24.   
25. }