contrib/samples/CppCalculator/README.html - tuscany-sca-cpp - Git at Google


 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 <!--
    Licensed to the Apache Software Foundation (ASF) under one
    or more contributor license agreements.  See the NOTICE file
    distributed with this work for additional information
    regarding copyright ownership.  The ASF licenses this file
    to you under the Apache License, Version 2.0 (the
    "License"); you may not use this file except in compliance
    with the License.  You may obtain a copy of the License at

      http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing,
    software distributed under the License is distributed on an
    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
    KIND, either express or implied.  See the License for the
    specific language governing permissions and limitations
    under the License.
 -->

 <HTML>
 <HEAD>
    <META CONTENT="text/html; charset=iso-8859-1" HTTP-EQUIV="Content-Type">
    <META CONTENT="text/css" HTTP-EQUIV="Content-Style-Type">
    <STYLE MEDIA="all" TYPE="text/css">
 @import url("../../doc/css/maven-base.css");
 @import url("../../doc/css/maven-theme.css");
    </STYLE>

     <LINK HREF="../doc/css/maven-theme.css" MEDIA="print" REL="stylesheet"
          TYPE="text/css">
    <TITLE>Tuscany SCA Native Samples - C++ Calculator Sample</TITLE>
 </HEAD>

 <BODY>
 <DIV ID="bodyColumn">
    <DIV ID="contentBox">
       <DIV CLASS="section">
          <H1>Tuscany SCA Native Samples - C++ Calculator Sample</H1>

          <P>This is a very simple sample to show how an SCA composite can wire
           together two C++ components to implement a Calculator service and invoke
           the service via a local client.
          </P>
          <P>There are two sub projects in this workspace:</P>
          <UL>
             <LI>sample.calculator<BR/>
                 This contains the source code and SCDL artifacts for the SCA Calculator
                 composite implementing the sample Calculator.
             </LI>
             <LI>sample.calculator.client<BR/>
                 A sample client which does a local call to the Calculator service.
             </LI>
          </UL>
          <P>Additionally, there is the sample.calculator.app.composite file. This
             describes the configuration of the SCA Calculator composite deployed to the SCA
             runtime.
          </P>
       </DIV>

       <DIV CLASS="section">
          <H2>Contents</H2>
          <OL>
             <LI><A HREF="#linuxbld">Building the C++ samples on Linux and Mac OS X</A></LI>
             <LI><A HREF="#linuxrun">Running the C++ Calculator sample on Linux and Mac OS X</A></LI>
             <LI><A HREF="#winbld">Building the C++ Calculator sample on Windows</A></LI>
             <LI><A HREF="#winrun">Running the C++ Calculator sample on Windows</A></LI>
             <LI><A HREF="#help">Getting help</A></LI>
          </OL>
       </DIV>


        <DIV CLASS="section">
          <A NAME="linuxbld"><H2>Building the C++ samples on Linux and Mac OS X</H2></A>
          <P>If using the binary distribution the samples are built and installed in
             &lt;tuscany_sca_install_dir&gt;/samples - go directly to <A HREF="#linuxrun">Running the samples on Linux and Mac OS X</A>.</P>
          <OL>
              <LI>The following environment variables are required:
                 <UL>
                   <LI>TUSCANY_SCACPP=&lt;path to installed Tuscany SCA&gt;
                   <LI>TUSCANY_SDOCPP=&lt;path to installed Tuscany SDO&gt;
                 </UL></LI>
              </LI>
              <LI>Build the C++ samples with the following command sequence:
                   <UL>
                       <LI>cd &lt;tuscany_sca_install_dir&gt;/samples</LI>
                       <LI>./configure --prefix=$TUSCANY_SCACPP/samples --enable-static=no</LI>
                       <LI>make</LI>
                       <LI>make install</LI>
                   </UL>
 	              NOTE: If you don't provide the --prefix configure option, it will by default install into
                   /usr/local/tuscany/sca/samples/CppCalculator</LI>
          </OL>
         </DIV>

        <DIV CLASS="section">
          <A NAME="linuxrun"><H2>Running the C++ Calculator sample on Linux and Mac OS X</H2></A>
          <OL>
              <LI>The following environment variables are required:
                 <UL>
                   <LI>TUSCANY_SCACPP=&lt;path to installed Tuscany SCA&gt;</LI>
                   <LI>TUSCANY_SDOCPP=&lt;path to installed Tuscany SDO&gt;</LI>
                 </UL>
              </LI>
              <LI>Run the sample with the following commands:
                 <UL>
                    <LI>cd &lt;tuscany_sca_install_dir&gt;/samples/CppCalculator/deploy/sample.calculator.client</LI>
                    <LI>./runclient.sh</LI>
                 </UL>
              </LI>
          </OL>
         </DIV>

         <DIV CLASS="section">
          <A NAME="winbld"><H2>Building the C++ Calculator sample on Windows</H2></A>
          <P>If using the binary distribution the samples are built and installed in
             &lt;tuscany_sca_install_dir&gt;\samples - go directly to <A HREF="#winrun">Running the samples on Windows</A>.</P>
          <OL>
              <LI>The following environment variables are required:
                 <UL>
                   <LI>TUSCANY_SCACPP=&lt;path to installed Tuscany SCA&gt;
                   <LI>TUSCANY_SDOCPP=&lt;path to installed Tuscany SDO&gt;
                 </UL></LI>
              </LI>
              <LI>You must have set up the environment for Microsoft Visual C++ tools.
                  The build command will call vcvars32 to set the environment. Ensure the
                  directory containing this is on your path. This will be where you
                  installed the compiler.
              </LI>
              <LI>Build the source, either via the Visual Studio Express projects under
                  &lt;tuscany_sca_install_dir&gt;\samples\CppCalculator\VSExpress\CppCalculator.sln or via the command-line build file
                  found at &lt;tuscany_sca_install_dir&gt;\samples\CppCalculator\VSExpress\CppCalculator\build.bat
                  which will build and deploy the samples.
              </LI>
          </OL>
         </DIV>

        <DIV CLASS="section">
          <A NAME="winrun"><H2>Running the C++ Calculator sample on Windows</H2></A>
          <OL>
              <LI>The following environment variables are required:
                 <UL>
                   <LI>TUSCANY_SCACPP=&lt;path to installed Tuscany SCA&gt;</LI>
                   <LI>TUSCANY_SDOCPP=&lt;path to installed Tuscany SDO&gt;</LI>
                 </UL>
              </LI>
              <LI>Run the sample with the following commands:
                 <UL>
                    <LI>cd &lt;tuscany_sca_install_dir&gt;\samples\CppCalculator\deploy\sample.calculator.client</LI>
                    <LI>runclient.bat</LI>
                 </UL>
              </LI>
       </DIV>


       <DIV CLASS="section">
          <A NAME="help"><H2>Getting Help</H2></A>

          <P>The first place to look is at the Tuscany SCA FAQ at
          <A HREF="http://cwiki.apache.org/confluence/display/TUSCANY/Tuscany+SCA+-+FAQ"
             TARGET="_blank">http://cwiki.apache.org/confluence/display/TUSCANY/Tuscany+SCA+-+FAQ</A> </P>

          <P>Any problem with this release can be reported to the Tuscany
          <A HREF="http://cwiki.apache.org/TUSCANY/mailing-lists.html"
             TARGET="_blank">mailing lists</A> or create a JIRA issue at&nbsp;<A HREF="http://issues.apache.org/jira/browse/Tuscany"
                                                                                 TARGET="_blank">http://issues.apache.org/jira/browse/Tuscany</A>.</P>

       </DIV>
    </DIV>
 </DIV>
 </BODY>

 </HTML>

	<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
	<!--
	Licensed to the Apache Software Foundation (ASF) under one
	or more contributor license agreements. See the NOTICE file
	distributed with this work for additional information
	regarding copyright ownership. The ASF licenses this file
	to you under the Apache License, Version 2.0 (the
	"License"); you may not use this file except in compliance
	with the License. You may obtain a copy of the License at

	http://www.apache.org/licenses/LICENSE-2.0

	Unless required by applicable law or agreed to in writing,
	software distributed under the License is distributed on an
	"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
	KIND, either express or implied. See the License for the
	specific language governing permissions and limitations
	under the License.
	-->

	<HTML>
	<HEAD>
	<META CONTENT="text/html; charset=iso-8859-1" HTTP-EQUIV="Content-Type">
	<META CONTENT="text/css" HTTP-EQUIV="Content-Style-Type">
	<STYLE MEDIA="all" TYPE="text/css">
	@import url("../../doc/css/maven-base.css");
	@import url("../../doc/css/maven-theme.css");
	</STYLE>

	<LINK HREF="../doc/css/maven-theme.css" MEDIA="print" REL="stylesheet"
	TYPE="text/css">
	<TITLE>Tuscany SCA Native Samples - C++ Calculator Sample</TITLE>
	</HEAD>

	<BODY>
	<DIV ID="bodyColumn">
	<DIV ID="contentBox">
	<DIV CLASS="section">
	<H1>Tuscany SCA Native Samples - C++ Calculator Sample</H1>

	<P>This is a very simple sample to show how an SCA composite can wire
	together two C++ components to implement a Calculator service and invoke
	the service via a local client.
	</P>
	<P>There are two sub projects in this workspace:</P>
	<UL>
	<LI>sample.calculator<BR/>
	This contains the source code and SCDL artifacts for the SCA Calculator
	composite implementing the sample Calculator.
	</LI>
	<LI>sample.calculator.client<BR/>
	A sample client which does a local call to the Calculator service.
	</LI>
	</UL>
	<P>Additionally, there is the sample.calculator.app.composite file. This
	describes the configuration of the SCA Calculator composite deployed to the SCA
	runtime.
	</P>
	</DIV>

	<DIV CLASS="section">
	<H2>Contents</H2>
	<OL>
	<LI><A HREF="#linuxbld">Building the C++ samples on Linux and Mac OS X</A></LI>
	<LI><A HREF="#linuxrun">Running the C++ Calculator sample on Linux and Mac OS X</A></LI>
	<LI><A HREF="#winbld">Building the C++ Calculator sample on Windows</A></LI>
	<LI><A HREF="#winrun">Running the C++ Calculator sample on Windows</A></LI>
	<LI><A HREF="#help">Getting help</A></LI>
	</OL>
	</DIV>


	<DIV CLASS="section">
	<A NAME="linuxbld"><H2>Building the C++ samples on Linux and Mac OS X</H2></A>
	<P>If using the binary distribution the samples are built and installed in
	<tuscany_sca_install_dir>/samples - go directly to <A HREF="#linuxrun">Running the samples on Linux and Mac OS X</A>.</P>
	<OL>
	<LI>The following environment variables are required:
	<UL>
	<LI>TUSCANY_SCACPP=<path to installed Tuscany SCA>
	<LI>TUSCANY_SDOCPP=<path to installed Tuscany SDO>
	</UL></LI>
	</LI>
	<LI>Build the C++ samples with the following command sequence:
	<UL>
	<LI>cd <tuscany_sca_install_dir>/samples</LI>
	<LI>./configure --prefix=$TUSCANY_SCACPP/samples --enable-static=no</LI>
	<LI>make</LI>
	<LI>make install</LI>
	</UL>
	NOTE: If you don't provide the --prefix configure option, it will by default install into
	/usr/local/tuscany/sca/samples/CppCalculator</LI>
	</OL>
	</DIV>

	<DIV CLASS="section">
	<A NAME="linuxrun"><H2>Running the C++ Calculator sample on Linux and Mac OS X</H2></A>
	<OL>
	<LI>The following environment variables are required:
	<UL>
	<LI>TUSCANY_SCACPP=<path to installed Tuscany SCA></LI>
	<LI>TUSCANY_SDOCPP=<path to installed Tuscany SDO></LI>
	</UL>
	</LI>
	<LI>Run the sample with the following commands:
	<UL>
	<LI>cd <tuscany_sca_install_dir>/samples/CppCalculator/deploy/sample.calculator.client</LI>
	<LI>./runclient.sh</LI>
	</UL>
	</LI>
	</OL>
	</DIV>

	<DIV CLASS="section">
	<A NAME="winbld"><H2>Building the C++ Calculator sample on Windows</H2></A>
	<P>If using the binary distribution the samples are built and installed in
	<tuscany_sca_install_dir>\samples - go directly to <A HREF="#winrun">Running the samples on Windows</A>.</P>
	<OL>
	<LI>The following environment variables are required:
	<UL>
	<LI>TUSCANY_SCACPP=<path to installed Tuscany SCA>
	<LI>TUSCANY_SDOCPP=<path to installed Tuscany SDO>
	</UL></LI>
	</LI>
	<LI>You must have set up the environment for Microsoft Visual C++ tools.
	The build command will call vcvars32 to set the environment. Ensure the
	directory containing this is on your path. This will be where you
	installed the compiler.
	</LI>
	<LI>Build the source, either via the Visual Studio Express projects under
	<tuscany_sca_install_dir>\samples\CppCalculator\VSExpress\CppCalculator.sln or via the command-line build file
	found at <tuscany_sca_install_dir>\samples\CppCalculator\VSExpress\CppCalculator\build.bat
	which will build and deploy the samples.
	</LI>
	</OL>
	</DIV>

	<DIV CLASS="section">
	<A NAME="winrun"><H2>Running the C++ Calculator sample on Windows</H2></A>
	<OL>
	<LI>The following environment variables are required:
	<UL>
	<LI>TUSCANY_SCACPP=<path to installed Tuscany SCA></LI>
	<LI>TUSCANY_SDOCPP=<path to installed Tuscany SDO></LI>
	</UL>
	</LI>
	<LI>Run the sample with the following commands:
	<UL>
	<LI>cd <tuscany_sca_install_dir>\samples\CppCalculator\deploy\sample.calculator.client</LI>
	<LI>runclient.bat</LI>
	</UL>
	</LI>
	</DIV>



	<DIV CLASS="section">
	<A NAME="help"><H2>Getting Help</H2></A>

	<P>The first place to look is at the Tuscany SCA FAQ at
	<A HREF="http://cwiki.apache.org/confluence/display/TUSCANY/Tuscany+SCA+-+FAQ"
	TARGET="_blank">http://cwiki.apache.org/confluence/display/TUSCANY/Tuscany+SCA+-+FAQ</A> </P>

	<P>Any problem with this release can be reported to the Tuscany
	<A HREF="http://cwiki.apache.org/TUSCANY/mailing-lists.html"
	TARGET="_blank">mailing lists</A> or create a JIRA issue at <A HREF="http://issues.apache.org/jira/browse/Tuscany"
	TARGET="_blank">http://issues.apache.org/jira/browse/Tuscany</A>.</P>

	</DIV>
	</DIV>
	</DIV>
	</BODY>

	</HTML>