200a40b332
git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@1640879 13f79535-47bb-0310-9956-ffa450edef68
726 lines
No EOL
47 KiB
HTML
726 lines
No EOL
47 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
<HTML>
|
|
<HEAD>
|
|
<LINK type="text/css" rel="stylesheet" href="http://incubator.apache.org/tuscany/stylesheets/default.css">
|
|
<LINK rel="SHORTCUT ICON" href="http://cwiki.apache.org/confluence/display/TUSCANY/$images/favicon.ico">
|
|
<TITLE>Getting Started with Tuscany Release 1.0 : Apache Tuscany</TITLE>
|
|
<META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
|
|
|
|
<BODY onload="init()">
|
|
|
|
<TABLE valign="top" border="0" cellspacing="0" cellpadding="0" width="100%" background="http://incubator.apache.org/tuscany/images/TuscanyLogoNEW_Text_120px_bg.jpg">
|
|
<TR>
|
|
<TD valing="top" align="left">
|
|
<A href="http://cwiki.apache.org/confluence/pages/viewpage.action?spaceKey=TUSCANY&title=$siteroot"><IMG src="http://incubator.apache.org/tuscany/images/TuscanyLogoNEW_Text_120px_bg.jpg" height="91" width="25" border="0"></A>
|
|
</TD>
|
|
<TD>
|
|
<A href="http://incubator.apache.org/tuscany/"><IMG src="http://incubator.apache.org/tuscany/images/TuscanyLogo.jpg" border="0"></A>
|
|
</TD>
|
|
|
|
<TD width="100%">
|
|
|
|
</TD>
|
|
<TD align="right">
|
|
<IMG src="http://incubator.apache.org/tuscany/images/apache-incubator-logo.png" border="0">
|
|
</TD>
|
|
|
|
<!-- Adds the edit page link to the top banner-->
|
|
<TD valign="bottom">
|
|
<DIV style="padding: 2px 10px; margin: 0px;">
|
|
<A href="http://cwiki.apache.org/confluence/pages/editpage.action?pageId=67902">
|
|
<IMG src="http://incubator.apache.org/tuscany/images/notep_16.gif" height="16" width="16" border="0" align="absmiddle" title="Edit Page"></A>
|
|
</DIV>
|
|
</TD>
|
|
|
|
</TR>
|
|
</TABLE>
|
|
|
|
<TABLE border="0" cellpadding="2" cellspacing="0" width="100%">
|
|
<TR class="topBar">
|
|
<TD align="left" valign="middle" class="topBarDiv" nowrap="true" width="100%">
|
|
<A href="home.html" title="Apache Tuscany">Apache Tuscany</A> > <A href="home.html" title="Home">Home</A> > <A href="sca-overview.html" title="SCA Overview">SCA Overview</A> > <A href="sca-java.html" title="SCA Java">SCA Java</A> > <A href="" title="Getting Started with Tuscany Release 1.0">Getting Started with Tuscany Release 1.0</A>
|
|
</TD>
|
|
|
|
<TD align="left" valign="middle" class="topBarDiv" nowrap="true">
|
|
<A href="http://mail-archives.apache.org/mod_mbox/ws-tuscany-user">User List</A> | <A href="http://mail-archives.apache.org/mod_mbox/ws-tuscany-dev">Dev List</A> | <A href="http://issues.apache.org/jira/browse/Tuscany">Issue Tracker</A>
|
|
</TD>
|
|
</TR>
|
|
</TABLE>
|
|
|
|
<TABLE border="0" cellpadding="0" width="100%" bgcolor="#FFFFFF">
|
|
<TR>
|
|
<TD align="left" valign="top">
|
|
<DIV id="PageContent">
|
|
|
|
<DIV class="pagecontent">
|
|
<DIV class="wiki-content">
|
|
<H1><A name="GettingStartedwithTuscanyRelease1.0-Ready%2CSet%2CGoGettingstartedwithTuscany"></A>Ready, Set, Go - Getting started with Tuscany</H1>
|
|
|
|
|
|
<H2><A name="GettingStartedwithTuscanyRelease1.0-InstalltheTuscanyDistribution%26nbsp%3B"></A>Install the Tuscany Distribution </H2>
|
|
|
|
<P>The first thing you do is to create a folder on you disk into which you will download the TUSCANY distribution.</P>
|
|
|
|
<P><IMG src="getting-started-with-tuscany-release-10.data/tuscany_folder.png" align="absmiddle" border="0"></P>
|
|
|
|
<P>Next you download the latest release distribution. Launch your browser and enter one of the<BR>
|
|
following URL's.<BR>
|
|
Latest Release - <SPAN class="nobr"><A href="http://cwiki.apache.org/TUSCANY/sca-java-releases.html" title="Visit page outside Confluence" rel="nofollow">http://cwiki.apache.org/TUSCANY/sca-java-releases.html<SUP><IMG class="rendericon" src="http://cwiki.apache.org/confluence/images/icons/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN><BR>
|
|
Download both the <B><EM>bin zip</EM></B> as well as the <B><EM>src zip</EM></B> to the folder that you created on your disk. Once you completed the download you should see the following on your disk.</P>
|
|
|
|
<P><IMG src="getting-started-with-tuscany-release-10.data/release_zips.png" align="absmiddle" border="0"><BR>
|
|
<BR>
|
|
Next you unzip the <B><EM>bin zip</EM></B> in place, you should see the following folder file structure on your disk after unzip is complete.<BR>
|
|
<IMG src="getting-started-with-tuscany-release-10.data/folder_structure.png" align="absmiddle" border="0"></P>
|
|
|
|
<H2><A name="GettingStartedwithTuscanyRelease1.0-SetupEclipseforTuscany"></A>Setup Eclipse for Tuscany</H2>
|
|
|
|
<P>Start Eclipse and create a User Library to contain the TUSCANY runtime jar's as well as their<BR>
|
|
depending jar's.</P>
|
|
|
|
<P>From the menu bar select <B><EM>Window</EM></B> and then <B><EM>Preferences...</EM></B> . The Preferences dialog will appear,<BR>
|
|
in its left navigation tree select <B><EM>Java</EM></B>, followed by <B><EM>Build Path</EM></B>, and followed by <B><EM>User Libraries</EM></B>.<BR>
|
|
Select the <B><EM>New...</EM></B> pushbutton on the right of the New Libraries dialog to create a new user library.</P>
|
|
|
|
<P><IMG src="getting-started-with-tuscany-release-10.data/New_User_Lib.png" align="absmiddle" border="0"></P>
|
|
|
|
<P>The user library created is empty, select the <B><EM>Add JARs...</EM></B> pushbutton on the right to add all the<BR>
|
|
jar's from your Tuscany installation <B><EM>lib folder</EM></B>. When completed all the jar's will appear under the<BR>
|
|
TUSCANY user library.</P>
|
|
|
|
<P><IMG src="getting-started-with-tuscany-release-10.data/Tuscany_User_Lib.png" align="absmiddle" border="0"></P>
|
|
|
|
<P>Since some of you maybe interested in <B><EM>debugging</EM></B> also the Tuscany runtime code we will attach<BR>
|
|
the Tuscany source to the Tuscany runtime jar in the following step. In the User Libraies dialog<BR>
|
|
scroll down until you see the <B><EM>Tuscany runtime jar</EM></B> and select its <B><EM>Source attachment.</EM></B></P>
|
|
|
|
<P><IMG src="getting-started-with-tuscany-release-10.data/source_attachment.png" align="absmiddle" border="0"></P>
|
|
|
|
<P>Select the <B><EM>Edit...</EM></B> pushbutton on the right and in the Edit dialog use the <B><EM>External File...</EM></B> pushbutton<BR>
|
|
to the select the Tuscany <B><EM>src zip</EM></B> that we downloaded earlier.</P>
|
|
|
|
<P><IMG src="getting-started-with-tuscany-release-10.data/source_attachment_config.png" align="absmiddle" border="0"></P>
|
|
|
|
<P>Select <B><EM>OK</EM></B> to complete this and the Preferences dialog, and you are done with the Tuscany setup<BR>
|
|
for Eclipse.</P>
|
|
|
|
<H2><A name="GettingStartedwithTuscanyRelease1.0-Createyour1stCompositeServiceApplication"></A>Create your 1st Composite Service Application</H2>
|
|
|
|
<P>The following shows the composition diagram for the composite service application you are about<BR>
|
|
to create.</P>
|
|
|
|
<P><IMG src="getting-started-with-tuscany-release-10.data/first_composite.png" align="absmiddle" border="0"></P>
|
|
|
|
<P>The composite service application you will create is a composition of four services. The composed<BR>
|
|
service provided is that of an on-line store.<BR>
|
|
There is a Catalog service which you can ask for catalog items, and depending on its currency<BR>
|
|
code property configuration it will provide the item prices in USD or EUR. The Catalog service is not<BR>
|
|
doing the currency conversion itself it references a CurrencyConverter service to do that task. Then<BR>
|
|
there is the ShoppingCart service into which items chosen from the catalog can be added, it is<BR>
|
|
implemented as a REST service. The Catalog is bound using the JSONRPC binding, and the<BR>
|
|
ShoppingCart service is bound using the ATOM binding. Finally there is the Store user facing<BR>
|
|
service that provides the browser based user interface of the store. The Store service makes use of<BR>
|
|
the Catalog and ShoppingCart service using the JSONRPC, and ATOM binding respectively.</P>
|
|
|
|
<H2><A name="GettingStartedwithTuscanyRelease1.0-CreateaJavaProject"></A>Create a Java Project</H2>
|
|
|
|
<P>In this step you create a Java Project in Eclipse to hold the composite service application.<BR>
|
|
Click on the <B><EM>New Java Project</EM></B> button <IMG src="getting-started-with-tuscany-release-10.data/new_java_project.png" align="absmiddle" border="0"> in the toolbar to launch the project creation dialog.<BR>
|
|
Next you enter "store" as the <B><EM>Project name</EM></B>, and for <B><EM>Project Layout</EM></B> select <B><EM>Create separate</EM></B><BR>
|
|
<B><EM>folders for sources and class files.</EM></B><BR>
|
|
<IMG src="getting-started-with-tuscany-release-10.data/new_java_project_dlg.png" align="absmiddle" border="0"><BR>
|
|
<BR>
|
|
<IMG src="getting-started-with-tuscany-release-10.data/project_layout.png" align="absmiddle" border="0"><BR>
|
|
<BR>
|
|
Hit the <B><EM>Next</EM></B> button, and on the following page go to the <B><EM>Libraries</EM></B> tab. Use the <B><EM>Add Library...</EM></B><BR>
|
|
button on the right to add the TUSCANY user library to the project.<BR>
|
|
<BR>
|
|
<IMG src="getting-started-with-tuscany-release-10.data/new_java_project_lib.png" align="absmiddle" border="0"><BR>
|
|
<BR>
|
|
<BR>
|
|
Hit the <B><EM>Finish</EM></B> button to complete the <B><EM>New Java Project</EM></B> dialog to create the "store" java project. <BR>
|
|
<BR>
|
|
<IMG src="getting-started-with-tuscany-release-10.data/new_java_project_folder.png" align="absmiddle" border="0"><BR>
|
|
<BR>
|
|
</P>
|
|
|
|
<H2><A name="GettingStartedwithTuscanyRelease1.0-ConstructServices"></A>Construct Services</H2>
|
|
|
|
<P>First you create two package folders into which later in this step you place service implementations.<BR>
|
|
Select the "store" project and click on the <B><EM>New Java Package</EM></B> button <IMG src="getting-started-with-tuscany-release-10.data/new_java_pkg_btn.png" align="absmiddle" border="0"> in the toolbar to launch<BR>
|
|
the package creation dialog.</P>
|
|
|
|
<P>Next you enter "services" as the package <B><EM>Name</EM></B>, and press the <B><EM>Finish</EM></B> button to complete the<BR>
|
|
dialog.<BR>
|
|
<IMG src="getting-started-with-tuscany-release-10.data/new_java_pkg_dlg.png" align="absmiddle" border="0"><BR>
|
|
<BR>
|
|
Repeat the previous step to create another package named "ufservices". The store project now<BR>
|
|
should look as follows.<BR>
|
|
<BR>
|
|
<IMG src="getting-started-with-tuscany-release-10.data/new_java_pkg_folder.png" align="absmiddle" border="0"><BR>
|
|
<BR>
|
|
In the following you will place in the "services" package the regular services, and in the "ufservices"<BR>
|
|
package the user facing services of the composite service application you create.</P>
|
|
|
|
<H3><A name="GettingStartedwithTuscanyRelease1.0-Catalog"></A><EM>Catalog</EM></H3>
|
|
|
|
<P>In this step you create the Catalog service interface and implementation.<BR>
|
|
Select the "services" package. Next you click on the dropdown arrow next to the <B><EM>New Java Class</EM></B><BR>
|
|
button <IMG src="getting-started-with-tuscany-release-10.data/class_btn.png" align="absmiddle" border="0"> and select the <B><EM>New Java Interface</EM></B> <IMG src="getting-started-with-tuscany-release-10.data/interface_btn.png" align="absmiddle" border="0"> option from the dropdown list. In the dialog<BR>
|
|
enter "Catalog" as the <B><EM>Name</EM></B> of the interface and select the Finish button to complete the dialog.<BR>
|
|
The Java editor will open on the new created Java interface. Replace the content of the editor by<BR>
|
|
<B><EM>copy-paste</EM></B> of the following Java interface code snippet.</P>
|
|
<DIV class="code"><DIV class="codeContent">
|
|
<PRE class="code-java"><SPAN class="code-keyword">package</SPAN> services;
|
|
<SPAN class="code-keyword">import</SPAN> org.osoa.sca.annotations.Remotable;
|
|
@Remotable
|
|
<SPAN class="code-keyword">public</SPAN> <SPAN class="code-keyword">interface</SPAN> Catalog {
|
|
<SPAN class="code-object">String</SPAN>[] get();
|
|
}</PRE>
|
|
</DIV></DIV>
|
|
<P>Select the "services" package again. Select the <B><EM>New Java Class</EM></B> button <IMG src="getting-started-with-tuscany-release-10.data/class_btn.png" align="absmiddle" border="0"> . In the dialog enter<BR>
|
|
"CatalogImpl" as the <B><EM>Name</EM></B> of the class, add "Catalog" as the interface this class implements, and<BR>
|
|
then select <B><EM>Finish</EM></B> to complete the dialog.</P>
|
|
|
|
<P>The Java editor will open on the new created Java class. Replace the content of the editor by<BR>
|
|
<B><EM>copy-paste</EM></B> of the following Java class code snippet.</P>
|
|
<DIV class="code"><DIV class="codeContent">
|
|
<PRE class="code-java"><SPAN class="code-keyword">package</SPAN> services;
|
|
<SPAN class="code-keyword">import</SPAN> java.util.ArrayList;
|
|
<SPAN class="code-keyword">import</SPAN> java.util.List;
|
|
<SPAN class="code-keyword">import</SPAN> org.osoa.sca.annotations.Init;
|
|
<SPAN class="code-keyword">import</SPAN> org.osoa.sca.annotations.Property;
|
|
<SPAN class="code-keyword">import</SPAN> org.osoa.sca.annotations.Reference;
|
|
<SPAN class="code-keyword">public</SPAN> class CatalogImpl <SPAN class="code-keyword">implements</SPAN> Catalog {
|
|
@Property
|
|
<SPAN class="code-keyword">public</SPAN> <SPAN class="code-object">String</SPAN> currencyCode = <SPAN class="code-quote">"USD"</SPAN>;
|
|
@Reference
|
|
<SPAN class="code-keyword">public</SPAN> CurrencyConverter currencyConverter;
|
|
<SPAN class="code-keyword">private</SPAN> List<<SPAN class="code-object">String</SPAN>> catalog = <SPAN class="code-keyword">new</SPAN> ArrayList<<SPAN class="code-object">String</SPAN>>();
|
|
@Init
|
|
<SPAN class="code-keyword">public</SPAN> void init() {
|
|
<SPAN class="code-object">String</SPAN> currencySymbol = currencyConverter.getCurrencySymbol(currencyCode);
|
|
catalog.add(<SPAN class="code-quote">"Apple - "</SPAN> + currencySymbol +
|
|
currencyConverter.getConversion(<SPAN class="code-quote">"USD"</SPAN>, currencyCode, 2.99f));
|
|
catalog.add(<SPAN class="code-quote">"Orange - "</SPAN> + currencySymbol +
|
|
currencyConverter.getConversion(<SPAN class="code-quote">"USD"</SPAN>, currencyCode, 3.55f));
|
|
catalog.add(<SPAN class="code-quote">"Pear - "</SPAN> + currencySymbol +
|
|
currencyConverter.getConversion(<SPAN class="code-quote">"USD"</SPAN>, currencyCode, 1.55f));
|
|
}
|
|
<SPAN class="code-keyword">public</SPAN> <SPAN class="code-object">String</SPAN>[] get() {
|
|
<SPAN class="code-object">String</SPAN>[] catalogArray = <SPAN class="code-keyword">new</SPAN> <SPAN class="code-object">String</SPAN>[catalog.size()];
|
|
catalog.toArray(catalogArray);
|
|
<SPAN class="code-keyword">return</SPAN> catalogArray;
|
|
}
|
|
}</PRE>
|
|
</DIV></DIV>
|
|
<P>After completing these steps the content of the "store" project will look as follows.<BR>
|
|
<IMG src="getting-started-with-tuscany-release-10.data/store_project.png" align="absmiddle" border="0"><BR>
|
|
<BR>
|
|
<B>Note:</B> CatalogImpl is red x'ed because it makes use of the CurrencyConverter interface that we<BR>
|
|
have not implemented yet.<BR>
|
|
</P>
|
|
|
|
<H3><A name="GettingStartedwithTuscanyRelease1.0-CurrencyConverter"></A><EM>CurrencyConverter</EM></H3>
|
|
|
|
<P>In this step you create the CurrencyConverter service interface and implementation.<BR>
|
|
You follow the same steps that you learned previously to create the interface and implementation.<BR>
|
|
First create a Java interface in the "services" package named "CurrencyConverter" and <B><EM>copy-paste</EM></B><BR>
|
|
the following Java interface code snippet into it.<BR>
|
|
</P>
|
|
<DIV class="code"><DIV class="codeContent">
|
|
<PRE class="code-java"><SPAN class="code-keyword">package</SPAN> services;
|
|
<SPAN class="code-keyword">import</SPAN> org.osoa.sca.annotations.Remotable;
|
|
@Remotable
|
|
<SPAN class="code-keyword">public</SPAN> <SPAN class="code-keyword">interface</SPAN> CurrencyConverter {
|
|
<SPAN class="code-keyword">public</SPAN> <SPAN class="code-object">float</SPAN> getConversion(<SPAN class="code-object">String</SPAN> fromCurrenycCode,
|
|
<SPAN class="code-object">String</SPAN> toCurrencyCode, <SPAN class="code-object">float</SPAN> amount);
|
|
<SPAN class="code-keyword">public</SPAN> <SPAN class="code-object">String</SPAN> getCurrencySymbol(<SPAN class="code-object">String</SPAN> currencyCode);
|
|
}</PRE>
|
|
</DIV></DIV>
|
|
<P>Next create a Java class in the "services" package named "CurrencyConverterImpl" and <B><EM>copy-paste</EM></B><BR>
|
|
the following Java class code snippet into it.</P>
|
|
<DIV class="code"><DIV class="codeContent">
|
|
<PRE class="code-java"><SPAN class="code-keyword">package</SPAN> services;
|
|
<SPAN class="code-keyword">public</SPAN> class CurrencyConverterImpl <SPAN class="code-keyword">implements</SPAN> CurrencyConverter {
|
|
<SPAN class="code-keyword">public</SPAN> <SPAN class="code-object">float</SPAN> getConversion(<SPAN class="code-object">String</SPAN> fromCurrencyCode,
|
|
<SPAN class="code-object">String</SPAN> toCurrencyCode, <SPAN class="code-object">float</SPAN> amount) {
|
|
<SPAN class="code-keyword">if</SPAN> (toCurrencyCode.equals(<SPAN class="code-quote">"USD"</SPAN>))
|
|
<SPAN class="code-keyword">return</SPAN> amount;
|
|
<SPAN class="code-keyword">else</SPAN> <SPAN class="code-keyword">if</SPAN> (toCurrencyCode.equals(<SPAN class="code-quote">"EUR"</SPAN>))
|
|
<SPAN class="code-keyword">return</SPAN> amount*0.7256f;
|
|
<SPAN class="code-keyword">return</SPAN> 0;
|
|
}
|
|
<SPAN class="code-keyword">public</SPAN> <SPAN class="code-object">String</SPAN> getCurrencySymbol(<SPAN class="code-object">String</SPAN> currencyCode) {
|
|
<SPAN class="code-keyword">if</SPAN> (currencyCode.equals(<SPAN class="code-quote">"USD"</SPAN>))
|
|
<SPAN class="code-keyword">return</SPAN> <SPAN class="code-quote">"$"</SPAN>;
|
|
<SPAN class="code-keyword">else</SPAN>
|
|
<SPAN class="code-keyword">if</SPAN> (currencyCode.equals(<SPAN class="code-quote">"EUR"</SPAN>))
|
|
<SPAN class="code-keyword">return</SPAN> <SPAN class="code-quote">"€"</SPAN>;
|
|
<SPAN class="code-keyword">return</SPAN> <SPAN class="code-quote">"?"</SPAN>;
|
|
}
|
|
}</PRE>
|
|
</DIV></DIV>
|
|
<P>After completing these steps the content of the "store" project will look as follows.</P>
|
|
|
|
<P><IMG src="getting-started-with-tuscany-release-10.data/store_project_1.png" align="absmiddle" border="0"></P>
|
|
|
|
<H3><A name="GettingStartedwithTuscanyRelease1.0-ShoppingCart"></A><EM>ShoppingCart</EM></H3>
|
|
|
|
<P>In this step you create the ShoppingCart service implementation.</P>
|
|
|
|
<P>You follow the same steps that you learned previously to create the implementation.</P>
|
|
|
|
<P>Create a Java class in the "services" package named "ShoppingCartImpl" and <B><EM>copy-paste</EM></B> the<BR>
|
|
following Java class code snippet into it.</P>
|
|
<DIV class="code"><DIV class="codeContent">
|
|
<PRE class="code-java"><SPAN class="code-keyword">package</SPAN> services;
|
|
<SPAN class="code-keyword">import</SPAN> java.util.Date;
|
|
<SPAN class="code-keyword">import</SPAN> java.util.HashMap;
|
|
<SPAN class="code-keyword">import</SPAN> java.util.Map;
|
|
<SPAN class="code-keyword">import</SPAN> java.util.UUID;
|
|
<SPAN class="code-keyword">import</SPAN> org.apache.tuscany.sca.binding.feed.collection.Collection;
|
|
<SPAN class="code-keyword">import</SPAN> org.apache.tuscany.sca.binding.feed.collection.NotFoundException;
|
|
<SPAN class="code-keyword">import</SPAN> com.sun.syndication.feed.atom.Content;
|
|
<SPAN class="code-keyword">import</SPAN> com.sun.syndication.feed.atom.Entry;
|
|
<SPAN class="code-keyword">import</SPAN> com.sun.syndication.feed.atom.Feed;
|
|
<SPAN class="code-keyword">import</SPAN> com.sun.syndication.feed.atom.Link;
|
|
<SPAN class="code-keyword">public</SPAN> class ShoppingCartImpl <SPAN class="code-keyword">implements</SPAN> Collection {
|
|
<SPAN class="code-comment">// needs to change to instance <SPAN class="code-keyword">var</SPAN> once conversation scope works
|
|
</SPAN> <SPAN class="code-keyword">private</SPAN> <SPAN class="code-keyword">static</SPAN> Map<<SPAN class="code-object">String</SPAN>, Entry> cart = <SPAN class="code-keyword">new</SPAN> HashMap<<SPAN class="code-object">String</SPAN>, Entry>();
|
|
<SPAN class="code-keyword">public</SPAN> Feed getFeed() {
|
|
Feed feed = <SPAN class="code-keyword">new</SPAN> Feed();
|
|
feed.setTitle(<SPAN class="code-quote">"shopping cart"</SPAN>);
|
|
Content subtitle = <SPAN class="code-keyword">new</SPAN> Content();
|
|
subtitle.setValue(<SPAN class="code-quote">"Total : "</SPAN> + getTotal());
|
|
feed.setSubtitle(subtitle);
|
|
feed.getEntries().addAll(cart.values());
|
|
<SPAN class="code-keyword">return</SPAN> feed;
|
|
}
|
|
<SPAN class="code-keyword">public</SPAN> Entry get(<SPAN class="code-object">String</SPAN> id) <SPAN class="code-keyword">throws</SPAN> NotFoundException {
|
|
<SPAN class="code-keyword">return</SPAN> cart.get(id);
|
|
}
|
|
<SPAN class="code-keyword">public</SPAN> Entry post(Entry entry) {
|
|
<SPAN class="code-object">String</SPAN> id = <SPAN class="code-quote">"cart-"</SPAN> + UUID.randomUUID().toString();
|
|
entry.setId(id);
|
|
Link link = <SPAN class="code-keyword">new</SPAN> Link();
|
|
link.setRel(<SPAN class="code-quote">"edit"</SPAN>);
|
|
link.setHref("" + id);
|
|
entry.getOtherLinks().add(link);
|
|
link = <SPAN class="code-keyword">new</SPAN> Link();
|
|
link.setRel(<SPAN class="code-quote">"alternate"</SPAN>);
|
|
link.setHref("" + id);
|
|
entry.getAlternateLinks().add(link);
|
|
entry.setCreated(<SPAN class="code-keyword">new</SPAN> Date());
|
|
cart.put(id, entry);
|
|
<SPAN class="code-keyword">return</SPAN> entry;
|
|
}
|
|
<SPAN class="code-keyword">public</SPAN> Entry put(<SPAN class="code-object">String</SPAN> id, Entry entry) <SPAN class="code-keyword">throws</SPAN> NotFoundException {
|
|
entry.setUpdated(<SPAN class="code-keyword">new</SPAN> Date());
|
|
cart.put(id, entry);
|
|
<SPAN class="code-keyword">return</SPAN> entry;
|
|
}
|
|
<SPAN class="code-keyword">public</SPAN> void delete(<SPAN class="code-object">String</SPAN> id) <SPAN class="code-keyword">throws</SPAN> NotFoundException {
|
|
<SPAN class="code-keyword">if</SPAN> (id.equals(""))
|
|
cart.clear();
|
|
<SPAN class="code-keyword">else</SPAN>
|
|
cart.remove(id);
|
|
} <SPAN class="code-keyword">private</SPAN> <SPAN class="code-object">String</SPAN> getTotal() {
|
|
<SPAN class="code-object">float</SPAN> total = 0;
|
|
<SPAN class="code-object">String</SPAN> symbol = "";
|
|
<SPAN class="code-keyword">if</SPAN> (!cart.isEmpty()) {
|
|
Entry entry = cart.values().iterator().next();
|
|
<SPAN class="code-object">String</SPAN> item = ((Content)entry.getContents().get(0)).getValue();
|
|
symbol = item.substring(item.indexOf(<SPAN class="code-quote">"-"</SPAN>)+2, item.indexOf(<SPAN class="code-quote">"-"</SPAN>)+3);
|
|
}
|
|
<SPAN class="code-keyword">for</SPAN> (Entry entry : cart.values()) {
|
|
<SPAN class="code-object">String</SPAN> item = ((Content)entry.getContents().get(0)).getValue();
|
|
total += <SPAN class="code-object">Float</SPAN>.valueOf(item.substring(item.indexOf(<SPAN class="code-quote">"-"</SPAN>)+3));
|
|
}
|
|
<SPAN class="code-keyword">return</SPAN> symbol + <SPAN class="code-object">String</SPAN>.valueOf(total);
|
|
}
|
|
}</PRE>
|
|
</DIV></DIV>
|
|
<P><B>Note:</B> Since the Tuscany conversational support is not ready yet the cart is realized through a hack.<BR>
|
|
The cart field is defined as static.</P>
|
|
|
|
<P>After completing these steps the content of the "store" project will look as follows.</P>
|
|
|
|
<P><IMG src="getting-started-with-tuscany-release-10.data/store_project_2.png" align="absmiddle" border="0"><BR>
|
|
</P>
|
|
|
|
<H3><A name="GettingStartedwithTuscanyRelease1.0-%7B%7DStore%7B%7D"></A><B><EM>Store</EM></B></H3>
|
|
|
|
<P>In this step you create the user facing Store service that will run in a Web browser and provide the<BR>
|
|
user interface to the other services you created.</P>
|
|
|
|
<P>Select the "ufservices" package. <B><EM>Right click</EM></B> to get the context menu, select <B><EM>New</EM></B>, and then <B><EM>File</EM></B>. In<BR>
|
|
the <B><EM>New File</EM></B> dialog enter "store.html" for the <B><EM>File name</EM></B>, and then select <B><EM>Finish</EM></B> to complete the<BR>
|
|
dialog.</P>
|
|
|
|
<P>The Text editor will open on the new created html file. Replace the content of the editor by <B><EM>copy-paste</EM></B><BR>
|
|
of the following html snippet.</P>
|
|
<DIV class="code"><DIV class="codeContent">
|
|
<PRE class="code-java"><html>
|
|
<head>
|
|
<title>Store</title>
|
|
<script type=<SPAN class="code-quote">"text/javascript"</SPAN> src=<SPAN class="code-quote">"binding-atom.js"</SPAN>></script>
|
|
<script type=<SPAN class="code-quote">"text/javascript"</SPAN> src=<SPAN class="code-quote">"binding-jsonrpc.js"</SPAN>></script>
|
|
<script language=<SPAN class="code-quote">"JavaScript"</SPAN>>
|
|
<SPAN class="code-comment">//Reference
|
|
</SPAN> catalog = (<SPAN class="code-keyword">new</SPAN> JSONRpcClient(<SPAN class="code-quote">"../Catalog"</SPAN>)).Catalog;
|
|
<SPAN class="code-comment">//Reference
|
|
</SPAN> shoppingCart = <SPAN class="code-keyword">new</SPAN> AtomClient(<SPAN class="code-quote">"../ShoppingCart"</SPAN>);
|
|
function catalog_getResponse(items) {
|
|
<SPAN class="code-keyword">var</SPAN> catalog = "";
|
|
<SPAN class="code-keyword">for</SPAN> (<SPAN class="code-keyword">var</SPAN> i=0; i<items.length; i++)
|
|
catalog += '<input name=<SPAN class="code-quote">"items"</SPAN> type=<SPAN class="code-quote">"checkbox"</SPAN> value="' +
|
|
items[i] + '">' + items[i]+ ' <br>';
|
|
document.getElementById('catalog').innerHTML=catalog;
|
|
}
|
|
function shoppingCart_getResponse(feed) {
|
|
<SPAN class="code-keyword">if</SPAN> (feed != <SPAN class="code-keyword">null</SPAN>) {
|
|
<SPAN class="code-keyword">var</SPAN> entries = feed.getElementsByTagName(<SPAN class="code-quote">"entry"</SPAN>);
|
|
<SPAN class="code-keyword">var</SPAN> list = "";
|
|
<SPAN class="code-keyword">for</SPAN> (<SPAN class="code-keyword">var</SPAN> i=0; i<entries.length; i++) {
|
|
<SPAN class="code-keyword">var</SPAN> item =
|
|
entries[i].getElementsByTagName(<SPAN class="code-quote">"content"</SPAN>)[0].firstChild.nodeValue;
|
|
list += item + ' <br>';
|
|
}
|
|
document.getElementById(<SPAN class="code-quote">"shoppingCart"</SPAN>).innerHTML = list;
|
|
<SPAN class="code-keyword">if</SPAN> (list != "")
|
|
document.getElementById('total').innerHTML =
|
|
feed.getElementsByTagName(<SPAN class="code-quote">"subtitle"</SPAN>)[0].firstChild.nodeValue;
|
|
}
|
|
}
|
|
function shoppingCart_postResponse(entry) {
|
|
shoppingCart.get("", shoppingCart_getResponse);
|
|
}
|
|
function addToCart() {
|
|
<SPAN class="code-keyword">var</SPAN> items = document.catalogForm.items;
|
|
<SPAN class="code-keyword">var</SPAN> j = 0;
|
|
<SPAN class="code-keyword">for</SPAN> (<SPAN class="code-keyword">var</SPAN> i=0; i<items.length; i++)
|
|
<SPAN class="code-keyword">if</SPAN> (items[i].checked) {
|
|
<SPAN class="code-keyword">var</SPAN> entry = '<entry xmlns=<SPAN class="code-quote">"http:<SPAN class="code-comment">//www.w3.org/2005/Atom"</SPAN>>' +
|
|
</SPAN> '<title>cart-item</title>' +
|
|
'<content type=<SPAN class="code-quote">"text"</SPAN>>'+items[i].value+'</content>' +
|
|
'</entry>';
|
|
shoppingCart.post(entry, shoppingCart_postResponse);
|
|
items[i].checked = <SPAN class="code-keyword">false</SPAN>;
|
|
}
|
|
}
|
|
function checkoutCart() {
|
|
document.getElementById('store').innerHTML='<h2>' +
|
|
'Thanks <SPAN class="code-keyword">for</SPAN> Shopping With Us!</h2>'+
|
|
'<h2>Your Order</h2>'+
|
|
'<form name=<SPAN class="code-quote">"orderForm"</SPAN> action=<SPAN class="code-quote">"/ufs/store.html"</SPAN>>'+
|
|
document.getElementById('shoppingCart').innerHTML+
|
|
'<br>'+
|
|
document.getElementById('total').innerHTML+
|
|
'<br>'+
|
|
'<br>'+
|
|
'<input type=<SPAN class="code-quote">"submit"</SPAN> value=<SPAN class="code-quote">"Continue Shopping"</SPAN>>'+
|
|
'</form>';
|
|
shoppingCart.delete("", <SPAN class="code-keyword">null</SPAN>);
|
|
}
|
|
function deleteCart() {
|
|
shoppingCart.delete("", <SPAN class="code-keyword">null</SPAN>);
|
|
document.getElementById('shoppingCart').innerHTML = "";
|
|
document.getElementById('total').innerHTML = "";
|
|
}
|
|
window.onload = function() {
|
|
catalog.get(catalog_getResponse);
|
|
shoppingCart.get("", shoppingCart_getResponse);
|
|
}
|
|
</script>
|
|
<link rel=<SPAN class="code-quote">"stylesheet"</SPAN> type=<SPAN class="code-quote">"text/css"</SPAN> href=<SPAN class="code-quote">"style.css"</SPAN> />
|
|
</head>
|
|
<body>
|
|
<h1>Store</h1>
|
|
<div id=<SPAN class="code-quote">"store"</SPAN>>
|
|
<h2>Catalog</h2>
|
|
<form name=<SPAN class="code-quote">"catalogForm"</SPAN>>
|
|
<div id=<SPAN class="code-quote">"catalog"</SPAN> ></div>
|
|
<br>
|
|
<input type=<SPAN class="code-quote">"button"</SPAN> onClick=<SPAN class="code-quote">"addToCart()"</SPAN> value=<SPAN class="code-quote">"Add to Cart"</SPAN>>
|
|
</form>
|
|
<br>
|
|
<h2>Your Shopping Cart</h2>
|
|
<form name=<SPAN class="code-quote">"shoppingCartForm"</SPAN>>
|
|
<div id=<SPAN class="code-quote">"shoppingCart"</SPAN>></div>
|
|
<br>
|
|
<div id=<SPAN class="code-quote">"total"</SPAN>></div>
|
|
<br>
|
|
<input type=<SPAN class="code-quote">"button"</SPAN> onClick=<SPAN class="code-quote">"checkoutCart()"</SPAN> value=<SPAN class="code-quote">"Checkout"</SPAN>>
|
|
<input type=<SPAN class="code-quote">"button"</SPAN> onClick=<SPAN class="code-quote">"deleteCart()"</SPAN> value=<SPAN class="code-quote">"Empty"</SPAN>>
|
|
<a href=<SPAN class="code-quote">"../ShoppingCart/"</SPAN>>
|
|
<img src=<SPAN class="code-quote">"http:<SPAN class="code-comment">//projects.apache.org/images/blue-icon.png"</SPAN> border=<SPAN class="code-quote">"0"</SPAN>>
|
|
</SPAN> </a>
|
|
</form>
|
|
</div>
|
|
</body>
|
|
</html></PRE>
|
|
</DIV></DIV>
|
|
<P>Next select the "ufservices" package again. <B><EM>Right click</EM></B> to get the context menu, select <B><EM>New</EM></B>, and<BR>
|
|
then <B><EM>File</EM></B>. In the <B><EM>New File</EM></B> dialog enter "binding-jsonrpc.js" for the <B><EM>File name</EM></B>, and then select<BR>
|
|
<B><EM>Finish</EM></B> to complete the dialog.</P>
|
|
|
|
<P>The Text editor will open on the new created javascript file. Replace the content of the editor by<BR>
|
|
<B><EM>copy-paste</EM></B> of the javascript snippet you find here:</P>
|
|
|
|
<P><SPAN class="nobr"><A href="http://svn.apache.org/repos/asf/incubator/tuscany/java/sca/modules/binding-jsonrpc/src/main/resources/org/apache/tuscany/sca/binding/jsonrpc/jsonrpc.js" title="Visit page outside Confluence" rel="nofollow">http://svn.apache.org/repos/asf/incubator/tuscany/java/sca/modules/binding-jsonrpc/src/main/resources/org/apache/tuscany/sca/binding/jsonrpc/jsonrpc.js<SUP><IMG class="rendericon" src="http://cwiki.apache.org/confluence/images/icons/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN></P>
|
|
|
|
<P>Next select the "ufservices" package again. <B><EM>Right click</EM></B> to get the context menu, select <B><EM>New</EM></B>, and<BR>
|
|
then <B><EM>File</EM></B>. In the <B><EM>New File</EM></B> dialog enter "binding-atom.js" for the <B><EM>File name</EM></B>, and then select <B><EM>Finish</EM></B><BR>
|
|
to complete the dialog.</P>
|
|
|
|
<P>The Text editor will open on the new created javascript file. Replace the content of the editor by<BR>
|
|
<B><EM>copy-paste</EM></B> of the following javascript snippet.</P>
|
|
<DIV class="code"><DIV class="codeContent">
|
|
<PRE class="code-java">function AtomClient(uri) {
|
|
<SPAN class="code-keyword">this</SPAN>.uri=uri;
|
|
<SPAN class="code-keyword">this</SPAN>.get = function(id, responseFunction) {
|
|
<SPAN class="code-keyword">var</SPAN> xhr = <SPAN class="code-keyword">this</SPAN>.createXMLHttpRequest();
|
|
xhr.onreadystatechange = function() {
|
|
<SPAN class="code-keyword">if</SPAN> (xhr.readyState == 4) {
|
|
<SPAN class="code-keyword">if</SPAN> (xhr.status == 200) {
|
|
<SPAN class="code-keyword">if</SPAN> (responseFunction != <SPAN class="code-keyword">null</SPAN>)
|
|
responseFunction(xhr.responseXML);
|
|
} <SPAN class="code-keyword">else</SPAN> {
|
|
alert(<SPAN class="code-quote">"get - Error getting data from the server"</SPAN>);
|
|
}
|
|
}
|
|
}
|
|
xhr.open(<SPAN class="code-quote">"GET"</SPAN>, uri + id, <SPAN class="code-keyword">true</SPAN>);
|
|
xhr.send(<SPAN class="code-keyword">null</SPAN>);
|
|
}
|
|
<SPAN class="code-keyword">this</SPAN>.post = function (entry, responseFunction) {
|
|
<SPAN class="code-keyword">var</SPAN> xhr = <SPAN class="code-keyword">this</SPAN>.createXMLHttpRequest();
|
|
xhr.onreadystatechange = function() {
|
|
<SPAN class="code-keyword">if</SPAN> (xhr.readyState == 4) {
|
|
<SPAN class="code-keyword">if</SPAN> (xhr.status == 201) {
|
|
<SPAN class="code-keyword">if</SPAN> (responseFunction != <SPAN class="code-keyword">null</SPAN>)
|
|
responseFunction(xhr.responseXML);
|
|
} <SPAN class="code-keyword">else</SPAN> {
|
|
alert(<SPAN class="code-quote">"post - Error getting data from the server"</SPAN>);
|
|
}
|
|
}
|
|
}
|
|
xhr.open(<SPAN class="code-quote">"POST"</SPAN>, uri, <SPAN class="code-keyword">true</SPAN>);
|
|
xhr.setRequestHeader(<SPAN class="code-quote">"Content-Type"</SPAN>, <SPAN class="code-quote">"application/atom+xml"</SPAN>);
|
|
xhr.send(entry);
|
|
}
|
|
<SPAN class="code-keyword">this</SPAN>.put = function (id, entry, responseFunction) {
|
|
<SPAN class="code-keyword">var</SPAN> xhr = <SPAN class="code-keyword">this</SPAN>.createXMLHttpRequest();
|
|
xhr.onreadystatechange = function() {
|
|
<SPAN class="code-keyword">if</SPAN> (xhr.readyState == 4) {
|
|
<SPAN class="code-keyword">if</SPAN> (xhr.status == 200) {
|
|
<SPAN class="code-keyword">if</SPAN> (responseFunction != <SPAN class="code-keyword">null</SPAN>)
|
|
responseFunction(xhr.responseXML);
|
|
} <SPAN class="code-keyword">else</SPAN> {
|
|
alert(<SPAN class="code-quote">"put - Error getting data from the server"</SPAN>);
|
|
}
|
|
}
|
|
}
|
|
xhr.open(<SPAN class="code-quote">"PUT"</SPAN>, uri + id, <SPAN class="code-keyword">true</SPAN>);
|
|
xhr.setRequestHeader(<SPAN class="code-quote">"Content-Type"</SPAN>, <SPAN class="code-quote">"application/atom+xml"</SPAN>);
|
|
xhr.send(entry);
|
|
}
|
|
<SPAN class="code-keyword">this</SPAN>.delete = function (id, responseFunction) {
|
|
<SPAN class="code-keyword">var</SPAN> xhr = <SPAN class="code-keyword">this</SPAN>.createXMLHttpRequest();
|
|
xhr.onreadystatechange = function() {
|
|
<SPAN class="code-keyword">if</SPAN> (xhr.readyState == 4) {
|
|
<SPAN class="code-keyword">if</SPAN> (xhr.status == 200) {
|
|
<SPAN class="code-keyword">if</SPAN> (responseFunction != <SPAN class="code-keyword">null</SPAN>) responseFunction();
|
|
} <SPAN class="code-keyword">else</SPAN> {
|
|
alert(<SPAN class="code-quote">"delete - Error getting data from the server"</SPAN>);
|
|
}
|
|
}
|
|
}
|
|
xhr.open(<SPAN class="code-quote">"DELETE"</SPAN>, uri + id, <SPAN class="code-keyword">true</SPAN>);
|
|
xhr.send(<SPAN class="code-keyword">null</SPAN>);
|
|
}
|
|
<SPAN class="code-keyword">this</SPAN>.createXMLHttpRequest = function () {
|
|
<SPAN class="code-keyword">try</SPAN> {<SPAN class="code-keyword">return</SPAN> <SPAN class="code-keyword">new</SPAN> XMLHttpRequest();} <SPAN class="code-keyword">catch</SPAN>(e) {}
|
|
<SPAN class="code-keyword">try</SPAN> {<SPAN class="code-keyword">return</SPAN> <SPAN class="code-keyword">new</SPAN> ActiveXObject(<SPAN class="code-quote">"Msxml2.XMLHTTP"</SPAN>);} <SPAN class="code-keyword">catch</SPAN>(e) {}
|
|
<SPAN class="code-keyword">try</SPAN> {<SPAN class="code-keyword">return</SPAN> <SPAN class="code-keyword">new</SPAN> ActiveXObject(<SPAN class="code-quote">"Microsoft.XMLHTTP"</SPAN>);} <SPAN class="code-keyword">catch</SPAN>(e) {}
|
|
alert(<SPAN class="code-quote">"XML http request not supported"</SPAN>);
|
|
<SPAN class="code-keyword">return</SPAN> <SPAN class="code-keyword">null</SPAN>;
|
|
}
|
|
}</PRE>
|
|
</DIV></DIV>
|
|
<P><B>Note:</B> That we have to have the bindig-jsonrpc.js, and binding-atom.js local in our project is only<BR>
|
|
temporary, so this step will be removed in the future.</P>
|
|
|
|
<P>After completing these steps the content of the "store" project will look as follows.</P>
|
|
|
|
<P> <IMG src="getting-started-with-tuscany-release-10.data/store_project_3.png" align="absmiddle" border="0"></P>
|
|
|
|
<H2><A name="GettingStartedwithTuscanyRelease1.0-ComposeServices"></A>Compose Services</H2>
|
|
|
|
<P>Now that you have all the required service implementations you compose them together to provide<BR>
|
|
the store composite service. The composition is stored in a .composite file.</P>
|
|
|
|
<P>Select the "src" folder of the "store" project. <B><EM>Right click</EM></B> to get the context menu, select <B><EM>New</EM></B>, and<BR>
|
|
then <B><EM>File</EM></B>. In the <B><EM>New File</EM></B> dialog enter "store.composite" for the <B><EM>File name</EM></B>, and then select <B><EM>Finish</EM></B><BR>
|
|
to complete the dialog.</P>
|
|
|
|
<P>The Text editor will open on the new created composite file. Replace the content of the editor by<BR>
|
|
<B><EM>copy-paste</EM></B> of the following composite snippet.</P>
|
|
<DIV class="code"><DIV class="codeContent">
|
|
<PRE class="code-java"><?xml version=<SPAN class="code-quote">"1.0"</SPAN> encoding=<SPAN class="code-quote">"UTF-8"</SPAN>?>
|
|
<composite xmlns=<SPAN class="code-quote">"http:<SPAN class="code-comment">//www.osoa.org/xmlns/sca/1.0"</SPAN>
|
|
</SPAN> xmlns:t=<SPAN class="code-quote">"http:<SPAN class="code-comment">//tuscany.apache.org/xmlns/sca/1.0"</SPAN>
|
|
</SPAN> xmlns:s=<SPAN class="code-quote">"http:<SPAN class="code-comment">//store"</SPAN>
|
|
</SPAN> name=<SPAN class="code-quote">"store"</SPAN>>
|
|
<component name=<SPAN class="code-quote">"ufs"</SPAN>>
|
|
<t:implementation.resource location=<SPAN class="code-quote">"ufservices"</SPAN>/>
|
|
<service name=<SPAN class="code-quote">"Resource"</SPAN>>
|
|
<t:binding.http/>
|
|
</service>
|
|
</component>
|
|
<component name=<SPAN class="code-quote">"Catalog"</SPAN>>
|
|
<implementation.java class=<SPAN class="code-quote">"services.CatalogImpl"</SPAN>/>
|
|
<property name=<SPAN class="code-quote">"currencyCode"</SPAN>>USD</property>
|
|
<service name=<SPAN class="code-quote">"Catalog"</SPAN>>
|
|
<t:binding.jsonrpc/>
|
|
</service>
|
|
<reference name=<SPAN class="code-quote">"currencyConverter"</SPAN> target=<SPAN class="code-quote">"CurrencyConverter"</SPAN>/>
|
|
</component>
|
|
<component name=<SPAN class="code-quote">"ShoppingCart"</SPAN>>
|
|
<implementation.java class=<SPAN class="code-quote">"services.ShoppingCartImpl"</SPAN>/>
|
|
<service name=<SPAN class="code-quote">"Collection"</SPAN>>
|
|
<t:binding.atom/>
|
|
</service>
|
|
</component>
|
|
<component name=<SPAN class="code-quote">"CurrencyConverter"</SPAN>>
|
|
<implementation.java class=<SPAN class="code-quote">"services.CurrencyConverterImpl"</SPAN>/>
|
|
</component>
|
|
</composite></PRE>
|
|
</DIV></DIV>
|
|
<P>After completing these steps the content of the "store" project will look as follows.</P>
|
|
|
|
<P><IMG src="getting-started-with-tuscany-release-10.data/store_project_4.png" align="absmiddle" border="0"><BR>
|
|
</P>
|
|
|
|
<H2><A name="GettingStartedwithTuscanyRelease1.0-LaunchServices"></A>Launch Services</H2>
|
|
|
|
<P>In this step you create the code to launch the Tuscany runtime with the new store composite<BR>
|
|
service you created.</P>
|
|
|
|
<P>Select the "store" project and click on the <B><EM>New Java Package</EM></B> button <IMG src="getting-started-with-tuscany-release-10.data/new_java_pkg_btn.png" align="absmiddle" border="0"> in the toolbar to start the</P>
|
|
|
|
<P>package creation dialog. Use the dialog to create a new package named "launch". <BR>
|
|
Select the "launch" package. Select the <B><EM>New Java Class</EM></B> button <IMG src="getting-started-with-tuscany-release-10.data/class_btn.png" align="absmiddle" border="0"> . In the dialog enter "Launch"<BR>
|
|
as the <B><EM>Name</EM></B> of the class, check the <B><EM>checkbox for creating a main method stub</EM></B>, and then select<BR>
|
|
<B><EM>Finish</EM></B> to complete the dialog.</P>
|
|
|
|
<P>The Java editor will open on the new created Java class. Replace the content of the editor by<BR>
|
|
<B><EM>copy-paste</EM></B> of the following Java class code snippet.</P>
|
|
<DIV class="code"><DIV class="codeContent">
|
|
<PRE class="code-java"><SPAN class="code-keyword">package</SPAN> launch;
|
|
<SPAN class="code-keyword">import</SPAN> org.apache.tuscany.sca.host.embedded.SCADomain;
|
|
<SPAN class="code-keyword">public</SPAN> class Launch {
|
|
<SPAN class="code-keyword">public</SPAN> <SPAN class="code-keyword">static</SPAN> void main(<SPAN class="code-object">String</SPAN>[] args) <SPAN class="code-keyword">throws</SPAN> Exception {
|
|
<SPAN class="code-object">System</SPAN>.out.println(<SPAN class="code-quote">"Starting ..."</SPAN>);
|
|
SCADomain scaDomain = SCADomain.newInstance(<SPAN class="code-quote">"store.composite"</SPAN>);
|
|
<SPAN class="code-object">System</SPAN>.out.println(<SPAN class="code-quote">"store.composite ready <SPAN class="code-keyword">for</SPAN> big business !!!"</SPAN>);
|
|
<SPAN class="code-object">System</SPAN>.out.println();
|
|
<SPAN class="code-object">System</SPAN>.in.read();
|
|
scaDomain.close();
|
|
}
|
|
}</PRE>
|
|
</DIV></DIV>
|
|
<P> After completing these steps the content of the "store" project will look as follows.</P>
|
|
|
|
<P><IMG src="getting-started-with-tuscany-release-10.data/store_project_5.png" align="absmiddle" border="0"><BR>
|
|
Congratulations you completed your 1st composite service applications, now its time to take it into<BR>
|
|
action.</P>
|
|
|
|
<H2><A name="GettingStartedwithTuscanyRelease1.0-UseServices"></A>Use Services</H2>
|
|
|
|
<P>In this step you launch and use the store composite service application you created.</P>
|
|
|
|
<P>First select the "Launch" class in the "launch" package of your "store" project. <B><EM>Right click</EM></B> to get the<BR>
|
|
context menu, select <B><EM>Run As</EM></B>, and then <B><EM>Java application</EM></B>. The Tuscany runtime will start up adding<BR>
|
|
the store composition to its domain.</P>
|
|
|
|
<P>The Eclipse console will show the following messages.</P>
|
|
|
|
<P> <IMG src="getting-started-with-tuscany-release-10.data/eclipse_console.png" align="absmiddle" border="0"></P>
|
|
|
|
<P> Next Launch your Web browser and enter the following address:</P>
|
|
|
|
<P><SPAN class="nobr"><A href="http://localhost:8080/ufs/store.html" title="Visit page outside Confluence" rel="nofollow">http://localhost:8080/ufs/store.html<SUP><IMG class="rendericon" src="http://cwiki.apache.org/confluence/images/icons/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN> </P>
|
|
|
|
<P> You get to the Store user facing service of the composite service application.</P>
|
|
|
|
<P><IMG src="getting-started-with-tuscany-release-10.data/store_page.png" align="absmiddle" border="0"></P>
|
|
|
|
<P>You can select items from the Catalog and add them to your Shopping Cart.</P>
|
|
|
|
<P><B>Note:</B> When adding items for the first time you will be asked for <B><EM>userid and password</EM></B> by the<BR>
|
|
browser. Enter "admin" for both.</P>
|
|
|
|
<P> <IMG src="getting-started-with-tuscany-release-10.data/store_page_1.png" align="absmiddle" border="0"></P>
|
|
|
|
<P>Since the ShoppingCart service is bound using the ATOM binding, you can also look at the<BR>
|
|
shopping card content in ATOM feed form by clicking on the feed icon <IMG src="getting-started-with-tuscany-release-10.data/atom_feed.png" align="absmiddle" border="0">. You get the browsers default rendering for ATOM feeds.</P>
|
|
|
|
<P> <IMG src="getting-started-with-tuscany-release-10.data/atom_feeds_page.png" align="absmiddle" border="0"></P>
|
|
|
|
<P> Use the browser back button to get back to the Store page.</P>
|
|
|
|
<P><IMG src="getting-started-with-tuscany-release-10.data/store_page_2.png" align="absmiddle" border="0"></P>
|
|
|
|
<P>And then you can Checkout to complete your order.</P>
|
|
|
|
<P><IMG src="getting-started-with-tuscany-release-10.data/store_page_3.png" align="absmiddle" border="0"></P>
|
|
|
|
<H2><A name="GettingStartedwithTuscanyRelease1.0-ExploretheSamplesfromtheTuscanyDistribution"></A>Explore the Samples from the Tuscany Distribution</H2>
|
|
|
|
<P>The sample folder of the Tuscany distribution provides a rich set of samples ready for you to explore.</P>
|
|
|
|
<P><IMG src="getting-started-with-tuscany-release-10.data/tuscany_samples_folder.png" align="absmiddle" border="0"><BR>
|
|
<BR>
|
|
In Eclipse create a New Java Project, specify the project name, select Create project from<BR>
|
|
existing source, and specify the folder that contains the sample source.</P>
|
|
|
|
<P><IMG src="getting-started-with-tuscany-release-10.data/New_Calc_Java_Project.png" align="absmiddle" border="0"><BR>
|
|
<BR>
|
|
Use <B><EM>Next</EM></B> to get to the next page in the New Java Project dialog. There go to the <B><EM>Libraries</EM></B> tab, use<BR>
|
|
the <B><EM>Add Library</EM></B>... pushbutton to add the JUnit library and the user library <B><EM>TUSCANY</EM></B>.</P>
|
|
|
|
<P><IMG src="getting-started-with-tuscany-release-10.data/New_Calc_Java_Project_lib.png" align="absmiddle" border="0"><BR>
|
|
<BR>
|
|
Finish the New Java Project dialog. You now have the sample project available in the Eclipse workbench.</P>
|
|
|
|
<P><IMG src="getting-started-with-tuscany-release-10.data/calculator_proj_dlg.png" align="absmiddle" border="0"><BR>
|
|
<BR>
|
|
For the calculator sample that we've chosen go to its <B><EM>CalculatorClient</EM></B> class and select <B><EM>Run As -></EM></B><BR>
|
|
<B><EM>Java Application.</EM></B> You will see the following output in the console.</P>
|
|
|
|
<P> <IMG src="getting-started-with-tuscany-release-10.data/calculator_eclipse_console.png" align="absmiddle" border="0"></P>
|
|
</DIV>
|
|
</DIV>
|
|
</DIV>
|
|
</TD>
|
|
</TR>
|
|
</TABLE>
|
|
|
|
<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-2007, The Apache Software Foundation
|
|
</DIV>
|
|
|
|
</BODY>
|
|
</HTML> |