diff options
| author | Marijke Hengstmengel <MHengstmengel@users.noreply.github.com> | 2010-06-28 13:44:03 +0000 |
|---|---|---|
| committer | Marijke Hengstmengel <MHengstmengel@users.noreply.github.com> | 2010-06-28 13:44:03 +0000 |
| commit | 7cc86af1e2b46bd323de960e88370087ab479cd1 (patch) | |
| tree | 2edcb1bf88eb7661d6d0aebdf676b7e8432260d2 /CIAO/connectors/ami4ccm | |
| parent | 0527a24a5833e78f14ce30e8ba7f928499ae3fd6 (diff) | |
| download | ATCD-7cc86af1e2b46bd323de960e88370087ab479cd1.tar.gz | |
Mon Jun 28 13:43:34 UTC 2010 Marijke Hengstmengel <mhengstmengel@remedy.nl>
* connectors/ami4ccm/tutorials/Hello/Tutorial/02_idl.html
* connectors/ami4ccm/tutorials/Hello/Tutorial/03_executors.html
* connectors/ami4ccm/tutorials/Hello/Tutorial/04_ami4ccm.html
* connectors/ami4ccm/tutorials/Hello/Tutorial/05_compilation.html
Layout changes.
Diffstat (limited to 'CIAO/connectors/ami4ccm')
4 files changed, 392 insertions, 609 deletions
diff --git a/CIAO/connectors/ami4ccm/tutorials/Hello/Tutorial/02_idl.html b/CIAO/connectors/ami4ccm/tutorials/Hello/Tutorial/02_idl.html index 4897e2ab52a..d73d34ffbcd 100644 --- a/CIAO/connectors/ami4ccm/tutorials/Hello/Tutorial/02_idl.html +++ b/CIAO/connectors/ami4ccm/tutorials/Hello/Tutorial/02_idl.html @@ -6,11 +6,12 @@ <META NAME="GENERATOR" CONTENT="OpenOffice.org 3.2 (Win32)"> <META NAME="CREATED" CONTENT="0;0"> <META NAME="CHANGEDBY" CONTENT="Marijke Hengstmengel"> - <META NAME="CHANGED" CONTENT="20100625;14095400"> + <META NAME="CHANGED" CONTENT="20100628;14101200"> <META NAME="CHANGEDBY" CONTENT="Marijke Hengstmengel"> <META NAME="CHANGEDBY" CONTENT="Marijke Hengstmengel"> <META NAME="CHANGEDBY" CONTENT="Marijke Hengstmengel"> - <!--//$Id$ --> + <META NAME="CHANGEDBY" CONTENT="Marijke Hengstmengel"> + <!--//$Id$ --> <STYLE TYPE="text/css"> <!-- H2.cjk { font-family: "SimSun" } @@ -18,165 +19,99 @@ --> </STYLE> </HEAD> -<BODY LANG="nl-NL" DIR="LTR"> -<TABLE WIDTH=100% BORDER=0 CELLPADDING=2 CELLSPACING=2 STYLE="page-break-before: always"> +<BODY LANG="nl-NL" DIR="ltr"> +<TABLE WIDTH="100%" BORDER=0 CELLPADDING=2 CELLSPACING=2 STYLE="PAGE-BREAK-BEFORE: always"> <TR> <TD> - <P ALIGN=LEFT><A HREF="01_general.html">Previous</A></P> - </TD> + <P ALIGN=left><A href="01_general.html">Previous</A></P></TD> <TD> - <P ALIGN=CENTER><IMG SRC="images/images.png" NAME="graphics1" ALIGN=BOTTOM WIDTH=4% HEIGHT=5% BORDER=0></P> - </TD> + <P ALIGN=center><IMG border=0 name=graphics1 align=bottom src="images/images.png" width="4%" height="5%" ></P></TD> <TD> - <P ALIGN=RIGHT><A HREF="03_executors.html">Next</A></P> - </TD> - </TR> -</TABLE> + <P ALIGN=right><A href="03_executors.html">Next</A></P></TD></TR></TABLE> <HR> -<H1>IDL files</H1> -<P>The IDL files are generated by the modelling tools. To understand -this example better, it'll give an overview of which IDL files are -generated. -</P> +<H1 STYLE="MARGIN-LEFT: 0cm">IDL files</H1> +<P>The IDL files are generated by the modelling tools. To +understand this example better, it'll give an overview of which IDL files are +generated. </P> <H2 CLASS="western">Common IDL files</H2> -<P>Below an simplied represenation of the common IDL files. Use the -links to view the file itself. The following IDL files can be found -in Hello_asm/ports: -</P> +<P>Below an simplied represenation of the common IDL files. +Use the links to view the file itself. The following IDL files can be found in +Hello_asm/ports: </P> <UL> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="../Hello_asm/ports/Hello_Common_defn.idl">Hello_Common_defn.idl</A> - : <BR>for common includes and IDL defenitions. - </P> -</UL> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><CODE CLASS="western"><FONT COLOR="#0000ff"><FONT SIZE=2>module</FONT></FONT></CODE><CODE CLASS="western"><FONT COLOR="#000000"> -</FONT></CODE><CODE CLASS="western"><FONT COLOR="#000000"><FONT SIZE=2>Hello</FONT></FONT></CODE><FONT COLOR="#000000"><FONT SIZE=2>{ -exception InternalError { </FONT></FONT><FONT COLOR="#0000ff"><FONT SIZE=2>long</FONT></FONT><FONT COLOR="#000000"> -</FONT><FONT COLOR="#0000ff"><FONT SIZE=2>id</FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2>; -</FONT></FONT><FONT COLOR="#0000ff"><FONT SIZE=2>string</FONT></FONT><FONT COLOR="#000000"> -</FONT><FONT COLOR="#000000"><FONT SIZE=2>error_string; }; };</FONT></FONT><CODE CLASS="western"> -</CODE> -</P> + <LI><P STYLE="MARGIN-BOTTOM: 0cm"><A href="../Hello_asm/ports/Hello_Common_defn.idl">Hello_Common_defn.idl</A> + : <BR>for common includes and IDL defenitions. +</P></LI></UL> +<P STYLE="MARGIN-BOTTOM: 0cm; MARGIN-LEFT: 2cm"><CODE CLASS="western"><FONT COLOR="#0000ff"><FONT FACE="Times New Roman, serif"><FONT SIZE=2>module</FONT></FONT></FONT></CODE><CODE CLASS="western"><FONT COLOR="#000000"><FONT SIZE=2> </FONT></FONT></CODE><CODE CLASS="western"><FONT COLOR="#000000"><FONT FACE="Times New Roman, serif"><FONT SIZE=2>Hello</FONT></FONT></FONT></CODE><FONT COLOR="#000000"><FONT SIZE=2>{ </FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2>exception +InternalError { </FONT></FONT><FONT COLOR="#0000ff"><FONT SIZE=2>long</FONT></FONT><FONT COLOR="#000000"> </FONT><FONT COLOR="#0000ff"><FONT SIZE=2>id</FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2>; </FONT></FONT><FONT COLOR="#0000ff"><FONT SIZE=2>string</FONT></FONT><FONT COLOR="#000000"> </FONT><FONT COLOR="#000000"><FONT SIZE=2>error_string; }; };</FONT></FONT><CODE CLASS="western"> </CODE></P> <UL> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="../Hello_asm/ports/Hello_MyFoo_obj.idl">Hello_MyFoo_obj.idl</A> - : <BR>for IDL interfaces. This IDL contains the #pragma's for - enabling AMI4CCM , needed by the TAO_IDL compiler: - </P> + <LI><P STYLE="MARGIN-BOTTOM: 0cm"><A href="../Hello_asm/ports/Hello_MyFoo_obj.idl">Hello_MyFoo_obj.idl</A> + : <BR>for IDL interfaces. This IDL contains the #pragma's + for enabling AMI4CCM , needed by the TAO_IDL compiler: </P> <UL> - <UL> - <UL> - <LI><P STYLE="margin-bottom: 0cm"><CODE CLASS="western"><FONT COLOR="#0000ff"><FONT FACE="Times New Roman, serif"><FONT SIZE=2>#pragma</FONT></FONT></FONT></CODE><CODE CLASS="western"><FONT COLOR="#000000"><FONT FACE="Times New Roman, serif"> - </FONT></FONT></CODE><CODE CLASS="western"><FONT COLOR="#000000"><FONT FACE="Times New Roman, serif"><FONT SIZE=2>ciao - lem </FONT></FONT></FONT></CODE><CODE CLASS="western"><FONT COLOR="#a31515"><FONT FACE="Times New Roman, serif"><FONT SIZE=2>"Hello_MyFoo_objE.idl", - </FONT></FONT></FONT></CODE> - </P> - <LI><P STYLE="margin-bottom: 0cm"><CODE CLASS="western"><FONT COLOR="#0000ff"><FONT FACE="Times New Roman, serif"><FONT SIZE=2>#pragma</FONT></FONT></FONT></CODE><CODE CLASS="western"><FONT COLOR="#000000"><FONT FACE="Times New Roman, serif"><FONT SIZE=2> - ciao lem </FONT></FONT></FONT></CODE><CODE CLASS="western"><FONT COLOR="#a31515"><FONT FACE="Times New Roman, serif"><FONT SIZE=2>"Hello_MyFoo_objAE.idl"</FONT></FONT></FONT></CODE></P> - <LI><P STYLE="margin-bottom: 0cm"><FONT COLOR="#0000ff"><FONT SIZE=2>#pragma</FONT></FONT><FONT COLOR="#000000"> - </FONT><FONT COLOR="#000000"><FONT SIZE=2>ciao ami4ccm </FONT></FONT><FONT COLOR="#0000ff"><FONT SIZE=2>interface</FONT></FONT><FONT COLOR="#000000"> - </FONT><FONT COLOR="#a31515"><FONT SIZE=2>"Hello::MyFoo_obj" - /</FONT></FONT><FONT COLOR="#33cc66"><FONT SIZE=2>//</FONT></FONT><FONT COLOR="#00ae00"><FONT SIZE=2>this - is needed per interface</FONT></FONT></P> - <LI><P STYLE="margin-bottom: 0cm"><FONT COLOR="#0000ff"><FONT SIZE=2><SPAN LANG="">#pragma</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG=""> - ciao ami4ccm idl </SPAN></FONT></FONT><FONT COLOR="#a31515"><FONT SIZE=2><SPAN LANG="">"Hello_MyFoo_objA.idl" - </SPAN></FONT></FONT><FONT COLOR="#008000"><FONT SIZE=2><SPAN LANG="">//needed - for 'uses multiple', not used in this example <BR></SPAN></FONT></FONT><FONT COLOR="#0000ff"><FONT SIZE=2><SPAN LANG=""> - </SPAN></FONT></FONT> - </P> - </UL> - </UL> - </UL> -</UL> -<P STYLE="margin-left: 1.33cm; margin-bottom: 0cm"><FONT COLOR="#000000"> - <FONT SIZE=3>Also this IDL contains the interface between Sender and -Receiver</FONT></FONT></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT SIZE=2><FONT COLOR="#0000ff">interface</FONT><FONT COLOR="#000000"> -</FONT><FONT COLOR="#000000">MyFoo_obj</FONT></FONT></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT SIZE=2>{</FONT></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT SIZE=2><FONT COLOR="#0000ff">long</FONT><FONT COLOR="#000000"> -</FONT><FONT COLOR="#000000">foo (</FONT><FONT COLOR="#0000ff">in</FONT><FONT COLOR="#000000"> -</FONT><FONT COLOR="#0000ff">string</FONT><FONT COLOR="#000000"> -</FONT><FONT COLOR="#000000">in_str, </FONT><FONT COLOR="#0000ff">out</FONT><FONT COLOR="#000000"> -</FONT><FONT COLOR="#0000ff">string</FONT><FONT COLOR="#000000"> -</FONT><FONT COLOR="#000000">answer)</FONT></FONT></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"> <FONT SIZE=2>raises -(InternalError);</FONT></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT SIZE=2><FONT COLOR="#0000ff">void</FONT><FONT COLOR="#000000"> -</FONT><FONT COLOR="#000000">hello (</FONT><FONT COLOR="#0000ff">out</FONT><FONT COLOR="#000000"> -</FONT><FONT COLOR="#0000ff">long</FONT><FONT COLOR="#000000"> -</FONT><FONT COLOR="#000000">answer)</FONT></FONT></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"> <FONT SIZE=2>raises -(InternalError);</FONT></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><BR> -</P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT SIZE=2><FONT COLOR="#000000">attribute -</FONT><FONT COLOR="#0000ff">short</FONT><FONT COLOR="#000000"> -</FONT><FONT COLOR="#000000">rw_attrib</FONT></FONT></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"> <FONT SIZE=2>getraises -(InternalError)</FONT></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"> <FONT SIZE=2>setraises + + <LI><P STYLE="MARGIN-BOTTOM: 0cm"><CODE CLASS="western"><FONT COLOR="#0000ff"><FONT FACE="Times New Roman, serif"><FONT SIZE=2>#pragma</FONT></FONT></FONT></CODE><CODE CLASS="western"><FONT COLOR="#000000"> + </FONT></CODE><CODE CLASS="western"><FONT COLOR="#000000"><FONT FACE="Times New Roman, serif"><FONT SIZE=2>ciao lem + </FONT></FONT></FONT></CODE><CODE CLASS="western"><FONT COLOR="#a31515"><FONT FACE="Times New Roman, serif"><FONT SIZE=2>"Hello_MyFoo_objE.idl", +</FONT></FONT></FONT></CODE></P> + <LI><P STYLE="MARGIN-BOTTOM: 0cm"><CODE CLASS="western"><FONT COLOR="#0000ff"><FONT FACE="Times New Roman, serif"><FONT SIZE=2>#pragma</FONT></FONT></FONT></CODE><CODE CLASS="western"><FONT COLOR="#000000"> + </FONT></CODE><CODE CLASS="western"><FONT COLOR="#000000"><FONT FACE="Times New Roman, serif"><FONT SIZE=2>ciao lem + </FONT></FONT></FONT></CODE><CODE CLASS="western"><FONT COLOR="#a31515"><FONT FACE="Times New Roman, serif"><FONT SIZE=2>"Hello_MyFoo_objAE.idl"</FONT></FONT></FONT></CODE></P> + <LI><P STYLE="MARGIN-BOTTOM: 0cm"><FONT COLOR="#0000ff"><FONT SIZE=2>#pragma</FONT></FONT><FONT COLOR="#000000"> </FONT><FONT COLOR="#000000"><FONT SIZE=2>ciao ami4ccm </FONT></FONT><FONT COLOR="#0000ff"><FONT SIZE=2>interface</FONT></FONT><FONT COLOR="#000000"> </FONT><FONT COLOR="#a31515"><FONT SIZE=2>"Hello::MyFoo_obj" /</FONT></FONT><FONT COLOR="#33cc66"><FONT SIZE=2>//</FONT></FONT><FONT COLOR="#008000"><FONT SIZE=2>this is needed per + interface</FONT></FONT></P> + <LI><P STYLE="MARGIN-BOTTOM: 0cm"><FONT COLOR="#0000ff"><FONT SIZE=2>#pragma</FONT></FONT><FONT COLOR="#000000"> </FONT><FONT COLOR="#000000"><FONT SIZE=2>ciao ami4ccm idl </FONT></FONT><FONT COLOR="#a31515"><FONT SIZE=2>"Hello_MyFoo_objA.idl" </FONT></FONT><FONT COLOR="#008000"><FONT SIZE=2>//needed for 'uses multiple', not used in this example + </FONT></FONT></P></LI></UL></LI></UL> +<P STYLE="MARGIN-BOTTOM: 0cm; MARGIN-LEFT: 1cm"><FONT COLOR="#000000"><FONT SIZE=3>Also this +IDL contains the interface between Sender and Receiver</FONT></FONT></P> +<P STYLE="MARGIN-BOTTOM: 0cm; MARGIN-LEFT: 2cm"><FONT SIZE=2><FONT COLOR="#0000ff">interface</FONT><FONT COLOR="#000000"> +MyFoo_obj<BR></FONT></FONT><FONT SIZE=2>{<BR></FONT><FONT SIZE=2><FONT COLOR="#0000ff"> long</FONT><FONT COLOR="#000000"> foo (</FONT><FONT COLOR="#0000ff">in</FONT><FONT COLOR="#000000"> +</FONT><FONT COLOR="#0000ff">string</FONT><FONT COLOR="#000000"> in_str, </FONT><FONT COLOR="#0000ff">out</FONT><FONT COLOR="#000000"> +</FONT><FONT COLOR="#0000ff">string</FONT><FONT COLOR="#000000"> +answer)<BR></FONT></FONT><FONT SIZE=2><FONT color=#0000ff> </FONT>raises (InternalError);</FONT></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><BR> -</P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT SIZE=2><FONT COLOR="#0000ff">readonly</FONT><FONT COLOR="#000000"> -</FONT><FONT COLOR="#000000">attribute </FONT><FONT COLOR="#0000ff">short</FONT><FONT COLOR="#000000"> -</FONT><FONT COLOR="#000000">ro_attrib</FONT></FONT></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT SIZE=2>raises +<P STYLE="MARGIN-BOTTOM: 0cm; MARGIN-LEFT: 2cm"><FONT SIZE=2><FONT COLOR="#0000ff"> void</FONT><FONT COLOR="#000000"> hello (</FONT><FONT COLOR="#0000ff">out</FONT><FONT COLOR="#000000"> +</FONT><FONT COLOR="#0000ff">long</FONT><FONT COLOR="#000000"> answer)<BR></FONT></FONT><FONT SIZE=2><FONT color=#0000ff> </FONT>raises +(InternalError);</FONT><BR></P> +<P STYLE="MARGIN-BOTTOM: 0cm; MARGIN-LEFT: 2cm"><FONT SIZE=2><FONT COLOR="#000000"><FONT +color=#0000ff> </FONT>attribute </FONT><FONT COLOR="#0000ff">short</FONT><FONT COLOR="#000000"> rw_attrib<BR></FONT></FONT><FONT SIZE=2><FONT +color=#0000ff> </FONT>getraises (InternalError)<BR></FONT><FONT SIZE=2><FONT +color=#0000ff> </FONT>setraises (InternalError);</FONT></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT COLOR="#000000"><FONT SIZE=2>};</FONT></FONT><CODE CLASS="western"><FONT SIZE=2> -</FONT></CODE> -</P> +<P STYLE="MARGIN-BOTTOM: 0cm; MARGIN-LEFT: 2cm"><FONT SIZE=2><FONT COLOR="#0000ff"> readonly</FONT><FONT COLOR="#000000"> attribute </FONT><FONT COLOR="#0000ff">short</FONT><FONT COLOR="#000000"> +ro_attrib<BR></FONT></FONT><FONT SIZE=2><FONT color=#0000ff> </FONT>raises +(InternalError);<BR></FONT><FONT COLOR="#000000"><FONT SIZE=2>};</FONT></FONT><CODE CLASS="western"> </CODE></P> <H2 CLASS="western">Component IDL files:</H2> -<H2 CLASS="western"><FONT SIZE=4 STYLE="font-size: 16pt">Sender -component IDL file</FONT></H2> -<P>The <A HREF="../Hello_asm/Sender_comp/src/Hello_Sender_comp.idl">Hello_Sender_comp.idl</A> +<H2 CLASS="western"><FONT SIZE=4 STYLE="FONT-SIZE: 16pt">Sender component IDL file</FONT></H2> +<P>The <A href="../Hello_asm/Sender_comp/src/Hello_Sender_comp.idl">Hello_Sender_comp.idl</A> file in the Sender_comp/src directory defines the asynchronous and -synchronous connections. <FONT COLOR="#000000"><FONT SIZE=3>For -synchronous invocations, the Sender component uses the MyFoo_obj -interface (which the Receiver provides). </FONT></FONT><FONT COLOR="#a31515"><FONT SIZE=3> -</FONT></FONT><FONT COLOR="#a31515"><FONT SIZE=2>component Sender</FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2> -{ </FONT></FONT><FONT COLOR="#008000"><FONT SIZE=2>/// For -synchronous invocation</FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2> -uses MyFoo run_my_foo; }; </FONT></FONT> -</P> -<P><FONT COLOR="#000000"><FONT SIZE=3>For asynchronous invocations, -the Sender component uses the AMI_MyFoo_obj interface of the AMI -component and provides the AMI_MyFoo_objReplyHandler interface to the -AMI component. This is indicated with </FONT></FONT> <FONT COLOR="#0000ff"><FONT SIZE=2>#pragma</FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2> -ciao ami4ccm receptacle </FONT></FONT><FONT COLOR="#a31515"><FONT SIZE=2>"Hello::Sender_comp::run_my_foo" -</FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2> .</FONT></FONT></P> -<H2 CLASS="western"><FONT SIZE=4 STYLE="font-size: 16pt">Receiver IDL -file</FONT></H2> -<P>The <A HREF="../Hello_asm/Receiver_comp/src/Hello_Receiver_comp.idl">Hello_Receiver_comp.idl</A> +synchronous connections. <FONT COLOR="#000000"><FONT SIZE=3>For synchronous invocations, the Sender component uses the +MyFoo_obj interface (which the Receiver provides). </FONT></FONT><FONT COLOR="#a31515"><FONT SIZE=2>component +Sender</FONT></FONT><FONT COLOR="#000000"> </FONT><FONT COLOR="#000000"><FONT SIZE=2>{ +</FONT></FONT><FONT COLOR="#008000"><FONT SIZE=2>/// For synchronous invocation</FONT></FONT><FONT COLOR="#000000"> </FONT><FONT COLOR="#000000"><FONT SIZE=2>uses MyFoo run_my_foo; }; +</FONT></FONT></P> +<P><FONT COLOR="#000000"><FONT SIZE=3>For asynchronous invocations, the Sender component uses the +AMI_MyFoo_obj interface of the AMI component and provides the +AMI_MyFoo_objReplyHandler interface to the AMI component. This is indicated with +</FONT></FONT><FONT COLOR="#0000ff"><FONT SIZE=2>#pragma</FONT></FONT><FONT COLOR="#000000"> </FONT><FONT COLOR="#000000"><FONT SIZE=2>ciao ami4ccm receptacle </FONT></FONT><FONT COLOR="#a31515"><FONT SIZE=2>"Hello::Sender_comp::run_my_foo" </FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2>.</FONT></FONT></P> +<H2 CLASS="western"><FONT SIZE=4 STYLE="FONT-SIZE: 16pt">Receiver component IDL file</FONT></H2> +<P>The <A href="../Hello_asm/Receiver_comp/src/Hello_Receiver_comp.idl">Hello_Receiver_comp.idl</A> file in the Receiver_comp/src directory indicates the port the receiver provide<FONT COLOR="#000000"><FONT SIZE=2>.</FONT></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT COLOR="#000000"><FONT SIZE=2>component -Receiver</FONT></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT COLOR="#000000"><FONT SIZE=2>{</FONT></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT COLOR="#008000"> <FONT SIZE=2>/// -Provides</FONT></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT COLOR="#000000"> <FONT SIZE=2>provides -MyFoo_obj do_my_foo;</FONT></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT COLOR="#000000"><FONT SIZE=2>};</FONT></FONT></P> -<P STYLE="margin-bottom: 0cm"><BR> -</P> -<P><CODE CLASS="western"><FONT COLOR="#000000"><FONT FACE="Times New Roman, serif">The -receiver isn't aware of the calls are a- or synchronously.</FONT></FONT></CODE></P> -<P><BR><BR> -</P> -<TABLE WIDTH=100% BORDER=0 CELLPADDING=2 CELLSPACING=2> +<P STYLE="MARGIN-BOTTOM: 0cm"><FONT COLOR="#000000"><FONT SIZE=2>component +Receiver<BR></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2>{<BR></FONT></FONT><FONT COLOR="#008000"><FONT SIZE=2> // +Provides<BR></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2> provides MyFoo_obj +do_my_foo;<BR></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2>};</FONT></FONT></P> +<P STYLE="MARGIN-BOTTOM: 0cm"><CODE CLASS="western"> +<FONT COLOR="#000000"><FONT FACE="Times New Roman"><FONT SIZE=3>The receiver isn't aware of the calls are a- or +synchronously.</FONT></FONT></FONT></CODE></P> +<P><BR><BR></P> +<TABLE WIDTH="100%" BORDER=0 CELLPADDING=2 CELLSPACING=2> <TR> <TD> - <P ALIGN=LEFT><A HREF="01_general.html">Previous</A></P> - </TD> + <P ALIGN=left><A href="01_general.html">Previous</A></P></TD> <TD> - <P ALIGN=CENTER><IMG SRC="images/images.png" NAME="graphics2" ALIGN=BOTTOM WIDTH=4% HEIGHT=5% BORDER=0></P> - </TD> + <P ALIGN=center><IMG border=0 name=graphics2 align=bottom src="images/images.png" width="4%" height="5%" ></P></TD> <TD> - <P ALIGN=RIGHT><A HREF="03_executors.html">Next</A></P> - </TD> - </TR> -</TABLE> -<P><BR><BR> -</P> + <P ALIGN=right><A href="03_executors.html">Next</A></P></TD></TR></TABLE> +<P><BR><BR></P> </BODY> -</HTML> +</HTML>
\ No newline at end of file diff --git a/CIAO/connectors/ami4ccm/tutorials/Hello/Tutorial/03_executors.html b/CIAO/connectors/ami4ccm/tutorials/Hello/Tutorial/03_executors.html index 4d42adae4d6..cda636b892f 100644 --- a/CIAO/connectors/ami4ccm/tutorials/Hello/Tutorial/03_executors.html +++ b/CIAO/connectors/ami4ccm/tutorials/Hello/Tutorial/03_executors.html @@ -16,74 +16,64 @@ --> </STYLE> </HEAD> -<BODY LANG="nl-NL" DIR="LTR"> -<TABLE WIDTH=100% BORDER=0 CELLPADDING=2 CELLSPACING=2 STYLE="page-break-before: always"> +<BODY LANG="nl-NL" DIR="ltr"> +<TABLE WIDTH="100%" BORDER=0 CELLPADDING=2 CELLSPACING=2 STYLE="PAGE-BREAK-BEFORE: always"> <TR> <TD> - <P ALIGN=LEFT><A HREF="02_idl.html">Previous</A></P> - </TD> + <P ALIGN=left><A href="02_idl.html">Previous</A></P></TD> <TD> - <P ALIGN=CENTER><IMG SRC="images/images.png" NAME="graphics1" ALIGN=BOTTOM WIDTH=4% HEIGHT=5% BORDER=0></P> - </TD> + <P ALIGN=center><IMG border=0 name=graphics1 align=bottom src="images/images.png" width="4%" height="5%" ></P></TD> <TD> - <P ALIGN=RIGHT><A HREF="04_ami4ccm.html">Next</A></P> - </TD> - </TR> -</TABLE> + <P ALIGN=right><A href="04_ami4ccm.html">Next</A></P></TD></TR></TABLE> <HR> <H1>Executors</H1> -<P>Once the IDL files are created, the business logic for the -components should be implemented. Since components can be complex, we -can use the IDL compiler to create empty executor files. This part of -the tutorial explains how this can be done. -</P> +<P>Once the IDL files are created, the business logic for +the components should be implemented. Since components can be complex, we can +use the IDL compiler to create empty executor files. This part of the tutorial +explains how this can be done. </P> <H2 CLASS="western">Sender</H2> -<P>In a command shell windows, navigate to the -Hello_asm/Sender_comp/src and invoke the TAO IDL compiler by running -the following command: -</P> -<P><CODE CLASS="western">tao_idl -I../../ports -I../../GeneratedCode --I%TAO_ROOT% -I%TAO_ROOT%/tao -I%CIAO_ROOT% -I%CIAO_ROOT%/ccm --I%CIAO_ROOT%/ciao -Gex Hello_Senmder_comp.idl </CODE><CODE CLASS="western"><FONT FACE="Times New Roman, serif">An -example of the </FONT></CODE>generated code can be found <A HREF="Code/GeneratedExec/Hello_Sender_comp_exec.cpp">here</A>. -<CODE CLASS="western"><FONT FACE="Times New Roman, serif">An example -of t</FONT></CODE>he implemented executor can be found <A HREF="Code/ImplementedExec/Hello_Sender_comp_exec.cpp">here</A> - .</P> -<P>Be aware that running this command, will overwrite the already -implemented exec code in the Hello_asm/Sender_comp directory. A -copy of the implemented executor can be found <A HREF="Code/ImplementedExec/Hello_Sender_comp_exec.cpp">here</A> - .</P> -<H2 CLASS="western">Receiver</H2> -<P>Navigate to the Hello_asm/Receiver_comp/src and invoke the TAO IDL -compiler by running the following command: -</P> -<P><CODE CLASS="western">tao_idl -I../../ports -I../../GeneratedCode --I%TAO_ROOT% -I%TAO_ROOT%/tao -I%CIAO_ROOT% -I%CIAO_ROOT%/ccm --I%CIAO_ROOT%/ciao -Gex Hello_Receiver_comp.idl </CODE><CODE CLASS="western"><FONT FACE="Times New Roman, serif">An -example of the </FONT></CODE> generated code can be found <A HREF="Code/GeneratedExec/Hello_Receiver_comp_exec.cpp">here</A>. -<CODE CLASS="western"><FONT FACE="Times New Roman, serif">An example -of the </FONT></CODE>implemented executor can be found <A HREF="Code/ImplementedExec/Hello_Receiver_comp_exec.cpp">here</A> - .</P> -<P>Be aware that running this command, will overwrite the already -implemented exec code in the Hello_asm/Receiver_comp directory. A -copy of the implemented executor can be found <A HREF="Code/ImplementedExec/Hello_Receiver_comp_exec.cpp">here</A> - .</P> -<P><BR><BR> -</P> -<TABLE WIDTH=100% BORDER=0 CELLPADDING=2 CELLSPACING=2> +<P>In a command shell windows, navigate to the +Hello_asm/Sender_comp/src and invoke the TAO IDL compiler by running the +following command: </P> +<P><CODE CLASS="western"><FONT SIZE=3>tao_idl +-I../../ports -I../../GeneratedCode -I%TAO_ROOT% -I%TAO_ROOT%/tao -I%CIAO_ROOT% +-I%CIAO_ROOT%/ccm -I%CIAO_ROOT%/ciao -Gex Hello_Senmder_comp.idl</CODE></P> +<FONT face="Times New Roman>An example of the </FONT></CODE>generated code can be found <A href=" +Hello_Sender_comp_exec.cpp? GeneratedExec Code></A><FONT +face="Times New Roman"><FONT face="Times New Roman">An +example of the implemented executor can be found </FONT><A +href="Code/ImplementedExec/Hello_Sender_comp_exec.cpp"><FONT +face="Times New Roman">here</FONT></A><FONT face="Times New Roman"> +.<BR></FONT><FONT face="Times New Roman">Be aware that running this command, +will overwrite the already implemented exec code in the Hello_asm/Sender_comp +directory. A copy of the implemented executor can be found </FONT><A +href="Code/ImplementedExec/Hello_Sender_comp_exec.cpp"><FONT +face="Times New Roman">here</FONT></A><FONT face="Times New Roman"> .</FONT></P> +<H2 class=western>Receiver</H2> +<P>Navigate to the Hello_asm/Receiver_comp/src and invoke the TAO IDL compiler +by running the following command: </P> +<P><CODE class=western>tao_idl -I../../ports -I../../GeneratedCode -I%TAO_ROOT% +-I%TAO_ROOT%/tao -I%CIAO_ROOT% -I%CIAO_ROOT%/ccm -I%CIAO_ROOT%/ciao -Gex +Hello_Receiver_comp.idl.<BR></CODE></p> +<FONT face="Times New Roman">An example of the generated code can be found </FONT><A +href="Code/GeneratedExec/Hello_Receiver_comp_exec.cpp"><FONT +face="Times New Roman">here</FONT></A><FONT face="Times New Roman">. <CODE +class=western>An example of the </CODE>implemented executor can be found +</FONT><A href="Code/ImplementedExec/Hello_Receiver_comp_exec.cpp"><FONT +face="Times New Roman">here</FONT></A><FONT face="Times New Roman"> +.<BR></FONT><FONT face="Times New Roman">Be aware that running this command, +will overwrite the already implemented exec code in the Hello_asm/Receiver_comp +directory. A copy of the implemented executor can be found </FONT><A +href="Code/ImplementedExec/Hello_Receiver_comp_exec.cpp"><FONT +face="Times New Roman">here</FONT></A><FONT face="Times New Roman"> .</FONT></P> +<P><BR><BR></P><TABLE BORDER=0 CELLPADDING =2 CELLSPACING =2 width ="100%" > <TR> <TD> - <P ALIGN=LEFT><A HREF="02_idl.html">Previous</A></P> - </TD> + <P ALIGN=left><A href="02_idl.html">Previous</A></P></TD> <TD> - <P ALIGN=CENTER><IMG SRC="images/images.png" NAME="graphics2" ALIGN=BOTTOM WIDTH=4% HEIGHT=5% BORDER=0></P> - </TD> + <P ALIGN=center><IMG border=0 name=graphics2 align=bottom src="images/images.png" width="4%" height="5%" ></P></TD> <TD> - <P ALIGN=RIGHT><A HREF="04_ami4ccm.html">Next</A></P> - </TD> - </TR> -</TABLE> -<P><BR><BR> -</P> + <P ALIGN=right><A href="04_ami4ccm.html">Next</A></P></TD></TR></TABLE> +<P><BR><BR></P></FONT></CODE> </BODY> </HTML> diff --git a/CIAO/connectors/ami4ccm/tutorials/Hello/Tutorial/04_ami4ccm.html b/CIAO/connectors/ami4ccm/tutorials/Hello/Tutorial/04_ami4ccm.html index 1c31a854363..5afc3d6cb2e 100644 --- a/CIAO/connectors/ami4ccm/tutorials/Hello/Tutorial/04_ami4ccm.html +++ b/CIAO/connectors/ami4ccm/tutorials/Hello/Tutorial/04_ami4ccm.html @@ -16,20 +16,15 @@ --> </STYLE> </HEAD> -<BODY LANG="nl-NL" DIR="LTR"> -<TABLE WIDTH=100% BORDER=0 CELLPADDING=2 CELLSPACING=2 STYLE="page-break-before: always"> +<BODY LANG="nl-NL" DIR="ltr"> +<TABLE WIDTH="100%" BORDER=0 CELLPADDING=2 CELLSPACING=2 STYLE="PAGE-BREAK-BEFORE: always"> <TR> <TD> - <P ALIGN=LEFT><A HREF="03_executors.html">Previous</A></P> - </TD> + <P ALIGN=left><A href="03_executors.html">Previous</A></P></TD> <TD> - <P ALIGN=CENTER><IMG SRC="images/images.png" NAME="graphics1" ALIGN=BOTTOM WIDTH=4% HEIGHT=5% BORDER=0></P> - </TD> + <P ALIGN=center><IMG border=0 name=graphics1 align=bottom src="images/images.png" width="4%" height="5%" ></P></TD> <TD> - <P ALIGN=RIGHT><A HREF="05_compilation.html">Next</A></P> - </TD> - </TR> -</TABLE> + <P ALIGN=right><A href="05_compilation.html">Next</A></P></TD></TR></TABLE> <HR> <H1>Implementation executors</H1> <H2 CLASS="western">AMI4CCM basics</H2> @@ -39,144 +34,104 @@ Receiver , second the interface for the Sender and third the interface for the Receiver. In this tutorial are that the IDL files Hello_MyFoo_obj.idl, Hello_Sender_comp.idl and the - Hello_Receiver_comp.idl . <BR>Naturally, it is possible that there - are more IDL-files to be used, as in this example the - Hello_Common_defn.idl file for the common definitions.</P> - <LI><P>The Receiver component ('server') has no idea which component - (AMI connector or Sender) uses his interface.</P> - <LI><P>The Connector, the AMI-Component, will be generated by the - IDL compiler by implying ami4ccm.idl</P> - <LI><P>In the Sender executor the handling of the AMI callbacks and - also the asynchronous and synchronous invocations must be coded.</P> -</UL> + Hello_Receiver_comp.idl . <BR>Naturally, it is possible that there are more IDL-files + to be used, as in this example the Hello_Common_defn.idl file for the common + definitions.</P> + <LI><P>The Receiver component ('server') has no idea which + component (AMI connector or Sender) uses his interface.</P> + <LI><P>The Connector, the AMI-Component, will be generated by + the IDL compiler by implying ami4ccm.idl</P> + <LI><P>In the Sender executor the handling of the AMI + callbacks and also the asynchronous and synchronous invocations must be + coded.</P></LI></UL> <H2 CLASS="western">Example</H2> -<P>The Sender component of this Hello tutorial invokes some -asynchronous methods and some synchronous methods. For asynchronous -invocations, the Sender component uses the AMI4CCM_MyFoo_obj -interface of the AMI component and provides the -AMI4CCM_MyFoo_objReplyHandler interface to the AMI component.</P> -<P>For synchronous invocations, the Sender component uses the -MyFoo_obj interface (which the Receiver provides).</P> -<P STYLE="margin-bottom: 0cm">The receiver just implements the -interface provided by the application programmer. The Receiver should -have no idea which component (in this case Sender or AMI) uses his -interface!</P> -<P STYLE="margin-bottom: 0cm"><BR> -</P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=4><B>Sender_comp_exec.cpp</B></FONT></P> -<P STYLE="margin-bottom: 0cm; font-weight: normal"><FONT SIZE=3>In de -ccm_activate method, first retrieve the receptacles:</FONT></P> -<P LANG="" STYLE="margin-bottom: 0cm; font-weight: normal"> +<P>The Sender component of this Hello tutorial invokes some +asynchronous methods and some synchronous methods. For asynchronous invocations, +the Sender component uses the AMI4CCM_MyFoo_obj interface of the AMI component +and provides the AMI4CCM_MyFoo_objReplyHandler interface to the AMI +component.</P> +<P>For synchronous invocations, the Sender component uses +the MyFoo_obj interface (which the Receiver provides).</P> +<P STYLE="MARGIN-BOTTOM: 0cm">The receiver just implements +the interface provided by the application programmer. The Receiver should have +no idea which component (in this case Sender or AMI) uses his interface!</P> +<P STYLE="MARGIN-BOTTOM: 0cm"><BR></P> +<P STYLE="MARGIN-BOTTOM: 0cm"><FONT SIZE=4><B>Sender_comp_exec.cpp</B></FONT></P> +<P STYLE="MARGIN-BOTTOM: 0cm; FONT-WEIGHT: normal"><FONT SIZE=3>In de ccm_activate method, first retrieve the +receptacles:</FONT></P> +<P LANG="" STYLE="MARGIN-BOTTOM: 0cm; FONT-WEIGHT: normal"> <FONT SIZE=3>Asynchronous:</FONT></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"> -<FONT SIZE=2><SPAN LANG=""><SPAN STYLE="font-weight: normal">::Hello::AMI4CCM_MyFoo_obj_var -asynch_foo</SPAN></SPAN></FONT><FONT SIZE=2><SPAN LANG=""><B> =</B></SPAN></FONT><FONT SIZE=2><SPAN LANG=""> - </SPAN></FONT><FONT COLOR="#0000ff"><FONT SIZE=2><SPAN LANG="">this</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG="">->context_->get_connection_sendc_run_my_foo();</SPAN></FONT></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=3><FONT COLOR="#000000"><SPAN LANG="">Synchronous:</SPAN></FONT></FONT></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT COLOR="#000000"> -<FONT SIZE=2><SPAN LANG="">::Hello::MyFoo_obj_var synch_foo =</SPAN></FONT></FONT><FONT SIZE=2><SPAN LANG=""> - </SPAN></FONT><FONT COLOR="#0000ff"><FONT SIZE=2><SPAN LANG="">this</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG="">->context_->get_connection_run_my_foo +<P STYLE="MARGIN-BOTTOM: 0cm; MARGIN-LEFT: 1cm; MARGIN-RIGHT: 0px" dir=ltr> +<FONT SIZE=2><SPAN LANG=""><SPAN STYLE="FONT-WEIGHT: normal">::Hello::AMI4CCM_MyFoo_obj_var +asynch_foo</SPAN></SPAN></FONT><FONT SIZE=2><SPAN LANG=""><B> =</B></SPAN></FONT><FONT SIZE=2><SPAN LANG=""> </SPAN></FONT><FONT COLOR="#0000ff"><FONT SIZE=2><SPAN LANG="">this</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG="">->context_->get_connection_sendc_run_my_foo();</SPAN></FONT></FONT></P> +<P STYLE="MARGIN-BOTTOM: 0cm"><FONT SIZE=3><FONT COLOR="#000000"><SPAN LANG="">Synchronous:</SPAN></FONT></FONT></P> +<P STYLE="MARGIN-BOTTOM: 0cm; MARGIN-LEFT: 1cm"><FONT COLOR="#000000"> +<FONT SIZE=2><SPAN LANG="">::Hello::MyFoo_obj_var synch_foo +=</SPAN></FONT></FONT><FONT SIZE=2><SPAN LANG=""> </SPAN></FONT><FONT COLOR="#0000ff"><FONT SIZE=2><SPAN LANG="">this</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG="">->context_->get_connection_run_my_foo ();</SPAN></FONT></FONT></P> -<P STYLE="margin-bottom: 0cm"><BR> -</P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=3><FONT COLOR="#000000"><SPAN LANG="">After -retrieving the receptacles, make the desired asynchronus and -synchronous invocations.</SPAN></FONT></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=3><FONT COLOR="#000000"><SPAN LANG="">The -asynchronous methods have the prefix sendc_. The first argument is -the Reply handler.</SPAN></FONT></FONT></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG="">my_foo_ami_->sendc_foo -(</SPAN></FONT></FONT><FONT COLOR="#0000ff"><FONT SIZE=2><SPAN LANG="">new</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG=""> -MyFoo_obj_callback_exec_i (), </SPAN></FONT></FONT><FONT COLOR="#a31515"><FONT SIZE=2><SPAN LANG="">"Do -something asynchronous"</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG="">);</SPAN></FONT></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=3><FONT COLOR="#000000"><SPAN LANG="">The -same synchronous method: </SPAN></FONT></FONT> -</P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT COLOR="#000000"> -<FONT SIZE=2><SPAN LANG="">CORBA::Long result = my_foo_ami_->foo -(</SPAN></FONT></FONT><FONT COLOR="#a31515"><FONT SIZE=2><SPAN LANG="">"Do -something synchronous"</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG="">, - out_str.out());</SPAN></FONT></FONT></P> -<P STYLE="margin-bottom: 0cm"><BR> -</P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=3><FONT COLOR="#000000"><SPAN LANG="">For -the asynchronus methods the implied Reply Handler interface for each -method must be coded.</SPAN></FONT></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=3><FONT COLOR="#000000"><SPAN LANG="">Example -foo callback:</SPAN></FONT></FONT></P> -<P LANG="" STYLE="margin-bottom: 0cm"><FONT COLOR="#0000ff"><FONT SIZE=2>void</FONT></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT COLOR="#000000"> -<SPAN LANG=""><FONT SIZE=2>MyFoo_obj_callback_exec_i::foo -(::CORBA::Long ami_return_val,</FONT></FONT></SPAN><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG=""> - </SPAN></FONT></FONT><FONT COLOR="#0000ff"><FONT SIZE=2><SPAN LANG="">const</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG=""> -</SPAN></FONT></FONT><FONT COLOR="#0000ff"><FONT SIZE=2><SPAN LANG="">char</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG=""> -* answer)</SPAN></FONT></FONT></P> -<P LANG="" STYLE="margin-bottom: 0cm"><FONT COLOR="#000000"> <FONT SIZE=2>{</FONT></FONT></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT COLOR="#000000"> - </FONT><FONT COLOR="#008000"><FONT SIZE=2><SPAN LANG="">/* Your -code here. */</SPAN></FONT></FONT></P> -<P LANG="" STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT COLOR="#000000"> -<FONT SIZE=2>ACE_DEBUG ((LM_DEBUG,</FONT></FONT></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT COLOR="#000000"> - <FONT SIZE=2><SPAN LANG="">ACE_TEXT(</SPAN></FONT></FONT><FONT COLOR="#a31515"><FONT SIZE=2><SPAN LANG="">"Sender:\tMyFoo -AMI Callback from foo:"</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG="">)</SPAN></FONT></FONT></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT COLOR="#000000"> - <FONT SIZE=2><SPAN LANG="">ACE_TEXT(</SPAN></FONT></FONT><FONT COLOR="#a31515"><FONT SIZE=2><SPAN LANG="">"result -<%u> answer <%C>\n"</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG="">),</SPAN></FONT></FONT></P> -<P LANG="" STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT COLOR="#000000"> - <FONT SIZE=2>ami_return_val, answer));</FONT></FONT></P> -<P LANG="" STYLE="margin-bottom: 0cm"><FONT COLOR="#000000"> <FONT SIZE=2>}</FONT></FONT></P> -<P LANG="" STYLE="margin-bottom: 0cm"><BR> -</P> -<P STYLE="margin-bottom: 0cm"><FONT COLOR="#000000"> </FONT><FONT COLOR="#0000ff"><FONT SIZE=2><SPAN LANG="">void</SPAN></FONT></FONT></P> -<P LANG="" STYLE="margin-bottom: 0cm"><FONT COLOR="#000000"> -<FONT SIZE=2>MyFoo_obj_callback_exec_i::foo_excep ( -::CCM_AMI::ExceptionHolder * excep_holder)</FONT></FONT></P> -<P LANG="" STYLE="margin-bottom: 0cm"><FONT COLOR="#000000"> <FONT SIZE=2>{</FONT></FONT></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT COLOR="#000000"> -</FONT><FONT COLOR="#008000"><FONT SIZE=2><SPAN LANG="">/* Your code -here. */</SPAN></FONT></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT COLOR="#000000"> <FONT SIZE=2><SPAN LANG="">}</SPAN></FONT></FONT></P> -<P STYLE="margin-bottom: 0cm"><BR> -</P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=4><B>Receiver_comp_exec.cpp</B></FONT></P> -<P STYLE="margin-bottom: 0cm; font-weight: normal"><FONT SIZE=4 STYLE="font-size: 16pt">I<FONT SIZE=3>n -this file the interface methods must be programmed.</FONT></FONT></P> -<P STYLE="margin-bottom: 0cm; font-weight: normal"><FONT SIZE=3>Example -foo method:</FONT></P> -<P STYLE="margin-bottom: 0cm"> <FONT SIZE=2><SPAN STYLE="font-weight: normal"><SPAN LANG="">::CORBA::Long +<P STYLE="MARGIN-BOTTOM: 0cm"><BR></P> +<P STYLE="MARGIN-BOTTOM: 0cm"><FONT SIZE=3><FONT COLOR="#000000"><SPAN LANG="">After retrieving the receptacles, make the desired +asynchronus and synchronous invocations.</SPAN></FONT></FONT></P> +<P STYLE="MARGIN-BOTTOM: 0cm"><FONT SIZE=3><FONT COLOR="#000000"><SPAN LANG="">The asynchronous methods have the prefix sendc_. The first +argument is the Reply handler.</SPAN></FONT></FONT></P> +<P STYLE="MARGIN-BOTTOM: 0cm; MARGIN-LEFT: 1cm"><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG="">my_foo_ami_->sendc_foo +(</SPAN></FONT></FONT><FONT COLOR="#0000ff"><FONT SIZE=2><SPAN LANG="">new</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG=""> MyFoo_obj_callback_exec_i (), </SPAN></FONT></FONT><FONT COLOR="#a31515"><FONT SIZE=2><SPAN LANG="">"Do something +asynchronous"</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG="">);</SPAN></FONT></FONT></P> +<P STYLE="MARGIN-BOTTOM: 0cm"><FONT SIZE=3><FONT COLOR="#000000"><SPAN LANG="">The same synchronous method: </SPAN></FONT></FONT></P> +<P STYLE="MARGIN-BOTTOM: 0cm; MARGIN-LEFT: 1cm"><FONT COLOR="#000000"> +<FONT SIZE=2><SPAN LANG="">CORBA::Long result = my_foo_ami_->foo +(</SPAN></FONT></FONT><FONT COLOR="#a31515"><FONT SIZE=2><SPAN LANG="">"Do something +synchronous"</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG="">, +out_str.out());</SPAN></FONT></FONT></P> +<P STYLE="MARGIN-BOTTOM: 0cm"><BR></P> +<P STYLE="MARGIN-BOTTOM: 0cm"><FONT SIZE=3><FONT COLOR="#000000"><SPAN LANG="">For the asynchronus methods the implied Reply Handler +interface for each method must be coded.</SPAN></FONT></FONT></P> +<P STYLE="MARGIN-BOTTOM: 0cm"><FONT SIZE=3><FONT COLOR="#000000"><SPAN LANG="">Example foo callback:</SPAN></FONT></FONT></P> +<P LANG="" STYLE="MARGIN-BOTTOM: 0cm"><FONT COLOR="#0000ff"><FONT SIZE=2>void<BR></FONT></FONT><FONT COLOR="#000000"> +<SPAN LANG=""><FONT SIZE=2>MyFoo_obj_callback_exec_i::foo (::CORBA::Long +ami_return_val,</FONT></FONT></SPAN><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG=""> </SPAN></FONT></FONT><FONT COLOR="#0000ff"><FONT SIZE=2><SPAN LANG="">const</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG=""> </SPAN></FONT></FONT><FONT COLOR="#0000ff"><FONT SIZE=2><SPAN LANG="">char</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG=""> * answer)<BR></SPAN></FONT></FONT><FONT COLOR="#000000"> <FONT SIZE=2>{<BR></FONT></FONT><FONT COLOR="#008000"><FONT SIZE=2><SPAN LANG=""><FONT color=#0000ff> </FONT>/* +Your code here. */<BR></SPAN></FONT></FONT><FONT COLOR="#000000"> +<FONT SIZE=2><FONT +color=#0000ff> </FONT>ACE_DEBUG +((LM_DEBUG,<BR></FONT></FONT><FONT COLOR="#000000"> + <FONT SIZE=2><SPAN LANG=""><FONT +color=#0000ff> </FONT>ACE_TEXT(</SPAN></FONT></FONT><FONT COLOR="#a31515"><FONT SIZE=2><SPAN LANG="">"Sender:\tMyFoo AMI Callback from +foo:"</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG="">)<BR></SPAN></FONT></FONT><FONT COLOR="#000000"> + <FONT SIZE=2><SPAN LANG=""><FONT +color=#0000ff> </FONT>ACE_TEXT(</SPAN></FONT></FONT><FONT COLOR="#a31515"><FONT SIZE=2><SPAN LANG="">"result <%u> answer +<%C>\n"</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG="">),<BR></SPAN></FONT></FONT><FONT COLOR="#000000"> + <FONT SIZE=2><FONT +color=#0000ff> </FONT>ami_return_val, +answer));<BR></FONT></FONT><FONT COLOR="#000000"> <FONT SIZE=2>}</FONT></FONT></P> +<P LANG="" STYLE="MARGIN-BOTTOM: 0cm"><FONT COLOR="#0000ff"><FONT SIZE=2><SPAN LANG="">void<BR></SPAN></FONT></FONT><FONT COLOR="#000000"> +<FONT SIZE=2>MyFoo_obj_callback_exec_i::foo_excep ( +::CCM_AMI::ExceptionHolder * excep_holder)<BR></FONT></FONT><FONT COLOR="#000000"> <FONT SIZE=2>{<BR></FONT></FONT><FONT COLOR="#008000"><FONT SIZE=2><SPAN LANG=""><FONT +color=#0000ff> </FONT>/* Your code here. +*/<BR></SPAN></FONT></FONT><FONT COLOR="#000000"> <FONT SIZE=2><SPAN LANG="">}</SPAN></FONT></FONT></P> +<P STYLE="MARGIN-BOTTOM: 0cm"><FONT SIZE=4><B>Receiver_comp_exec.cpp</B></FONT></P> +<P STYLE="MARGIN-BOTTOM: 0cm; FONT-WEIGHT: normal"><FONT SIZE=4 STYLE="FONT-SIZE: 16pt">I<FONT SIZE=3>n this file the interface methods must be +programmed.</FONT></FONT></P> +<P STYLE="MARGIN-BOTTOM: 0cm; FONT-WEIGHT: normal"><FONT SIZE=3>Example foo method:</FONT></P> +<P STYLE="MARGIN-BOTTOM: 0cm"> <FONT SIZE=2><SPAN STYLE="FONT-WEIGHT: normal"><SPAN LANG="">::CORBA::Long </SPAN></SPAN></FONT><FONT SIZE=2><SPAN LANG=""> -MyFoo_obj_exec_i::foo (</SPAN></FONT><FONT COLOR="#0000ff"><FONT SIZE=2><SPAN LANG="">const</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG=""> -</SPAN></FONT></FONT><FONT COLOR="#0000ff"><FONT SIZE=2><SPAN LANG="">char</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG=""> -* in_str, ::CORBA::String_out answer)</SPAN></FONT></FONT></P> -<P LANG="" STYLE="margin-bottom: 0cm"><FONT COLOR="#000000"> <FONT SIZE=2>{</FONT></FONT></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT COLOR="#000000"> - </FONT><FONT COLOR="#008000"><FONT SIZE=2><SPAN LANG="">/* Your -code here. */</SPAN></FONT></FONT></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT COLOR="#000000"> - <FONT SIZE=2><SPAN LANG="">answer = CORBA::string_dup (</SPAN></FONT></FONT><FONT COLOR="#a31515"><FONT SIZE=2><SPAN LANG="">"This -is my answer : Hi"</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG="">);</SPAN></FONT></FONT></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT COLOR="#000000"> - </FONT><FONT COLOR="#0000ff"><FONT SIZE=2><SPAN LANG="">return</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG=""> -ACE_OS::rand () % 100;</SPAN></FONT></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT COLOR="#000000"> </FONT><FONT COLOR="#000000"> +MyFoo_obj_exec_i::foo (</SPAN></FONT><FONT COLOR="#0000ff"><FONT SIZE=2><SPAN LANG="">const</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG=""> </SPAN></FONT></FONT><FONT COLOR="#0000ff"><FONT SIZE=2><SPAN LANG="">char</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG=""> * in_str, ::CORBA::String_out +answer)<BR></SPAN></FONT></FONT><FONT COLOR="#000000"> <FONT SIZE=2>{<BR></FONT></FONT><FONT COLOR="#008000"><FONT SIZE=2><SPAN LANG=""><FONT color=#0000ff> </FONT>/* Your code +here. */<BR></SPAN></FONT></FONT><FONT COLOR="#000000"> + <FONT SIZE=2><SPAN LANG=""><FONT +color=#0000ff> </FONT>answer = CORBA::string_dup +(</SPAN></FONT></FONT><FONT COLOR="#a31515"><FONT SIZE=2><SPAN LANG="">"This is my answer : +Hi"</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG="">);<BR></SPAN></FONT></FONT><FONT COLOR="#0000ff"><FONT SIZE=2><SPAN LANG=""> return</SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2><SPAN LANG=""> ACE_OS::rand () % +100;<BR></SPAN></FONT></FONT><FONT COLOR="#000000"> <FONT SIZE=2><SPAN LANG="">}</SPAN></FONT></FONT></P> -<P STYLE="margin-bottom: 0cm"><BR> -</P> -<TABLE WIDTH=100% BORDER=0 CELLPADDING=2 CELLSPACING=2> +<P STYLE="MARGIN-BOTTOM: 0cm"><BR></P> +<TABLE WIDTH="100%" BORDER=0 CELLPADDING=2 CELLSPACING=2> <TR> <TD> - <P ALIGN=LEFT><A HREF="03_executors.html">Previous</A></P> - </TD> + <P ALIGN=left><A href="03_executors.html">Previous</A></P></TD> <TD> - <P ALIGN=CENTER><IMG SRC="images/images.png" NAME="graphics2" ALIGN=BOTTOM WIDTH=4% HEIGHT=5% BORDER=0></P> - </TD> + <P ALIGN=center><IMG border=0 name=graphics2 align=bottom src="images/images.png" width="4%" height="5%" ></P></TD> <TD> - <P ALIGN=RIGHT><A HREF="05_compilation.html">Next</A></P> - </TD> - </TR> -</TABLE> -<P><BR><BR> -</P> + <P ALIGN=right><A href="05_compilation.html">Next</A></P></TD></TR></TABLE> +<P><BR><BR></P> </BODY> </HTML> diff --git a/CIAO/connectors/ami4ccm/tutorials/Hello/Tutorial/05_compilation.html b/CIAO/connectors/ami4ccm/tutorials/Hello/Tutorial/05_compilation.html index efccfec181f..24148490fb0 100644 --- a/CIAO/connectors/ami4ccm/tutorials/Hello/Tutorial/05_compilation.html +++ b/CIAO/connectors/ami4ccm/tutorials/Hello/Tutorial/05_compilation.html @@ -20,300 +20,203 @@ --> </STYLE> </HEAD> -<BODY LANG="nl-NL" DIR="LTR"> -<TABLE WIDTH=100% BORDER=0 CELLPADDING=2 CELLSPACING=2 STYLE="page-break-before: always"> +<BODY LANG="nl-NL" DIR="ltr"> +<TABLE WIDTH="100%" BORDER=0 CELLPADDING=2 CELLSPACING=2 STYLE="PAGE-BREAK-BEFORE: always"> <TR> <TD> - <P ALIGN=LEFT><A HREF="04_ami4ccm.html">Previous</A></P> - </TD> + <P ALIGN=left><A href="04_ami4ccm.html">Previous</A></P></TD> <TD> - <P ALIGN=CENTER><IMG SRC="images/images.png" NAME="graphics1" ALIGN=BOTTOM WIDTH=4% HEIGHT=5% BORDER=0></P> - </TD> - <TD></TD> - </TR> -</TABLE> + <P ALIGN=center><IMG border=0 name=graphics1 align=bottom src="images/images.png" width="4%" height="5%" ></P></TD> + <TD></TD></TR></TABLE> <HR> <H1>Compilation and deployment</H1> -<H2 CLASS="western" STYLE="page-break-after: avoid">Compilation</H2> -<P STYLE="margin-bottom: 0cm">Once all the code has been written, -compilation of the code would be the next step. MPC is used in order -to create the Makefiles and projects files. All MPC files that are -needed for this tutorial are in the same directory as the -accompanying IDL or executor files. In order to make the GNU make -files or the Visual Studio project files, the following steps should -be performed : -</P> +<H2 CLASS="western" STYLE="PAGE-BREAK-AFTER: avoid">Compilation</H2> +<P STYLE="MARGIN-BOTTOM: 0cm">Once all the code has been +written, compilation of the code would be the next step. MPC is used in order to +create the Makefiles and projects files. All MPC files that are needed for this +tutorial are in the same directory as the accompanying IDL or executor files. In +order to make the GNU make files or the Visual Studio project files, the +following steps should be performed : </P> <UL> <UL> - <LI><P STYLE="margin-bottom: 0cm"><FONT SIZE=3>Start a command - shell and navigate to : - </FONT><CODE CLASS="western"><FONT SIZE=3>%CIAO_ROOT%/connectors/ami4ccm/tutorials/Hello/Hello_asm</FONT></CODE> - </P> - <LI><P STYLE="margin-bottom: 0cm">Run - </P> - <LI><P STYLE="margin-bottom: 0cm"><CODE CLASS="western"><FONT SIZE=3>perl - %ACE_ROOT%/bin/mwc.pl -type vc9</FONT></CODE> <FONT SIZE=3>to - create Visual Studio 2008 project files. </FONT> - </P> - <LI><P STYLE="margin-bottom: 0cm"><CODE CLASS="western"><FONT SIZE=3>perl - %ACE_ROOT%/bin/mwc.pl -type gnuace</FONT></CODE> <FONT SIZE=3>to - create the GNU make files. </FONT> - </P> - <LI><P STYLE="margin-bottom: 0cm">Now compile the code like you're - used to. - </P> - </UL> -</UL> -<P STYLE="margin-bottom: 0cm">If all went well, all libraries are in -the Hello_asm/lib directory. -</P> -<H2 CLASS="western" STYLE="page-break-after: avoid">Deployment</H2> -<P STYLE="margin-bottom: 0cm">Once all binaries are compiled, they're -ready to be deployed. In this tutorial we are using DAnCE to deploy -our system. DAnCE starts a system in two phases : -</P> + <LI><P STYLE="MARGIN-BOTTOM: 0cm"><FONT SIZE=3>Start a command shell and navigate to : </FONT><CODE CLASS="western"><FONT SIZE=3>%CIAO_ROOT%/connectors/ami4ccm/tutorials/Hello/Hello_asm</FONT></CODE> + </P> + <LI><P STYLE="MARGIN-BOTTOM: 0cm">Run </P> + <LI><P STYLE="MARGIN-BOTTOM: 0cm"><CODE CLASS="western"><FONT SIZE=3>perl + %ACE_ROOT%/bin/mwc.pl -type vc9</FONT></CODE> <FONT SIZE=3>to create Visual Studio 2008 project files. </FONT></P> + <LI><P STYLE="MARGIN-BOTTOM: 0cm"><CODE CLASS="western"><FONT SIZE=3>perl + %ACE_ROOT%/bin/mwc.pl -type gnuace</FONT></CODE> <FONT SIZE=3>to create the GNU make files. </FONT></P> + <LI><P STYLE="MARGIN-BOTTOM: 0cm">Now compile the code like + you're used to. </P></LI></UL></UL> +<P STYLE="MARGIN-BOTTOM: 0cm">If all went well, all +libraries are in the Hello_asm/lib directory. </P> +<H2 CLASS="western" STYLE="PAGE-BREAK-AFTER: avoid">Deployment</H2> +<P STYLE="MARGIN-BOTTOM: 0cm">Once all binaries are +compiled, they're ready to be deployed. In this tutorial we are using DAnCE to +deploy our system. DAnCE starts a system in two phases : </P> <OL> <OL> - <LI><P STYLE="margin-bottom: 0cm">configuration_complete - </P> - <LI><P STYLE="margin-bottom: 0cm">ccm_activate - </P> - </OL> -</OL> -<P STYLE="margin-bottom: 0cm">DAnCE shuts down a system again in two -phases : -</P> + <LI><P STYLE="MARGIN-BOTTOM: 0cm">configuration_complete + </P> + <LI><P STYLE="MARGIN-BOTTOM: 0cm">ccm_activate +</P></LI></OL></OL> +<P STYLE="MARGIN-BOTTOM: 0cm">DAnCE shuts down a system +again in two phases : </P> <OL> <OL> - <LI><P STYLE="margin-bottom: 0cm">passivate - </P> - <LI><P STYLE="margin-bottom: 0cm">ccm_remove - </P> - </OL> -</OL> -<P STYLE="margin-bottom: 0cm">Each component should have these four -methods implemented. The business logic implemented in each step -depends on you implementation. There're several processes taking care -of the total deployment process. See the DAnCE documentation for more -information about which processes there are and what their -responsibilities are. DAnCE will start and shutdown a system with the -aid of a deployment plan. A deployment plan describes which artifacts -must run on which nodes and which components are connected to -eachother via which interface (more on this later). All connections -between components are made before 'configuration_complete' is -called. -</P> -<P STYLE="margin-bottom: 0cm"><BR> -</P> -<P STYLE="margin-bottom: 0cm">The deployment plan will be generated -by the modelling tools but we take a brief look at the most important -items of a deployment plan. A deployment plan is a XML based file -which is devided into the following (main) sections: -</P> + <LI><P STYLE="MARGIN-BOTTOM: 0cm">passivate </P> + <LI><P STYLE="MARGIN-BOTTOM: 0cm">ccm_remove +</P></LI></OL></OL> +<P STYLE="MARGIN-BOTTOM: 0cm">Each component should have +these four methods implemented. The business logic implemented in each step +depends on you implementation. There're several processes taking care of the +total deployment process. See the DAnCE documentation for more information about +which processes there are and what their responsibilities are. DAnCE will start +and shutdown a system with the aid of a deployment plan. A deployment plan +describes which artifacts must run on which nodes and which components are +connected to eachother via which interface (more on this later). All connections +between components are made before 'configuration_complete' is called. </P> +<P STYLE="MARGIN-BOTTOM: 0cm"><BR></P> +<P STYLE="MARGIN-BOTTOM: 0cm">The deployment plan will be +generated by the modelling tools but we take a brief look at the most important +items of a deployment plan. A deployment plan is a XML based file which is +devided into the following (main) sections: </P> <UL> <UL> - <LI><P STYLE="margin-bottom: 0cm">Implementations - </P> - <LI><P STYLE="margin-bottom: 0cm">Entry points - </P> - <LI><P STYLE="margin-bottom: 0cm">Instances - </P> - <LI><P STYLE="margin-bottom: 0cm">Connections - </P> - <LI><P STYLE="margin-bottom: 0cm">Artifacts - </P> - </UL> -</UL> -<P STYLE="margin-bottom: 0cm"><I><B>All deployment code fragments -mentioned in the rest of this tutorial are *NO* exports of any -modelling tool.</B> </I> -</P> -<H3 CLASS="western" STYLE="page-break-after: avoid">Implementations -and Entry Points</H3> -<P STYLE="margin-bottom: 0cm">This defines which executor and servant + <LI><P STYLE="MARGIN-BOTTOM: 0cm">Implementations </P> + <LI><P STYLE="MARGIN-BOTTOM: 0cm">Entry points </P> + <LI><P STYLE="MARGIN-BOTTOM: 0cm">Instances </P> + <LI><P STYLE="MARGIN-BOTTOM: 0cm">Connections </P> + <LI><P STYLE="MARGIN-BOTTOM: 0cm">Artifacts </P></LI></UL></UL> +<P STYLE="MARGIN-BOTTOM: 0cm"><I><B>All deployment code fragments mentioned in the rest of this +tutorial are *NO* exports of any modelling tool.</B> </I></P> +<H3 CLASS="western" STYLE="PAGE-BREAK-AFTER: avoid">Implementations and Entry Points</H3> +<P STYLE="MARGIN-BOTTOM: 0cm">This defines which executor and servant artifacts (binaries) should be used. Implementations also defines which entry points in the binaries should be used. In this example there are neeede 3 implementation sections, for the Sender Receiver -and AMI connector. <A HREF="Code/Deployment/descriptors/implementation.cdp">This</A> -file shows the implementation section of the AMI connector. Beware -that artifacts and entry points are exact otherwise deployment will -fail.</P> -<H3 CLASS="western" STYLE="page-break-after: avoid">Instances</H3> -<P STYLE="margin-bottom: 0cm">Instances define which artifacts run on +and AMI connector. <A href="Code/Deployment/descriptors/implementation.cdp">This</A> file +shows the implementation section of the AMI connector. Beware that artifacts and +entry points are exact otherwise deployment will fail.</P> +<H3 CLASS="western" STYLE="PAGE-BREAK-AFTER: avoid">Instances</H3> +<P STYLE="MARGIN-BOTTOM: 0cm">Instances define which artifacts run on which node. Every fysical artifact in the system results in one instance. The <node> section refers to the fysical node on which this instance will be deployed. An instance always refers to an implementation. It's possible that more than one instance refers to the same implementation. The instance section also provide the -initial values of all attributes defined on the component. <A HREF="Code/Deployment/descriptors/instance.cdp">This</A> +initial values of all attributes defined on the component. <A href="Code/Deployment/descriptors/instance.cdp">This</A> file shows the instance section of the Sender, Receiver and AMI -connector. <U><B>The instance of the AMI connector uses the same node -as the Sender! </B></U> -</P> -<H3 CLASS="western" STYLE="page-break-after: avoid">Connections</H3> -<P STYLE="margin-bottom: 0cm">A connection section defines which -components are connected together. The connection is 'local' since a -connector and a component are always running in the same process. Now -that we have got all the data we need to know to make a connection -for the asynchronous methods between the Sender and AMI connector (1) -and between the AMI connector and the receiver (2)</P> -<H4 CLASS="western">(1) -</H4> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><connection><FONT COLOR="#00e000">//unique -name of the connection</FONT> <name>run_asynch_foo_connection</name></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><deployRequirement><name>edu.dre.vanderbilt.DAnCE.ConnectionType</name><resourceType>Local_Interface</resourceType></deployRequirement></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><FONT COLOR="#00e000">//First -endpoint (the Sender component)</FONT><internalEndpoint></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><FONT COLOR="#00e000">// -PortName is defined as “sendc_” + name of port defined in -Hello_Sender_comp.idl</FONT> </FONT> -</P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><portName>sendc_run_my_foo</portName></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><provider>false</provider></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><kind>SimplexReceptacle</kind></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><FONT COLOR="#00e000">//The -reference to the sender instance.</FONT> <instance -xmi:idref="Hello.ComponentImplementations.HelloImplementation.Hello.Sender" -/></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2></internalEndpoint></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><FONT COLOR="#00e000">/Second -endpoint (the AMI connector component)</FONT><internalEndpoint></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><FONT COLOR="#00e000">// -PortName alsways the same -</FONT><portName>ami4ccm_port_ami4ccm_provides</portName></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><provider>true</provider></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><kind>Facet</kind></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><FONT COLOR="#00e000">//The -reference to the connector instance.</FONT><instance -xmi:idref="Hello.ComponentImplementations.HelloImplementation.Hello.AMI" -/></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2></internalEndpoint></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2></connection></FONT></P> -<H4 CLASS="western">(2) -</H4> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><connection></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><FONT COLOR="#00e000">//unique -name of the connection</FONT><name>do_foo_connection</name></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><FONT COLOR="#00e000">//First -endpoint (the Receiver component)</FONT><internalEndpoint></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><FONT COLOR="#00e000">// -PortName is defined as name of port defined in -Hello_Receiver_comp.idl</FONT> <portName>do_my_foo</portName></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><provider>true</provider><kind>Facet</kind></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><instance -xmi:idref="Hello.ComponentImplementations.HelloImplementation.Hello.Receiver" -/></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2></internalEndpoint></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><FONT COLOR="#00e000">//Second -endpoint (the AMI component)</FONT><internalEndpoint></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><FONT COLOR="#00e000">// -PortName alsways the same -</FONT><portName>ami4ccm_port_ami4ccm_uses</portName></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><provider>false</provider></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><kind>SimplexReceptacle</kind></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><instance -xmi:idref="Hello.ComponentImplementations.HelloImplementation.Hello.AMI" -/></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2></internalEndpoint></connection></FONT></P> -<P STYLE="margin-bottom: 0cm"><BR> -</P> -<P STYLE="margin-bottom: 0cm">For the synchronous methods we need a -connection between the Sender and the receiver. (3)</P> -<H4 CLASS="western">(3)</H4> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><connection></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><name>synch_foo_connection</name></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><internalEndpoint></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><FONT COLOR="#00e000">// -PortName is defined as name of port defined in -Hello_Receiver_comp.idl</FONT> <portName>do_my_foo</portName></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><FONT COLOR="#00e000">// -The receiver provides this port</FONT> <provider>true</provider></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><kind>Facet</kind></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><instance -xmi:idref="Hello.ComponentImplementations.HelloImplementation.Hello.Receiver" -/></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2></internalEndpoint></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><internalEndpoint></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><FONT COLOR="#00e000">// -PortName is defined as name of port defined in -Hello_Sender_comp.idl</FONT><portName>run_my_foo</portName></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><FONT COLOR="#00e000">// -The sender uses this port</FONT> <provider>false</provider></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><kind>SimplexReceptacle</kind></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2><instance -xmi:idref="Hello.ComponentImplementations.HelloImplementation.Hello.Sender" -/></FONT></P> -<P STYLE="margin-bottom: 0cm"><FONT SIZE=2></internalEndpoint></connection></FONT></P> -<P STYLE="margin-bottom: 0cm"><BR> -</P> -<P STYLE="margin-bottom: 0cm">Take a look at <A HREF="Code/Deployment/descriptors/connections.cdp">this</A> -file to see which connection should be made by DAnCE in order to run -the Hello tutorial properly. -</P> -<P STYLE="margin-bottom: 0cm">When the deployment tools (in this case -DAnCE) deploys this system, it'll connect all defined connectors -before the system is started (i.e. before configuration_complete is -called on a component). -</P> +connector. <U><B>The instance of the AMI connector +uses the same node as the Sender! </B></U></P> +<H3 CLASS="western" STYLE="PAGE-BREAK-AFTER: avoid">Connections</H3> +<P STYLE="MARGIN-BOTTOM: 0cm">A connection section defines +which components are connected together. The connection is 'local' since a +connector and a component are always running in the same process. Now that we +have got all the data we need to know to make a connection for the asynchronous +methods between the Sender and AMI connector (1) and between the AMI connector +and the receiver (2). For the synchronous methods we need a connection between +the Sender and the receiver. (3)</P> +<H4 CLASS="western">(1) </H4> +<P STYLE="MARGIN-BOTTOM: 0cm"><FONT SIZE=2><connection><FONT >//unique name +of the connection</FONT> <BR> <name>run_asynch_foo_connection</name><BR></FONT><FONT SIZE=2> <deployRequirement><BR> <name>edu.dre.vanderbilt.DAnCE.ConnectionType</name><BR> <resourceType>Local_Interface</resourceType><BR> </deployRequirement><BR></FONT> +<FONT SIZE=2> <internalEndpoint><FONT COLOR="#008000">//First endpoint +(the Sender component)<BR></FONT><FONT SIZE=2><FONT COLOR="#008000">// PortName is defined as “sendc_” + name of +port defined in Hello_Sender_comp.idl</FONT> <BR></FONT><FONT SIZE=2> <portName>sendc_run_my_foo</portName><BR></FONT><FONT SIZE=2> <provider>false</provider><BR></FONT><FONT SIZE=2> <kind>SimplexReceptacle</kind><BR></FONT><FONT SIZE=2><FONT > </FONT><instance +xmi:idref="Hello.ComponentImplementations.HelloImplementation.Hello.Sender" +/> <FONT COLOR="#008000">//The reference to the sender +instance. <BR></FONT><FONT SIZE=2> </internalEndpoint><BR></FONT> +<FONT SIZE=2><FONT > <</FONT>internalEndpoint><FONT COLOR="#008000">//Second +endpoint (the AMI connector component);<BR></FONT><FONT SIZE=2><FONT > </FONT><portName>ami4ccm_port_ami4ccm_provides</portName> +<FONT COLOR="#008000">//PortName alsways the same <BR></FONT><FONT SIZE=2> <provider>true</provider><BR></FONT><FONT SIZE=2> <kind>Facet</kind><BR></FONT><FONT SIZE=2><FONT COLOR="#008000"><FONT +color=#000000> </FONT></FONT><instance +xmi:idref="Hello.ComponentImplementations.HelloImplementation.Hello.AMI" +/> <FONT color=#008000>//The reference to the connector +instance< +/FONT> +<BR></FONT><FONT SIZE=2> </internalEndpoint><BR></FONT><FONT SIZE=2></connection></FONT></P> +<H4 CLASS="western">(2) </H4> +<P STYLE="MARGIN-BOTTOM: 0cm"><FONT SIZE=2><connection><BR></FONT><FONT SIZE=2> <name>do_foo_connection</name><FONT +color=#008000>//unique name of the connection</FONT><BR></FONT><FONT SIZE=2> <internalEndpoint><FONT +color=#008000>//First endpoint (the Receiver component)</FONT><BR></FONT><FONT SIZE=2> <portName>do_my_foo</portName><FONT +color=#008000>// PortName is defined as name of port +defined in Hello_Receiver_comp.idl</FONT> + <BR></FONT><FONT SIZE=2> <provider>true</provider><BR> <kind>Facet</kind><BR></FONT><FONT SIZE=2> <instance +xmi:idref="Hello.ComponentImplementations.HelloImplementation.Hello.Receiver" +/><BR></FONT><FONT SIZE=2> </internalEndpoint><BR></FONT><FONT SIZE=2> <internalEndpoint><FONT +color=#008000>//Second endpoint (the AMI component)</FONT><BR></FONT><FONT SIZE=2> <portName>ami4ccm_port_ami4ccm_uses</portName><FONT +color=#008000>// PortName alsways the same </FONT><BR></FONT><FONT SIZE=2> <provider>false</provider><BR></FONT><FONT SIZE=2> <kind>SimplexReceptacle</kind><BR></FONT><FONT SIZE=2> <instance +xmi:idref="Hello.ComponentImplementations.HelloImplementation.Hello.AMI" +/><BR></FONT><FONT SIZE=2> </internalEndpoint><BR></connection></FONT></P> +<P STYLE="MARGIN-BOTTOM: 0cm"><STRONG>(3)</STRONG></P> +<P STYLE="MARGIN-BOTTOM: 0cm"><FONT SIZE=2><connection><BR></FONT><FONT SIZE=2> <name>synch_foo_connection</name><BR></FONT><FONT SIZE=2> <internalEndpoint><BR></FONT><FONT SIZE=2> <portName>do_my_foo</portName> +<FONT color=#008000>// PortName is defined as name of port +defined in Hello_Receiver_comp.idl</FONT> +<BR></FONT><FONT SIZE=2> <provider>true</provider> +<FONT color=#008000>// The receiver provides this +port</FONT> <BR></FONT><FONT SIZE=2> <kind>Facet</kind><BR></FONT><FONT SIZE=2> <instance +xmi:idref="Hello.ComponentImplementations.HelloImplementation.Hello.Receiver" +/><BR></FONT><FONT SIZE=2> </internalEndpoint><BR> </FONT><FONT SIZE=2><internalEndpoint><BR></FONT><FONT SIZE=2> <portName>run_my_foo</portName> +<FONT color=#008000>// PortName is defined as name of port +defined in Hello_Sender_comp.idl</FONT><BR></FONT><FONT SIZE=2> <provider>false</provider> +<FONT color=#008000>// The sender uses this port</FONT> + <BR></FONT><FONT SIZE=2> <kind>SimplexReceptacle</kind><BR></FONT><FONT SIZE=2> <instance +xmi:idref="Hello.ComponentImplementations.HelloImplementation.Hello.Sender" +/><BR></FONT><FONT SIZE=2> </internalEndpoint><BR></connection></FONT></P> +<P STYLE="MARGIN-BOTTOM: 0cm"><BR></P> +<P STYLE="MARGIN-BOTTOM: 0cm"><FONT size=3>Take a look at </FONT> <A href="Code/Deployment/descriptors/connections.cdp"><FONT +size=3>this</FONT></A><FONT size=3> file to +see which connection should be made by DAnCE in order to run the Hello tutorial +properly. </FONT></P> +<P STYLE="MARGIN-BOTTOM: 0cm"><FONT size=3>When the deployment tools (in this case DAnCE) deploys this +system, it'll connect all defined connectors before the system is started (i.e. +before configuration_complete is called on a component). </FONT></P> <H3 CLASS="western">Coding connections</H3> -<P STYLE="margin-bottom: 0cm">Every component has got a context. The -context is set by DAnCE and is the 'gateway' to all other component -your component is connected to. The context caches all these -connections so that the user doesn't need to cache those in his/her -component. -</P> -<P STYLE="margin-bottom: 0cm"><SPAN STYLE="text-decoration: none"><B>Sender: -</B></SPAN>The following code retrieves the connection to the AMI -connector interface from the context. -</P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT SIZE=2>::Hello::AMI4CCM_MyFoo_obj_var -asynch_foo = </FONT><FONT COLOR="#0000ff"><FONT SIZE=2>this</FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2>->context_->get_connection_sendc_run_my_foo();</FONT></FONT></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm">The following code -retrieves the connection to the Receiver interface from the context.</P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT COLOR="#000000"><FONT SIZE=2>::Hello::MyFoo_obj_var -synch_foo = </FONT></FONT><FONT COLOR="#0000ff"><FONT SIZE=2>this</FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2>->context_->get_connection_run_my_foo +<P STYLE="MARGIN-BOTTOM: 0cm"><FONT size=3>Every component has got a context. The context is set by +DAnCE and is the 'gateway' to all other component your component is connected +to. The context caches all these connections so that the user doesn't need to +cache those in his/her component. </FONT></P> +<P STYLE="MARGIN-BOTTOM: 0cm"><FONT size=3><SPAN STYLE="TEXT-DECORATION: none"><B>Sender: </B></SPAN>The following code retrieves the +connection to the AMI connector interface from the context: </FONT></P> +<P STYLE="MARGIN-BOTTOM: 0cm"><FONT SIZE=2>::Hello::AMI4CCM_MyFoo_obj_var asynch_foo = </FONT><FONT COLOR="#0000ff"><FONT SIZE=2>this</FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2>->context_->get_connection_sendc_run_my_foo();</FONT></FONT></P> +<P STYLE="MARGIN-BOTTOM: 0cm"><FONT +size=3>The following code retrieves the connection to the Receiver +interface from the context:</FONT></P> +<P STYLE="MARGIN-BOTTOM: 0cm"><FONT COLOR="#000000"><FONT SIZE=2>::Hello::MyFoo_obj_var +synch_foo = </FONT></FONT><FONT COLOR="#0000ff"><FONT SIZE=2>this</FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2>->context_->get_connection_run_my_foo ();</FONT></FONT></P> -<P STYLE="margin-bottom: 0cm"><BR> -</P> -<P STYLE="margin-bottom: 0cm"><SPAN STYLE="text-decoration: none"><B>Receiver: -</B></SPAN>The Receiver provide one facet for the AMI connector and -for the sender. -</P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><CODE CLASS="western"><FONT SIZE=2>::Hello::CCM_MyFoo_obj_ptr</FONT></CODE></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT SIZE=2>Receiver_exec_i::get_do_my_foo -(</FONT><FONT COLOR="#0000ff"><FONT SIZE=2>void</FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2>)</FONT></FONT></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT COLOR="#000000"><FONT SIZE=2>{</FONT></FONT></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT COLOR="#0000ff"><FONT SIZE=2>return</FONT></FONT><FONT COLOR="#000000"> -</FONT><FONT COLOR="#0000ff"><FONT SIZE=2>new</FONT></FONT><FONT COLOR="#000000"> -</FONT><FONT COLOR="#000000"><FONT SIZE=2>MyFoo_exec_i ();</FONT></FONT></P> -<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT COLOR="#000000"><FONT SIZE=2>}</FONT></FONT></P> -<H3 CLASS="western" STYLE="page-break-after: avoid"><CODE CLASS="western">Artifacts</CODE></H3> -<P STYLE="margin-bottom: 0cm"><CODE CLASS="western"><FONT FACE="Times New Roman, serif">Artifacts -sections contains the names of the binaries. See <A HREF="Code/Deployment/descriptors/artifacts.cdp">this</A> -files for an overview of all artifacts in the Hello tutorial. </FONT></CODE> -</P> -<H3 CLASS="western" STYLE="page-break-after: avoid"><CODE CLASS="western">Complete -plan</CODE></H3> -<P STYLE="margin-bottom: 0cm"><CODE CLASS="western"><FONT FACE="Times New Roman, serif"><A HREF="Code/Deployment/descriptors/Plan.cdp">This</A> -file shows the complete deployment plan. </FONT></CODE> -</P> -<P STYLE="margin-bottom: 0cm"><BR> -</P> +<P STYLE="MARGIN-BOTTOM: 0cm"><FONT size=3><SPAN STYLE="TEXT-DECORATION: none"><B>Receiver: </B></SPAN>The Receiver provide one facet for the +AMI connector and for the sender. </FONT></P> +<P STYLE="MARGIN-BOTTOM: 0cm"><CODE CLASS="western"><FONT SIZE=2 face="Times New Roman">::Hello::CCM_MyFoo_obj_ptr<BR></FONT></CODE> +<FONT SIZE=2>Receiver_exec_i::get_do_my_foo (</FONT><FONT COLOR="#0000ff"><FONT SIZE=2>void</FONT></FONT> +<FONT COLOR="#000000"><FONT SIZE=2>)<BR></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=2>{<BR></FONT></FONT> +<FONT COLOR="#0000ff"><FONT SIZE=2> return</FONT></FONT> +<FONT COLOR="#000000"></FONT><FONT COLOR="#0000ff"> +<FONT SIZE=2>new</FONT></FONT><FONT COLOR="#000000"> </FONT> +<FONT COLOR="#000000"><FONT SIZE=2>MyFoo_exec_i ();<BR></FONT></FONT> +<FONT COLOR="#000000"><FONT SIZE=2>}</FONT></FONT></P> +<H3 CLASS="western" STYLE="PAGE-BREAK-AFTER: avoid"><CODE CLASS="western"><FONT +face="Times New Roman">Artifacts</FONT></CODE></H3> +<P STYLE="MARGIN-BOTTOM: 0cm"><CODE CLASS="western"><FONT > <FONT size=3 +face="Times New Roman">Artifacts sections contains the +names of the binaries. See </FONT> + <A href="Code/Deployment/descriptors/artifacts.cdp"><FONT size=3 +face="Times New Roman">this</FONT></A><FONT size=3 face="Times New Roman"> files for an overview of all +artifacts in the Hello tutorial. </FONT></FONT></CODE></P> +<H3 CLASS="western" STYLE="PAGE-BREAK-AFTER: avoid"><CODE CLASS="western"><FONT face="Times New Roman">Complete plan</FONT></CODE></H3> +<P STYLE="MARGIN-BOTTOM: 0cm"><CODE CLASS="western"><FONT ><A href="Code/Deployment/descriptors/Plan.cdp"><FONT size=3 +face="Times New Roman">This</FONT></A><FONT size=3 face="Times New Roman"> file shows the complete deployment +plan. </FONT></FONT></CODE></P> +<P STYLE="MARGIN-BOTTOM: 0cm"><BR></P> <HR> -<P><BR><BR> -</P> -<TABLE WIDTH=100% BORDER=0 CELLPADDING=2 CELLSPACING=2> +<P><BR><BR></P> +<TABLE WIDTH="100%" BORDER=0 CELLPADDING=2 CELLSPACING=2> <TR> <TD> - <P ALIGN=LEFT><A HREF="04_ami4ccm.html">Previous</A></P> - </TD> + <P ALIGN=left><A href="04_ami4ccm.html">Previous</A></P></TD> <TD> - <P ALIGN=CENTER><IMG SRC="images/images.png" NAME="graphics2" ALIGN=BOTTOM WIDTH=4% HEIGHT=5% BORDER=0></P> - </TD> - <TD></TD> - </TR> -</TABLE> -<H2 CLASS="western"><BR><BR> -</H2> + <P ALIGN=center><IMG border=0 name=graphics2 align=bottom src="images/images.png" width="4%" height="5%" ></P></TD> + <TD></TD></TR></TABLE> +<H2 CLASS="western"><BR><BR></H2></FONT></FONT></FONT></FONT></FONT> </BODY> </HTML> |