Tuscany SCA Native Samples - C++ Calculator Sample

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.

There are two sub projects in this workspace:

  • sample.calculator
    This contains the source code and SCDL artifacts for the SCA Calculator composite implementing the sample Calculator.
  • sample.calculator.client
    A sample client which does a local call to the Calculator service.

Additionally, there is the sample.calculator.app.composite file. This describes the configuration of the SCA Calculator composite deployed to the SCA runtime.

Contents

  1. Building the C++ samples on Linux and Mac OS X
  2. Running the C++ Calculator sample on Linux and Mac OS X
  3. Building the C++ Calculator sample on Windows
  4. Running the C++ Calculator sample on Windows
  5. Getting help

Building the C++ samples on Linux and Mac OS X

If using the binary distribution the samples are built and installed in <tuscany_sca_install_dir>/samples - go directly to Running the samples on Linux and Mac OS X.

  1. The following environment variables are required:
    • TUSCANY_SCACPP=<path to installed Tuscany SCA>
    • TUSCANY_SDOCPP=<path to installed Tuscany SDO>
  2. Build the C++ samples with the following command sequence:
    • cd <tuscany_sca_install_dir>/samples
    • ./configure --prefix=$TUSCANY_SCACPP/samples --enable-static=no
    • make
    • make install
    NOTE: If you don't provide the --prefix configure option, it will by default install into /usr/local/tuscany/sca/samples/CppCalculator

Running the C++ Calculator sample on Linux and Mac OS X
  1. The following environment variables are required:
    • TUSCANY_SCACPP=<path to installed Tuscany SCA>
    • TUSCANY_SDOCPP=<path to installed Tuscany SDO>
  2. Run the sample with the following commands:
    • cd <tuscany_sca_install_dir>/samples/CppCalculator/deploy/sample.calculator.client
    • ./runclient.sh

Building the C++ Calculator sample on Windows

If using the binary distribution the samples are built and installed in <tuscany_sca_install_dir>\samples - go directly to Running the samples on Windows.

  1. The following environment variables are required:
    • TUSCANY_SCACPP=<path to installed Tuscany SCA>
    • TUSCANY_SDOCPP=<path to installed Tuscany SDO>
  2. 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.
  3. 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.

Running the C++ Calculator sample on Windows
  1. The following environment variables are required:
    • TUSCANY_SCACPP=<path to installed Tuscany SCA>
    • TUSCANY_SDOCPP=<path to installed Tuscany SDO>
  2. Run the sample with the following commands:
    • cd <tuscany_sca_install_dir>\samples\CppCalculator\deploy\sample.calculator.client
    • runclient.bat

Getting Help

The first place to look is at the Tuscany SCA FAQ at http://cwiki.apache.org/confluence/display/TUSCANY/Tuscany+SCA+-+FAQ

Any problem with this release can be reported to the Tuscany mailing lists or create a JIRA issue at http://issues.apache.org/jira/browse/Tuscany.