Return-Path: 
 <tuscany-user-return-2774-apmail-ws-tuscany-user-archive=ws.apache.org@ws.apache.org>
Delivered-To: apmail-ws-tuscany-user-archive@locus.apache.org
Received: (qmail 22003 invoked from network); 25 Mar 2008 16:24:10 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2)
  by minotaur.apache.org with SMTP; 25 Mar 2008 16:24:10 -0000
Received: (qmail 23489 invoked by uid 500); 25 Mar 2008 16:24:09 -0000
Delivered-To: apmail-ws-tuscany-user-archive@ws.apache.org
Received: (qmail 23455 invoked by uid 500); 25 Mar 2008 16:24:08 -0000
Mailing-List: contact tuscany-user-help@ws.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:tuscany-user-help@ws.apache.org>
List-Unsubscribe: <mailto:tuscany-user-unsubscribe@ws.apache.org>
List-Post: <mailto:tuscany-user@ws.apache.org>
List-Id: <tuscany-user.ws.apache.org>
Reply-To: tuscany-user@ws.apache.org
Delivered-To: mailing list tuscany-user@ws.apache.org
Received: (qmail 23446 invoked by uid 99); 25 Mar 2008 16:24:08 -0000
Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136)
    by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 25 Mar 2008 09:24:08 -0700
X-ASF-Spam-Status: No, hits=-0.0 required=10.0
	tests=SPF_PASS
X-Spam-Check-By: apache.org
Received-SPF: pass (athena.apache.org: domain of enjoyjava@gmail.com
 designates 64.233.166.177 as permitted sender)
Received: from [64.233.166.177] (HELO py-out-1112.google.com) (64.233.166.177)
    by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 25 Mar 2008 16:23:28 +0000
Received: by py-out-1112.google.com with SMTP id a29so3960591pyi.0
        for <tuscany-user@ws.apache.org>;
 Tue, 25 Mar 2008 09:23:38 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=gmail.com; s=beta;
        h=domainkey-signature:received:received:message-id:from:to:references:subject:date:mime-version:content-type:content-transfer-encoding:x-priority:x-msmail-priority:importance:x-mailer:x-mimeole;
        bh=Bta1kUuZb1FJN31EAvOxpIaluWrBXfxM8JAEVpS7a0g=;
        b=sfh9FXYAA10b3Myqcza7wjzWYUcwour0xzUYeLMjljP2l7rDANfcjk/8PWrHF+k79PrNI2/K+0rL3y6T7hR20wmC+RvZSazHKDYuPIK2hjcVLpeQ0a/AmbIT0ckuqiLd9jAUXvACK3sYoWIMwDnjKuxIg5XbuV1T8X/MrlAlvfY=
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=beta;
        h=message-id:from:to:references:subject:date:mime-version:content-type:content-transfer-encoding:x-priority:x-msmail-priority:importance:x-mailer:x-mimeole;
        b=O4GHlT3GCfaQi/aLKVmMNEgB9qn92bjDIa4dBgjV2r+GSVNzuoET2ysSJTgnqNf8Cm4ShJoaqxE1unL71Ia5OeZXML3M3/U0ninxDF7MBp0uu3LG5nW3HUGY/P97oLP+y+Ddpbj4+pVQbPpS70iWoBKMAvPCWZFgLDb4KyWj4B4=
Received: by 10.35.96.11 with SMTP id y11mr11304087pyl.52.1206462215758;
        Tue, 25 Mar 2008 09:23:35 -0700 (PDT)
Received: from rfengt60p ( [75.36.180.32])
        by mx.google.com with ESMTPS id
 p77sm11371735pyb.16.2008.03.25.09.23.34
        (version=SSLv3 cipher=RC4-MD5);
        Tue, 25 Mar 2008 09:23:34 -0700 (PDT)
Message-ID: <DD7A35C9650548D68F389C618A490ADC@rfengt60p>
From: "Raymond Feng" <enjoyjava@gmail.com>
To: <tuscany-user@ws.apache.org>
References: <8b40fe270803230206g7f3c6174l6ada7a20614ad980@mail.gmail.com>
Subject: Re: Ask for help on promot and target
Date: Tue, 25 Mar 2008 09:24:18 -0700
MIME-Version: 1.0
Content-Type: text/plain;
	format=flowed;
	charset="utf-8";
	reply-type=original
Content-Transfer-Encoding: 7bit
X-Priority: 3
X-MSMail-Priority: Normal
Importance: Normal
X-Mailer: Microsoft Windows Live Mail 12.0.1606
X-MimeOLE: Produced By Microsoft MimeOLE V12.0.1606
X-Virus-Checked: Checked by ClamAV on apache.org

Hi,

Let me give a try:

1) @target

a) An SCA service represents a business function that a component provides, 
for example, a book store selling books.
b) An SCA reference represents a business function that a component 
consumes, for example, book store needs to use shopping cart and catalog.

The 'target' attribute of <reference> points to an SCA service that can 
provide the business function required by the reference. For example, if the 
BookStore component has a catalog reference as follows:

<component name="BookStoreComponent">
    <reference name="catalog" target="CatalogComponent/Catalog"/>
</component>

<component name="CatalogComponent">
    ...
</component>

The @target says CatalogComponent's Catalog service is the provider for 
catalog reference. If you change it to "NewCatalogComponent/Catalog", you 
basically switch to a new service provider: NewCatalogComponent's Catalog 
service.

2) @promote

In SCA, a pre-assembled composite can be reused as a building block for 
compositions. It's achieved by <implementation.composite>. For example, the 
Catalog service itself can be developed as a SCA composite. Inside the 
Catalog composite, there could be a few java components.

<component name="CatalogComponent>
    <implementation.composite composite="ns1:CatalogComposite"/>
    ...
</component>

Now the question is what services/references in the CatalogComposite will be 
made public for CatalogComponent. Service/Reference promotion is introduced 
for this purpose.

For example,

<composite name="CatalogComposite">
    <service name="Catalog" 
promote="InternalCatalogComponent/InternalCatalog">
         ...
    </service>

    <reference name="parnterCatalog" 
promote="InternalCatalogComponent/partnerCatalog">
         ...
    </reference>


    <component name="InternalCatalogComponent>
    ...
    </component>
</composite>

The @promote for the <service> says if CatalogComposite is used as a 
component for assembly, there is a service named Catalog that makes the 
InternalCatalogComponent's InternalCatalog service public. As a result, the 
CatalogComponent has a public Catalog service that can be wired to.

The @promote for the <reference> says if CatalogComposite is used as a 
component for assembly, there is a reference named partnerCatalog that makes 
the InternalCatalogComponent's partnerCatalog reference public. As a result, 
the CatalogComponent has a public partnerCatalog reference and a service 
provider can be defined for this reference.

Thanks,
Raymond
--------------------------------------------------
From: "Fengxiang" <meflyup@gmail.com>
Sent: Sunday, March 23, 2008 2:06 AM
To: <tuscany-user@ws.apache.org>
Subject: Ask for help on promot and target

> Dear all,
> My mother luangage is not english.So I can't got an deep understand with 
> the
> specification document of assembly of sca.
> Especially on attribution of promot and target, Could you give me an 
> detail
> explaination .
> Thanks.
> 

---------------------------------------------------------------------
To unsubscribe, e-mail: tuscany-user-unsubscribe@ws.apache.org
For additional commands, e-mail: tuscany-user-help@ws.apache.org