You are viewing a plain text version of this content. The canonical link for it is here.
Posted to muse-commits@ws.apache.org by sc...@apache.org on 2006/06/02 19:30:35 UTC
svn commit: r411217 [5/5] - in
/webservices/muse/branches/1.0/src/site/content/xdocs: ./ muse/
muse/dev_guide/ muse/tutorial/ muse/tutorial/images/ pubscribe/
pubscribe/dev_guide/ pubscribe/tutorial/ pubscribe/tutorial/images/ wsrf/
wsrf/dev_guide/ wsr...
Added: webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/index.xml
URL: http://svn.apache.org/viewvc/webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/index.xml?rev=411217&view=auto
==============================================================================
--- webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/index.xml (added)
+++ webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/index.xml Fri Jun 2 10:30:32 2006
@@ -0,0 +1,41 @@
+<?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 - 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>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>Features</title>
+ <p>Apache WSRF includes the following features:</p>
+ <ul>
+ <li>A handler and service framework that supports: the WSRF implied resource pattern for dispatching requests to specific WS-Resources; dispatching to Java service
+ methods based on either outermost SOAP body element name or value of wsa:Action header element; and schema validation of request XML</li>
+ <li>a WSDL to Java generator that will generate the classes and configuration entries from a WSRF WSDL that are required to deploy it as a service to the above
+ framework. The WSDL to Java generator also uses Apache XMLBeans to create Java bindings for custom types defined in the WSDL.</li>
+ <li>full implementations of all portTypes defined by the WS-ResourceProperties, WS-ResourceLifetime, and WS-MetadataExchange specifications</li>
+ <li>and more...</li>
+ </ul>
+ <p>Your feedback is welcome and can be sent to the <a href="contact_info.html#wsrf-user">wsrf-user mailing list</a>.
+ </p>
+ </section>
+ <section>
+ <title>News</title>
+ <ul>
+ <li>(June 3, 2005) Apache 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/">WSRF 1.0 Beta</a> is
+ now available!</li>
+ </ul>
+ </section>
+ </body>
+</document>
Added: webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/site.xml_old
URL: http://svn.apache.org/viewvc/webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/site.xml_old?rev=411217&view=auto
==============================================================================
--- webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/site.xml_old (added)
+++ webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/site.xml_old Fri Jun 2 10:30:32 2006
@@ -0,0 +1,97 @@
+<?xml version="1.0"?>
+<!--
+Forrest site.xml
+
+This file contains an outline of the site's information content. It is used to:
+- Generate the website menus (though these can be overridden - see docs)
+- Provide semantic, location-independent aliases for internal 'site:' URIs, eg
+<link href="site:changes"> links to changes.html (or ../changes.html if in
+ subdir).
+- Provide aliases for external URLs in the external-refs section. Eg, <link
+ href="ext:cocoon"> links to http://xml.apache.org/cocoon/
+
+See http://forrest.apache.org/docs/linking.html for more info.
+-->
+<site label="WSRF" 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"/>
+ <setup label="Create Workspace" href="setup.html"/>
+ <wsdl label="Create WSDL" href="wsdl.html"/>
+ <wsdl2java label="Run wsdl2Java Tool" href="wsdl2java.html"/>
+ <modhome label="Modify Home Class" href="mod_home.html"/>
+ <modresource label="Modify Resource Class" href="mod_resource.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"/>
+ <tool label="Using Wsdl2Java" href="wsdl_tool.html"/>
+ <service label="Service Class" href="service.html"/>
+ <resource label="Resource Class" href="resource.html"/>
+ <home label="Home Class" href="home.html"/>
+ <callback label="Callback Objects" href="callback.html"/>
+ <metadata label="Metadata Operations" href="metadata.html"/>
+ <single label="Singleton Service" href="singleton.html"/>
+ <deploy label="Deploying" href="deploy.html"/>
+ <client label="Using the SOAP Client" href="client.html"/>
+ <validate label="Schema Validation" href="validate.html"/>
+ <log label="Logging" href="debug.html"/>
+ </developer>
+ <projects label="Related Projects" tab="home">
+ <pubscribe label="Pubscribe" href="ext:pubscribe"/>
+ <muse label="Muse" href="ext:muse"/>
+ <axis label="Axis" href="ext:axis"/>
+ <addressing label="Addressing" href="ext:addressing"/>
+ <xmlbeans label="XMLBeans" href="ext:xmlbeans.apache.org"/>
+ </projects>
+ <external-refs>
+ <xmlbeans.apache.org href="http://xmlbeans.apache.org/"/>
+ <maven.apache.org href="http://maven.apache.org/"/>
+ <ws.apache.org href="http://ws.apache.org/">
+ <pubscribe href="pubscribe/"/>
+ <muse href="muse/"/>
+ <axis href="axis/"/>
+ <addressing href="addressing/"/>
+ <asl href="LICENSE.txt"/>
+ <mirrors href="mirrors.cgi"/>
+ </ws.apache.org>
+ <cvs.apache.org href="http://cvs.apache.org/">
+ <viewcvs href="viewcvs/">
+ <wsfx-cvs href="ws-fx/">
+ <wsrf-cvs href="wsrf/"/>
+ </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>
Added: webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tabs.xml_old
URL: http://svn.apache.org/viewvc/webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tabs.xml_old?rev=411217&view=auto
==============================================================================
--- webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tabs.xml_old (added)
+++ webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tabs.xml_old Fri Jun 2 10:30:32 2006
@@ -0,0 +1,13 @@
+<?xml version="1.0"?>
+<!DOCTYPE tabs PUBLIC "-//APACHE//DTD Cocoon Documentation Tab V1.1//EN"
+ "tab-cocoon-v11.dtd">
+<tabs software="WSRF" title="WSRF" 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 id="home" label="Project Info" dir=""/>
+ <tab id="doc" label="Documentation" dir="" indexfile="getting_started.html"/>
+ <tab label="API Docs" dir="apidocs/"/>
+</tabs>
Added: webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/images/back.gif
URL: http://svn.apache.org/viewvc/webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/images/back.gif?rev=411217&view=auto
==============================================================================
Binary file - no diff available.
Propchange: webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/images/back.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/images/next.gif
URL: http://svn.apache.org/viewvc/webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/images/next.gif?rev=411217&view=auto
==============================================================================
Binary file - no diff available.
Propchange: webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/images/next.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/index.xml
URL: http://svn.apache.org/viewvc/webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/index.xml?rev=411217&view=auto
==============================================================================
--- webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/index.xml (added)
+++ webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/index.xml Fri Jun 2 10:30:32 2006
@@ -0,0 +1,45 @@
+<?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 WSRF Tutorial</title>
+ </header>
+ <body>
+ <section>
+ <title>Creating and Deploying a WSRF Web Service</title>
+ <p>This tutorial provides a step-by-step approach to using Apache WSRF to create and deploy a WSRF-compliant Web
+ service that represents a UNIX file system. If you want to see a completed version of the example in this tutorial, see the
+ <a href="site:quick">Quick Demonstration</a>.</p>
+ <note>To complete the tutorial, you must first<a href="site:installation">install</a> the distribution.</note>
+ <p>The process consists of the following steps:</p>
+ <ol>
+ <li>
+ <a href="setup.html">Create a Working Directory</a>
+ </li>
+ <li>
+ <a href="wsdl.html">Create a WSRF WSDL</a>
+ </li>
+ <li>
+ <a href="wsdl2java.html">Run the Wsdl2Java Tool</a>
+ </li>
+ <li>
+ <a href="mod_home.html">Modify the Home Class</a>
+ </li>
+ <li>
+ <a href="mod_resource.html">Modify the Resource Class</a>
+ </li>
+ <li>
+ <a href="webapp.html">Compile and Deploy the Service</a>
+ </li>
+ <li>
+ <a href="test.html">Test the Service</a>
+ </li>
+ </ol>
+ <p>
+ <img src="images/next.gif" alt="go to the next step"/>
+ <a href="site:setup">Next</a>
+ </p>
+ </section>
+ </body>
+</document>
Added: webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/mod_home.xml
URL: http://svn.apache.org/viewvc/webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/mod_home.xml?rev=411217&view=auto
==============================================================================
--- webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/mod_home.xml (added)
+++ webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/mod_home.xml Fri Jun 2 10:30:32 2006
@@ -0,0 +1,43 @@
+<?xml version="1.0"?>
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN"
+ "http://forrest.apache.org/dtd/document-v20.dtd">
+<document>
+ <header>
+ <title>Modify the Home Class</title>
+ </header>
+ <body>
+ <section>
+ <title>Introduction</title>
+ <p>In this step of the tutorial, the generated Home class (<code>FilesystemHome</code>) is modified to include an <code>init</code> method.
+ The Home is used to lookup a resource instance. It can act as a factory for creating instances upon request, or build all instances. It is meant
+ to be the entry point for locating a resource instance.
+ </p>
+ </section>
+ <section>
+ <title>Modify the FilesytemHome Class</title>
+ <p>Open <code>WORK_DIR/generated/filesystem/src/java/org/apache/ws/resource/example/filesystem/FilesystemHome.java</code> and
+ replace the <code>public void init()</code> method with the following method. You will also need to copy the instance variables below.</p>
+ <source><![CDATA[
+ private static final String LVOL1_ID = "/dev/vg00/lvol1";
+ private static final String LVOL2_ID = "/dev/vg00/lvol2";
+
+ /**
+ * Create and add two resource instances.
+ *
+ * @throws Exception on error
+ */
+ public void init() throws Exception
+ {
+ super.init();
+ add( createInstance( LVOL1_ID ) );
+ add( createInstance( LVOL2_ID ) );
+ }]]></source>
+ <p>
+ <img src="images/back.gif" alt="go to the previous step"/>
+ <a href="site:wsdl2java">Back</a>
+ <img src="images/next.gif" alt="go to the next step"/>
+ <a href="site:modresource">Next</a>
+ </p>
+ </section>
+ </body>
+</document>
Added: webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/mod_resource.xml
URL: http://svn.apache.org/viewvc/webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/mod_resource.xml?rev=411217&view=auto
==============================================================================
--- webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/mod_resource.xml (added)
+++ webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/mod_resource.xml Fri Jun 2 10:30:32 2006
@@ -0,0 +1,131 @@
+<?xml version="1.0"?>
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN"
+ "http://forrest.apache.org/dtd/document-v20.dtd">
+<document>
+ <header>
+ <title>Modify the Resource Class</title>
+ </header>
+ <body>
+ <section>
+ <title>Introduction</title>
+ <p>In this step of the tutorial, the generated Resource class (<code>FilesystemResource</code>) is modified to implement the <code>init</code>
+ method as well as several methods for the filesystem's custom operations. The Resource class is the stateful instance-representation of your Web service. The resource
+ maintains the resource <code>id</code> and the <code>ResourcePropertySet</code>. The resource <code>id</code> is the unique identifier for an instance of your Web
+ service. It allows you to have multiple resource instances, each with their own states, fronted by the same Web service. The stateful properties are
+ represented by the <code>ResourcePropertySet</code>. The <code>ResourcePropertySet</code> is the Java representation of the Resource
+ Properties document defined in the types section of your WSDL file.
+ </p>
+ </section>
+ <section>
+ <title>Modify the Resource Class</title>
+ <p>Open <code>WORK_DIR/generated/filesystem/src/java/org/apache/ws/resource/example/filesystem/FilesystemResource.java</code> and
+ replace the <code>public void init()</code> method with the following method. You will also need to copy the custom operation methods below.</p>
+ <source><![CDATA[
+ /*
+ * An mock object representing the filesystem being exposed as a WS-Resource.
+ */
+ private example.filesystem.backend.FileSystem m_filesystem;
+
+ public void init()
+ {
+
+ super.init();
+
+ m_filesystem = new example.filesystem.backend.UnixFileSystem( (String)getID() ); // create a mock filesystem object
+
+ /*
+ * The resource property set which contains all of resource properties that were defined in the WSDL.
+ */
+ org.apache.ws.resource.properties.ResourcePropertySet resourcePropertySet = getResourcePropertySet();
+ org.apache.ws.resource.properties.ResourceProperty resourceProperty = null;
+
+ try
+ {
+ /*
+ * Initialize each of our properties by calling resourceProperty.add(propElem) and/or resourceProperty.setCallback(callback)...
+ */
+ resourceProperty = resourcePropertySet.get( FilesystemPropertyQNames.DEVICESPECIALFILE );
+ DeviceSpecialFileDocument deviceDocXBean = DeviceSpecialFileDocument.Factory.newInstance();
+ deviceDocXBean.setDeviceSpecialFile( m_filesystem.getDeviceSpecialFile() );
+ resourceProperty.add( deviceDocXBean );
+
+ resourceProperty = resourcePropertySet.get( FilesystemPropertyQNames.TYPE );
+ TypeDocument typeDocXBean = TypeDocument.Factory.newInstance();
+ typeDocXBean.setType( m_filesystem.getType() );
+ resourceProperty.add( typeDocXBean );
+
+ BackupFrequencyDocument backupDocXBean = BackupFrequencyDocument.Factory.newInstance();
+ backupDocXBean.setBackupFrequency( m_filesystem.getBackupFrequency() );
+ resourceProperty = resourcePropertySet.get( FilesystemPropertyQNames.BACKUPFREQUENCY );
+ resourceProperty.add( backupDocXBean );
+ resourceProperty.setCallback( new example.filesystem.callback.BackupFrequencyCallback( m_filesystem ) );
+
+ CommentDocument commentDocXBean = CommentDocument.Factory.newInstance();
+ commentDocXBean.setComment( m_filesystem.getComment() );
+ resourceProperty = resourcePropertySet.get( FilesystemPropertyQNames.COMMENT );
+ resourceProperty.add( commentDocXBean );
+ resourceProperty.setCallback( new example.filesystem.callback.CommentCallback( m_filesystem ) );
+
+ FsckPassNumberDocument fsckDocXBean = FsckPassNumberDocument.Factory.newInstance();
+ fsckDocXBean.setFsckPassNumber( m_filesystem.getFsckPassNumber() );
+ resourceProperty = resourcePropertySet.get( FilesystemPropertyQNames.FSCKPASSNUMBER );
+ resourceProperty.add( fsckDocXBean );
+ resourceProperty.setCallback( new example.filesystem.callback.FsckPassNumberCallback( m_filesystem ) );
+
+ MountPointDirectoryDocument mountPointDocXBean = MountPointDirectoryDocument.Factory.newInstance();
+ mountPointDocXBean.setMountPointDirectory( m_filesystem.getMountPoint() );
+ resourceProperty = resourcePropertySet.get( FilesystemPropertyQNames.MOUNTPOINTDIRECTORY );
+ resourceProperty.add( mountPointDocXBean );
+ resourceProperty.setCallback( new example.filesystem.callback.MountPointCallback( m_filesystem ) );
+
+ OptionsDocument optionsDocXBean =
+ OptionsDocument.Factory.newInstance();
+ org.apache.ws.resource.example.filesystem.OptionsDocument.Options options =
+ optionsDocXBean.addNewOptions();
+ java.util.List backendOptions =
+ m_filesystem.getOptions();
+ for ( int i = 0; i < backendOptions.size(); i++ )
+ {
+ options.addOption( (String) backendOptions.get( i ) );
+ }
+
+ resourceProperty = resourcePropertySet.get( FilesystemPropertyQNames.OPTIONS );
+ resourceProperty.add( optionsDocXBean );
+ resourceProperty.setCallback( new example.filesystem.callback.OptionsCallback( m_filesystem ) );
+
+ }
+ catch ( Exception e )
+ {
+ throw new javax.xml.rpc.JAXRPCException( "There was a problem in initializing your resource properties. Please check your init() method. Cause: " +
+ e.getLocalizedMessage() );
+ }
+
+ // Resource Property {http://docs.oasis-open.org/wsrf/2004/06/wsrf-WS-ResourceLifetime-1.2-draft-01.xsd}TerminationTime is implemented by the framework.
+ // Resource Property {http://docs.oasis-open.org/wsrf/2004/06/wsrf-WS-ResourceLifetime-1.2-draft-01.xsd}CurrentTime is implemented by the framework.
+
+ }
+
+ public void mount() throws Exception
+ {
+ m_filesystem.mount();
+ }
+
+ public void unmount() throws Exception
+ {
+ m_filesystem.unmount();
+ }
+
+ public boolean isMounted()
+ {
+ return m_filesystem.isMounted();
+ }
+]]></source>
+ <p>
+ <img src="images/back.gif" alt="go to the previous step"/>
+ <a href="site:modhome">Back</a>
+ <img src="images/next.gif" alt="go to the next step"/>
+ <a href="site:webapp">Next</a>
+ </p>
+ </section>
+ </body>
+</document>
Added: webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/setup.xml
URL: http://svn.apache.org/viewvc/webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/setup.xml?rev=411217&view=auto
==============================================================================
--- webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/setup.xml (added)
+++ webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/setup.xml Fri Jun 2 10:30:32 2006
@@ -0,0 +1,38 @@
+<?xml version="1.0"?>
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN"
+ "http://forrest.apache.org/dtd/document-v20.dtd">
+<document>
+ <header>
+ <title>Create a Working Directory</title>
+ </header>
+ <body>
+ <section>
+ <title>Introduction</title>
+ <p>In this step of the tutorial, a development working directory is created and populated with several template files.
+ The template files help facilitate the development process. There is a WSRF-based WSDL template, an ANT build script, and a SOAP client. The templates
+ are discussed in further detail throughout the tutorial. It is a good idea to start a WSRF development project by creating a working directory and using the
+ templates.
+ </p>
+ </section>
+ <section>
+ <title>Create and Populate a Working Directory</title>
+ <p>To create a working directory for the filesystem example:
+ </p>
+ <ol>
+ <li>Create a directory on your computer (e.g.,<code> /filesystem</code>). This directory will be referred to as <code>WORK_DIR</code>.</li>
+ <li>Copy all the files in <code>INSTALL_DIR/template</code> to <code>WORK_DIR</code>.</li>
+ <li>Using a text editor, open <code>WORK_DIR/build.properties</code>.</li>
+ <li>Uncomment the <code>wsrf.webapp.dir</code> property and set it to the location where the WSRF Web application is installed. If you are using
+ Tomcat and have the <code>CATALINA_HOME</code> environment variable set, you do not need to modify this property.</li>
+ <li>Uncomment and modify the proxy settings if you require a proxy to connect to external Web sites.</li>
+ <li>Save and close build.properties.</li>
+ </ol>
+ <p>
+ <img src="images/back.gif" alt="go to the previous step"/>
+ <a href="site:tut">Back</a>
+ <img src="images/next.gif" alt="go to the next step"/>
+ <a href="site:wsdl">Next</a>
+ </p>
+ </section>
+ </body>
+</document>
Added: webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/test.xml
URL: http://svn.apache.org/viewvc/webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/test.xml?rev=411217&view=auto
==============================================================================
--- webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/test.xml (added)
+++ webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/test.xml Fri Jun 2 10:30:32 2006
@@ -0,0 +1,36 @@
+<?xml version="1.0"?>
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN"
+ "http://forrest.apache.org/dtd/document-v20.dtd">
+<document>
+ <header>
+ <title>Test the Service</title>
+ </header>
+ <body>
+ <section id="intro">
+ <title>Introduction</title>
+ <p>In this final step of the tutorial, a SOAP client is used to send requests to the filesystem service deployed in Tomcat. The requests are located in
+ <code>INSTALL_DIR/examples/filesystem/requests</code>. The client is used from an Ant script to send the requests. The scripts can be
+ leveraged in order to test your own services as well. Detailed instructions for using the SOAP client is provided in the
+ <a href="site:client">Developer Guide</a>.
+ </p>
+ </section>
+ <section id="testing">
+ <title>Sending SOAP Requests</title>
+ <p>To send a request to the filesystem service:
+ </p>
+ <ol>
+ <li>From a command prompt, change directories to <code>WORK_DIR</code>.</li>
+ <li>Run:
+ <source><![CDATA[
+ ant -f soapclient.xml -Durl=http://localhost:8080/wsrf/services/filesystem -Dxml=INSTALL_DIR/examples/filesystem/requests/QueryResourceProperties_allProps.soap]]></source>
+ Replace <code>INSTALL_DIR</code> in the <code>xml</code> property.</li>
+ </ol>
+ <p>You may also try other request messages in the
+ <code>requests</code> directory.</p>
+ <p>
+ <img src="images/back.gif" alt="go to the previous step"/>
+ <a href="site:webapp">Back</a>
+ </p>
+ </section>
+ </body>
+</document>
Added: webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/webapp.xml
URL: http://svn.apache.org/viewvc/webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/webapp.xml?rev=411217&view=auto
==============================================================================
--- webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/webapp.xml (added)
+++ webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/webapp.xml Fri Jun 2 10:30:32 2006
@@ -0,0 +1,42 @@
+<?xml version="1.0"?>
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN"
+ "http://forrest.apache.org/dtd/document-v20.dtd">
+<document>
+ <header>
+ <title>Compile and Deploy the Service</title>
+ </header>
+ <body>
+ <section id="intro">
+ <title>Introduction</title>
+ <p>In this step of the tutorial, the filesystem example code and the generated classes are compiled and deployed
+ to the WSRF Web application. An Ant script is provided for compiling and deploying. Detailed instructions for
+ using the Ant script are provided in the <a href="site:deploy">Developer Guide</a>.
+ </p>
+ </section>
+ <section>
+ <title>Run the Compile/Deploy Ant Script</title>
+ <p>To compile and deploy the service:</p>
+ <ol>
+ <li>Copy <code>INSTALL_DIR/examples/filesystem/src/java/example</code> to
+ <code>WORK_DIR/generated/filesystem/src/java</code>.</li>
+ <li>From a command prompt, change directories to <code>WORK_DIR/generated/filesystem</code>.</li>
+ <li>Using a text editor, open <code>build.properties</code>.</li>
+ <li>Uncomment the <code>wsrf.webapp.dir</code> property and set it to the location where the WSRF Web application is installed. If you are using
+ Tomcat and have <code>CATALINA_HOME</code> set, you do not need to modify this property.</li>
+ <li>Uncomment and modify the proxy settings if you require a proxy to connect to external Web sites.</li>
+ <li>Save and close build.properties.</li>
+ <li>Run <code>ant compile deploy</code>. The service is compiled and deployed to the WSRF Web application.</li>
+ <li>Start Tomcat if it is not already started.</li>
+ <li>Using a browser, go to <a href="http://localhost:8080/wsrf/services">
+ http://localhost:8080/wsrf/services</a> and verify that the filesystem service is deployed.
+ </li>
+ </ol>
+ <p>
+ <img src="images/back.gif" alt="go to the previous step"/>
+ <a href="site:modresource">Back</a>
+ <img src="images/next.gif" alt="go to the next step"/>
+ <a href="site:test">Next</a>
+ </p>
+ </section>
+ </body>
+</document>
Added: webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/wsdl.xml
URL: http://svn.apache.org/viewvc/webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/wsdl.xml?rev=411217&view=auto
==============================================================================
--- webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/wsdl.xml (added)
+++ webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/wsdl.xml Fri Jun 2 10:30:32 2006
@@ -0,0 +1,37 @@
+<?xml version="1.0"?>
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN"
+ "http://forrest.apache.org/dtd/document-v20.dtd">
+<document>
+ <header>
+ <title>Create a WSRF WSDL</title>
+ </header>
+ <body>
+ <section>
+ <title>Introduction</title>
+ <p>In this step of the tutorial, a WSRF-compliant WSDL is created for the filesystem resource. In the interest of time, the
+ <code>FileSystem.wsdl</code> has already been created for use in this tutorial.
+ </p>
+ <p> The WSDL was created using the WSRF WSDL template (<code>WORK_DIR/_TEMPLATE_.wsdl</code>). Use the template to
+ expedite the WSDL creation process for a resource. It contains detailed instructions and the default operations that
+ are required by a WSRF-compliant WSDL. In addition, the template contains sections for adding custom operations. It is
+ good practice to use the template if you are not familiar with the WSRF family of specifications. Detailed instructions for
+ composing a WSRF-compliant WSDL using the template are provided in the <a href="site:compose">Developer Guide</a>.
+ </p>
+ <p>The FileSystem WSDL is an example of a WSRF WSDL that contains a single portType
+ (<code>FileSystemPortType</code>), which exposes all of the optional portTypes defined by the WSRF-RP and WSRF-RL
+ specifications. It also defines two custom operations, <code>Mount</code> and <code>Unmount</code>, and a group of
+ custom resource properties.
+ </p>
+ </section>
+ <section>
+ <title>Copy the FileSystem WSDL</title>
+ <p>Copy <code>INSTALL_DIR/examples/filesystem/src/wsdl/FileSystem.wsdl</code> to <code>WORK_DIR</code>.</p>
+ <p>
+ <img src="images/back.gif" alt="go to the previous step"/>
+ <a href="site:setup">Back</a>
+ <img src="images/next.gif" alt="go to the next step"/>
+ <a href="site:wsdl2java">Next</a>
+ </p>
+ </section>
+ </body>
+</document>
Added: webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/wsdl2java.xml
URL: http://svn.apache.org/viewvc/webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/wsdl2java.xml?rev=411217&view=auto
==============================================================================
--- webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/wsdl2java.xml (added)
+++ webservices/muse/branches/1.0/src/site/content/xdocs/wsrf/tutorial/wsdl2java.xml Fri Jun 2 10:30:32 2006
@@ -0,0 +1,49 @@
+<?xml version="1.0"?>
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN"
+ "http://forrest.apache.org/dtd/document-v20.dtd">
+<document>
+ <header>
+ <title>Run the Wsdl2Java Tool</title>
+ </header>
+ <body>
+ <section>
+ <title>Introduction</title>
+ <p>In this step of the tutorial, the Apache WSRF Wsdl2Java tool is used to generate a set of artifacts for the filesystem example. The tool takes a WSDL
+ as its input and outputs the following artifacts:
+ </p>
+ <ul>
+ <li>
+ <a href="ext:xmlbeans.apache.org">XMLBeans</a> for all XML Schema types and elements defined in the types section of the WSDL</li>
+ <li>an abstract base Resource class</li>
+ <li>an abstract base Service class</li>
+ <li>an abstract base Home class</li>
+ <li>a Resource class</li>
+ <li>a Service class</li>
+ <li>a Home class</li>
+ <li>a CustomOperationsPortType interface</li>
+ <li>a PropertyQNames interface</li>
+ <li>an Axis deploy.wsdd file</li>
+ <li>a jndi-config.xml file</li>
+ </ul>
+ <note>The abstract classes and interfaces should NEVER be modified.</note>
+ </section>
+ <section>
+ <title>Generating the Artifacts</title>
+ <p>The Ant script (<code>WORK_DIR/build.xml</code>) contains a target for the Wsdl2Java tool. To generate the artifacts for the
+ filesystem example:</p>
+ <ol>
+ <li>From a command prompt, change directories to <code>WORK_DIR</code>.</li>
+ <li>Enter the following command: <code>ant generate</code>
+ </li>
+ </ol>
+ <p>The artifacts are generated and placed in <code>WORK_DIR/generated</code>. For more information about the
+ WSDL2Java tool and the generated artifacts, see <a href="site:tool">Using the WSDL2Java Tool</a> in the Developer's Guide.</p>
+ <p>
+ <img src="images/back.gif" alt="go to the previous step"/>
+ <a href="site:wsdl">Back</a>
+ <img src="images/next.gif" alt="go to the next step"/>
+ <a href="site:modhome">Next</a>
+ </p>
+ </section>
+ </body>
+</document>
---------------------------------------------------------------------
To unsubscribe, e-mail: muse-commits-unsubscribe@ws.apache.org
For additional commands, e-mail: muse-commits-help@ws.apache.org