Author: chirino
Date: Mon Oct 2 05:22:00 2006
New Revision: 451994
URL: http://svn.apache.org/viewvc?view=rev&rev=451994
Log:
Latest export from confluence
Modified:
incubator/servicemix/site/main/hello-world-se.html
incubator/servicemix/site/main/ideas-concerning-documentation.html
incubator/servicemix/site/main/sandbox.html
incubator/servicemix/site/main/users-space.html
Modified: incubator/servicemix/site/main/hello-world-se.html
URL:
http://svn.apache.org/viewvc/incubator/servicemix/site/main/hello-world-se.html?view=diff&rev=451994&r1=451993&r2=451994
==============================================================================
--- incubator/servicemix/site/main/hello-world-se.html (original)
+++ incubator/servicemix/site/main/hello-world-se.html Mon Oct 2 05:22:00 2006
@@ -116,6 +116,9 @@
<P><B>Note:</B> The content of this document is overlapping with <A
href="creating-a-standard-jbi-component.html" title="Creating a Standard JBI
Component">Creating a Standard JBI Component</A> and <A
href="notes-on-creating-jbi-component-using-maven2.html" title="Notes on
Creating JBI Component using maven2">Notes on Creating JBI Component using
maven2</A>. Any changes you might want to do for this document might be
relevant for them as well. Questions unanswered by this document may be
answered by the other documents.</P>
+<P><B>Note:</B> The <A href="users-space.html" title="Users space">Roadmap for
a perspective Servicemix developer</A> might be a helpful reading as well,
especially for new users. It focuses on using the examples and components
shipped with ServiceMix during development in a company.</P>
+
+
<P>This tutorial describes how to create a <EM>very simple</EM> "Hello
world" JBI service engine (SE) component, pack it into a Service Unit (SU)
which will be packed to a Service Assambly (SA), and finally how to run the SE
inside ServiceMix. The SE will answer received messages with "Hello, I
received xyz bytes!", so we literally see that it works. As it has the
same structure as real, useful SE, the given hints help to use the presented
code as a blueprint to create own SE-SA-SUs. Still, the example is as
minimalistic as possible, so readers shall not get lost in too many details but
get an idea of the big picture.</P>
<P>This tutorial shows the desired/best practices or "clean" way to
create a SE-SA-SU using ServiceMix Maven archetypes and the Maven plugin (see
<A href="maven-jbi-plugin.html" title="Maven JBI plugin">Maven JBI plugin</A>),
so how the workflow <EM>shall</EM> be - of course, other possibilities exist
and may be better suited for certain situations. Furthermore, it will explain
the reasons for critical choices and how required information can be retrieved.
Where appropriate, additional reading is suggested.</P>
@@ -436,8 +439,8 @@
</DIV>
<DIV id="site-footer">
Added by <A
href="http://goopen.org/confluence/users/viewuserprofile.action?username=georg_dembowski";>Georg
Dembowski</A>,
- last edited by <A
href="http://goopen.org/confluence/users/viewuserprofile.action?username=georg_dembowski";>Georg
Dembowski</A> on Sep 30, 2006
- (<A
href="http://goopen.org/confluence/pages/diffpages.action?pageId=13823&originalId=13883";>view
change</A>)
+ last edited by <A
href="http://goopen.org/confluence/users/viewuserprofile.action?username=georg_dembowski";>Georg
Dembowski</A> on Oct 02, 2006
+ (<A
href="http://goopen.org/confluence/pages/diffpages.action?pageId=13823&originalId=13904";>view
change</A>)
(<A
href="http://goopen.org/confluence/pages/editpage.action?pageId=13823";>edit
page</A>)
</DIV>
Modified: incubator/servicemix/site/main/ideas-concerning-documentation.html
URL:
http://svn.apache.org/viewvc/incubator/servicemix/site/main/ideas-concerning-documentation.html?view=diff&rev=451994&r1=451993&r2=451994
==============================================================================
--- incubator/servicemix/site/main/ideas-concerning-documentation.html
(original)
+++ incubator/servicemix/site/main/ideas-concerning-documentation.html Mon Oct
2 05:22:00 2006
@@ -116,7 +116,11 @@
<P>Here are collected ideas <B>how the documentation may be improved. Feel
free to work on any of the tasks or add new ones</B> - in case you have and
want no confluence login, just leave a comment at the bottom of the page. And,
by the way, developers as well as total freshmen can contribute to the
documentation, as questions/suggestions are as important as the answers.</P>
-<H2><A
name="Ideasconcerningdocumentation-Concerningthestructureandorganization"></A>Concerning
the structure and organization</H2>
+<H4><A name="Ideasconcerningdocumentation-Todo"></A>Todo</H4>
+
+<P>Incorporate suggestions of <SPAN class="nobr"><A
href="http://www.nabble.com/User-Feedback-Request-tf2356023.html"; title="Visit
page outside Confluence"
rel="nofollow">http://www.nabble.com/User-Feedback-Request-tf2356023.html<SUP><IMG
class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif"; height="0"
width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN> into this
document. </P>
+
+<H2><A
name="Ideasconcerningdocumentation-Concerningstructureandorganization"></A>Concerning
structure and organization</H2>
<P>The page <A href="documentation.html"
title="Documentation">Documentation</A> (more correctly: it's children)
deperately needs to be <B>re-organized</B>. Is it possible to extend the
child-list short <B>comments</B> describing the content of the linked pages?</P>
@@ -124,7 +128,7 @@
<P>Several tutorials etc. are related to <B>one specific ServiceMix
version</B> but do not mention this. Include this info in the title page,
duplicate the page and change the duplicate to suit the current version.</P>
-<H2><A name="Ideasconcerningdocumentation-Concerningthecontent"></A>Concerning
the content</H2>
+<H2><A name="Ideasconcerningdocumentation-Concerningcontent"></A>Concerning
content</H2>
<H3><A name="Ideasconcerningdocumentation-Pagesthatneedacleanup"></A>Pages
that need a clean-up</H3>
@@ -151,7 +155,6 @@
<UL>
<LI>Using out of the box functionality (http component, jsr181 comp,
eip comp,...) to create an own SA</LI>
<LI>undeployment, see <SPAN class="nobr"><A
href="http://mail-archives.apache.org/mod_mbox/geronimo-servicemix-dev/200610.mbox/[EMAIL
PROTECTED]" title="Visit page outside Confluence"
rel="nofollow">http://mail-archives.apache.org/mod_mbox/geronimo-servicemix-dev/200610.mbox/[EMAIL
PROTECTED]<SUP><IMG class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif"; height="0"
width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
- <LI> </LI>
</UL>
</DIV>
@@ -164,7 +167,7 @@
<DIV id="site-footer">
Added by <A
href="http://goopen.org/confluence/users/viewuserprofile.action?username=georg_dembowski";>Georg
Dembowski</A>,
last edited by <A
href="http://goopen.org/confluence/users/viewuserprofile.action?username=georg_dembowski";>Georg
Dembowski</A> on Oct 02, 2006
- (<A
href="http://goopen.org/confluence/pages/diffpages.action?pageId=13899&originalId=13902";>view
change</A>)
+ (<A
href="http://goopen.org/confluence/pages/diffpages.action?pageId=13899&originalId=13905";>view
change</A>)
(<A
href="http://goopen.org/confluence/pages/editpage.action?pageId=13899";>edit
page</A>)
</DIV>
Modified: incubator/servicemix/site/main/sandbox.html
URL:
http://svn.apache.org/viewvc/incubator/servicemix/site/main/sandbox.html?view=diff&rev=451994&r1=451993&r2=451994
==============================================================================
--- incubator/servicemix/site/main/sandbox.html (original)
+++ incubator/servicemix/site/main/sandbox.html Mon Oct 2 05:22:00 2006
@@ -115,7 +115,7 @@
<DIV class="wiki-content">
<P>This is a place holder for unfinished or deprecated documentation</P>
-<UL><LI><A href="agila.html" title="Agila">Agila</A></LI><LI><A
href="articles.html" title="Articles">Articles</A></LI><LI><A href="books.html"
title="Books">Books</A></LI><LI><A href="bpel-example-ja.html" title="BPEL
Example Ja">BPEL Example Ja</A></LI><LI><A href="file-binding-example.html"
title="File Binding Example">File Binding Example</A></LI><LI><A
href="getting-started.html" title="Getting Started">Getting
Started</A></LI><LI><A href="getting-started-guide-old.html" title="Getting
Started Guide - old">Getting Started Guide - old</A></LI><LI><A
href="home-30.html" title="Home-3.0">Home-3.0</A></LI><LI><A
href="http-binding-ja.html" title="Http Binding Ja">Http Binding
Ja</A></LI><LI><A href="imogeronimo-integration-lisa.html" title="imoGeronimo
Integration Lisa">imoGeronimo Integration Lisa</A></LI><LI><A
href="jboss-integration.html" title="JBoss Integration">JBoss
Integration</A></LI><LI><A href="jms-binding.html" title="JMS Binding">JMS
Binding</A></LI><LI><A hre
f="joram.html" title="JORAM">JORAM</A></LI><LI><A href="leftheader.html"
title="LeftHeader">LeftHeader</A></LI><LI><A href="mc4j.html"
title="MC4J">MC4J</A></LI><LI><A href="navigation-lisa.html"
title="Navigation-lisa">Navigation-lisa</A><UL><LI><A
href="all-components.html" title="All Components">All Components</A></LI><LI><A
href="component-introduction.html" title="Component Introduction">Component
Introduction</A></LI></UL></LI><LI><A href="navigation-tree.html"
title="Navigation-Tree">Navigation-Tree</A><UL><LI><A href="child-one.html"
title="child-one">child-one</A><UL><LI><A href="child-oneone.html"
title="child-one.one">child-one.one</A><UL><LI><A href="grandchild.html"
title="grandchild">grandchild</A></LI></UL></LI></UL></LI><LI><A
href="child-two.html" title="child-two">child-two</A></LI></UL></LI><LI><A
href="quartz-example-ja.html" title="Quartz Example Ja">Quartz Example
Ja</A></LI><LI><A href="rightheader.html"
title="RightHeader">RightHeader</A></LI><LI><A h
ref="rss-binding-ja.html" title="RSS Binding Ja">RSS Binding Ja</A></LI><LI><A
href="servicemix.html" title="ServiceMix">ServiceMix</A></LI><LI><A
href="soap-jabber-integration.html" title="SOAP - Jabber Integration">SOAP -
Jabber Integration</A></LI><LI><A href="use-cases-whole.html" title="Use Cases
(whole)">Use Cases (whole)</A></LI><LI><A href="using-a-jmx-console.html"
title="Using a JMX Console">Using a JMX Console</A></LI><LI><A
href="using-and-understanding-the-basic-example.html" title="Using and
Understanding the Basic Example">Using and Understanding the Basic
Example</A></LI><LI><A href="wsif-binding.html" title="WSIF Binding">WSIF
Binding</A></LI><LI><A href="xfire-binding.html"
title="XFIRE-binding">XFIRE-binding</A></LI><LI><A href="ztest.html"
title="ztest">ztest</A></LI></UL></DIV>
+<UL><LI><A href="agila.html" title="Agila">Agila</A></LI><LI><A
href="articles.html" title="Articles">Articles</A></LI><LI><A href="books.html"
title="Books">Books</A></LI><LI><A href="bpel-example-ja.html" title="BPEL
Example Ja">BPEL Example Ja</A></LI><LI><A href="file-binding-example.html"
title="File Binding Example">File Binding Example</A></LI><LI><A
href="getting-started.html" title="Getting Started">Getting
Started</A></LI><LI><A href="getting-started-guide-old.html" title="Getting
Started Guide - old">Getting Started Guide - old</A></LI><LI><A
href="hello-world-se.html" title="Hello World - SE">Hello World -
SE</A></LI><LI><A href="home-30.html" title="Home-3.0">Home-3.0</A></LI><LI><A
href="http-binding-ja.html" title="Http Binding Ja">Http Binding
Ja</A></LI><LI><A href="imogeronimo-integration-lisa.html" title="imoGeronimo
Integration Lisa">imoGeronimo Integration Lisa</A></LI><LI><A
href="jboss-integration.html" title="JBoss Integration">JBoss Integration</A></
LI><LI><A href="jms-binding.html" title="JMS Binding">JMS
Binding</A></LI><LI><A href="joram.html" title="JORAM">JORAM</A></LI><LI><A
href="leftheader.html" title="LeftHeader">LeftHeader</A></LI><LI><A
href="mc4j.html" title="MC4J">MC4J</A></LI><LI><A href="navigation-lisa.html"
title="Navigation-lisa">Navigation-lisa</A><UL><LI><A
href="all-components.html" title="All Components">All Components</A></LI><LI><A
href="component-introduction.html" title="Component Introduction">Component
Introduction</A></LI></UL></LI><LI><A href="navigation-tree.html"
title="Navigation-Tree">Navigation-Tree</A><UL><LI><A href="child-one.html"
title="child-one">child-one</A><UL><LI><A href="child-oneone.html"
title="child-one.one">child-one.one</A><UL><LI><A href="grandchild.html"
title="grandchild">grandchild</A></LI></UL></LI></UL></LI><LI><A
href="child-two.html" title="child-two">child-two</A></LI></UL></LI><LI><A
href="quartz-example-ja.html" title="Quartz Example Ja">Quartz Example Ja</A>
</LI><LI><A href="rightheader.html"
title="RightHeader">RightHeader</A></LI><LI><A href="rss-binding-ja.html"
title="RSS Binding Ja">RSS Binding Ja</A></LI><LI><A href="servicemix.html"
title="ServiceMix">ServiceMix</A></LI><LI><A
href="soap-jabber-integration.html" title="SOAP - Jabber Integration">SOAP -
Jabber Integration</A></LI><LI><A href="use-cases-whole.html" title="Use Cases
(whole)">Use Cases (whole)</A></LI><LI><A href="using-a-jmx-console.html"
title="Using a JMX Console">Using a JMX Console</A></LI><LI><A
href="using-and-understanding-the-basic-example.html" title="Using and
Understanding the Basic Example">Using and Understanding the Basic
Example</A></LI><LI><A href="wsif-binding.html" title="WSIF Binding">WSIF
Binding</A></LI><LI><A href="xfire-binding.html"
title="XFIRE-binding">XFIRE-binding</A></LI><LI><A href="ztest.html"
title="ztest">ztest</A></LI></UL></DIV>
<!--
<div class="tabletitle">
@@ -208,6 +208,9 @@
<span class="smalltext">(ServiceMix)</span>
<br>
<a
href="http://goopen.org/confluence/display/SM/Articles";
title="Articles">Articles</a>
+ <span class="smalltext">(ServiceMix)</span>
+ <br>
+ <a
href="http://goopen.org/confluence/display/SM/Hello+World+- +SE" title="Hello
World - SE">Hello World - SE</a>
<span class="smalltext">(ServiceMix)</span>
<br>
</div>
Modified: incubator/servicemix/site/main/users-space.html
URL:
http://svn.apache.org/viewvc/incubator/servicemix/site/main/users-space.html?view=diff&rev=451994&r1=451993&r2=451994
==============================================================================
--- incubator/servicemix/site/main/users-space.html (original)
+++ incubator/servicemix/site/main/users-space.html Mon Oct 2 05:22:00 2006
@@ -112,7 +112,7 @@
<!--
<div class="pagetitle">Users space</div>
-->
- <DIV class="wiki-content"><H2><A
name="Usersspace-RoadmapforaperspectiveServicemixdeveloper"></A><B>Roadmap for
a perspective Servicemix developer</B></H2>
+ <DIV class="wiki-content"><H2><A
name="Usersspace-RoadmapforaperspectiveServicemixdeveloper"></A>Roadmap for a
perspective Servicemix developer</H2>
<H4><A name="Usersspace-THEPOINT%3A"></A>THE POINT:</H4>
@@ -128,7 +128,7 @@
<H4><A name="Usersspace-Also..."></A>Also...</H4>
-<P>Check out Georg Dembowski's <SPAN class="nobr"><A
href="hello-world-se.html" title="Visit page outside Confluence"
rel="nofollow">tutorial<SUP><IMG class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif"; height="0"
width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN> in progress on
creating a simple service engine (JBI component).</P>
+<P>Check out <A href="hello-world-se.html" title="Hello World - SE">Hello
World - SE</A>, a tutorial in progress on creating a simple service engine
(JBI component) using tooling (mainly Maven archetypes).</P>
<H4><A name="Usersspace-Conventions%3A"></A>Conventions:</H4>
@@ -140,19 +140,19 @@
</OL>
-<P><EM>Note: I am using</EM> <EM><SPAN class="nobr"><A
href="http://people.apache.org/maven-snapshot-repository/org/apache/servicemix/apache-servicemix/3.0-incubating-SNAPSHOT/apache-servicemix-3.0-incubating-20060907.104512-15-src.tar.gz";
title="Visit page outside Confluence"
rel="nofollow"><EM>apache-servicemix-3.0-incubating-20060907.104512-15-src.tar.gz</EM><SUP><IMG
class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif"; height="0"
width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></EM><EM>for the
following tutorial. If you do not use this snapshot release I cannot guarantee
the following will work.</EM></P>
+<P><EM>Note: I am using</EM> <EM><SPAN class="nobr"><A
href="http://people.apache.org/maven-snapshot-repository/org/apache/servicemix/apache-servicemix/3.0-incubating-SNAPSHOT/apache-servicemix-3.0-incubating-20060907.104512-15-src.tar.gz";
title="Visit page outside Confluence"
rel="nofollow"><EM>apache-servicemix-3.0-incubating-20060907.104512-15-src.tar.gz</EM><SUP><IMG
class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif"; height="0"
width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></EM> <EM>for
the following tutorial. If you do not use this snapshot release I cannot
guarantee the following will work.</EM></P>
<P><EM>Note: I am writing all this from a Apple MacBook, and therefore the
tutorital is from a BSD perspective.</EM></P>
<P>BEFORE STARTING:</P>
<UL>
- <LI>You will need Maven 2 installed on your machine </LI>
+ <LI>You will need Maven 2.0.4 or greater installed on your machine</LI>
</UL>
-<H4><A
name="Usersspace-Gettingthecomponentdependenciesintoyourlocalmachine%2Fcompanyrepository"></A><B>Getting
the component dependencies into your local machine/company repository</B></H4>
+<H4><A
name="Usersspace-Gettingthecomponentdependenciesintoyourlocalmachine%2Fcompanyrepository"></A>Getting
the component dependencies into your local machine/company repository</H4>
-<P>If you are going to be running any of the examples or doing any development
with a current SNAPSHOT/release then you may want to do a few things first. It
makes sense to check out the 3.0 (SNAPSHOT if you want the newest) source code
so that you can install the Smix component dependencies in your local
repository. First go here and download the <SPAN class="nobr"><A
href="http://servicemix.org/site/download.html"; title="Visit page outside
Confluence" rel="nofollow">ServiceMix 3.0<SUP><IMG class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif"; height="0"
width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN> sources. Next
you will want to build the Servicemix app and it's included components. Go
<SPAN class="nobr"><A href="http://servicemix.org/site/building.html";
title="Visit page outside Confluence" rel="nofollow">here<SUP><IMG
class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif";
height="0" width="0" align
="absmiddle" alt="" border="0"></SUP></A></SPAN> for instructions.</P>
+<P>If you are going to be running any of the examples or doing any development
with a current SNAPSHOT/release then you may want to do a few things first. It
makes sense to check out the 3.0 (SNAPSHOT if you want the newest) source code
so that you can install the Smix component dependencies in your local
repository. First go here and download the <A href="download.html"
title="Download">ServiceMix 3.0</A> sources. Next you will want to build the
Servicemix app and it's included components. Go to <A href="building.html"
title="Building">Building</A> for instructions.</P>
<P>Once you have built the 3.0 app, following the instructions linked above,
the Smix component modules will be installed locally.</P>
<TABLE cellpadding="5" width="85%" cellspacing="8px" class="infoMacro"
border="0" align="center"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD><B
class="strong">Getting the Smix dependencies into your company
repository</B><BR>
@@ -160,18 +160,16 @@
<P>You should now be able to 'mvn -Dmaven.test.skip=true deploy'
and the dependencies will upload to the remote repository you defined. This is
a good thing when people you are working with will need the Smix component
dependencies. If others will be working on a Smix project you create it will
also come in handy, as they will not have to chase down dependencies. THANKS
MAVEN!!! I think there are other benefits too, such as faster
fetching since the dependencies are more local
(physically).</P></TD></TR></TABLE>
-<H4><A
name="Usersspace-NextupinstallthecompiledbinaryServicemix..."></A><B>Next up
install the compiled binary Servicemix...</B></H4>
+<H4><A name="Usersspace-NextupinstallthecompiledbinaryServicemix..."></A>Next
up install the compiled binary Servicemix...</H4>
-<P>You now have Smix built from source, and the Smix components in a Maven 2
repository. The built distribution of Smix will be in
[Smix_source_folder]/apache-servicemix/target. There will be a source
distribution that is like (exactly like?) the one which you downloaded, and the
.zip, .tar.gzip binary distributions. Install the binary distribution following
<SPAN class="nobr"><A
href="http://servicemix.org/sm30ug/3-installation.html#3.Installation-UnixSourceInstallation";
title="Visit page outside Confluence" rel="nofollow">these<SUP><IMG
class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif";
height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN>
directions. Note those are for Unix, but you can follow the link and find
directions for Windows. Once you have installed the binary Servicemix
installation you are ready to do some testing.</P>
+<P>You now have Smix built from source, and the Smix components in a Maven 2
repository. The built distribution of Smix will be in
[Smix_source_folder]/apache-servicemix/target. There will be a source
distribution that is like (exactly like?) the one which you downloaded, and the
.zip, .tar.gzip binary distributions. Install the binary distribution following
the source installation instructions for <A
href="../SM30UG/3-installation.html#3.Installation-WindowsSourceInstallation"
title="Windows Source Installation on 3. Installation">Windows</A> respectively
<A href="../SM30UG/3-installation.html#3.Installation-UnixSourceInstallation"
title="Unix Source Installation on 3. Installation">Unix</A>. Once you have
installed the binary Servicemix installation you are ready to do some
testing.</P>
-<H4><A name="Usersspace-wsdlfirst"></A><B>wsdl-first</B></H4>
-
-<P>The first thing to do now is install the <SPAN class="nobr"><A
href="http://servicemix.org/sm30ug/1-quick-start.html#1.Quickstart-Deployasampleapplication";
title="Visit page outside Confluence" rel="nofollow">wsdl-first<SUP><IMG
class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif";
height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN>
service assembly (SA) which contains a few service units (SU's) (<SPAN
class="nobr"><A
href="https://sdlc6a.sun.com/ECom/EComActionServlet;jsessionid=728961EE41294F2FB2547B82D037F02E";
title="Visit page outside Confluence" rel="nofollow">See JBI specification
document<SUP><IMG class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif"; height="0"
width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN>). The end
result is a XFire based SOAP service which is pretty simple. The actual code
for the service is in the file [Servicemix_binary_distribution_home]/examples/
wsdl-first/wsdl-first-jsr181-su/src/main/java/org/apache/servicemix/samples/wsdl_first/PersonImpl.java.
Phew! Take a look at the code, it is pretty simple. It uses an <SPAN
class="nobr"><A
href="http://java.sun.com/j2se/1.5.0/docs/guide/language/annotations.html";
title="Visit page outside Confluence" rel="nofollow">annotation<SUP><IMG
class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif";
height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN>
which describes the class as a <SPAN class="nobr"><A
href="http://dev2dev.bea.com/webservices/jwsm.html"; title="Visit page outside
Confluence" rel="nofollow">jsr181<SUP><IMG class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif"; height="0"
width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN> web service.
One interesting thing to note about this project is the use of an ant task
inside the parent pom.xml. This taks uses XFire's WsGenTask to create J
ava objects used by the web service, as described in the WSDL file.</P>
+<H4><A name="Usersspace-wsdlfirst"></A>wsdl-first</H4>
+<P>The first thing to do now is install the <A
href="../SM30UG/1-quick-start.html#1.Quickstart-Deployasampleapplication"
title="Deploy a sample application on 1. Quick start">wsdl-first</A> service
assembly (SA) which contains a few service units (SU's) (<SPAN
class="nobr"><A
href="https://sdlc6a.sun.com/ECom/EComActionServlet;jsessionid=728961EE41294F2FB2547B82D037F02E";
title="Visit page outside Confluence" rel="nofollow">see JBI specification
document<SUP><IMG class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif"; height="0"
width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN>). The end
result is a XFire based SOAP service which is pretty simple. The actual code
for the service is in the file
[Servicemix_binary_distribution_home]/examples/wsdl-first/wsdl-first-jsr181-su/src/main/java/org/apache/servicemix/samples/wsdl_first/PersonImpl.java.
Phew! Take a look at the code, it is pretty simple. It uses an <SPAN
class="nobr"><A href
="http://java.sun.com/j2se/1.5.0/docs/guide/language/annotations.html";
title="Visit page outside Confluence" rel="nofollow">annotation<SUP><IMG
class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif";
height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN>
which describes the class as a <SPAN class="nobr"><A
href="http://dev2dev.bea.com/webservices/jwsm.html"; title="Visit page outside
Confluence" rel="nofollow">jsr181<SUP><IMG class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif"; height="0"
width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN> web service.
One interesting thing to note about this project is the use of an ant task
inside the parent pom.xml. This task uses XFire's WsGenTask to create Java
objects used by the web service, as described in the WSDL file.</P>
<TABLE cellpadding="5" width="85%" cellspacing="8px" class="infoMacro"
border="0" align="center"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD><B
class="strong">About this example</B><BR>
<P>This example is a good starting place if you are interested in creating a
SOAP service in Smix. After reviewing the full code you should have a grasp on
creating a simple POJO web service.</P></TD></TR></TABLE>
-
-<P>So let's get this up and running in our Smix container. <SPAN
class="nobr"><A
href="http://servicemix.org/sm30ug/1-quick-start.html#1.Quickstart-Starttheserver";
title="Visit page outside Confluence" rel="nofollow">Start<SUP><IMG
class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif";
height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN>
Smix, watch the output to make sure things start up correctly. You will need to
open up a new console for the next step, since the Smix output is taking up the
other. You will be able to watch this output to see what is going on in some of
the following steps. Go back to [Servicemix_binary_distribution_home]. You need
to copy the components needed by the wsdl-first SA from the /components folder
to the /install folder. The ones you should copy are:</P>
+<P>So let's get this up and running in our Smix container. <A
href="../SM30UG/1-quick-start.html#1.Quickstart-Starttheserver" title="Start
the server on 1. Quick start">Start</A> Smix, watch the output to make sure
things start up correctly. You will need to open up a new console for the next
step, since the Smix output is taking up the other. You will be able to watch
this output to see what is going on in some of the following steps. Go back to
[Servicemix_binary_distribution_home]. You need to copy the components needed
by the wsdl-first SA from the /components folder to the /install folder. The
ones you should copy are:</P>
<UL>
<LI>servicemix-http-3.0-incubating-SNAPSHOT-installer.zip</LI>
<LI>servicemix-shared-3.0-incubating-SNAPSHOT-installer.zip</LI>
@@ -183,7 +181,7 @@
<P>There is an easy way to do the following: copy the file
[Servicemix_binary_distribution_home]/examples/wsdl-first/wsdl-first-sa-3.0-incubating-SNAPSHOT.zip
into the /install folder. Watch the Smix console window making sure things go
well. You can now open a browser and go <SPAN class="nobr"><A
href="http://localhost:8192/PersonService/main.wsdl"; title="Visit page outside
Confluence" rel="nofollow">here<SUP><IMG class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif"; height="0"
width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN> to see the WSDL
for the SOAP service.</P>
-<P> That was the easy way....but you want to learn about developing so
let's do it the 'hard' way. First go to the
[Servicemix_binary_distribution_home]/examples/wsdl-first folder and type mvn
install. This example project is using a <SPAN class="nobr"><A
href="http://servicemix.org/site/maven-jbi-plugin.html"; title="Visit page
outside Confluence" rel="nofollow">Maven 2 plugin<SUP><IMG class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif"; height="0"
width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN> for creating
specific JBI components. If you look in the module pom.xml files you will see a
special packaging type. After the mvn install completes there will be file
called wsdl-first-sa-3.0-incubating-SNAPSHOT-installer in the wsdl-first-sa
module's target folder. This is SA for the wsdl-first example project. Now
we want to deploy this to our container. The Maven JBI plugin will take care of
this for us!!
! Note we need to make a small change to the wsdl-first-sa module's
pom.xml. The plugin will normally try to install all the shared libraries
needed by the SA when running the Maven goal jbi:projectDeploy. This is
sometimes useful. But often it causes problems because another SA in Smix is
using the shared lib already. In this case the Maven goal will try to remove
and redeploy the shared lib from Smix. This causes a problem and will make the
SA deployment fail. So to tell the plugin to not do this make the following
change in the pom.xml:</P>
+<P>That was the easy way....but you want to learn about developing so
let's do it the 'hard' way. First go to the
[Servicemix_binary_distribution_home]/examples/wsdl-first folder and type mvn
install. This example project is using a <A href="maven-jbi-plugin.html"
title="Maven JBI plugin">Maven 2 plugin</A> for creating specific JBI
components. If you look in the module pom.xml files you will see a special
packaging type. After the mvn install completes there will be file called
wsdl-first-sa-3.0-incubating-SNAPSHOT-installer in the wsdl-first-sa
module's target folder. This is the SA for the wsdl-first example project.
Now we want to deploy this to our container. The Maven JBI plugin will take
care of this for us!!! Note we need to make a small change to the
wsdl-first-sa module's pom.xml. The plugin will normally try to install
all the shared libraries needed by the SA when running the Maven goal
jbi:projectDeploy. This is sometimes use
ful. But often it causes problems because another SA in Smix is using the
shared lib already. In this case the Maven goal will try to remove and redeploy
the shared lib from Smix. This causes a problem and will make the SA deployment
fail. So to tell the plugin to not do this make the following change in the
pom.xml:</P>
<DIV class="preformatted"><DIV class="preformattedContent">
<PRE><build>
<plugins>
@@ -194,10 +192,11 @@
</plugin>
</plugins>
</build>
-
-into....
-
-<build>
+</PRE>
+</DIV></DIV>
+<P>into....</P>
+<DIV class="preformatted"><DIV class="preformattedContent">
+<PRE><build>
<plugins>
<plugin>
<groupId>org.apache.servicemix.tooling</groupId>
@@ -209,19 +208,21 @@
</plugin>
</plugins>
</build>
-
-That little config change will prevent some headaches later.
</PRE>
</DIV></DIV>
+<P>That little config change will prevent some headaches later.</P>
+
<P>You are ready to rock. Change directory to the wsdl-first-sa module. Type
'mvn jbi:projectDeploy'. You can watch the Smix console for
information on the deployment.<DIV align="center"><IMG
src="users-space.data/wsdl-first-install.jpg" border="0"></DIV><BR>
<BR>
Betting that all went well you should be ready to test out the web service you
deployed into Smix. Lucky for you a nice little web app has been packaged with
the application. In your web browser open the file
[Servicemix_binary_distribution_home]/examples/wsdl-first/client.html. This
static .html page contains a javascript which will try to contact the web
service on your local machine. To make it work simply click the
'send' button. If your browser issues any warning make sure you allow
the javascript to do what it needs to do. In Firefox I have to
'allow' what it calls an unsafe operation. The results of clicking
the 'send' button will be a SOAP response posted into the right hand
text area.</P>
-<H4><A name="Usersspace-Temporaryexcursionintomonitoring"></A><B>Temporary
excursion into monitoring</B></H4>
+<H4><A name="Usersspace-Temporaryexcursionintomonitoring"></A>Temporary
excursion into monitoring</H4>
<P>One great benefit to JBI and Smix are the monitoring capabilities. Using
the jconsole application packaged with the Java SDK you can tap into your Smix
instance. In doing so you can get all sorts of information on things like
thread and memory usage, and have the ability to configure the Smix environment
dynamically. Lets use jconsole! Open a terminal session and type
'nohup jconsole &'. If your machine has the Java SDK's /bin
folder in it's path then this should launch the jconsole application. If
the application has launched then you should be able to close the terminal
window now.</P>
-<P>You should see a window titled 'JConsole: Connect to Agent'. In
the 'Local' tab's window you should see an entry. Select this
entry and press the 'Connect' button. You should now be connected to
your local Smix instance. Take some time to play around. Done? Alright now lets
do some maintanance to the Smix environment. We are going to shut down the
wsdl-first SA, then start it back up.</P>
+<P>You should see a window titled 'JConsole: Connect to Agent'. In
the 'Local' tab's window you should see an entry. Select this
entry and press the 'Connect' button. You should now be connected to
your local Smix instance. Take some time to play around. </P>
+
+<P>Done? Alright, now lets do some maintanance to the Smix environment. We are
going to shut down the wsdl-first SA, then start it back up.</P>
<UL>
<LI>Select the tab called 'MBeans'.</LI>
<LI>This gives a tree like structure that you can navigate through.</LI>
@@ -232,15 +233,12 @@
<LI>Click the shutdown button. You will get a pop up window containing
XML that tells you how the operation went. I hope that you see SUCCESS in the
task-result element.</LI>
<LI>With the SA shutdown try to get the <SPAN class="nobr"><A
href="http://localhost:8192/PersonService/main.wsdl"; title="Visit page outside
Confluence" rel="nofollow">WSDL<SUP><IMG class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif"; height="0"
width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN> and use the
client.html app to contact the web service. Niether will work.</LI>
<LI>Let us start the SA again, click the start button in the operations
window. You again get a pop up with XML.</LI>
- <LI>Try again to get the WSDL or hit the web service using the
client.html app. Both should now work.</LI>
+ <LI>Try again to get the WSDL or hit the web service using the
client.html app. Both should now work.<DIV align="center"><IMG
src="users-space.data/jconsole.jpg" border="0"></DIV><BR>
+So this is brief but should give you a good idea of how easy it can be to
manage your Servicemix instance(s).</LI>
</UL>
-<P><DIV align="center"><IMG src="users-space.data/jconsole.jpg"
border="0"></DIV></P>
-
-<P>So this is brief but should give you a good idea of how easy it can be to
manage your Servicemix instance(s).</P>
-
-<H4><A name="Usersspace-Nextupthebridgeexample"></A><B>Next up - the bridge
example</B></H4>
+<H4><A name="Usersspace-Nextupthebridgeexample"></A>Next up - the bridge
example</H4>
<P>coming soon....<DIV align="center"><IMG src="users-space.data/bridge.jpg"
border="0"></DIV></P></DIV>
@@ -252,9 +250,35 @@
</DIV>
<DIV id="site-footer">
Added by <A
href="http://goopen.org/confluence/users/viewuserprofile.action?username=gnodet";>Guillaume
Nodet</A>,
- last edited by <A
href="http://goopen.org/confluence/users/viewuserprofile.action?username=robottaway";>Robert
Ottaway</A> on Oct 02, 2006
- (<A
href="http://goopen.org/confluence/pages/diffpages.action?pageId=13814&originalId=13896";>view
change</A>)
-
+ last edited by <A
href="http://goopen.org/confluence/users/viewuserprofile.action?username=georg_dembowski";>Georg
Dembowski</A> on Oct 02, 2006
+ (<A
href="http://goopen.org/confluence/pages/diffpages.action?pageId=13814&originalId=13903";>view
change</A>)
+ <SPAN id="show" class="inline-control-link"><A href=""
onclick="showComment(); return false;">show comment</A></SPAN>
+ <SPAN id="hide" class="inline-control-link" style="display:none;"><A
href="" onclick="hideComment(); return false;">hide comment</A></SPAN>
+ <DIV id="versionComment" class="noteMacro" style="display:none;
padding: 5px;">
+ <B>Comment:</B>
+ typos, links made conlfuence-internally<BR>
+ <SPAN class="smalltext"><A
href="http://goopen.org/confluence/pages/viewpreviouspageversions.action?pageId=13814";>View
page history</A></SPAN>
+ </DIV>
+
+ <SCRIPT>
+ var show = document.getElementById('show');
+ var hide = document.getElementById('hide');
+ var versionComment = document.getElementById('versionComment');
+
+ function showComment(){
+ show.style.display = 'none';
+ hide.style.display = 'inline';
+ versionComment.style.display = 'block';
+ }
+
+ function hideComment(){
+ show.style.display = 'inline';
+ hide.style.display = 'none';
+ versionComment.style.display = 'none';
+ }
+
+ </SCRIPT>
+
(<A
href="http://goopen.org/confluence/pages/editpage.action?pageId=13814";>edit
page</A>)
</DIV>
![http://goopen.org/confluence/images/icons/linkext7.gif"](http://goopen.org/confluence/images/icons/linkext7.gif"){kind=link}