Author: jruzzi
Date: Fri Jun 17 14:34:11 2005
New Revision: 191214
URL: http://svn.apache.org/viewcvs?rev=191214&view=rev
Log:
new for wsrf
Modified:
incubator/apollo/trunk/src/site/content/xdocs/getting_started.xml
incubator/apollo/trunk/src/site/content/xdocs/index.xml
incubator/apollo/trunk/src/site/content/xdocs/site.xml
incubator/apollo/trunk/src/site/content/xdocs/tabs.xml
Modified: incubator/apollo/trunk/src/site/content/xdocs/getting_started.xml
URL:
http://svn.apache.org/viewcvs/incubator/apollo/trunk/src/site/content/xdocs/getting_started.xml?rev=191214&r1=191213&r2=191214&view=diff
==============================================================================
--- incubator/apollo/trunk/src/site/content/xdocs/getting_started.xml (original)
+++ incubator/apollo/trunk/src/site/content/xdocs/getting_started.xml Fri Jun
17 14:34:11 2005
@@ -1,105 +1,55 @@
<?xml version="1.0"?>
-
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN"
"http://forrest.apache.org/dtd/document-v20.dtd";>
-
-<document>
-
- <header>
- <title>Getting Started with Apollo</title>
- </header>
-
- <body>
-
- <section>
- <title>Introduction</title>
-
- <p>
- This page lists the steps required to run the Apollo tutorial sample
application,
- assuming that you have already
- </p>
- <ul>
- <li>installed Apollo binary distribution obtained by unzipping the
zip file.</li>
- <li>installed Apache Tomcat or an another similar Web container.</li>
- <li>installed a recent version of Apache Ant and environment variable
PATH includes
- its <code>bin</code> directory.</li>
- </ul>
-
- <p>
- For simplicity, let us assume that everything runs on the same machine
and Tomcat
- is configured to listen at the default HTTP port 8080. Also, we will
refer to Tomcat
- home directory (say, <code>c:\jakarta-tomcat-4.1.30</code>)
- by TOMCAT_HOME and Apollo home directory
- (say, <code>c:\apollo-incubating-1.0-alpha3-SNAPSHOT</code>)
- by APOLLO_HOME.
- </p>
- </section>
-
- <section>
- <title>Getting Started Steps</title>
- <p>Carry out the following steps to see your Apollo installation in
action:</p>
-
- <ol>
- <li><strong>Deploy the WSRF webapp to Tomcat:</strong> Copy directory
tree
- <code>APOLLO_HOME/webapps/wsrf</code> to
<code>TOMCAT_HOME/webapps</code> directory.
- At this stage, if you start Tomcat and point your browser to
- <a
href="http://localhost:8080/wsrf";>http://localhost:8080/wsrf</a>, you should
- be able to see the Apache-Axis welcome page (Yes, WSRF webapp is
just Axis webapp and
- some additional stuff). Clicking on
- <em><a
href="http://localhost:8080/wsrf/servlet/AxisServlet";>View</a> the list of
- deployed Web services</em> should show two default
- Axis services -- 'AdminService' and 'Version'.<br/></li>
-
- <li><strong>Property changes for Tomcat installation and HTTP
Proxy:</strong> Change
- directory to <code>APOLLO_HOME/docs/tutorial</code> and edit
- <code>build.properties</code> file, following the instructions in
the file.<br/></li>
-
- <li><strong>Generate Java code from WSDL:</strong> Issue the command
- <strong><code>ant generate</code></strong>. Successful execution of
this command
- will create a bunch of directories and files under
<code>generated</code> sub-directory.<br/></li>
-
- <li><strong>Supply Application specific code:</strong> Some of the
generated source files
- need application specific code to be supplied. Change directory to
-
<code>generated/filesystem/src/java/org/apache/ws/resource/example/filesystem</code>,
and
- edit files <code>FilesystemHome.java</code>,
<code>FilesystemResource.java</code> and
- <code>FilesystemService.java</code>
- as per the embedded instructions. Just do a Copy-Paste of code
fragments available in
- directory <code>APOLLO_HOME/docs/tutorial/method_impls</code>. Which
fragment goes
- in which
- source file can be inferred from code fragment filenames.
- <br/>
- The code fragments use additional classes. To get the source files
for these classes
- at appropriate place, copy sub directories <code>backend</code> and
<code>callback</code> from
- <code>APOLLO_HOME/docs/tutorial/src/example/filesystem</code> to
-
<code>APOLLO_HOME/docs/tutorial/generated/filesystem/src/java/org/apache/ws/resource/example/filesystem</code>.
- <br/></li>
-
- <li><strong>Compile and deploy filesystem service:</strong> Change
directory to
- <code>APOLLO_HOME/docs/tutorial/generated/filesystem</code> and
issue the
- command: <strong><code>ant compile deploy</code></strong>.<br/></li>
-
- <li><strong>Verify service deployment:</strong> Restart Tomcat and
point your browser
- to <a href="http://localhost:8080/wsrf/servlet/AxisServlet";>
- http://localhost:8080/wsrf/servlet/AxisServlet</a>. You should see
the additional
- service
- 'filesystem'. You should be able to drill down into the link labelled
'wsdl' and retrieve
- the WSDL document of the newly deployed WSRF service.<br/></li>
-
- <li><strong>Perform WSRF operations:</strong> Change directory to
- <code>APOLLO_HOME/docs/tutorial</code>
- directory and issue the following command:
- <br/>
- <strong><code>ant -f soapclient.xml
-Durl=http://localhost:8080/wsrf/services/filesystem
-Dxml=requests/GetMultipleResourceProperties.soap</code></strong>
- <br/>
- You should also try other request messages kept under
<code>requests</code> sub-directory.
- </li>
- </ol>
- <p>
- For a more detailed description about what happens behind the scene at
each step, refer to
- the <a href="tutorial/index.html">Apollo Tutorial</a>.
- </p>
- </section>
-
- </body>
-
+<document>
+ <header>
+ <title>Getting Started with Apache WSRF</title>
+ </header>
+ <body>
+ <section>
+ <title>Introduction</title>
+ <p>The topics in this section detail how to install
Apache WSRF and use the quick demonstration to verify the installation as well
as exercise some of the features that are included
in the release. It is suggested that you complete these sections before
starting any development work. Once you get a
good feel for the example in the demonstration, you can recreate it by
completing the <a href="site:tut"> tutorial</a>.</p>
+ <p>The tutorial takes a step-by-step approach to
learning Apache WSRF. It highlights the most common procedures that are used to
create WSRF-compliant Web services for resources. The
tutorial also includes steps for deploying Apache WSRF Web services.
</p>
+ <p>Lastly, refer to the <a href="site:dev">Developer
Guide</a> for basic and advanced tasks as well as general information about
Apache WSRF. In addition, much of the information that
is covered in the demonstration and the tutorial is discussed in more detail in
the Developer Guide. </p>
+ </section>
+ <section id="install">
+ <title>Installation</title>
+ <p> Apache WSRF is packaged as a Web application. In
particular, it is an Apache Axis-based Web application with
+ additional functionality that is required to implement the
WSRF family of specifications.</p>
+ <p>To run and install Apache WSRF, you must first:</p>
+ <ul>
+ <li>install Apache Tomcat or a similar Web
container. The documentation assumes Tomcat and refers to the Tomcat
+ home directory (e.g.,
<code>c:\jakarta-tomcat-4.1.30</code>) as <code>TOMCAT_HOME</code>. In
addition, it is assumed that Tomcat
+ is configured to listen at the default HTTP
port (8080).</li>
+ <li>install Apache Ant 1.6.X and include its
<code>bin</code> directory in the <code>PATH</code> environment variable.</li>
+ </ul>
+ <p>To install Apache WSRF:</p>
+ <ol>
+ <li>Download the Apache WSRF <a
href="site:releases">binary distribution</a>.</li>
+ <li>Unzip the Apache WSRF distribution to a
location on your computer. This location is referred to as
<code>INSTALL_DIR</code>.</li>
+ <li>From <code>INSTALL_DIR</code>, copy the
<code>webapps/wsrf</code> directory to <code>TOMCAT_HOME/webapps</code>.</li>
+ <li>Using a browser, go to <a
href="http://localhost:8080/wsrf";>http://localhost:8080/wsrf</a>. The
Apache-Axis welcome page
+ displays.</li>
+ <li>From the Apache-Axis page, click <a
href="http://localhost:8080/wsrf/servlet/AxisServlet";>View</a>. The list of
+ deployed Web services displays. Three services
are deployed: <code>filesystem</code>, <code>AdminService</code>, and
+ <code>Version</code>. The
<code>AdminService</code> and <code>Version</code> services are default
Apache-Axis services. The <code>filesystem</code>
service is a pre-deployed example and is discussed in the <a
href="site:quick">Quick Demonstration</a>
section below.</li>
+ <li>Click on the respective WSDL links to view
and ensure that the WSDL for the services are published.</li>
+ </ol>
+ </section>
+ <section id="qd">
+ <title>Quick Demonstration</title>
+ <p>The Quick Demonstration shows some of the features
and implementation details of Apache WSRF. The demo uses an example that is
included in the distribution and is automatically deployed in
Apache-Axis. The example represents a UNIX file system resource whose
management capabilities are exposed as a WSRF-compliant Web
service.</p>
+ <note>The <a href="site:tut">tutorial</a> provides a
step-by-step approach for exposing the management capabilities of the file
system resource. In essence, the tutorial
builds and deploys the example that is used in this demo.</note>
+ <p>Complete the following demonstration steps:</p>
+ <ol>
+ <li>
+ <strong>Perform WSRF
operations:</strong> In this step, an ANT-based SOAP client that is included in
the distribution is used to send a SOAP
request to the filesystem Web service. The request uses the
<code>GetMultipleResourceProperties</code> operation to return a
list of resource properties for the filesystem
resouorce.
+ <p>Change directory to
<code>INSTALL_DIR/docs/tutorial</code> directory and issue the
following command:</p>
+ <br/>
+ <code>ant -f soapclient.xml
-Durl=http://localhost:8080/wsrf/services/filesystem -
xml=requests/GetMultipleResourceProperties.soap</code>
+ <br/>
+ <br/>You should also try other request
messages kept under <code>requests</code> sub-directory.</li>
+ </ol>
+ </section>
+ </body>
</document>
Modified: incubator/apollo/trunk/src/site/content/xdocs/index.xml
URL:
http://svn.apache.org/viewcvs/incubator/apollo/trunk/src/site/content/xdocs/index.xml?rev=191214&r1=191213&r2=191214&view=diff
==============================================================================
--- incubator/apollo/trunk/src/site/content/xdocs/index.xml (original)
+++ incubator/apollo/trunk/src/site/content/xdocs/index.xml Fri Jun 17 14:34:11
2005
@@ -1,60 +1,32 @@
<?xml version="1.0"?>
-
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN"
"http://forrest.apache.org/dtd/document-v20.dtd";>
-
-<document>
-
- <header>
- <title>Apache WebServices - Apollo</title>
- </header>
-
- <body>
-
- <section>
- <title>Overview</title>
- <p>
- Apollo is a robust Java implementation of the
+<document>
+ <header>
+ <title>Apache WebServices - Apache WSRF</title>
+ </header>
+ <body>
+ <section>
+ <title>Overview</title>
+ <p>
+ Apache WSRF is a robust Java implementation of the
<a href="wsrf.html">Web Services Resource Framework (WSRF)</a>
family of specifications.
</p>
- <p>
+ <p>
WSRF defines a generic and open framework for modeling and accessing
stateful resources
using Web services. This includes mechanisms to describe views on the
state, to support
management of the state through properties associated with the Web
service, and to
describe how these mechanisms are extensible to groups of Web services.
- </p>
- </section>
-
- <section>
- <title>News</title>
- <ul>
- <li>(May 25, 2005) <a
href="http://cvs.apache.org/dist/incubator/apollo/1.0-beta/";>Apollo 1.0
Beta</a> is now available!</li>
- </ul>
- </section>
-
- <section>
- <title>Incubation Disclaimer</title>
- <p>
- The Apollo project is an effort undergoing incubation at the Apache
- Software Foundation (ASF), sponsored by Davanum Srinivas. Incubation is
- required of all newly accepted projects until a further review
indicates
- that the infrastructure, communications, and decision making process
- have stabilized in a manner consistent with other successful ASF
- projects. While incubation status is not necessarily a reflection of
- the completeness or stability of the code, it does indicate that the
- project has yet to be fully endorsed by the ASF.
- </p>
- <p>
- The initial proposal for Apollo is
- <a href="http://wiki.apache.org/incubator/ApolloProposal";>here</a>.
- </p>
- <p>
- The status of the Apollo project is tracked by the Apache incubator
- <a href="http://incubator.apache.org/projects/apollo.html";>here</a>.
- </p>
- </section>
-
- </body>
-
+ </p>
+ </section>
+ <section>
+ <title>News</title>
+ <ul>
+ <li>(June 3, 2005) WSRF has graduated from
incubation and is now an official Apache project! </li>
+ <li>(May 25, 2005) <a
href="http://cvs.apache.org/dist/incubator/apollo/1.0-beta/";>Apollo 1.0
Beta</a> is
+ now available!</li>
+ </ul>
+ </section>
+ </body>
</document>
Modified: incubator/apollo/trunk/src/site/content/xdocs/site.xml
URL:
http://svn.apache.org/viewcvs/incubator/apollo/trunk/src/site/content/xdocs/site.xml?rev=191214&r1=191213&r2=191214&view=diff
==============================================================================
--- incubator/apollo/trunk/src/site/content/xdocs/site.xml (original)
+++ incubator/apollo/trunk/src/site/content/xdocs/site.xml Fri Jun 17 14:34:11
2005
@@ -1,5 +1,4 @@
<?xml version="1.0"?>
-
<!--
Forrest site.xml
@@ -13,74 +12,83 @@
See http://forrest.apache.org/docs/linking.html for more info.
-->
-
-<site label="Apollo" href="" xmlns="http://apache.org/forrest/linkmap/1.0";>
-
- <project label="Project Info">
- <overview label="Overview" href="index.html" />
- <vcs label="Version Control" href="version_control.html" />
- <issues label="Issue Tracking" href="issue_tracking.html" />
- <contact label="Contact Info" href="contact_info.html" />
- <relnotes label="Release Notes" href="release_notes.html" />
- </project>
-
- <project label="Downloads">
- <releases label="Releases" href="release.html" />
- </project>
-
- <docs label="Documentation">
- <website label="Getting Started" href="getting_started.html" />
- <website label="WSRF" href="wsrf.html" />
- <tutorial label="Tutorial" href="tutorial/index.html" />
- <!--<manual label="Manual" href="manual/index.html" />-->
- <apidocs label="API Docs" href="apidocs/index.html" />
- </docs>
-
- <projects label="Related Projects">
- <axis label="Axis" href="ext:axis" />
- <addressing label="Addressing" href="ext:addressing" />
- <xmlbeans label="XMLBeans" href="ext:xmlbeans.apache.org" />
- <maven label="Maven" href="ext:maven.apache.org" />
- <incubator label="Incubator" href="ext:incubator.apache.org" />
- </projects>
-
- <external-refs>
- <xml.apache.org href="http://xml.apache.org/";>
- <forrest href="forrest/" />
- </xml.apache.org>
- <xmlbeans.apache.org href="http://xmlbeans.apache.org/"; />
- <maven.apache.org href="http://maven.apache.org/"; />
- <incubator.apache.org href="http://incubator.apache.org/"; >
- <apollo href="apollo/" />
- </incubator.apache.org>
- <ws.apache.org href="http://ws.apache.org/";>
- <mirrors href="mirrors.cgi" />
- <axis href="axis/" />
- <wsfx href="ws-fx/">
- <addressing href="addressing/" />
- <wss4j href="wss4j/" />
- </wsfx>
- <asl href="LICENSE.txt" />
- </ws.apache.org>
- <cvs.apache.org href="http://cvs.apache.org/";>
- <viewcvs href="viewcvs/">
- <wsfx-cvs href="ws-fx/">
- <apollo-cvs href="apollo/"/>
- </wsfx-cvs>
- </viewcvs>
- </cvs.apache.org>
- <www.apache.org href="http://www.apache.org/";>
- <foundation href="foundation/"/>
- </www.apache.org>
- <nagoya.apache.org href="http://nagoya.apache.org/";>
- <eyebrowse href="eyebrowse/"/>
- <bugzilla href="bugzilla/"/>
- <apachewiki href="wiki/apachewiki.cgi?HomePage"/>
- </nagoya.apache.org>
- <archive.apache.org href="http://archive.apache.org/";>
- <archive-ws href="dist/ws/"/>
- </archive.apache.org>
- <apachecon.com href="http://apachecon.com/"; />
- </external-refs>
-
+<site label="Apollo" href="" xmlns="http://apache.org/forrest/linkmap/1.0";
tab="home">
+ <project label="Project Info" tab="home">
+ <overview label="Overview" href="index.html"/>
+ <vcs label="Version Control" href="version_control.html"/>
+ <issues label="Issue Tracking" href="issue_tracking.html"/>
+ <contact label="Contact Info" href="contact_info.html"/>
+ <relnotes label="Release Notes" href="release_notes.html"/>
+ <wsrf label="WSRF Specs" href="wsrf.html"/>
+ </project>
+ <download label="Downloads" tab="home">
+ <releases label="Releases" href="release.html"/>
+ </download>
+ <!-- **************** Documentation **************** -->
+ <install label="Getting Started" tab="doc">
+ <overview label="Introduction" href="getting_started.html"/>
+ <installation href="getting_started.html#install"/>
+ <get label="Installation" href="getting_started.html#install"/>
+ <quick label="Quick Demo" href="getting_started.html#qd"/>
+ </install>
+ <tutorial label="Tutorial" href="tutorial/" tab="doc">
+ <tut label="Overview" href="index.html"/>
+ <wsdl label="View WSDL" href="wsdl.html"/>
+ <wsdl2java label="Generate Java" href="wsdl2java.html"/>
+ <service label="Write Service Class" href="service.html"/>
+ <resource label="Write Resource Class" href="resource.html"/>
+ <callback label="Write Callback Objects" href="callback.html"/>
+ <home label="Write Home Class" href="home.html"/>
+ <webapp label="Deploy Service" href="webapp.html"/>
+ <test label="Test" href="test.html"/>
+ </tutorial>
+ <developer label="Developer Guide" href="dev_guide/" tab="doc">
+ <dev label="Overview" href="index.html"/>
+ <compose label="Composing a WSRF WSDL" href="wsrf_wsdl.html"/>
+ </developer>
+ <projects label="Related Projects" tab="home">
+ <axis label="Axis" href="ext:axis"/>
+ <addressing label="Addressing" href="ext:addressing"/>
+ <xmlbeans label="XMLBeans" href="ext:xmlbeans.apache.org"/>
+ <maven label="Maven" href="ext:maven.apache.org"/>
+ <incubator label="Incubator" href="ext:incubator.apache.org"/>
+ </projects>
+ <external-refs>
+ <xml.apache.org href="http://xml.apache.org/";>
+ <forrest href="forrest/"/>
+ </xml.apache.org>
+ <xmlbeans.apache.org href="http://xmlbeans.apache.org/"/>
+ <maven.apache.org href="http://maven.apache.org/"/>
+ <incubator.apache.org href="http://incubator.apache.org/";>
+ <apollo href="apollo/"/>
+ </incubator.apache.org>
+ <ws.apache.org href="http://ws.apache.org/";>
+ <mirrors href="mirrors.cgi"/>
+ <axis href="axis/"/>
+ <wsfx href="ws-fx/">
+ <addressing href="addressing/"/>
+ <wss4j href="wss4j/"/>
+ </wsfx>
+ <asl href="LICENSE.txt"/>
+ </ws.apache.org>
+ <cvs.apache.org href="http://cvs.apache.org/";>
+ <viewcvs href="viewcvs/">
+ <wsfx-cvs href="ws-fx/">
+ <apollo-cvs href="apollo/"/>
+ </wsfx-cvs>
+ </viewcvs>
+ </cvs.apache.org>
+ <www.apache.org href="http://www.apache.org/";>
+ <foundation href="foundation/"/>
+ </www.apache.org>
+ <nagoya.apache.org href="http://nagoya.apache.org/";>
+ <eyebrowse href="eyebrowse/"/>
+ <bugzilla href="bugzilla/"/>
+ <apachewiki href="wiki/apachewiki.cgi?HomePage"/>
+ </nagoya.apache.org>
+ <archive.apache.org href="http://archive.apache.org/";>
+ <archive-ws href="dist/ws/"/>
+ </archive.apache.org>
+ <apachecon.com href="http://apachecon.com/"/>
+ </external-refs>
</site>
Modified: incubator/apollo/trunk/src/site/content/xdocs/tabs.xml
URL:
http://svn.apache.org/viewcvs/incubator/apollo/trunk/src/site/content/xdocs/tabs.xml?rev=191214&r1=191213&r2=191214&view=diff
==============================================================================
--- incubator/apollo/trunk/src/site/content/xdocs/tabs.xml (original)
+++ incubator/apollo/trunk/src/site/content/xdocs/tabs.xml Fri Jun 17 14:34:11
2005
@@ -1,21 +1,13 @@
<?xml version="1.0"?>
-
-<!DOCTYPE tabs PUBLIC "-//APACHE//DTD Cocoon Documentation Tab V1.0//EN"
- "tab-cocoon-v10.dtd">
-
-<tabs software="Apollo"
- title="Apollo"
- copyright="The Apache Software Foundation"
- xmlns:xlink="http://www.w3.org/1999/xlink";>
-
- <!-- The rules are:
+<!DOCTYPE tabs PUBLIC "-//APACHE//DTD Cocoon Documentation Tab V1.1//EN"
+ "tab-cocoon-v11.dtd">
+<tabs software="Apollo" title="Apollo" copyright="The Apache Software
Foundation" xmlns:xlink="http://www.w3.org/1999/xlink";>
+ <!-- The rules are:
@dir will always have /index.html added.
@href is not modified unless it is root-relative and obviously specifies a
directory (ends in '/'), in which case /index.html will be added
-->
-
- <tab label="Overview" dir=""/>
- <tab label="Tutorial" dir="tutorial/" />
- <tab label="API Docs" dir="apidocs/" />
-
+ <tab id="home" label="Project Info" dir=""/>
+ <tab id="doc" label="Documentation" dir=""
indexfile="getting_started.html"/>
+ <tab label="API Docs" dir="apidocs/"/>
</tabs>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
