From bdd0a41aed7edf21ec2a65cfa17a86af2ef8c48a Mon Sep 17 00:00:00 2001 From: dims Date: Tue, 17 Jun 2008 00:23:01 +0000 Subject: Move Tuscany from Incubator to top level. git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@668359 13f79535-47bb-0310-9956-ffa450edef68 --- .../sdo/samples/GettingStarted.html | 237 +++++++++++++++++++++ 1 file changed, 237 insertions(+) create mode 100644 tags/cpp-1.0-incubating-M2-RC2/sdo/samples/GettingStarted.html (limited to 'tags/cpp-1.0-incubating-M2-RC2/sdo/samples/GettingStarted.html') diff --git a/tags/cpp-1.0-incubating-M2-RC2/sdo/samples/GettingStarted.html b/tags/cpp-1.0-incubating-M2-RC2/sdo/samples/GettingStarted.html new file mode 100644 index 0000000000..0a2d269083 --- /dev/null +++ b/tags/cpp-1.0-incubating-M2-RC2/sdo/samples/GettingStarted.html @@ -0,0 +1,237 @@ + + + + + + + + + + + Tuscany SDO C++ Samples - Getting Started + + + +
+
+
+

Tuscany Samples - Getting Started - SDO C++ Milestone release 2

+ +

Tuscany SDO C++ includes some simple technology samples that demonstrate some of the basic sceanrios for C++ SDO. + This page describes the samples and what is needed to install and run them. +

+
    +
  • The ObjectCreation sample demonstrates building the metadata programmatically, followed by use + of the metadata to instantiate objects in a graph. +
    • +
  • The XSDLoading sample shows how to load metadata from an XSD, and how to check for errors during + parsing. The parser gathers all non-fatal errors into one list, so all errors can be checked at one + time after parsing. Elements which contained errors will have been omitted from the resulting metadata. +
    • +
  • The ChangeSummarySave sample modifies a data graph of employees, and saves the modified graph with + its change summary. The output in ChangeSummarySave-output.xml shows the summary and its relationship + by references to the data graph. +
    • +
  • The Substitutes sample shows how to use substitites in XSD to achieve a property which will accept a + range of types. +
    • +
  • The Query sample shows how to use XPath to navigate within a graph to the required element. Note + that exceptions such as "path not found" may well be thrown if the XPath specified does not lead to + a real object in the graph. +
    • +
+

The SDO samples are built together into a single executable called sdo_misc.exe on Windows and sdo_misc on Linux +

+
+ +
+

Contents

+
    +
  1. Building the samples on Linux
    2. + +
  2. Running the samples on Linux
    3. +
  3. Building the samples on Windows
    4. +
  4. Building the samples on Windows with Apache STDCXX
    5. +
  5. Running the samples on Windows
    6. +
+
+ + +
+

Building the samples on Linux

 +

If using the binary distribution the samples are built and installed in + <tuscany_sdo_install_dir>/samples - go directly to Running the samples on Linux.

+
    +
  1. The following environment variables are required: +
      +
    • TUSCANY_SDOCPP=<path to installed Tuscany SDO> +
    • AXIS2C_HOME=<path to axis2c version 0.94>
      • +
    2. + +
  2. Build the source with the following command sequence: +
      +
    • cd <tuscany_sdo_install_dir>/samples
      • +
    • ./configure --prefix=<tuscany_sdo_install_dir>/deploy --enable-static=no
      • +
    • make
      • +
    • make install
      • +
    + NOTE: If you don't provide a --prefix configure option, it will by default install into + /usr/local/tuscany/sdo/samples/misc
    3. +
+
+ + + +
+

Running the samples on Linux

 +
    +
  1. Ensure that <tuscany_sdo_install_dir>/lib is included in the LD_LIBRARY_PATH environment variable +
    2. +
  2. Run the sample with the following commands: +
      +
    • cd <tuscany_sdo_install_dir>/samples/misc/deploy
      • +
    • ./bin/sdo_misc
      • +
    +
    3. +
+
+ +
+

Building the samples on Windows

 +

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

+
    +
  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 or 7 projects under + <tuscany_sdo_install_dir>\samples\ides or via the command-line build file + found at <tuscany_sdo_install_dir>\samples\build.bat + which will build and deploy the samples. +
    4. +
+
+ +
+

Building the samples on Windows with Apache STDCXX

 +

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

+
+ +
+

Running the samples on Windows

 +
    +
  1. Ensure that <tuscany_sdo_install_dir>\bin is included in the PATH environment variable +
    2. +
  2. Run the sample with the following commands: +
      +
    • cd <tuscany_sdo_install_dir>/samples/misc/deploy
      • +
    • bin\sdo_misc
      • +
    +
    3. +
+
+ + +
+

Getting Help

 + +

First place to look is at the Tuscany FAQ at + http://incubator.apache.org/tuscany/faq.html

+ +

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.

+ + +

 

+ +

 

+ +

 

+ + + + + + +
+ +

Thank you for your interest in Tuscany.

-The + Tuscany Development Team +
+
+
+
+ + + -- cgit v1.2.3