Return-Path: Delivered-To: apmail-ws-tuscany-commits-archive@locus.apache.org Received: (qmail 65991 invoked from network); 6 Oct 2006 15:35:01 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur.apache.org with SMTP; 6 Oct 2006 15:35:01 -0000 Received: (qmail 36565 invoked by uid 500); 6 Oct 2006 15:35:01 -0000 Delivered-To: apmail-ws-tuscany-commits-archive@ws.apache.org Received: (qmail 36543 invoked by uid 500); 6 Oct 2006 15:35:01 -0000 Mailing-List: contact tuscany-commits-help@ws.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: tuscany-dev@ws.apache.org Delivered-To: mailing list tuscany-commits@ws.apache.org Received: (qmail 36534 invoked by uid 99); 6 Oct 2006 15:35:01 -0000 Received: from idunn.apache.osuosl.org (HELO idunn.apache.osuosl.org) (140.211.166.84) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 06 Oct 2006 08:35:01 -0700 X-ASF-Spam-Status: No, hits=-9.4 required=5.0 tests=ALL_TRUSTED,NO_REAL_NAME Received: from [140.211.166.113] ([140.211.166.113:64091] helo=eris.apache.org) by idunn.apache.osuosl.org (ecelerity 2.1.1.8 r(12930)) with ESMTP id 0E/04-24193-3A776254 for ; Fri, 06 Oct 2006 08:34:59 -0700 Received: by eris.apache.org (Postfix, from userid 65534) id F192B1A981D; Fri, 6 Oct 2006 08:34:56 -0700 (PDT) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: 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 Date: Fri, 06 Oct 2006 15:34:55 -0000 To: tuscany-commits@ws.apache.org From: ajborley@apache.org X-Mailer: svnmailer-1.1.0 Message-Id: <20061006153456.F192B1A981D@eris.apache.org> X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N 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 @@

Calculator with Web Service client
    -
  1. Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions found here. +
  2. Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions + found here.
  3. Start the Axis2C simple http server:
      @@ -197,7 +198,8 @@

    Calculator with Web Service client
      -
    1. Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions found here. +
    2. Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions + found here.
    3. Start the Axis2C simple http server:
        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 @@

      PythonCalculator with Web Service client
        -
      1. Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions found here. +
      2. Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions + found here.
      3. Start the Axis2C simple http server:
          @@ -200,7 +201,8 @@

        PythonCalculator with Web Service client
          -
        1. Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions found here. +
        2. Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions + found here.
        3. Start the Axis2C simple http server:
            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 @@

          RubyBank with Web Service clients
            -
          1. Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions found here. +
          2. Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions + found here.
          3. Start the Axis2C simple http server:
              @@ -187,7 +188,8 @@

            RubyBank with Web Service clients
              -
            1. Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions found here. +
            2. Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions + found here.
            3. Start the Axis2C simple http server:
                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 @@

              RubyCalculator with Web Service client
                -
              1. Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions found here. +
              2. Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions + found here.
              3. Start the Axis2C simple http server:
                  @@ -195,7 +196,8 @@

                RubyCalculator with Web Service client
                  -
                1. Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions found here. +
                2. Ensure you have enabled Axis2C to run Tuscany SCA services. Follow the instructions + found here.
                3. Start the Axis2C simple http server:
                    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 @@

                    Building the samples on Windows with Apache STDCXX

                     -
                      -
                    1. The following environment variables are required: -
                        -
                      • TUSCANY_SDOCPP=<path to installed Tuscany SDO> -
                      • AXIS2C_HOME=<path to axis2c version 0.94>
                        • -
                      2. - -
                    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. -
                    3. 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. -
                      4. -
                    +

                    STDCXX is an implementation of the C++ Standard Library provided by Apache. + The website is at http://incubator.apache.org/stdcxx/. +

                    +

                    You must begin by downloading and building STDCXX as described here +

                    +

                    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 +

                    +

                    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. +

                    +

                    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. +

                    --------------------------------------------------------------------- To unsubscribe, e-mail: tuscany-commits-unsubscribe@ws.apache.org For additional commands, e-mail: tuscany-commits-help@ws.apache.org