You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tuscany.apache.org by aj...@apache.org on 2007/02/20 14:13:03 UTC
svn commit: r509543 - in /incubator/tuscany/cpp/sca: GettingStarted.html
doc/Axis2CWSService.html doc/CPPComponents.html doc/PythonExtension.html
doc/RubyExtension.html doc/css/maven-theme.css samples/GettingStarted.html
Author: ajborley
Date: Tue Feb 20 05:13:02 2007
New Revision: 509543
URL: http://svn.apache.org/viewvc?view=rev&rev=509543
Log:
Various documentation updates for Native M3
Modified:
incubator/tuscany/cpp/sca/GettingStarted.html
incubator/tuscany/cpp/sca/doc/Axis2CWSService.html
incubator/tuscany/cpp/sca/doc/CPPComponents.html
incubator/tuscany/cpp/sca/doc/PythonExtension.html
incubator/tuscany/cpp/sca/doc/RubyExtension.html
incubator/tuscany/cpp/sca/doc/css/maven-theme.css
incubator/tuscany/cpp/sca/samples/GettingStarted.html
Modified: incubator/tuscany/cpp/sca/GettingStarted.html
URL: http://svn.apache.org/viewvc/incubator/tuscany/cpp/sca/GettingStarted.html?view=diff&rev=509543&r1=509542&r2=509543
==============================================================================
--- incubator/tuscany/cpp/sca/GettingStarted.html (original)
+++ incubator/tuscany/cpp/sca/GettingStarted.html Tue Feb 20 05:13:02 2007
@@ -30,22 +30,22 @@
<LINK HREF="doc/css/maven-theme.css" MEDIA="print" REL="stylesheet"
TYPE="text/css">
- <TITLE>Tuscany - Getting Started</TITLE>
+ <TITLE>Tuscany SCA Native - Getting Started</TITLE>
</HEAD>
<BODY>
<DIV ID="bodyColumn">
<DIV ID="contentBox">
<DIV CLASS="section">
- <H2>Tuscany - Getting Started - SCA C++ Milestone release 2</H2>
+ <H1>Tuscany - Getting Started - SCA Native Milestone release 3</H1>
- <P>Tuscany SCA C++ provides a runtime implementation for the Service Component
+ <P>Tuscany SCA Native provides a runtime implementation for the Service Component
Architecture 0.96 Assembly specification and the 0.95 C++ Client & Implementation specification
(found <A HREF="http://www.osoa.org/display/Main/Service+Component+Architecture+Specifications">here</A>),
written in C++ and currently supports C++, Python and Ruby
component implementation types. This page describes what is needed to install and run Tuscany
- SCA for C++.<BR/>If you haven't already done so, the first
- step is to download the SCA C++ Milestone release 2 of Apache Tuscany from our
+ SCA Native.<BR/>If you haven't already done so, the first
+ step is to download the SCA Native Milestone release 3 of Apache Tuscany from our
<A HREF="http://incubator.apache.org/tuscany/downloads.html" target='_blank'>download page</A>.<BR/>
</P>
</DIV>
@@ -95,16 +95,7 @@
</TD>
</TR>
<TR CLASS="a">
- <TD>Axis2C Release 0.94</TD>
-
- <TD>
- <A HREF="http://ws.apache.org/axis2/c/download.cgi"
- TARGET="_blank">http://ws.apache.org/axis2/c/download.cgi</A><BR/>
- Please download and follow the installation instructions. Ensure you can run the Axis2C samples
- </TD>
- </TR>
- <TR CLASS="b">
- <TD>Tuscany SDO for C++ Milestone Release 2</TD>
+ <TD>Tuscany SDO for C++ Milestone Release 3</TD>
<TD>
<A HREF="http://incubator.apache.org/tuscany/download.html"
@@ -112,7 +103,7 @@
Please download and follow the installation instructions
</TD>
</TR>
- <TR CLASS="a">
+ <TR CLASS="b">
<TD><STRONG>Optional:</STRONG> Java SDK 1.4 or later</TD>
<TD>
@@ -123,33 +114,28 @@
Python or Ruby SCA components.
</TD>
</TR>
- <TR CLASS="b">
+ <TR CLASS="a">
<TD><STRONG>Optional:</STRONG> Apache Ant 1.6 or later</TD>
-
<TD>
<A HREF="http://ant.apache.org"
TARGET="_blank">http://ant.apache.org</A><BR/>
This is required for building the SCAGEN code generation tool, which is used
when developing Tuscany SCA C++ components. This is only required when building
- a source distribution of Tuscany SCA C++.
+ the C++ extension from a source distribution of Tuscany SCA Native.
</TD>
</TR>
- <TR CLASS="a">
- <TD><STRONG>Optional:</STRONG> Python version 2.4</TD>
-
+ <TR CLASS="b">
+ <TD><STRONG>Optional:</STRONG> Python version 2.5</TD>
<TD>
<A HREF="http://www.python.org/download/"
TARGET="_blank">http://www.python.org/download/</A><BR/>
This is required for building or running the Tuscany SCA Python extension
(see <A HREF="#extensions">below</A>).
- Please download and follow the installation instructions. You can build
- the Tuscany SCA Python Extension with other versions of Python - versions 2.3.4
- and higher have been tested.
+ Please download and follow the installation instructions.
</TD>
</TR>
- <TR CLASS="b">
+ <TR CLASS="a">
<TD><STRONG>Optional:</STRONG> Ruby version 1.8.x</TD>
-
<TD>
<A HREF="http://www.ruby-lang.org"
TARGET="_blank">http://www.ruby-lang.org</A><BR/>
@@ -159,24 +145,76 @@
be able to build the Tuscany SCA Ruby Extension with other versions of Ruby.
</TD>
</TR>
+ <TR CLASS="b">
+ <TD><STRONG>Optional:</STRONG> PHP version 5.2</TD>
+ <TD>
+ <A HREF="http://www.php.net"
+ TARGET="_blank">http://www.php.net</A><BR/>
+ This is required for building and running the Tuscany SCA PHP extension
+ (see <A HREF="#extensions">below</A>).
+ Please download and follow the installation instructions.
+ </TD>
+ </TR>
+ <TR CLASS="a">
+ <TD><STRONG>Optional:</STRONG> PHP PECL SCA_SDO package version 1.1.2</TD>
+ <TD>
+ <A HREF="http://pecl.php.net/package/SCA_SDO"
+ TARGET="_blank">http://pecl.php.net/package/SCA_SDO</A><BR/>
+ This is required for running the Tuscany SCA PHP extension
+ (see <A HREF="#extensions">below</A>).
+ Please download and follow the installation instructions.
+ </TD>
+ </TR>
+ <TR CLASS="b">
+ <TD><STRONG>Optional:</STRONG> Axis2C Release 0.96</TD>
+ <TD>
+ <A HREF="http://ws.apache.org/axis2/c/download.cgi"
+ TARGET="_blank">http://ws.apache.org/axis2/c/download.cgi</A><BR/>
+ This is required for building and running the Tuscany SCA Web Service extension
+ (see <A HREF="#extensions">below</A>).
+ Please download and follow the installation instructions. Ensure you can run the Axis2C samples
+ </TD>
+ </TR>
+ <TR CLASS="a">
+ <TD><STRONG>Optional:</STRONG> Apache HTTPD version 2.2</TD>
+ <TD>
+ <A HREF="http://httpd.apache.org"
+ TARGET="_blank">http://httpd.apache.org</A><BR/>
+ This is required for building and running the Tuscany SCA REST extension
+ (see <A HREF="#extensions">below</A>). It is also required for some
+ of the Web Services samples.
+ Please download and follow the installation instructions.
+ </TD>
+ </TR>
+ <TR CLASS="b">
+ <TD><STRONG>Optional:</STRONG> libcurl version 7.15 or higher</TD>
+
+ <TD>
+ <A HREF="http://curl.haxx.se/download.html"
+ TARGET="_blank">http://curl.haxx.se/download.html</A><BR/>
+ This is required for building and running the Tuscany SCA REST extension
+ (see <A HREF="#extensions">below</A>).
+ Please download and follow the installation instructions.
+ </TD>
+ </TR>
</TBODY>
</TABLE>
</DIV>
<DIV CLASS="section">
- <A NAME="install"><H2>Installing Tuscany SCA for C++</H2></A>
- <A NAME="linuxbin"><H3>Getting Tuscany SCA for C++ working with the binary release on Linux</H3></A>
+ <A NAME="install"><H2>Installing Tuscany SCA Native</H2></A>
+ <A NAME="linuxbin"><H3>Getting Tuscany SCA Native working with the binary release on Linux</H3></A>
<OL>
<LI>Extract the binary tar package to a folder</LI>
<LI>Set the TUSCANY_SCACPP environment variable to point to the directory that was just extracted</LI>
<LI>Add the <tuscany_sca_install_dir>/lib directory to the LD_LIBRARY_PATH <!--(Linux) or DYLD_LIBRARY_PATH (MacOS X)--> environment variable</LI>
</OL>
- <A NAME="linuxsrc"><H3>Getting Tuscany SCA for C++ working with the source release on Linux</H3></A>
+ <A NAME="linuxsrc"><H3>Getting Tuscany SCA Native working with the source release on Linux</H3></A>
<OL>
<LI>Extract the source tar package to a folder <tuscany_sca_install_dir></LI>
<LI>The following environment variables are required:
<UL>
<LI>TUSCANY_SDOCPP=<path to installed Tuscany SDO>
- <LI>AXIS2C_HOME=<path to axis2c version 0.94></LI>
+ <LI>AXIS2C_HOME=<path to axis2c version 0.96></LI>
</UL></LI>
<LI>The following environment variables are optional if you wish to build the Python or Ruby extensions
(see the <A HREF="doc/PythonExtension.html">Python extension</A> and
@@ -185,10 +223,10 @@
<LI>PYTHON_LIB=<path to Python libraries></LI>
<LI>PYTHON_INCLUDE=<path to Python includes></LI>
<LI>PYTHON_VERSION=<name of the Python version><BR/>
- Note: If you are using a default installation of Python 2.3 these are usually:<BR/>
+ Note: If you are using a default installation of Python 2.5 these are usually:<BR/>
PYTHON_LIB=/usr/lib<BR/>
- PYTHON_INCLUDE=/usr/include/python2.3<BR/>
- PYTHON_VERSION=python2.3<BR/></LI>
+ PYTHON_INCLUDE=/usr/include/python2.5<BR/>
+ PYTHON_VERSION=python2.5<BR/></LI>
<LI>RUBY_LIB=<path to Ruby libraries></LI>
<LI>RUBY_INCLUDE=<path to Ruby includes><BR/>
Note: If you are using a default installation of Ruby these are usually:<BR/>
@@ -209,19 +247,19 @@
directory that contains the built Tuscany SCA distribution</LI>
</OL>
- <A NAME="winbin"><H3>Getting Tuscany SCA for C++ working with the binary release on Windows</H3></A>
+ <A NAME="winbin"><H3>Getting Tuscany SCA Native working with the binary release on Windows</H3></A>
<OL>
<LI>Unzip the supplied zip file to a folder</LI>
<LI>Set the TUSCANY_SCACPP environment variable to point to the directory that was just unzipped</LI>
<LI>Add the <tuscany_sca_install_dir>\bin directory to the PATH environment variable</LI>
</OL>
- <A NAME="winsrc"><H3>Getting Tuscany SCA for C++ working with the source release on Windows</H3></A>
+ <A NAME="winsrc"><H3>Getting Tuscany SCA Native working with the source release on Windows</H3></A>
<OL>
<LI>Unzip the supplied source zip file</LI>
<LI>The following environment variables are required:
<UL>
<LI>TUSCANY_SDOCPP=<path to installed Tuscany SDO>
- <LI>AXIS2C_HOME=<path to axis2c version 0.94></LI>
+ <LI>AXIS2C_HOME=<path to axis2c version 0.96></LI>
</UL></LI>
<LI>The following environment variables are optional if you wish to build the Python or Ruby extensions
(see the <A HREF="doc/PythonExtension.html">Python extension</A> and
@@ -246,7 +284,7 @@
<DIV CLASS="section">
<A NAME="extensions"><H2>Tuscany SCA Extensions</H2></A>
- <P>Tuscany SCA is composed of two distinct areas: the core and extensions. The core provides the
+ <P>Tuscany SCA is composed of two distinct areas: the kernel and extensions. The kernel provides the
implementation of the
<A HREF="http://www.osoa.org/display/Main/Service+Component+Architecture+Specifications">Service
Component Architecture Assembly Model specification</A>, reading composite files, loading the
@@ -254,8 +292,8 @@
extensions provide the functionality required to call a component implementation (e.g. a C++ class
compiled into a dll) or invoke a binding (e.g. make a Web Services call).
</P>
- <P>The table below details the extensions that are included with TuscanySCA for C++ Milestone
- Release 2.
+ <P>The table below details the extensions that are included with Tuscany SCA Native Milestone
+ Release 3.
</P>
<TABLE CLASS="bodyTable">
<TBODY>
@@ -271,38 +309,107 @@
<A HREF="http://www.osoa.org/display/Main/Service+Component+Architecture+Specifications">SCA
C++ Client and Implementation specification</A> for more details about the SCA C++
Programming Model and the <A HREF="doc/CPPComponents.html">Creating C++ SCA Components</A>
- document for a step-by-step example.
+ document for a step-by-step example.<BR/>
+ <STRONG>Requires:</STRONG>
+ <UL>
+ <LI><A HREF="http://java.sun.com/javase/downloads/index.jsp" TARGET="_blank">Java SDK 1.4 or later</A>
+ - for building and running the SCAGEN code generation tool, which is used
+ when developing Tuscany SCA C++ components.</LI>
+ <LI><A HREF="http://ant.apache.org" TARGET="_blank">Apache Ant 1.6 or later</A>
+ - for building the SCAGEN code generation tool. This is only required when building
+ the C++ extension from a source distribution of Tuscany SCA Native.</LI>
+ </UL>
+ </TD>
+ </TR>
+ <TR CLASS="a">
+ <TD STYLE="vertical-align: top; white-space: nowrap;">
+ <A HREF="doc/PythonExtension.html">Python</A>
+ </TD>
+ <TD>Provides a Python SCA client API and enables Python component implementations.
+ See the <A HREF="doc/PythonExtension.html">Python extension documentation</A> for
+ more details.<BR/>
+ <STRONG>Requires:</STRONG>
+ <UL>
+ <LI><A HREF="http://www.python.org/download/" TARGET="_blank">Python version 2.5</A>
+ - for building and running the extension.</LI>
+ </UL>
+ </TD>
+ </TR>
+ <TR CLASS="b">
+ <TD STYLE="vertical-align: top; white-space: nowrap;">
+ <A HREF="doc/RubyExtension.html">Ruby</A>
+ </TD>
+ <TD>Provides a Ruby SCA client API and enables Ruby component implementations.
+ See the <A HREF="doc/RubyExtension.html">Ruby extension documentation</A> for
+ more details.<BR/>
+ <STRONG>Requires:</STRONG>
+ <UL>
+ <LI><A HREF="http://www.ruby-lang.org" TARGET="_blank">Ruby version 1.8.x</A>
+ - for building and running the extension.</LI>
+ </UL>
</TD>
</TR>
<TR CLASS="a">
- <TD STYLE="vertical-align: top; white-space: nowrap;">Axis2C Web Services
+ <TD STYLE="vertical-align: top; white-space: nowrap;">
+ <A HREF="doc/PHPExtension.html">PHP</A>
+ </TD>
+ <TD>Provides a PHP SCA client API and enables PHP component implementations by integrating
+ with the <A HREF="http://pecl.php.net/package/SCA_SDO">PECL SCA_SDO package</A>.
+ See the <A HREF="doc/PHPExtension.html">PHP extension documentation</A> for
+ more details. <BR/>
+ <STRONG>Requires:</STRONG>
+ <UL>
+ <LI><A HREF="http://www.php.net" TARGET="_blank">PHP version 5.2</A>
+ - for building and running the extension.</LI>
+ <LI><A HREF="http://pecl.php.net/package/SCA_SDO" TARGET="_blank">PECL SCA_SDO package version 1.1.2</A>
+ - for running the extension.</LI>
+ </UL>
</TD>
+ </TR>
+ <TR CLASS="b">
+ <TD STYLE="vertical-align: top; white-space: nowrap;">Axis2C Web Services</TD>
<TD>Provides the Web Service bindings enabling Tuscany to call SCA references via
Web Services or expose SCA services as Web Services. See the
<A HREF="http://www.osoa.org/display/Main/Service+Component+Architecture+Specifications">SCA
Web Service bindings specification</A> for more details about SCA Web Service support
and the <A HREF="doc/Axis2CWSService.html">Enabling Web Service
- access to SCA Components</A> document for a step-by-step example.
+ access to SCA Components</A> document for a step-by-step example.<BR/>
+ <STRONG>Requires:</STRONG>
+ <UL>
+ <LI><A HREF="http://ws.apache.org/axis2/c/download.cgi" TARGET="_blank">Axis2C Release 0.96</A>
+ - for building and running the extension.</LI>
+ </UL>
</TD>
</TR>
- <TR CLASS="b">
+ <TR CLASS="a">
<TD STYLE="vertical-align: top; white-space: nowrap;">
- <A HREF="doc/PythonExtension.html">Python</A>
+ <A HREF="doc/RESTExtension.html">REST</A>
</TD>
- <TD>Provides a Python SCA client API and enables Python component implementations.
- This extension is disabled by default and must be enabled to be used.
- See the <A HREF="doc/PythonExtension.html">Python extension documentation</A> for
- more details.
+ <TD>Provides the REST bindings enabling Tuscany to call SCA references via
+ REST HTTP calls or expose SCA services as REST Services. See the
+ <A HREF="doc/RESTExtension.html">REST extension documentation</A> for more details.<BR/>
+ <STRONG>Requires:</STRONG>
+ <UL>
+ <LI><A HREF="http://httpd.apache.org" TARGET="_blank">Apache HTTPD version 2.2</TD>
+ - for building and running the REST Service extension</LI>
+ <LI><A HREF="http://curl.haxx.se/download.html" TARGET="_blank">libcurl version 7.15 or higher</TD>
+ - for building and running the REST Reference extension</LI>
+ </UL>
</TD>
</TR>
- <TR CLASS="a">
+ <TR CLASS="b">
<TD STYLE="vertical-align: top; white-space: nowrap;">
- <A HREF="doc/RubyExtension.html">Ruby</A>
+ <A HREF="doc/SCAExtension.html">SCA</A>
</TD>
- <TD>Provides a Ruby SCA client API and enables Ruby component implementations.
- This extension is disabled by default and must be enabled to be used.
- See the <A HREF="doc/RubyExtension.html">Ruby extension documentation</A> for
- more details.
+ <TD>Provides a default SCA binding enabling Tuscany to determine the appropriate technology
+ to use to provide services or invoke references. Currently this defaults to using the
+ Axis2C Web Services binding. See the
+ <A HREF="doc/SCAExtension.html">SCA extension documentation</A> for more details.<BR/>
+ <STRONG>Requires:</STRONG>
+ <UL>
+ <LI><A HREF="doc/Axis2CWSService.html" TARGET="_blank">Axis2C Web Services extension</A>
+ - for building and running the extension.</LI>
+ </UL>
</TD>
</TR>
</TBODY>
Modified: incubator/tuscany/cpp/sca/doc/Axis2CWSService.html
URL: http://svn.apache.org/viewvc/incubator/tuscany/cpp/sca/doc/Axis2CWSService.html?view=diff&rev=509543&r1=509542&r2=509543
==============================================================================
--- incubator/tuscany/cpp/sca/doc/Axis2CWSService.html (original)
+++ incubator/tuscany/cpp/sca/doc/Axis2CWSService.html Tue Feb 20 05:13:02 2007
@@ -30,20 +30,20 @@
<LINK HREF="css/maven-theme.css" MEDIA="print" REL="stylesheet"
TYPE="text/css">
- <TITLE>Tuscany SCA for C++ - Enabling Axis2C Web Services</TITLE>
+ <TITLE>Tuscany SCA Native - Enabling Axis2C Web Services</TITLE>
</HEAD>
<BODY>
<DIV ID="bodyColumn">
<DIV ID="contentBox">
<DIV CLASS="section">
- <H2>Tuscany SCA for C++ - Enabling Axis2C Web Services</H2>
+ <H2>Tuscany SCA Native - Enabling Axis2C Web Services</H2>
<P>This document describes the deployment and use of the Axis2C Web Service
- (binding.ws) service support in the Apache Tuscany SCA C++ runtime.
+ (binding.ws) service support in the Apache Tuscany SCA Native runtime.
</P>
<P>The WS service code is based on <A HREF="http://ws.apache.org/axis2/c">Apache
- Axis2C version 0.94</A> and allows SCA components to be invoked via Web
+ Axis2C version 0.96</A> and allows SCA components to be invoked via Web
Service calls.
</P>
<P>WS service currently supports Document/literal Wrapped style Web Services
@@ -88,7 +88,7 @@
<OL>
<LI>The AXIS2C_HOME environment variable is required:
<UL>
- <LI>set AXIS2C_HOME=<path to axis2c version 0.94></LI>
+ <LI>set AXIS2C_HOME=<path to axis2c version 0.96></LI>
</UL></LI>
<LI>Use the following command sequence to run the deploy script:
<UL>
@@ -102,7 +102,7 @@
<OL>
<LI>The AXIS2C_HOME environment variable is required:
<UL>
- <LI>export AXIS2C_HOME=<path to axis2c version 0.94></LI>
+ <LI>export AXIS2C_HOME=<path to axis2c version 0.96></LI>
</UL></LI>
<LI>Use the following command sequence to run the deploy script:
<UL>
@@ -121,26 +121,26 @@
<LI>
Linux:
<OL>
- <LI>cd <axis2c version 0.94>/services</LI>
+ <LI>cd <axis2c version 0.96>/services</LI>
<LI>ln -sf <tuscany_sca_install_dir>/extensions/ws/service/services/tuscany</LI>
- <LI>cd <axis2c version 0.94>/modules</LI>
+ <LI>cd <axis2c version 0.96>/modules</LI>
<LI>ln -sf <tuscany_sca_install_dir>/extensions/ws/service/modules/tuscany</LI>
</OL>
Windows:
<OL>
- <LI>Create a <axis2c version 0.94>\services\tuscany directory
+ <LI>Create a <axis2c version 0.96>\services\tuscany directory
</LI>
<LI>Copy all the files in <tuscany_sca_install_dir>\extensions\ws\service\services\tuscany
to the directory created above
</LI>
- <LI>Create a <axis2c version 0.94>\modules\tuscany directory
+ <LI>Create a <axis2c version 0.96>\modules\tuscany directory
</LI>
<LI>Copy all the files in <tuscany_sca_install_dir>\extensions\ws\service\modules\tuscany
to the directory created above
</LI>
</OL>
</LI>
- <LI>Edit the <axis2c version 0.94>/axis2.xml file to add a <ref module="tuscany">
+ <LI>Edit the <axis2c version 0.96>/axis2.xml file to add a <ref module="tuscany">
element. This will register the above module. E.g.:
<PRE>...
<!-- ================================================= -->
@@ -224,8 +224,8 @@
<UL>
<LI>set TUSCANY_SCACPP=C:/tuscany_sca </LI>
<LI>set TUSCANY_SDOCPP=C:/tuscany_sdo </LI>
- <LI>set AXIS2C_HOME=C:/axis2c-bin-0.94-win32 </LI>
- <LI>set PATH=%PATH%;C:/tuscany_sca/bin;C:/tuscany_sdo/bin;C:/axis2c-bin-0.94-win32/lib</LI>
+ <LI>set AXIS2C_HOME=C:/axis2c-bin-0.96-win32 </LI>
+ <LI>set PATH=%PATH%;C:/tuscany_sca/bin;C:/tuscany_sdo/bin;C:/axis2c-bin-0.96-win32/lib</LI>
<LI>set TUSCANY_SCACPP_SYSTEM_ROOT=C:/tuscany_sca/samples/CppCalculator/deploy </LI>
<LI>set TUSCANY_SCACPP_DEFAULT_COMPONENT=sample.calculator.CalculatorComponent </LI>
<LI>cd %AXIS2C_HOME%/bin/ </LI>
Modified: incubator/tuscany/cpp/sca/doc/CPPComponents.html
URL: http://svn.apache.org/viewvc/incubator/tuscany/cpp/sca/doc/CPPComponents.html?view=diff&rev=509543&r1=509542&r2=509543
==============================================================================
--- incubator/tuscany/cpp/sca/doc/CPPComponents.html (original)
+++ incubator/tuscany/cpp/sca/doc/CPPComponents.html Tue Feb 20 05:13:02 2007
@@ -30,17 +30,17 @@
<LINK HREF="css/maven-theme.css" MEDIA="print" REL="stylesheet"
TYPE="text/css">
- <TITLE>Tuscany SCA for C++ - Creating C++ SCA Components</TITLE>
+ <TITLE>Tuscany SCA Native - Creating C++ SCA Components</TITLE>
</HEAD>
<BODY>
<DIV ID="bodyColumn">
<DIV ID="contentBox">
<DIV CLASS="section">
- <H2>Tuscany SCA for C++ - Creating C++ SCA Components</H2>
+ <H1>Tuscany SCA Native - Creating C++ SCA Components</H1>
- <P>This document describes how to create and run SCA components in Tuscany SCA C++
- milestone release 2.
+ <P>This document describes how to create and run SCA components in Tuscany SCA Native
+ milestone release 3.
</P>
<P>See the <A HREF="http://www.osoa.org/display/Main/Service+Component+Architecture+Specifications">SCA
C++ Client and Implementation specification</A> for more details about the SCA C++
@@ -288,8 +288,8 @@
<UL>
<LI>set TUSCANY_SCACPP=C:/tuscany_sca </LI>
<LI>set TUSCANY_SDOCPP=C:/tuscany_sdo </LI>
- <LI>set AXIS2C_HOME=C:/axis2c-bin-0.94-win32 </LI>
- <LI>set PATH=%PATH%;C:/tuscany_sca/bin;C:/tuscany_sdo/bin;C:/axis2c-bin-0.94-win32/lib</LI>
+ <LI>set AXIS2C_HOME=C:/axis2c-bin-0.96-win32 </LI>
+ <LI>set PATH=%PATH%;C:/tuscany_sca/bin;C:/tuscany_sdo/bin;C:/axis2c-bin-0.96-win32/lib</LI>
<LI>set TUSCANY_SCACPP_SYSTEM_ROOT=C:/tuscany_sca/samples/CppCalculator/deploy </LI>
<LI>set TUSCANY_SCACPP_DEFAULT_COMPONENT=sample.calculator.CalculatorComponent </LI>
<LI>./calculator_client.exe </LI>
Modified: incubator/tuscany/cpp/sca/doc/PythonExtension.html
URL: http://svn.apache.org/viewvc/incubator/tuscany/cpp/sca/doc/PythonExtension.html?view=diff&rev=509543&r1=509542&r2=509543
==============================================================================
--- incubator/tuscany/cpp/sca/doc/PythonExtension.html (original)
+++ incubator/tuscany/cpp/sca/doc/PythonExtension.html Tue Feb 20 05:13:02 2007
@@ -30,21 +30,27 @@
<LINK HREF="css/maven-theme.css" MEDIA="print" REL="stylesheet"
TYPE="text/css">
- <TITLE>Tuscany SCA for C++ - Python Extension</TITLE>
+ <TITLE>Tuscany SCA Native - Python Extension</TITLE>
</HEAD>
<BODY>
<DIV ID="bodyColumn">
<DIV ID="contentBox">
<DIV CLASS="section">
- <H2>Tuscany SCA for C++ - Python Extension</H2>
+ <H1>Tuscany SCA Native - Python Extension</H1>
<P>The Tuscany Python extension allows Python scripts to be used as components in
SCA composites and as clients that can invoke SCA services.
</P>
- <P>See <A HREF="../samples/PythonCalculator/README.html">PythonCalculator</A> for
- a sample that demonstrates the use of the Python extension.
- </P>
+ <P>The following samples demonstrate use of the Python extension:</P>
+ <UL>
+ <LI><A HREF="../samples/PythonCalculator/README.html">PythonCalculator</A></LI>
+ <LI><A HREF="../samples/PythonWeatherForecast/README.html">PythonWeatherForecast</A></LI>
+ <LI><A HREF="../samples/RestCustomer/README.html">RestCustomer</A></LI>
+ <LI><A HREF="../samples/RestYahoo/README.html">RestYahoo</A></LI>
+ <LI><A HREF="../samples/AlertAggregator/README.html">AlertAggregator</A></LI>
+ </UL>
+
</DIV>
<DIV CLASS="section">
<H2>Contents</H2>
@@ -81,14 +87,12 @@
<TD><B>Download Link</B></TD>
</TR>
<TR CLASS="b">
- <TD>Python version 2.4</TD>
+ <TD>Python version 2.5</TD>
<TD>
<A HREF="http://www.python.org/download/"
TARGET="_blank">http://www.python.org/download/</A><BR/>
- Please download and follow the installation instructions. You can build
- the Tuscany SCA Python Extension with other versions of Python - versions 2.3.4
- and higher have been tested.
+ Please download and follow the installation instructions.
</TD>
</TR>
</TBODY>
@@ -101,12 +105,6 @@
<OL>
<LI>Ensure the Python libraries are available on the PATH environment variable</LI>
<LI>Add the <tuscany_sca_install_dir>/extensions/python/lib directory to the PYTHONPATH environment variable</LI>
- <LI>Use the following command sequence to enable the extension:
- <UL>
- <LI>cd <tuscany_sca_install_dir>/extensions/python</LI>
- <LI>./deploy.sh</LI>
- </UL>
- </LI>
</OL>
<A NAME="linuxsrc"><H3>Getting the Tuscany SCA Python Extension working with the source release on Linux</H3></A>
<OL>
@@ -119,10 +117,10 @@
<LI>PYTHON_LIB=<path to Python libraries></LI>
<LI>PYTHON_INCLUDE=<path to Python includes></LI>
<LI>PYTHON_VERSION=<name of the Python version><BR/>
- Note: If you are using a default installation of Python 2.3 these are usually:<BR/>
+ Note: If you are using a default installation of Python 2.5 these are usually:<BR/>
PYTHON_LIB=/usr/lib<BR/>
- PYTHON_INCLUDE=/usr/include/python2.3<BR/>
- PYTHON_VERSION=python2.3<BR/></LI>
+ PYTHON_INCLUDE=/usr/include/python2.5<BR/>
+ PYTHON_VERSION=python2.5<BR/></LI>
</UL></LI>
<LI>Build the Python source only with the following command sequence:
<UL>
@@ -133,20 +131,12 @@
</UL>
NOTE: If you don't provide a --prefix configure option, it will by default install into
/usr/local/tuscany/sca</LI>
- <LI>You will now need to follow the <A HREF="#linuxbin">instructions above</A> to enable
- and use the extension.</LI>
</OL>
<A NAME="winbin"><H3>Getting the Tuscany SCA Python Extension working with the binary release on Windows</H3></A>
<OL>
<LI>Ensure the Python libraries are available on the PATH environment variable</LI>
<LI>Add the <tuscany_sca_install_dir>\extensions\python\bin directory to the PYTHONPATH environment variable</LI>
- <LI>Use the following command sequence to enable the extension:
- <UL>
- <LI>cd <tuscany_sca_install_dir>\extensions\python</LI>
- <LI>deploy.bat</LI>
- </UL>
- </LI>
</OL>
<A NAME="winsrc"><H3>Getting the Tuscany SCA Python Extension working with the source release on Windows</H3></A>
<OL>
@@ -170,8 +160,6 @@
in Visual Studio 6 or at at <tuscany_sca_install_dir>/projectsvc7/tuscany_sca/tuscany_sca.sln
in Visual Studio 7.1 - you can build projects individually
<LI>Set the TUSCANY_SCACPP environment variable to point to the 'deploy' directory that was just created</LI>
- <LI>You will now need to follow the <A HREF="#winbin">instructions above</A> to enable
- and use the extension.</LI>
</OL>
</DIV>
@@ -218,28 +206,18 @@
'self') and the class attribute must be defined in the implementation.python element
in your composite, like so:
</P>
-<PRE><implementation.python module="PythonModuleName" path="relative/path/to/module" class="PythonClassName"/>
-</PRE>
- <P>Tuscany currently only supports passing simple types (strings, ints, floats, etc) into
- and out of Python components. Support for more complex types, such as Service Data Objects,
- will be added in later releases.
- </P>
- <P>Additionally, Tuscany currently requires a componentType file that corresponds to the
- name of the Python module, e.g. for the Python Calculator sample, the module name is
- 'CalculatorImpl' and the componentType file is 'CalculatorImpl.componentType'. The
- componentType file specifies what services are available on the component and which
- references are called by the component. For example, CalculatorImpl.componentType
- contains the following:
- </P>
-<PRE><componentType xmlns="http://www.osoa.org/xmlns/sca/1.0">
- <service name="CalculatorService">
- <interface.python/>
- </service>
- <reference name="divideService">
- <interface.python/>
- </reference>
-</componentType>
+<PRE><implementation.python module="PythonModuleName" path="path/to/module" class="PythonClassName"/>
</PRE>
+ <P>Tuscany currently supports passing simple types (strings, ints, floats, etc) as well
+ as Service Data Objects into and out of Ruby components. Service Data Objects are represented
+ in Python as xml.etree.ElementTree Element objects (see the <A HREF="../samples/PythonWeatherForecast/README.html">
+ PythonWeatherForecast sample</A> for a demonstration).
+ </P>
+ <P>You can write a componentType file for your Python component, but you don't have to - the Python
+ extension automatically exposes a service and adds references and properties to your Python component
+ implementation classes based on the information in the composite file.
+ </P>
+
<A NAME="references"><H3>References</H3></A>
<P>References are automatically added to your Python component implementation when
the runtime loads the implementation script, so they can be used like so:
@@ -264,13 +242,6 @@
<implementation.python module="DivideImpl"/>
<property name="doRounding">true</property>
</component>
-</PRE>
- <P>and in the associated .componentType file like so:
- </P>
-<PRE><componentType ...
-...
- <property name="doRounding" type="xsd:boolean"/>
-</componentType>
</PRE>
<P>means the property is automatically instantiated and assigned the
property value in the Python component implementation, so it can be
Modified: incubator/tuscany/cpp/sca/doc/RubyExtension.html
URL: http://svn.apache.org/viewvc/incubator/tuscany/cpp/sca/doc/RubyExtension.html?view=diff&rev=509543&r1=509542&r2=509543
==============================================================================
--- incubator/tuscany/cpp/sca/doc/RubyExtension.html (original)
+++ incubator/tuscany/cpp/sca/doc/RubyExtension.html Tue Feb 20 05:13:02 2007
@@ -30,22 +30,26 @@
<LINK HREF="css/maven-theme.css" MEDIA="print" REL="stylesheet"
TYPE="text/css">
- <TITLE>Tuscany SCA for C++ - Ruby Extension</TITLE>
+ <TITLE>Tuscany SCA Native - Ruby Extension</TITLE>
</HEAD>
<BODY>
<DIV ID="bodyColumn">
<DIV ID="contentBox">
<DIV CLASS="section">
- <H2>Tuscany SCA for C++ - Ruby Extension</H2>
+ <H1>Tuscany SCA Native - Ruby Extension</H1>
<P>The Tuscany Ruby extension allows Ruby scripts to be used as components in
SCA composites and as clients that can invoke SCA services.
</P>
- <P>See <A HREF="../samples/RubyCalculator/README.html">RubyCalculator</A> and
- <A HREF="../samples/RubyBigBank/README.html">RubyBigBank</A> for
- two samples that demonstrate the use of the Ruby extension.
- </P>
+ <P>The following samples demonstrate use of the Ruby extension:</P>
+ <UL>
+ <LI><A HREF="../samples/RubyCalculator/README.html">RubyCalculator</A></LI>
+ <LI><A HREF="../samples/RubyBigBank/README.html">RubyBigBank</A></LI>
+ <LI><A HREF="../samples/RestCalculator/README.html">RestCalculator</A></LI>
+ <LI><A HREF="../samples/RestYahoo/README.html">RestYahoo</A></LI>
+ <LI><A HREF="../samples/HTTPDBigBank/README.html">HTTPDBigBank</A></LI>
+ </UL>
</DIV>
<DIV CLASS="section">
<H2>Contents</H2>
@@ -89,6 +93,10 @@
TARGET="_blank">http://www.ruby-lang.org</A><BR/>
Please download and follow the installation instructions. You should
be able to build the Tuscany SCA Ruby Extension with other versions of Ruby.
+ The extension has been tested with the
+ <A HREF="http://rubyforge.org/frs/download.php/12751/ruby185-21.exe">Ruby 1.8.5 One-Click Installer</A>
+ on Windows and the <A HREF="ftp://ftp.ruby-lang.org/pub/ruby/ruby-1.8.5-p12.tar.gz">1.8.5 source code</A>
+ (compiled locally) on Linux.
</TD>
</TR>
</TBODY>
@@ -100,13 +108,6 @@
<A NAME="linuxbin"><H3>Getting the Tuscany SCA Ruby Extension working with the binary release on Linux</H3></A>
<OL>
<LI>Ensure the Ruby libraries are available on the PATH environment variable</LI>
- <LI>Use the following command sequence to enable the extension:
- <UL>
- <LI>cd <tuscany_sca_install_dir>/extensions/ruby</LI>
- <LI>./deploy.sh</LI>
- </UL>
- </LI>
-
</OL>
<A NAME="linuxsrc"><H3>Getting the Tuscany SCA Ruby Extension working with the source release on Linux</H3></A>
<OL>
@@ -131,20 +132,11 @@
</UL>
NOTE: If you don't provide a --prefix configure option, it will by default install into
/usr/local/tuscany/sca</LI>
- <LI>You will now need to follow the <A HREF="#linuxbin">instructions above</A> to enable
- and use the extension.</LI>
-
</OL>
<A NAME="winbin"><H3>Getting the Tuscany SCA Ruby Extension working with the binary release on Windows</H3></A>
<OL>
<LI>Ensure the Ruby libraries are available on the PATH environment variable</LI>
- <LI>Use the following command sequence to enable the extension:
- <UL>
- <LI>cd <tuscany_sca_install_dir>\extensions\ruby</LI>
- <LI>deploy.bat</LI>
- </UL>
- </LI>
</OL>
<A NAME="winsrc"><H3>Getting the Tuscany SCA Ruby Extension working with the source release on Windows</H3></A>
<OL>
@@ -169,9 +161,6 @@
in Visual Studio 7.1 - you can build projects individually
or build the samples to rebuild all the projects</LI>
<LI>Set the TUSCANY_SCACPP environment variable to point to the 'deploy' directory that was just created</LI>
- <LI>You will now need to follow the <A HREF="#winbin">instructions above</A> to enable
- and use the extension.</LI>
-
</OL>
</DIV>
Modified: incubator/tuscany/cpp/sca/doc/css/maven-theme.css
URL: http://svn.apache.org/viewvc/incubator/tuscany/cpp/sca/doc/css/maven-theme.css?view=diff&rev=509543&r1=509542&r2=509543
==============================================================================
--- incubator/tuscany/cpp/sca/doc/css/maven-theme.css (original)
+++ incubator/tuscany/cpp/sca/doc/css/maven-theme.css Tue Feb 20 05:13:02 2007
@@ -27,6 +27,7 @@
#font-size: 13px;
padding: 4px 4px 4px 4px;
line-height: 1.5em;
+ font-size: small;
}
code{
font-family: Courier, monospace;
Modified: incubator/tuscany/cpp/sca/samples/GettingStarted.html
URL: http://svn.apache.org/viewvc/incubator/tuscany/cpp/sca/samples/GettingStarted.html?view=diff&rev=509543&r1=509542&r2=509543
==============================================================================
--- incubator/tuscany/cpp/sca/samples/GettingStarted.html (original)
+++ incubator/tuscany/cpp/sca/samples/GettingStarted.html Tue Feb 20 05:13:02 2007
@@ -29,17 +29,17 @@
<LINK HREF="../doc/css/maven-theme.css" MEDIA="print" REL="stylesheet"
TYPE="text/css">
- <TITLE>Tuscany SCA C++ Samples - Getting Started</TITLE>
+ <TITLE>Tuscany SCA Native Samples - Getting Started</TITLE>
</HEAD>
<BODY>
<DIV ID="bodyColumn">
<DIV ID="contentBox">
<DIV CLASS="section">
- <H2>Tuscany Samples - Getting Started - SCA C++ Milestone release 2</H2>
+ <H2>Tuscany Samples - Getting Started - SCA Native Milestone release 3</H2>
- <P>Tuscany SCA C++ includes a set of simple technology samples that demonstrates some of the functionality of
- the Tuscany SCA C++ runtime. This page describes the samples and links to the documents that describe how to
+ <P>Tuscany SCA Native includes a set of simple technology samples that demonstrates some of the functionality of
+ the Tuscany SCA Native runtime. This page describes the samples and links to the documents that describe how to
build and run them
</P>
</DIV>
@@ -149,8 +149,8 @@
<TD><A HREF="../doc/RESTExtension.html#service">REST Service Extension</A></TD>
<TD><A HREF="../doc/RESTExtension.html#reference">REST Reference Extension</A></TD>
<TD><A HREF="../doc/RESTExtension.html#interface">REST Interface Extension</A></TD>
- <TD><A HREF="../doc/SCABindingExtension.html#service">SCA Service Extension</A></TD>
- <TD><A HREF="../doc/SCABindingExtension.html#reference">SCA Reference Extension</A></TD>
+ <TD><A HREF="../doc/SCAExtension.html#service">SCA Service Extension</A></TD>
+ <TD><A HREF="../doc/SCAExtension.html#reference">SCA Reference Extension</A></TD>
</TR>
</THEAD>
<TBODY>
---------------------------------------------------------------------
To unsubscribe, e-mail: tuscany-commits-unsubscribe@ws.apache.org
For additional commands, e-mail: tuscany-commits-help@ws.apache.org