Author: svkrish
Date: Tue Oct 31 03:46:19 2006
New Revision: 469454
URL: http://svn.apache.org/viewvc?view=rev&rev=469454
Log:
Fixed Readmes
Added:
incubator/tuscany/branches/sca-java-M2/samples/standalone/helloworldRMIReference/HelloworldRMIReference-Readme.html
Removed:
incubator/tuscany/branches/sca-java-M2/samples/standalone/helloworldRMIReference/readme.htm
Modified:
incubator/tuscany/branches/sca-java-M2/samples/standalone/helloworldRMIReference/src/main/java/helloworld/HelloWorldRmiClient.java
Added:
incubator/tuscany/branches/sca-java-M2/samples/standalone/helloworldRMIReference/HelloworldRMIReference-Readme.html
URL:
http://svn.apache.org/viewvc/incubator/tuscany/branches/sca-java-M2/samples/standalone/helloworldRMIReference/HelloworldRMIReference-Readme.html?view=auto&rev=469454
==============================================================================
---
incubator/tuscany/branches/sca-java-M2/samples/standalone/helloworldRMIReference/HelloworldRMIReference-Readme.html
(added)
+++
incubator/tuscany/branches/sca-java-M2/samples/standalone/helloworldRMIReference/HelloworldRMIReference-Readme.html
Tue Oct 31 03:46:19 2006
@@ -0,0 +1,213 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html><head><!-- * 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.
+ -->
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><meta
http-equiv="Content-Style-Type" content="text/css"><title>Tuscany
+Hello World Web Service Sample</title><!-- LINK rel="stylesheet"
href="ait.css" type="text/css" --><!-- maven -->
+<style type="text/css" media="all">
[EMAIL PROTECTED] url("../../../../css/maven-base.css");
[EMAIL PROTECTED] url("../../../../css/maven-theme.css");
[EMAIL PROTECTED] url("../../../../css/site.css");
+</style><link rel="stylesheet" href="./css/print.css" type="text/css"
media="print"><!-- end maven --></head>
+<body>
+<H1>Tuscany HelloWorld - RMI Reference Sample</H1>
+<H2>Overview</H2>
+<TABLE border="0">
+ <TBODY>
+ <TR>
+ <TD width="100%" valign="top" align="left">The RMI
Reference sample demonstrates how the Tuscany Runtime provides RMI client
bindings for service components that would like to refer RMI Servcies.</TD>
+ </TR>
+ </TBODY>
+</TABLE>
+<H2>Location</H2>
+<P>The source for this sample is located in the paths -
<I>samples/standalone/helloworldRMIReference</I> <I></I>
+ of the source
+distribution.<BR>
+<BR>If there is binary distribution available for these samples, then you may
find these samples packaged as <I></I><I>sample-helloworld-rmiReference.jar.</I>
+</P>
+<H2>Building & Running the HelloWorldRMIReference Sample Source</H2>
+<P>If you are working with a source distribution, then you must first build
the source of this sample. <BR>- Ensure that you have Java 5 installed on your
system.<BR>- Next, you must have Maven 2.0.4 installed on your system. Look up
+http://maven.apache.org/download.html for downloading and installing
+Maven.</P>
+<H3>Building the HelloWorldRMIReference Sample</H3>
+<TABLE border="0">
+ <TBODY>
+ <TR>
+ <TD valign="top"></TD>
+ <TD valign="top">Having installed Maven, , open a
command line console and switch over to the directory on your local
+system, where you have extracted the source.<BR>-
+ Now switch futher into
+the subdirectory <I>samples/standalone/helloworldRMIReference. </I>In this
directory execute the following command<TABLE border="0">
+ <TBODY>
+ <TR>
+ <TD><FONT
color="purple">></FONT></TD>
+ <TD><FONT color="purple"
face="Courier New">mvn install</FONT></TD>
+ </TR>
+ </TBODY>
+ </TABLE>This will build the
<I>helloworldRMIReference</I> sample, package a JAR file for the composite and
install it in your local maven repository for use by other samples..</TD>
+ <TD></TD>
+ </TR>
+ </TBODY>
+</TABLE>
+<H3>Setting up Tuscany Standalone Runtime </H3>
+<P>To run these samples you need the Tuscany Standalone Runtime. This is
+available as a distribution that can be conveniently unpacked and setup
+in the samples directory itself. For this, do the following: -</P>
+<TABLE border="0">
+ <TBODY>
+ <TR>
+ <TD valign="top" align="right">i) </TD>
+ <TD>From the directory
<I>samples/standalone/helloworldRMIReference</I>
+ execute the following command<TABLE border="0">
+ <TBODY>
+ <TR>
+ <TD><FONT
color="purple">></FONT></TD>
+ <TD><FONT color="purple"
face="Courier New">mvn dependency:unpack</FONT></TD>
+ </TR>
+ </TBODY>
+ </TABLE>
+ This will unpack the Tuscany Standalone Runtime
Distribution to the <I>target/distribution </I>sub-directory within the present
working directory - <I>samples/standalone/helloworldRMIReference</I></TD>
+ </TR>
+ <TR>
+ <TD valign="top">ii)</TD>
+ <TD>Since this sample would require the RMI Binding
Extension of Tuscany you must copy the RMI Extension JAR from the <I>contrib
</I>sub-directory into the <I>extensions </I>directory of the distribution. ie.
execute the following from the
+ <I>samples/standalone/helloworldRMIReference
</I>sub-directory: -
+ <TABLE>
+ <TBODY>
+ <TR>
+ <TD valign="top"><FONT
color="purple">></FONT></TD>
+ <TD><FONT color="purple"
face="Courier New">copy target/distribution/contrib/rmi-1.0-incubator-M2.jar
<FONT
+ color="purple"
face="Courier
New">target/distribution/extensions/rmi-1.0-incubator-M2.jar</FONT></FONT></TD>
+ </TR>
+ </TBODY>
+ </TABLE>
+ <I>Note</I> : <I>If you are working with SNAPSHOTs
versions of
+ Tuscany Extensions then the file
<B>rmi-1.0-incubator-M2.jar</B> in
+ the above command must be substituted with
<B>rmi-1.0-incubator-M2-SNAPSHOT.jar</B></I></TD>
+ </TR>
+ </TBODY>
+</TABLE>
+<H3><BR>
+Running the HelloWorldRMIReference Sample</H3>
+<P>Now that the sample source has been built and the Tuscany Standalone
Runtime setup, you may run the HelloWorldRMIReference sample as follows: -</P>
+<TABLE border="0">
+ <TBODY>
+ <TR>
+ <TD valign="top">i) </TD>
+ <TD>First ensure that the HelloWorldRMIService Sample
is up and running. </TD>
+ </TR>
+ <TR>
+ <TD valign="top">ii)</TD>
+ <TD>Switch to the
<I>samples/standalone/helloworldRMIReference/target/distribution
+ </I>sub-directory and execute the following command:
<TABLE>
+ <TBODY>
+ <TR>
+ <TD><FONT
color="purple">></FONT></TD>
+ <TD><FONT color="purple"
face="Courier New">java -jar
+ bin\launcher.jar
..\sample-helloworld-rmiReference.jar</FONT></TD>
+ </TR>
+ </TBODY>
+ </TABLE>
+ </TD>
+ </TR>
+ <TR>
+ <TD valign="top">iii)</TD>
+ <TD>Running this sample will send a <I>'sayHello'</I>
request to the HelloWorldRMIService (that must be running) with the argument
'<I>name</I>' set to the string <I>"SCA
+ RMI Client"</I></TD>
+ </TR>
+ <TR>
+ <TD valign="top">iii)</TD>
+ <TD>You will initially observe messages that relate to
resolution of dependencies required to run this sample and finlly see the
following message on your console<BR>
+ <FONT face="Courier New" color="green"></FONT><FONT
color="green" face="Courier
New">***********************************************************<BR>
+ Hello SCA RMI Client - from the SCA RMI Service<BR>
+
***********************************************************</FONT></TD>
+ </TR>
+ <TR>
+ <TD valign="top">iv)</TD>
+ <TD>This message indicates that the
HelloWorldRMIReference sample has successfuly invoked the HelloWorldRMIService
and obtained the string value <FONT
+ color="green" face="Courier New">"Hello
SCA RMI Client - from the SCA
+ RMI Service"</FONT></TD>
+ </TR>
+ <TR>
+ <TD valign="top">v)</TD>
+ <TD>Meanwhile, on the console where you have started
the HelloworldRMIService sample you will see a message <FONT
+ color="green">"Saying Hello to - SCA RMI
Client"</FONT> that is displayed (implying that its service method was
invoked)</TD>
+ </TR>
+ </TBODY>
+</TABLE>
+<H3><B><I><FONT color="maroon" size="+1">Note : You may also try the
+HelloWorldRMIReference Sample by creating your own RMI Server with the
following attributes </FONT></I></B></H3><TABLE border="0">
+ <TBODY>
+ <TR>
+ <TD align="right"><FONT color="maroon">host
=</FONT></TD>
+ <TD><FONT
color="maroon">"localhost"</FONT></TD>
+ </TR>
+ <TR>
+ <TD align="right"><FONT color="maroon">port
=</FONT></TD>
+ <TD><FONT color="maroon">"1099"</FONT></TD>
+ </TR>
+ <TR>
+ <TD align="right"><FONT color="maroon">server name
=</FONT></TD>
+ <TD><FONT
color="maroon">"HelloWorldRemoteService"</FONT></TD>
+ </TR>
+ </TBODY>
+</TABLE>
+<P><I><FONT color="maroon">Note: You are free to modify any of the above
+(host, port, server name) by making corresponding modifications to the
+default.scdl file of the HelloWorldRMIReference sample and then running this
+sample.</FONT></I></P>
+<P><B><I><FONT color="maroon" size="+1"></FONT></I></B>
+</P><H2>Code Overview</H2>
+The source files are physically organized as shown below:<br>
+<table style="text-align: left; width: 100%;" border="1" cellpadding="2"
cellspacing="2"><tbody><tr><td>
+<pre>
+<U><B></B></U><B><U>RMI Reference Sample</U></B>
++---main<BR> +---java<BR> | +---helloworld
+ HelloWorldService.java
+ HelloWorldImpl.java
+ HelloWorldRmiClient.java
+ +---resources
+ +----META-INF
+ +----sca
+ default.scdl</pre></td></tr></tbody></table><P><BR>
+<B>RMI Reference Sample</B></P><TABLE border="1">
+ <TBODY>
+ <TR>
+ <TD width="230" valign="top">default.scdl</TD>
+ <TD width="396" valign="top">Defines the assembly of
the Helloworld
+ Application with the HelloWorldImpl component referring
the a
+ HelloWorld RMI Service</TD>
+ </TR>
+ <TR>
+ <TD width="230">HelloWorldService.java</TD>
+ <TD width="396">Defines a HelloWorld service
interface</TD>
+ </TR>
+ <TR>
+ <TD width="230">HelloWorldImpl.java</TD>
+ <TD width="396">Implements the HelloWorldService
interface. This
+ implementation inturn calls out to the RMI Service
under the covers
+ of the SCA Runtime - i.e. you will never notice any
APIs in
+ java.rmi.* used in this application</TD>
+ </TR>
+ <TR>
+ <TD width="230">HelloWorldRmiClient.java</TD>
+ <TD width="396">Launches the Standalone Tuscany Runtime
with the RMI
+ Client SCA Application loaded and run.</TD>
+ </TR>
+ </TBODY>
+</TABLE>
+</p></body></html>
Modified:
incubator/tuscany/branches/sca-java-M2/samples/standalone/helloworldRMIReference/src/main/java/helloworld/HelloWorldRmiClient.java
URL:
http://svn.apache.org/viewvc/incubator/tuscany/branches/sca-java-M2/samples/standalone/helloworldRMIReference/src/main/java/helloworld/HelloWorldRmiClient.java?view=diff&rev=469454&r1=469453&r2=469454
==============================================================================
---
incubator/tuscany/branches/sca-java-M2/samples/standalone/helloworldRMIReference/src/main/java/helloworld/HelloWorldRmiClient.java
(original)
+++
incubator/tuscany/branches/sca-java-M2/samples/standalone/helloworldRMIReference/src/main/java/helloworld/HelloWorldRmiClient.java
Tue Oct 31 03:46:19 2006
@@ -36,7 +36,9 @@
CompositeContext context = CurrentCompositeContext.getContext();
HelloWorldService helloWorldService =
context.locateService(HelloWorldService.class, "HelloWorldServiceComponent");
+
System.out.println("***********************************************************");
System.out.println(helloWorldService.sayHello("SCA RMI Client"));
+
System.out.println("***********************************************************");
} catch ( Exception e ) {
e.printStackTrace();
}
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
