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 2006/10/06 17:34:55 UTC
svn commit: r453643 - in /incubator/tuscany/cpp: sca/README
sca/samples/Calculator/README.html sca/samples/PythonCalculator/README.html
sca/samples/RubyBank/README.html sca/samples/RubyCalculator/README.html
sdo/README sdo/samples/GettingStarted.html
Author: ajborley
Date: Fri Oct 6 08:34:54 2006
New Revision: 453643
URL: http://svn.apache.org/viewvc?view=rev&rev=453643
Log:
More documentation updates. Includes building the SDO samples with STDCXX and initial updates to the README status docs
Modified:
incubator/tuscany/cpp/sca/README
incubator/tuscany/cpp/sca/samples/Calculator/README.html
incubator/tuscany/cpp/sca/samples/PythonCalculator/README.html
incubator/tuscany/cpp/sca/samples/RubyBank/README.html
incubator/tuscany/cpp/sca/samples/RubyCalculator/README.html
incubator/tuscany/cpp/sdo/README
incubator/tuscany/cpp/sdo/samples/GettingStarted.html
Modified: incubator/tuscany/cpp/sca/README
URL: http://svn.apache.org/viewvc/incubator/tuscany/cpp/sca/README?view=diff&rev=453643&r1=453642&r2=453643
==============================================================================
--- incubator/tuscany/cpp/sca/README (original)
+++ incubator/tuscany/cpp/sca/README Fri Oct 6 08:34:54 2006
@@ -1,5 +1,5 @@
-Apache Tuscany C++ M1 build (July, 2006)
-===================================
+Apache Tuscany C++ M2 build (October, 2006)
+===========================================
http://incubator.apache.org/tuscany
@@ -19,18 +19,23 @@
===============
Documentation describing the system requirements and the steps to install
-Tuscany SCA C++ and run the samples can be found in the GettingStarted.html file.
+Tuscany SCA C++ and run the samples can be found in the GettingStarted.html
+file.
About Tuscany SCA C++
=====================
-Tuscany SCA C++ provides a runtime implementation for the Service Component
-Architecture 0.9 specification, written in C++ and will currently support C++
-component implementation types.
+Tuscany SCA C++ provides a runtime implementation for the for the Service
+Component Architecture 0.96 Assembly specification and the 0.95 C++ Client
+& Implementation Model specification, written in C++ and will currently
+support C++, Python and Ruby component implementation types.
+
+The specifications can be found at
+http://www.osoa.org/display/Main/Service+Component+Architecture+Specifications
It is possible to interoperate with Tuscany SCA Java via the Web Service bindings
-for EntryPoint/ExternalService but restrictions apply. This is not yet a complete
+for services and references but restrictions apply. This is not yet a complete
implementation and known restrictions are described below.
Supported SCA Assembly Model features
@@ -38,29 +43,29 @@
below. See SCA Assembly Model specification.
Supported language bindings
- * Component implementations written in C++. See SCA Client and
+ * Component implementations written in C++. See the SCA C++ Client and
Implementation Model specification.
+ * Component implementations written in Python. See the doc/PythonExtension.html
+ documentation.
+ * Component implementations written in Python. See the doc/RubyExtension.html
+ documentation.
* Component interfaces described by C++ classes. See SCA Client and
Implementation Model specification.
-Supported external service and entry point bindings
+Supported service and reference bindings
* The web service binding is supported. This implementation will support
web services which using document literal SOAP bindings conforming to the
WS-I basic profile (rpc/encoded is not yet supported).
Known restrictions
- * Subsystem wiring, entry points and external services are not supported.
* Local service interfaces cannot use overloaded operations (the SCA
specification limits remote service interfaces to not using overloaded
- operations).
+ operations).
* Each WSDL definition for a web service binding must be in a single WSDL
document.
- * No load time validation of the deployed SCA application (run time validation
- only).
- * No metadata API.
- * A Web Service EntryPoint that is wired (via zero or more components) to a
- Web Service ExternalService will fail when attempting to send the final
- response to the originating client.
+ * No load time validation of the deployed SCA application (run time
+ validation only).
+ * No metadata API.
Modified: incubator/tuscany/cpp/sca/samples/Calculator/README.html
URL: http://svn.apache.org/viewvc/incubator/tuscany/cpp/sca/samples/Calculator/README.html?view=diff&rev=453643&r1=453642&r2=453643
==============================================================================
--- incubator/tuscany/cpp/sca/samples/Calculator/README.html (original)
+++ incubator/tuscany/cpp/sca/samples/Calculator/README.html Fri Oct 6 08:34:54 2006
@@ -122,7 +122,8 @@
</OL>
<A NAME="linuxws"><H3>Calculator with Web Service client</H3></A>
<OL>
- <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions found here.
+ <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions
+ found <A HREF="../../../doc/Axis2CWSService.html">here</A>.
</LI>
<LI>Start the Axis2C simple http server:
<OL>
@@ -197,7 +198,8 @@
</OL>
<A NAME="winws"><H3>Calculator with Web Service client</H3></A>
<OL>
- <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions found here.
+ <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions
+ found <A HREF="../../../doc/Axis2CWSService.html">here</A>.
</LI>
<LI>Start the Axis2C simple http server:
<OL>
Modified: incubator/tuscany/cpp/sca/samples/PythonCalculator/README.html
URL: http://svn.apache.org/viewvc/incubator/tuscany/cpp/sca/samples/PythonCalculator/README.html?view=diff&rev=453643&r1=453642&r2=453643
==============================================================================
--- incubator/tuscany/cpp/sca/samples/PythonCalculator/README.html (original)
+++ incubator/tuscany/cpp/sca/samples/PythonCalculator/README.html Fri Oct 6 08:34:54 2006
@@ -128,7 +128,8 @@
</OL>
<A NAME="linuxws"><H3>PythonCalculator with Web Service client</H3></A>
<OL>
- <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions found here.
+ <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions
+ found <A HREF="../../../doc/Axis2CWSService.html">here</A>.
</LI>
<LI>Start the Axis2C simple http server:
<OL>
@@ -200,7 +201,8 @@
</OL>
<A NAME="winws"><H3>PythonCalculator with Web Service client</H3></A>
<OL>
- <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions found here.
+ <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions
+ found <A HREF="../../../doc/Axis2CWSService.html">here</A>.
</LI>
<LI>Start the Axis2C simple http server:
<OL>
Modified: incubator/tuscany/cpp/sca/samples/RubyBank/README.html
URL: http://svn.apache.org/viewvc/incubator/tuscany/cpp/sca/samples/RubyBank/README.html?view=diff&rev=453643&r1=453642&r2=453643
==============================================================================
--- incubator/tuscany/cpp/sca/samples/RubyBank/README.html (original)
+++ incubator/tuscany/cpp/sca/samples/RubyBank/README.html Fri Oct 6 08:34:54 2006
@@ -122,7 +122,8 @@
</OL>
<A NAME="linuxws"><H3>RubyBank with Web Service clients</H3></A>
<OL>
- <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions found here.
+ <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions
+ found <A HREF="../../../doc/Axis2CWSService.html">here</A>.
</LI>
<LI>Start the Axis2C simple http server:
<OL>
@@ -187,7 +188,8 @@
</OL>
<A NAME="winws"><H3>RubyBank with Web Service clients</H3></A>
<OL>
- <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions found here.
+ <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions
+ found <A HREF="../../../doc/Axis2CWSService.html">here</A>.
</LI>
<LI>Start the Axis2C simple http server:
<OL>
Modified: incubator/tuscany/cpp/sca/samples/RubyCalculator/README.html
URL: http://svn.apache.org/viewvc/incubator/tuscany/cpp/sca/samples/RubyCalculator/README.html?view=diff&rev=453643&r1=453642&r2=453643
==============================================================================
--- incubator/tuscany/cpp/sca/samples/RubyCalculator/README.html (original)
+++ incubator/tuscany/cpp/sca/samples/RubyCalculator/README.html Fri Oct 6 08:34:54 2006
@@ -123,7 +123,8 @@
</OL>
<A NAME="linuxws"><H3>RubyCalculator with Web Service client</H3></A>
<OL>
- <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions found here.
+ <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions
+ found <A HREF="../../../doc/Axis2CWSService.html">here</A>.
</LI>
<LI>Start the Axis2C simple http server:
<OL>
@@ -195,7 +196,8 @@
</OL>
<A NAME="winws"><H3>RubyCalculator with Web Service client</H3></A>
<OL>
- <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions found here.
+ <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions
+ found <A HREF="../../../doc/Axis2CWSService.html">here</A>.
</LI>
<LI>Start the Axis2C simple http server:
<OL>
Modified: incubator/tuscany/cpp/sdo/README
URL: http://svn.apache.org/viewvc/incubator/tuscany/cpp/sdo/README?view=diff&rev=453643&r1=453642&r2=453643
==============================================================================
--- incubator/tuscany/cpp/sdo/README (original)
+++ incubator/tuscany/cpp/sdo/README Fri Oct 6 08:34:54 2006
@@ -1,5 +1,5 @@
-Apache Tuscany C++ M1 build (July, 2006)
-===================================
+Apache Tuscany C++ M2 build (October, 2006)
+===========================================
http://incubator.apache.org/tuscany
@@ -19,38 +19,45 @@
===============
Documentation describing the system requirements and the steps to install
-Tuscany SDO C++ and run the samples can be found in the GettingStarted.html file.
+Tuscany SDO C++ and run the samples can be found in the GettingStarted.html
+file.
About Tuscany SDO for C++
=========================
-Tuscany SDO is an implementation of the Service Data Objects 2.0 specification for C++ developers.
-
-The implementation adheres closely to the specification, but there are a number of features which
-did not make it into this release. These are documented below.
+Tuscany SDO is an implementation of the Service Data Objects 2.01
+specification for C++ developers found at
+http://www.osoa.org/display/Main/Service+Data+Objects+Specifications
+
+The implementation adheres closely to the specification, but there are a number
+of features which did not make it into this release. These are documented
+below.
Generic get/set
---------------
-The C++ implementation defines a set of access methods directly appropriate to each Type. For example
-getString(), setString(), getBoolean(), setBoolean(). There is no generic get() method as there is no
-common base object to return - unlike the java implementation which can return an Object.
+The C++ implementation defines a set of access methods directly appropriate to
+each Type. For example getString(), setString(), getBoolean(), setBoolean().
+There is no generic get() method as there is no common base object to return -
+unlike the java implementation which can return an Object.
Typesafe interface
------------------
-There is no code generation in this version, so there is no interface such that a property called
-"Name" can be accessed via object->getName(). The name must be accessed via object->getString("Name");
+There is no code generation in this version, so there is no interface such that
+a property called "Name" can be accessed via object->getName(). The name must
+be accessed via object->getString("Name");
Change Summary Serialization
----------------------------
-Change summaries contain creations, deletions and modifications to data graphs. The specification
-indicates that these will be serialized to XML such that creations and deletions will become attributes
-of the change summary element, whilst changes become elements within the change summary element.
-This implementation saves all creations, deletions and changes as elements within the chang summary
-element.
+Change summaries contain creations, deletions and modifications to data graphs.
+The specification indicates that these will be serialized to XML such that
+creations and deletions will become attributes of the change summary element,
+whilst changes become elements within the change summary element. This
+implementation saves all creations, deletions and changes as elements within
+the change summary element.
Change Summary Undo
@@ -60,8 +67,8 @@
Read-Only
---------
-Read-only data elements are not supported by this implementation. Properties may be set read-only, but
-the property may still be modified without an error.
+Read-only data elements are not supported by this implementation. Properties
+may be set read-only, but the property may still be modified without an error.
Opposites
@@ -71,21 +78,23 @@
Date and Time
-------------
-Date support is limited to using a time_t. There are no calendar or duration style objects, and no
-helpers for conversions.
+Date support is limited to using a time_t. There are no calendar or duration
+style objects, and no helpers for conversions.
BigDecimal and BigInteger
-------------------------
-The equivalent of the java BigDecimal and BigInteger objects are not implmented.
+The equivalent of the java BigDecimal and BigInteger objects are not
+implemented.
NLS support
-----------
-Data objects may contain multi-byte data in the form of an SDO string, but locale information is not
-stored with the data.
+Data objects may contain multi-byte data in the form of an SDO string, but
+locale information is not stored with the data.
-The creation API only allows properties and types to have ascii names (taking a char* as the name).
+The creation API only allows properties and types to have ascii names (taking a
+char* as the name).
Inheritance
Modified: incubator/tuscany/cpp/sdo/samples/GettingStarted.html
URL: http://svn.apache.org/viewvc/incubator/tuscany/cpp/sdo/samples/GettingStarted.html?view=diff&rev=453643&r1=453642&r2=453643
==============================================================================
--- incubator/tuscany/cpp/sdo/samples/GettingStarted.html (original)
+++ incubator/tuscany/cpp/sdo/samples/GettingStarted.html Fri Oct 6 08:34:54 2006
@@ -157,24 +157,27 @@
<DIV CLASS="section">
<A NAME="winbldstdcxx"><H2>Building the samples on Windows with Apache STDCXX</H2></A>
- <OL>
- <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>
- </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 6 project under
- <tuscany_sdo_install_dir>\samples\ides or via the command-line build file
- found at <tuscany_sdo_install_dir>\samples\ides\devstudio6\projects\misc\build.cmd
- which will build and deploy the samples.
- </LI>
- </OL>
+ <P>STDCXX is an implementation of the C++ Standard Library provided by Apache.
+ The website is at <A HREF="http://incubator.apache.org/stdcxx/">http://incubator.apache.org/stdcxx/</A>.
+ </P>
+ <P>You must begin by downloading and building STDCXX as described <A HREF="../doc/BuildingSTDCXX.html">here</A>
+ </P>
+ <P>STDCXX is supported only when used with Microsoft Visual Studio C++ V7.1. Launch the
+ MSVC++ 7.1 studio by opening the file
+ <tuscany_sdo_install_dir>samples\ides\devstudio7\projects\misc\misc.sln
+ </P>
+ <P>The sdo_misc project includes build configurations that
+ use STDCXX. There are several ways to access the build configurations, and all
+ are equally effective. As an example, open the Property pages for sdo_misc by
+ right clicking on sdo_misc in the Solution Explorer pane and selecting
+ Properties. The Configuration property in the top left corner of the pane is a
+ drop down box offering four options: Debug, Release, stdcxx-Debug,
+ stdcxx-Release. Choose the one you want and then launch the build.
+ </P>
+ <P>All components that are linked (by the linker) must all use the same C++
+ Standard library. Therefore, if either sdo_misc or sdo_runtime are built with
+ STDCXX then both must be.
+ </P>
</DIV>
<DIV CLASS="section">
---------------------------------------------------------------------
To unsubscribe, e-mail: tuscany-commits-unsubscribe@ws.apache.org
For additional commands, e-mail: tuscany-commits-help@ws.apache.org