summaryrefslogtreecommitdiffstats
path: root/site/trunk/site-publish/getting-started.html
diff options
context:
space:
mode:
Diffstat (limited to 'site/trunk/site-publish/getting-started.html')
-rw-r--r--site/trunk/site-publish/getting-started.html213
1 files changed, 213 insertions, 0 deletions
diff --git a/site/trunk/site-publish/getting-started.html b/site/trunk/site-publish/getting-started.html
new file mode 100644
index 0000000000..f5c0e975d4
--- /dev/null
+++ b/site/trunk/site-publish/getting-started.html
@@ -0,0 +1,213 @@
+
+<!--
+
+ 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.
+-->
+
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML>
+ <HEAD>
+ <!-- generateKeywords macro -->
+ <META name="description" content="Apache Tuscany">
+ <META name="keywords" content="apache, apache tuscany, tuscany, service, services, fabric, soa, service oriented architecture, sca, service component architecture, das, sdo, csa, ruby, opensource">
+ <!-- generateKeywords macro end -->
+
+ <LINK type="text/css" rel="stylesheet" href="http://tuscany.apache.org/stylesheets/default.css">
+ <LINK rel="SHORTCUT ICON" href="https://cwiki.apache.org/confluence/display/TUSCANY/$images/favicon.ico">
+ <TITLE>Apache Tuscany : Getting Started</TITLE>
+ <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+
+ <BODY onload="init()">
+ <!-- topNav macro -->
+ <TABLE valign="top" border="0" cellspacing="0" cellpadding="0" width="100%" background="http://tuscany.apache.org/images/TuscanyLogoNEW_Text_120px_bg.jpg">
+ <TR>
+ <TD valing="top" align="left">
+ <A href="https://cwiki.apache.org/confluence/pages/viewpage.action?spaceKey=TUSCANY&title=$siteroot"><IMG src="http://tuscany.apache.org/images/TuscanyLogoNEW_Text_120px_bg.jpg" height="91" width="25" border="0"></A>
+ </TD>
+ <TD>
+ <A href="http://tuscany.apache.org/"><IMG src="http://tuscany.apache.org/images/TuscanyLogo.jpg" border="0"></A>
+ </TD>
+
+ <TD width="100%">
+ &nbsp;
+ </TD>
+
+ <!-- Adds the edit page link to the top banner-->
+ <TD valign="bottom">
+ <DIV style="padding: 2px 10px; margin: 0px;">
+ <A href="https://cwiki.apache.org/confluence/pages/editpage.action?pageId=44794">
+ <IMG src="http://tuscany.apache.org/images/notep_16.gif" height="16" width="16" border="0" align="absmiddle" title="Edit Page"></A>
+ </DIV>
+ </TD>
+
+ </TR>
+ </TABLE>
+ <!-- topNav macro end -->
+
+ <!-- breadCrumbs macro -->
+ <TABLE border="0" cellpadding="2" cellspacing="0" width="100%">
+ <TR class="topBar">
+ <TD align="left" valign="middle" class="topBarDiv" nowrap="true" width="100%">
+ &nbsp;<A href="home.html" title="Apache Tuscany">Apache Tuscany</A>&nbsp;&gt;&nbsp;<A href="home.html" title="Home">Home</A>&nbsp;&gt;&nbsp;<A href="sca-overview.html" title="SCA Overview">SCA Overview</A>&nbsp;&gt;&nbsp;<A href="sca-java.html" title="SCA Java">SCA Java</A>&nbsp;&gt;&nbsp;<A href="sca-java-work-in-progress.html" title="SCA Java Work-In-Progress">SCA Java Work-In-Progress</A>&nbsp;&gt;&nbsp;<A href="" title="Getting Started">Getting Started</A>
+ </TD>
+
+ <TD align="right" valign="middle" class="topBarDiv" align="left" nowrap="true">
+ <A href="http://mail-archives.apache.org/mod_mbox/tuscany-user">User List</A> | <A href="http://mail-archives.apache.org/mod_mbox/tuscany-dev">Dev List</A> | <A href="http://issues.apache.org/jira/browse/Tuscany">Issue Tracker</A>&nbsp;&nbsp;
+ </TD>
+ </TR>
+ </TABLE>
+ <!-- breadCrumbs macro end -->
+
+
+ <TABLE border="0" cellpadding="0" width="100%" bgcolor="#FFFFFF">
+ <TR>
+ <TD align="left" valign="top">
+
+ <!-- pageContent macro -->
+ <DIV id="PageContent">
+
+ <DIV class="pagecontent">
+ <DIV class="wiki-content">
+ <H1><A name="GettingStarted-GettingStartedwithTuscanySCAforJava"></A>Getting Started with Tuscany SCA for Java</H1>
+
+
+<H2><A name="GettingStarted-Overview"></A>Overview</H2>
+
+
+<H2><A name="GettingStarted-Setupthedevelopmentenvironment"></A>Set up the development environment</H2>
+
+<P>1) Repository</P>
+
+<P>Tuscany source code is hosted at Apache subversion repository. If you want to build Tuscany from source, you need to install a subversion client. </P>
+<DIV class="panelMacro"><TABLE class="infoMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="https://cwiki.apache.org/confluence/images/icons/emoticons/information.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B>Where to download the subversion clients?</B><BR>Command line: <A href="http://subversion.tigris.org/" class="external-link" rel="nofollow">http://subversion.tigris.org/</A> (1.4.2)<BR>
+Windows GUI: <A href="http://tortoisesvn.tigris.org/" class="external-link" rel="nofollow">http://tortoisesvn.tigris.org/</A> (1.4.1)</TD></TR></TABLE></DIV>
+<P>2) Build </P>
+<DIV class="panelMacro"><TABLE class="infoMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="https://cwiki.apache.org/confluence/images/icons/emoticons/information.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B>Where to download maven?</B><BR>Maven 2: <A href="http://maven.apache.org/" class="external-link" rel="nofollow">http://maven.apache.org/</A> (2.0.4)</TD></TR></TABLE></DIV>
+<P>3) Development IDE </P>
+<DIV class="panelMacro"><TABLE class="infoMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="https://cwiki.apache.org/confluence/images/icons/emoticons/information.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B>Where to download Eclipse/WTP?</B><BR>Eclipse: <A href="http://www.eclipse.org/" class="external-link" rel="nofollow">http://www.eclipse.org/</A> (3.2.1)<BR>
+Eclipse WTP: <A href="http://www.eclipse.org/webtools/" class="external-link" rel="nofollow">http://www.eclipse.org/webtools/</A> (1.5.2)</TD></TR></TABLE></DIV>
+
+<H2><A name="GettingStarted-Createasimpleprojectfromscratch"></A>Create a simple project from scratch</H2>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+mvn archetype:create -DgroupId=sample -DartifactId=helloworld
+</PRE>
+</DIV></DIV>
+
+<H2><A name="GettingStarted-Configuretheprojectformavenbuild"></A>Configure the project for maven build</H2>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+&lt;project&gt;
+ &lt;modelVersion&gt;4.0.0&lt;/modelVersion&gt;
+ &lt;groupId&gt;org.apache.tuscany.samples.sca&lt;/groupId&gt;
+ &lt;version&gt;1.0-incubator-SNAPSHOT&lt;/version&gt;
+ &lt;artifactId&gt;sample-mortgage&lt;/artifactId&gt;
+ &lt;packaging&gt;jar&lt;/packaging&gt;
+ &lt;name&gt;Tuscany Mortgage Sample&lt;/name&gt;
+ &lt;description&gt;A sample Mortgage application made of several SCA components wired together.&lt;/description&gt;
+
+ &lt;properties&gt;
+ &lt;property name=<SPAN class="code-quote">&quot;tuscanyVersion&quot;</SPAN>&gt;1.0-incubator-SNAPSHOT&lt;/property&gt;
+ &lt;/properties&gt;
+
+ &lt;dependencies&gt;
+ &lt;dependency&gt;
+ &lt;groupId&gt;org.osoa&lt;/groupId&gt;
+ &lt;artifactId&gt;sca-api-r0.95&lt;/artifactId&gt;
+ &lt;version&gt;${tuscanyVersion}&lt;/version&gt;
+ &lt;/dependency&gt;
+ &lt;dependency&gt;
+ &lt;groupId&gt;org.apache.tuscany.sca&lt;/groupId&gt;
+ &lt;artifactId&gt;test&lt;/artifactId&gt;
+ &lt;version&gt;${tuscanyVersion}&lt;/version&gt;
+ &lt;scope&gt;test&lt;/scope&gt;
+ &lt;/dependency&gt;
+&lt;/project&gt;
+</PRE>
+</DIV></DIV>
+
+<H2><A name="GettingStarted-LoadtheprojectintoEclipse"></A>Load the project into Eclipse</H2>
+
+<P>1. Adding M2_REPO classpath variable</P>
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+mvn -Declipse.workspace=&lt;path-to-eclipse-workspace&gt; eclipse:add-maven-repo
+</PRE>
+</DIV></DIV>
+
+<P><SPAN class="image-wrap" style=""><IMG src="getting-started.data/eclipse_m2_repo.jpg" style="border: 0px solid black"></SPAN></P>
+
+<P>2. (Optional) Add maven as an external tool for Eclipse</P>
+
+<P>3. Create Eclispe metadata files</P>
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+mvn -Peclipse eclipse:eclipse
+</PRE>
+</DIV></DIV>
+
+<P>4. Import projects into Eclipse<BR>
+File --&gt; Import ... --&gt; Existing Projects into Workspace</P>
+
+<DIV class="panelMacro"><TABLE class="tipMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B>&quot;Maven integration with Eclipse&quot;</B><BR><A href="http://maven.apache.org/guides/mini/guide-ide-eclipse.html" class="external-link" rel="nofollow">http://maven.apache.org/guides/mini/guide-ide-eclipse.html</A></TD></TR></TABLE></DIV>
+
+<H2><A name="GettingStarted-DevelopasimpleSCAapplication"></A>Develop a simple SCA application</H2>
+
+<P>1. Declare components in the SCDL</P>
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeHeader panelHeader" style="border-bottom-width: 1px;"><B>META-INF/sca/default.scdl</B></DIV><DIV class="codeContent panelContent">
+<PRE class="code-java">
+The SCDL file
+</PRE>
+</DIV></DIV>
+
+<P>2. Implement the components in java</P>
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeHeader panelHeader" style="border-bottom-width: 1px;"><B>CreditCheckImpl.java</B></DIV><DIV class="codeContent panelContent">
+<PRE class="code-java">
+The java file
+</PRE>
+</DIV></DIV>
+
+<H2><A name="GettingStarted-RuntheSCAapplication"></A>Run the SCA application </H2>
+ </DIV>
+ </DIV>
+ </DIV>
+ <!-- pageContent macro end -->
+
+ </TD>
+ </TR>
+ </TABLE>
+
+ <!-- footer macro -->
+ <SCRIPT src="http://www.google-analytics.com/urchin.js" type="text/javascript">
+ </SCRIPT>
+ <SCRIPT type="text/javascript">
+ _uacct = "UA-1174707-5";
+ urchinTracker();
+ </SCRIPT>
+
+ <A href="http://www.statcounter.com/" target="_blank"><IMG src="http://c26.statcounter.com/counter.php?sc_project=2619156&java=0&security=94bd7e7d&invisible=0" alt="website stats" border="0"></A>
+
+ <DIV class="footer">
+ Copyright � 2003-2012, The Apache Software Foundation&nbsp;&nbsp;</BR>
+ Apache Tuscany and the Apache Tuscany project logo are trademarks of The Apache Software Foundation.
+ </DIV>
+ <!-- footer macro end -->
+
+ </BODY>
+</HTML>