contrib/doc/SCAExtension.html - tuscany-sca-cpp - Git at Google


 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 <!--
    Licensed to the Apache Software Foundation (ASF) under one
    or more contributor license agreements.  See the NOTICE file
    distributed with this work for additional information
    regarding copyright ownership.  The ASF licenses this file
    to you under the Apache License, Version 2.0 (the
    "License"); you may not use this file except in compliance
    with the License.  You may obtain a copy of the License at

      http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing,
    software distributed under the License is distributed on an
    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
    KIND, either express or implied.  See the License for the
    specific language governing permissions and limitations
    under the License.
 -->

 <HTML>
 <HEAD>
    <META CONTENT="text/html; charset=iso-8859-1" HTTP-EQUIV="Content-Type">
    <META CONTENT="text/css" HTTP-EQUIV="Content-Style-Type">
    <STYLE MEDIA="all" TYPE="text/css">
 @import url("css/maven-base.css");
 @import url("css/maven-theme.css");
    </STYLE>

     <LINK HREF="css/maven-theme.css" MEDIA="print" REL="stylesheet"
          TYPE="text/css">
    <TITLE>Tuscany SCA Native - SCA Binding Extension</TITLE>
 </HEAD>

 <BODY>
 <DIV ID="bodyColumn">
    <DIV ID="contentBox">
       <DIV CLASS="section">
          <H1>Tuscany SCA Native - SCA Binding Extension</H1>

          <P>This document describes the deployment and use of the SCA
             binding support in the Apache Tuscany SCA Native runtime.
          </P>
          <P>The SCA binding allows components to be invoked via an
             implementation specific protocol. Currently, in the Tuscany SCA binding
             extension, the <A HREF="Axis2CWSExtension.html">Axis2/C Web Service binding extension</A>
             is used to provide the implementaion, so calls use the SOAP protocol
          </P>
          <P>The <A HREF="../samples/HTTPDBigBank/README.html">HTTPDBigBank</A> sample demonstrates the
             use of the SCA binding extension.
          </P>
       </DIV>
       <DIV CLASS="section">
          <H2>Contents</H2>
          <OL>
             <LI><A HREF="#requirements">System Requirements</A></LI>
             <LI><A HREF="#install">Installing the Tuscany SCA Binding Extension..</A>
                 <UL>
                     <LI><A HREF="#linuxbin">..from the binary release on Linux and Mac OS X</A></LI>
                     <LI><A HREF="#linuxsrc">..from the source release on Linux and Mac OS X</A></LI>
                     <LI><A HREF="#winbin">..from the binary release on Windows</A></LI>
                     <LI><A HREF="#winsrc">..from the source release on Windows</A></LI>
                 </UL></LI>
             <LI><A HREF="#help">Getting help</A></LI>
          </OL>
       </DIV>
      <DIV CLASS="section">
          <A NAME="requirements"><H2>System Requirements</H2></A>

          <P>In order to install and use the Tuscany SCA Binding Extension there are some
          extra requirements in addition to the <A HREF="../GettingStarted.html#requirements">Tuscany
          SCA requirements</A>:</P>
          <TABLE CLASS="bodyTable">

             <TBODY>
             <TR CLASS="a">
                <TD><B>Software</B></TD>
                <TD><B>Details</B></TD>
             </TR>
             <TR CLASS="b">
                <TD><A HREF="Axis2CWSExtension.html">Tuscany Axis2/C Web Service binding extension</A></TD>

                <TD>
                   Please follow the installation instructions. The Axis2/C Web Service extension requires
                   <A HREF="http://ws.apache.org/axis2/c">Axis2/C version 0.96</A>.
                </TD>
             </TR>
             </TBODY>
          </TABLE>
       </DIV>

       <DIV CLASS="section">
          <A NAME="install"><H2>Installing the Tuscany SCA Binding Extension</H2></A>
          <A NAME="linuxbin"><H3>Getting the Tuscany SCA Binding Extension working with the binary release on Linux and Mac OS X</H3></A>
           <OL>
               <LI>Ensure the AXIS2C_HOME environment variable is set to the Axis2/C installation</LI>
               <LI>Deploy the Axis2/C Web Services extension by following the <A HREF="Axis2CWSExtension.html#deploy">deployment steps</A></LI>
               <LI>Ensure the Axis2/C Web Service extension and SCA Binding extension libraries are available
                   on the LD_LIBRARY_PATH environment variable on Linux and the DYLD_LIBRARY_PATH environment variable on Mac OS X</LI>
           </OL>
          <A NAME="linuxsrc"><H3>Getting the Tuscany SCA Binding Extension working with the source release on Linux and Mac OS X</H3></A>
           <OL>
               <LI>You will need the Tuscany SCA and SDO libraries - follow the instructions
                   <A HREF="../GettingStarted.html">here</A> to build the SCA libraries and default extensions</LI>
               <LI>The following environment variables are required:
                 <UL>
                   <LI>TUSCANY_SCACPP=&lt;path to built Tuscany SCA&gt;</LI>
                   <LI>TUSCANY_SDOCPP=&lt;path to installed Tuscany SDO&gt;</LI>
                 </UL></LI>
               <LI>Build the SCA Binding source only with the following command sequence:
                   <UL>
                       <LI>cd &lt;tuscany_sca_install_dir&gt;</LI>
                       <LI>./configure --prefix=$TUSCANY_SCACPP --enable-scabinding --enable-cpp=no --enable-wsbinding=no</LI>
                       <LI>make</LI>
                       <LI>make install</LI>
                   </UL>
 	              NOTE: If you don't provide a --prefix configure option, it will by default install into
                   /usr/local/tuscany/sca</LI>
               </OL>

          <A NAME="winbin"><H3>Getting the Tuscany SCA Binding Extension working with the binary release on Windows</H3></A>
           <OL>
               <LI>Ensure the AXIS2C_HOME environment variable is set to the Axis2/C installation</LI>
               <LI>Deploy the Axis2/C Web Services extension by following the <A HREF="Axis2CWSExtension.html#deploy">deployment steps</A></LI>
               <LI>Ensure the Axis2/C Web Services extension and SCA Binding extension libraries are available
                   on the PATH environment variable</LI>
           </OL>
         <A NAME="winsrc"><H3>Getting the Tuscany SCA Binding Extension 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_SCACPP=&lt;path to built Tuscany SCA&gt;
                   <LI>TUSCANY_SDOCPP=&lt;path to installed Tuscany SDO&gt;
                 </UL></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:
                   <UL>
                       <LI>cd &lt;to where you unzipped the source&gt;</LI>
                       <LI>build</LI>
                   </UL>
 	              This will build all the projects and put the required output into the 'deploy' directory<BR/><BR/>
                   Alternatively, open the workspace at &lt;tuscany_sca_install_dir&gt;/projects/tuscany_sca/tuscany_sca.dsw
                   in Visual Studio 6 or at at &lt;tuscany_sca_install_dir&gt;/projectsvc7/tuscany_sca/tuscany_sca.sln
                   in Visual Studio 7.1 - you can build projects individually
                   or build the samples to rebuild all the projects</LI>
           </OL>
       </DIV>

       <DIV CLASS="section">
       </DIV>

       <DIV CLASS="section">
          <A NAME="help"><H2>Getting Help</H2></A>

          <P>First place to look is at the Tuscany FAQ at
          <A HREF="http://incubator.apache.org/tuscany/faq.html"
             TARGET="_blank">http://incubator.apache.org/tuscany/faq.html</A> </P>

          <P>Any problem with this release can be reported to the Tuscany
          <A HREF="http://incubator.apache.org/tuscany/mail-lists.html"
             TARGET="_blank">mailing lists</A> or create a JIRA issue at&nbsp;<A HREF="http://issues.apache.org/jira/browse/Tuscany"
                                                                                 TARGET="_blank">http://issues.apache.org/jira/browse/Tuscany</A>.</P>
       </DIV>
    </DIV>
 </DIV>
 </BODY>

 </HTML>

	<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
	<!--
	Licensed to the Apache Software Foundation (ASF) under one
	or more contributor license agreements. See the NOTICE file
	distributed with this work for additional information
	regarding copyright ownership. The ASF licenses this file
	to you under the Apache License, Version 2.0 (the
	"License"); you may not use this file except in compliance
	with the License. You may obtain a copy of the License at

	http://www.apache.org/licenses/LICENSE-2.0

	Unless required by applicable law or agreed to in writing,
	software distributed under the License is distributed on an
	"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
	KIND, either express or implied. See the License for the
	specific language governing permissions and limitations
	under the License.
	-->

	<HTML>
	<HEAD>
	<META CONTENT="text/html; charset=iso-8859-1" HTTP-EQUIV="Content-Type">
	<META CONTENT="text/css" HTTP-EQUIV="Content-Style-Type">
	<STYLE MEDIA="all" TYPE="text/css">
	@import url("css/maven-base.css");
	@import url("css/maven-theme.css");
	</STYLE>

	<LINK HREF="css/maven-theme.css" MEDIA="print" REL="stylesheet"
	TYPE="text/css">
	<TITLE>Tuscany SCA Native - SCA Binding Extension</TITLE>
	</HEAD>

	<BODY>
	<DIV ID="bodyColumn">
	<DIV ID="contentBox">
	<DIV CLASS="section">
	<H1>Tuscany SCA Native - SCA Binding Extension</H1>

	<P>This document describes the deployment and use of the SCA
	binding support in the Apache Tuscany SCA Native runtime.
	</P>
	<P>The SCA binding allows components to be invoked via an
	implementation specific protocol. Currently, in the Tuscany SCA binding
	extension, the <A HREF="Axis2CWSExtension.html">Axis2/C Web Service binding extension</A>
	is used to provide the implementaion, so calls use the SOAP protocol
	</P>
	<P>The <A HREF="../samples/HTTPDBigBank/README.html">HTTPDBigBank</A> sample demonstrates the
	use of the SCA binding extension.
	</P>
	</DIV>
	<DIV CLASS="section">
	<H2>Contents</H2>
	<OL>
	<LI><A HREF="#requirements">System Requirements</A></LI>
	<LI><A HREF="#install">Installing the Tuscany SCA Binding Extension..</A>
	<UL>
	<LI><A HREF="#linuxbin">..from the binary release on Linux and Mac OS X</A></LI>
	<LI><A HREF="#linuxsrc">..from the source release on Linux and Mac OS X</A></LI>
	<LI><A HREF="#winbin">..from the binary release on Windows</A></LI>
	<LI><A HREF="#winsrc">..from the source release on Windows</A></LI>
	</UL></LI>
	<LI><A HREF="#help">Getting help</A></LI>
	</OL>
	</DIV>
	<DIV CLASS="section">
	<A NAME="requirements"><H2>System Requirements</H2></A>

	<P>In order to install and use the Tuscany SCA Binding Extension there are some
	extra requirements in addition to the <A HREF="../GettingStarted.html#requirements">Tuscany
	SCA requirements</A>:</P>
	<TABLE CLASS="bodyTable">

	<TBODY>
	<TR CLASS="a">
	<TD><B>Software</B></TD>
	<TD><B>Details</B></TD>
	</TR>
	<TR CLASS="b">
	<TD><A HREF="Axis2CWSExtension.html">Tuscany Axis2/C Web Service binding extension</A></TD>

	<TD>
	Please follow the installation instructions. The Axis2/C Web Service extension requires
	<A HREF="http://ws.apache.org/axis2/c">Axis2/C version 0.96</A>.
	</TD>
	</TR>
	</TBODY>
	</TABLE>
	</DIV>

	<DIV CLASS="section">
	<A NAME="install"><H2>Installing the Tuscany SCA Binding Extension</H2></A>
	<A NAME="linuxbin"><H3>Getting the Tuscany SCA Binding Extension working with the binary release on Linux and Mac OS X</H3></A>
	<OL>
	<LI>Ensure the AXIS2C_HOME environment variable is set to the Axis2/C installation</LI>
	<LI>Deploy the Axis2/C Web Services extension by following the <A HREF="Axis2CWSExtension.html#deploy">deployment steps</A></LI>
	<LI>Ensure the Axis2/C Web Service extension and SCA Binding extension libraries are available
	on the LD_LIBRARY_PATH environment variable on Linux and the DYLD_LIBRARY_PATH environment variable on Mac OS X</LI>
	</OL>
	<A NAME="linuxsrc"><H3>Getting the Tuscany SCA Binding Extension working with the source release on Linux and Mac OS X</H3></A>
	<OL>
	<LI>You will need the Tuscany SCA and SDO libraries - follow the instructions
	<A HREF="../GettingStarted.html">here</A> to build the SCA libraries and default extensions</LI>
	<LI>The following environment variables are required:
	<UL>
	<LI>TUSCANY_SCACPP=<path to built Tuscany SCA></LI>
	<LI>TUSCANY_SDOCPP=<path to installed Tuscany SDO></LI>
	</UL></LI>
	<LI>Build the SCA Binding source only with the following command sequence:
	<UL>
	<LI>cd <tuscany_sca_install_dir></LI>
	<LI>./configure --prefix=$TUSCANY_SCACPP --enable-scabinding --enable-cpp=no --enable-wsbinding=no</LI>
	<LI>make</LI>
	<LI>make install</LI>
	</UL>
	NOTE: If you don't provide a --prefix configure option, it will by default install into
	/usr/local/tuscany/sca</LI>
	</OL>

	<A NAME="winbin"><H3>Getting the Tuscany SCA Binding Extension working with the binary release on Windows</H3></A>
	<OL>
	<LI>Ensure the AXIS2C_HOME environment variable is set to the Axis2/C installation</LI>
	<LI>Deploy the Axis2/C Web Services extension by following the <A HREF="Axis2CWSExtension.html#deploy">deployment steps</A></LI>
	<LI>Ensure the Axis2/C Web Services extension and SCA Binding extension libraries are available
	on the PATH environment variable</LI>
	</OL>
	<A NAME="winsrc"><H3>Getting the Tuscany SCA Binding Extension 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_SCACPP=<path to built Tuscany SCA>
	<LI>TUSCANY_SDOCPP=<path to installed Tuscany SDO>
	</UL></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:
	<UL>
	<LI>cd <to where you unzipped the source></LI>
	<LI>build</LI>
	</UL>
	This will build all the projects and put the required output into the 'deploy' directory<BR/><BR/>
	Alternatively, open the workspace at <tuscany_sca_install_dir>/projects/tuscany_sca/tuscany_sca.dsw
	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
	or build the samples to rebuild all the projects</LI>
	</OL>
	</DIV>

	<DIV CLASS="section">
	</DIV>

	<DIV CLASS="section">
	<A NAME="help"><H2>Getting Help</H2></A>

	<P>First place to look is at the Tuscany FAQ at
	<A HREF="http://incubator.apache.org/tuscany/faq.html"
	TARGET="_blank">http://incubator.apache.org/tuscany/faq.html</A> </P>

	<P>Any problem with this release can be reported to the Tuscany
	<A HREF="http://incubator.apache.org/tuscany/mail-lists.html"
	TARGET="_blank">mailing lists</A> or create a JIRA issue at <A HREF="http://issues.apache.org/jira/browse/Tuscany"
	TARGET="_blank">http://issues.apache.org/jira/browse/Tuscany</A>.</P>
	</DIV>
	</DIV>
	</DIV>
	</BODY>

	</HTML>