You are viewing a plain text version of this content. The canonical link for it is here.
Posted to muse-dev@ws.apache.org by sc...@apache.org on 2005/08/05 15:45:44 UTC
svn commit: r230467 [5/6] - in /webservices/muse/site: ./ dev_guide/ images/
skin/ skin/css/ skin/images/ skin/scripts/ tutorial/ tutorial/images/
Added: webservices/muse/site/tutorial/mod_resource.html
URL: http://svn.apache.org/viewcvs/webservices/muse/site/tutorial/mod_resource.html?rev=230467&view=auto
==============================================================================
--- webservices/muse/site/tutorial/mod_resource.html (added)
+++ webservices/muse/site/tutorial/mod_resource.html Fri Aug 5 06:45:22 2005
@@ -0,0 +1,520 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.6">
+<meta name="Forrest-skin-name" content="pelt">
+<title>Modify the Resource Classes</title>
+<link type="text/css" href="../skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="../skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="../skin/print.css" rel="stylesheet">
+<link type="text/css" href="../skin/profile.css" rel="stylesheet">
+<script src="../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../skin/fontsize.js" language="javascript" type="text/javascript"></script>
+<link rel="shortcut icon" href="../images/apache.ico">
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache</a> > <a href="http://ws.apache.org">ws.apache</a><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+ |header
+ +-->
+<div class="header">
+<!--+
+ |start group logo
+ +-->
+<div class="grouplogo">
+<a href="http://ws.apache.org/"><img class="logoImage" alt="Web Services" src="../images/ws-logo.gif"></a>
+</div>
+<!--+
+ |end group logo
+ +-->
+<!--+
+ |start Project Logo
+ +-->
+<div class="projectlogoA1">
+<a href="http://ws.apache.org/ws-fx/muse/"><img class="logoImage" alt="Muse" src="../images/muse-logo.gif"></a>
+</div>
+<!--+
+ |end Project Logo
+ +-->
+<!--+
+ |start Tabs
+ +-->
+<ul id="tabs">
+<li>
+<a class="base-not-selected" href="../index.html">Project Info</a>
+</li>
+<li class="current">
+<a class="base-selected" href="../getting_started.html">Documentation</a>
+</li>
+<li>
+<a class="base-not-selected" href="../apidocs/index.html">API Docs</a>
+</li>
+</ul>
+<!--+
+ |end Tabs
+ +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+ |start Subtabs
+ +-->
+<div id="level2tabs"></div>
+<!--+
+ |end Endtabs
+ +-->
+<script type="text/javascript" language="JavaScript"><!--
+ document.write("Published: " + document.lastModified);
+ // --></script>
+</div>
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+
+
+ </div>
+<!--+
+ |start Menu, mainarea
+ +-->
+<!--+
+ |start Menu
+ +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_1.1', '../skin/')" id="menu_1.1Title" class="menutitle">Getting Started</div>
+<div id="menu_1.1" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../getting_started.html">Introduction</a>
+</div>
+<div class="menuitem">
+<a title="" href="../getting_started.html#install">Installation</a>
+</div>
+<div class="menuitem">
+<a title="" href="../getting_started.html#qd">Quick Demo</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.2', '../skin/')" id="menu_selected_1.2Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Tutorial</div>
+<div id="menu_selected_1.2" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a title="" href="../tutorial/index.html">Overview</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/setup.html">Create Workspace</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/wsdl.html">Create WSDLs</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/wsdl2java.html">Run wsdl2Java Tool</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/mod_home.html">Modify Home Classes</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">Modify Resource Classes</div>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/mod_service.html">Modify Service Class</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/webapp.html">Deploy Services</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/test.html">Test</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.3', '../skin/')" id="menu_1.3Title" class="menutitle">Developer Guide</div>
+<div id="menu_1.3" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../dev_guide/index.html">Overview</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/wsdl.html">MuWS WSDL</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/wsdl_tool.html">Using Wsdl2Java</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/home.html">Home Class</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/muws_topics.html">MUWS-Specific Topics</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/relationships.html">Relationships</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/advertiser.html">Advertiser Service</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/deploy.html">Deploying</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/client.html">Using the SOAP Client</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/debug.html">Logging</a>
+</div>
+</div>
+<div id="credit"></div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+ |alternative credits
+ +-->
+</div>
+<!--+
+ |end Menu
+ +-->
+<!--+
+ |start content
+ +-->
+<div id="content">
+<div id="skinconf-txtlink"></div>
+<h1>Modify the Resource Classes</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#Introduction">Introduction</a>
+</li>
+<li>
+<a href="#Modify+the+FileSystem+Resource+Class">Modify the FileSystem Resource Class</a>
+</li>
+<li>
+<a href="#Modify+the+Host+Resource+Class">Modify the Host Resource Class</a>
+</li>
+</ul>
+</div>
+
+<a name="N1000C"></a><a name="Introduction"></a>
+<h2 class="boxed">Introduction</h2>
+<div class="section">
+<p>In this step of the tutorial, the generated Resource classes (<span class="codefrag">FilesystemResource</span> and <span class="codefrag">HostResource</span>) are modified modified to implement
+ the <span class="codefrag">init</span> method as well as several methods for the filesystem's custom operations. The Resource class is the stateful instance-representation of a
+ Web service. The resource maintains the resource <span class="codefrag">id</span> and the <span class="codefrag">ResourcePropertySet</span>. The resource <span class="codefrag">id</span> 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 <span class="codefrag">ResourcePropertySet</span>. The <span class="codefrag">ResourcePropertySet</span> is the Java representation of the
+ Resource Properties document defined in the types section of your WSDL file.
+ </p>
+<p>
+ The resource class is also used to expose resource properties as notification topics and register the exposed topics. This includes MUWS specific topics for all
+ properties that are defined in the schema section of the WSDL.
+ </p>
+<p>
+ Lastly, the resource class is used to define any relationships this resource has to other resources.
+ </p>
+</div>
+
+<a name="N10034"></a><a name="Modify+the+FileSystem+Resource+Class"></a>
+<h2 class="boxed">Modify the FileSystem Resource Class</h2>
+<div class="section">
+<p>Open <span class="codefrag">WORK_DIR/generated/filesystem/src/java/org/apache/ws/resource/example/filesystem/FilesystemResource.java</span> and
+ replace the <span class="codefrag">public void init()</span> method with the following methods. You will also need to copy the instance variables and custom operation
+ methods below.</p>
+<pre class="code">
+ private static final String HOST_HOME_LOCATION =
+ org.apache.ws.resource.JndiConstants.CONTEXT_NAME_SERVICES + "/host/" + org.apache.ws.resource.JndiConstants.ATOMIC_NAME_HOME;
+
+ private example.filesystem.backend.FileSystem m_filesystem;
+
+ /**
+ * Initializes this resource's state (properties, etc.).
+ */
+ public void init()
+ {
+ super.init();
+
+ /*
+ * This is where you should associate the backend instance with
+ * the resource instance for a given id.
+ */
+ m_filesystem = new example.filesystem.backend.UnixFileSystem( m_id );
+
+ /*
+ * Add MUWS "capability topics" to the topic set.
+ */
+ org.apache.ws.muws.v1_0.topics.ManagementEventTopic identityCapabilityTopic;
+ org.apache.ws.muws.v1_0.topics.ManagementEventTopic manageabilityCharacteristicsCapabilityTopic;
+ org.apache.ws.muws.v1_0.topics.ManagementEventTopic operationalStatusCapabilityTopic;
+ org.apache.ws.muws.v1_0.topics.ManagementEventTopic relationshipsCapabilityTopic;
+ try
+ {
+ org.apache.ws.notification.topics.TopicSpace muwsTopicSpace = new org.apache.ws.notification.topics.impl.TopicSpaceImpl( org.apache.ws.muws.v1_0.MuwsConstants.NSURI_MUWS_PART2_TOPICS );
+ getTopicSpaceSet().addTopicSpace( muwsTopicSpace );
+
+ identityCapabilityTopic = new org.apache.ws.muws.v1_0.topics.impl.XmlBeansManagementEventTopicImpl( org.apache.ws.muws.v1_0.capability.IdentityCapability.TOPIC_NAME );
+ muwsTopicSpace.addTopic( identityCapabilityTopic );
+ manageabilityCharacteristicsCapabilityTopic = new org.apache.ws.muws.v1_0.topics.impl.XmlBeansManagementEventTopicImpl(
+ org.apache.ws.muws.v1_0.capability.ManageabilityCharacteristicsCapability.TOPIC_NAME );
+ muwsTopicSpace.addTopic( manageabilityCharacteristicsCapabilityTopic );
+ operationalStatusCapabilityTopic = new org.apache.ws.muws.v1_0.topics.impl.XmlBeansManagementEventTopicImpl(
+ org.apache.ws.muws.v1_0.capability.OperationalStatusCapability.TOPIC_NAME );
+ muwsTopicSpace.addTopic( operationalStatusCapabilityTopic );
+ relationshipsCapabilityTopic = new org.apache.ws.muws.v1_0.topics.impl.XmlBeansManagementEventTopicImpl( org.apache.ws.muws.v1_0.capability.RelationshipsCapability.TOPIC_NAME );
+ muwsTopicSpace.addTopic( relationshipsCapabilityTopic );
+ }
+ catch ( Exception e )
+ {
+ throw new RuntimeException( "Failed to add MUWS capability topics to topic set of " + this.getClass().getName() + " resource with ID " + getID() + ".", e );
+ }
+
+ org.apache.ws.resource.properties.ResourcePropertySet resourcePropertySet = getResourcePropertySet();
+ org.apache.ws.resource.properties.ResourceProperty resourceProperty;
+ 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 ) );
+
+ /*
+ * MUWS-defined properties.
+ */
+ // init the {http://docs.oasis-open.org/wsdm/2004/12/muws/wsdm-muws-part1.xsd}ResourceId resource property
+ org.apache.ws.muws.MuwsUtils.initResourceIdProperty(this);
+ // NOTE: it's not necessary to add a property change listener, since the ResourceId prop is immutable
+
+ // init the {http://docs.oasis-open.org/wsdm/2004/12/muws/wsdm-muws-part1.xsd}ManageabilityCapability resource property
+ resourceProperty = resourcePropertySet.get( FilesystemPropertyQNames.MANAGEABILITYCAPABILITY );
+ // add property element for MUWS Identity capability...
+ org.oasisOpen.docs.wsdm.x2004.x12.muws.wsdmMuwsPart1.ManageabilityCapabilityDocument identityCapabilityPropElem = org.oasisOpen.docs.wsdm.x2004.x12.muws.wsdmMuwsPart1.ManageabilityCapabilityDocument.Factory.newInstance();
+ identityCapabilityPropElem.setManageabilityCapability( org.apache.ws.muws.v1_0.capability.IdentityCapability.URI );
+ resourceProperty.add( identityCapabilityPropElem );
+ // add property element for MUWS ManageabilityCharacteristics capability...
+ org.oasisOpen.docs.wsdm.x2004.x12.muws.wsdmMuwsPart1.ManageabilityCapabilityDocument manageabilityCharacteristicsCapabilityPropElem = org.oasisOpen.docs.wsdm.x2004.x12.muws.wsdmMuwsPart1.ManageabilityCapabilityDocument.Factory.newInstance();
+ manageabilityCharacteristicsCapabilityPropElem.setManageabilityCapability(
+ org.apache.ws.muws.v1_0.capability.ManageabilityCharacteristicsCapability.URI );
+ resourceProperty.add( manageabilityCharacteristicsCapabilityPropElem );
+ // add property element for MUWS OperationalStatus capability...
+ org.oasisOpen.docs.wsdm.x2004.x12.muws.wsdmMuwsPart1.ManageabilityCapabilityDocument operationalStatusCapabilityPropElem = org.oasisOpen.docs.wsdm.x2004.x12.muws.wsdmMuwsPart1.ManageabilityCapabilityDocument.Factory.newInstance();
+ operationalStatusCapabilityPropElem.setManageabilityCapability( org.apache.ws.muws.v1_0.capability.OperationalStatusCapability.URI );
+ resourceProperty.add( operationalStatusCapabilityPropElem );
+ // add property element for MUWS Relationships capability...
+ org.oasisOpen.docs.wsdm.x2004.x12.muws.wsdmMuwsPart1.ManageabilityCapabilityDocument relationshipsCapabilityPropElem = org.oasisOpen.docs.wsdm.x2004.x12.muws.wsdmMuwsPart1.ManageabilityCapabilityDocument.Factory.newInstance();
+ relationshipsCapabilityPropElem.setManageabilityCapability( org.apache.ws.muws.v1_0.capability.RelationshipsCapability.URI );
+ resourceProperty.add( relationshipsCapabilityPropElem );
+ // NOTE: it's not necessary to add a property change listener, since the ManageabilityCapability prop is immutable
+
+ // init the {http://docs.oasis-open.org/wsdm/2004/12/muws/wsdm-muws-part2.xsd}OperationalStatus resource property
+ resourceProperty = resourcePropertySet.get( FilesystemPropertyQNames.OPERATIONALSTATUS );
+ org.oasisOpen.docs.wsdm.x2004.x12.muws.wsdmMuwsPart2.OperationalStatusDocument statusDoc = org.oasisOpen.docs.wsdm.x2004.x12.muws.wsdmMuwsPart2.OperationalStatusDocument.Factory.newInstance();
+ statusDoc.setOperationalStatus( org.oasisOpen.docs.wsdm.x2004.x12.muws.wsdmMuwsPart2.OperationalStatusDocument.OperationalStatus.AVAILABLE );
+ resourceProperty.add(statusDoc);
+ resourceProperty.setCallback( new example.filesystem.callback.OperationalStatusCallback( m_filesystem ) );
+ resourceProperty.addChangeListener( operationalStatusCapabilityTopic ); // add for property-value-changed management events
+
+ // init the {http://docs.oasis-open.org/wsdm/2004/12/muws/wsdm-muws-part2.xsd}Relationship resource property
+ resourceProperty = resourcePropertySet.get( FilesystemPropertyQNames.RELATIONSHIP );
+ org.oasisOpen.docs.wsdm.x2004.x12.muws.wsdmMuwsPart2.RelationshipDocument prop_relationship = org.oasisOpen.docs.wsdm.x2004.x12.muws.wsdmMuwsPart2.RelationshipDocument.Factory.newInstance();
+ /*
+ * Create the relationship bean...
+ */
+ org.oasisOpen.docs.wsdm.x2004.x12.muws.wsdmMuwsPart2.RelationshipType relationshipType = null;
+ relationshipType = prop_relationship.addNewRelationship();
+ org.oasisOpen.docs.wsdm.x2004.x12.muws.wsdmMuwsPart2.RelationshipTypeType relationshipTypeType = relationshipType.addNewType();
+ org.apache.ws.util.XmlBeanUtils.addChildElement( relationshipTypeType, new javax.xml.namespace.QName( "http://myns.com/", "ContainedBy", "myns" ) );
+
+
+ org.oasisOpen.docs.wsdm.x2004.x12.muws.wsdmMuwsPart2.RelationshipParticipantType relationshipParticipantType = relationshipType.addNewParticipant();
+ org.apache.ws.resource.properties.ResourceProperty resourceIdProp = resourcePropertySet.get( FilesystemPropertyQNames.RESOURCEID );
+ org.apache.xmlbeans.XmlAnyURI resourceId = (org.apache.xmlbeans.XmlAnyURI) resourceIdProp.get( 0 );
+ relationshipParticipantType.setResourceId( resourceId.getStringValue() );
+ relationshipParticipantType.setRole( "urn:containee" );
+ // NOTE: the below line assumes that the Filesystem resource's EndpointReference field has been initialized
+ org.xmlsoap.schemas.ws.x2004.x08.addressing.EndpointReferenceType filesystemReference = (org.xmlsoap.schemas.ws.x2004.x08.addressing.EndpointReferenceType) ((org.apache.ws.addressing.XmlBeansEndpointReference)getEndpointReference()).getXmlObject( org.apache.ws.addressing.v2004_08_10.AddressingConstants.NSURI_ADDRESSING_SCHEMA );
+ relationshipParticipantType.setManageabilityEndpointReferenceArray( new org.xmlsoap.schemas.ws.x2004.x08.addressing.EndpointReferenceType[] { filesystemReference } );
+
+ org.oasisOpen.docs.wsdm.x2004.x12.muws.wsdmMuwsPart2.RelationshipParticipantType relationshipParticipantType2 = relationshipType.addNewParticipant();
+ org.apache.ws.resource.ResourceHome hostHome = (org.apache.ws.resource.ResourceHome) new javax.naming.InitialContext( ).lookup( HOST_HOME_LOCATION );
+ org.apache.ws.resource.PropertiesResource host = (org.apache.ws.resource.PropertiesResource) hostHome.find( null ); // host is a singleton resource w/ a null resource identifier
+ resourceIdProp = host.getResourcePropertySet().get( org.apache.ws.muws.v1_0.capability.IdentityCapability.PROP_NAME_RESOURCE_ID );
+ resourceId = (org.apache.xmlbeans.XmlAnyURI) resourceIdProp.get( 0 );
+ relationshipParticipantType2.setResourceId( resourceId.getStringValue() );
+ relationshipParticipantType2.setRole( "urn:container" );
+ // NOTE: the below line assumes that the Host resource's EndpointReference field has been initialized
+ org.xmlsoap.schemas.ws.x2004.x08.addressing.EndpointReferenceType hostReference = (org.xmlsoap.schemas.ws.x2004.x08.addressing.EndpointReferenceType) ((org.apache.ws.addressing.XmlBeansEndpointReference)host.getEndpointReference()).getXmlObject( org.apache.ws.addressing.v2004_08_10.AddressingConstants.NSURI_ADDRESSING_SCHEMA );
+ relationshipParticipantType.setManageabilityEndpointReferenceArray( new org.xmlsoap.schemas.ws.x2004.x08.addressing.EndpointReferenceType[] { hostReference } );
+
+ resourceProperty.add( prop_relationship );
+ resourceProperty.addChangeListener( relationshipsCapabilityTopic ); // add for property-value-changed management events
+ }
+ catch ( Exception e )
+ {
+ throw new RuntimeException( "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.
+ // Resource Property {http://docs.oasis-open.org/wsn/2004/06/wsn-WS-BaseNotification-1.2-draft-01.xsd}FixedTopicSet is implemented by the framework.
+ // Resource Property {http://docs.oasis-open.org/wsn/2004/06/wsn-WS-BaseNotification-1.2-draft-01.xsd}Topic is implemented by the framework.
+ // Resource Property {http://docs.oasis-open.org/wsn/2004/06/wsn-WS-BaseNotification-1.2-draft-01.xsd}TopicExpressionDialects is implemented by the framework.
+
+ /**
+ * This method enables the ResourceTermination Topic for notifications
+ * about this resource's termination. If you would not like this
+ * behaviour either comment or remove the line of code.
+ */
+ try
+ {
+ org.apache.ws.notification.topics.util.TopicUtils.addResourceTerminationTopic( getTopicSpaceSet(), this,
+ SPEC_NAMESPACE_SET );
+ }
+ catch ( Exception e )
+ {
+ throw new RuntimeException(
+ "Unable to init the ResourceTermination topic. Cause: " + e.getLocalizedMessage(), e );
+ }
+
+ /**
+ * This method call will make all resource properties be exposed
+ * as Topics. If you would like to change that behaviour you can
+ * call TopicUtils.addResourcePropertyValueChangeTopic for each
+ * Topic you'd like to expose property change notifications for.
+ */
+ try
+ {
+ org.apache.ws.notification.topics.util.TopicUtils.addResourcePropertyValueChangeTopics(
+ getResourcePropertySet(), getTopicSpaceSet() );
+ }
+ catch ( Exception e )
+ {
+ throw new RuntimeException(
+ "Unable to init the ResourceProperty Changed topics. Cause: " + e.getLocalizedMessage(), e );
+ }
+
+ }
+ public void mount() throws Exception
+ {
+ m_filesystem.mount();
+ }
+
+ public void unmount() throws Exception
+ {
+ m_filesystem.unmount();
+ }
+
+ public boolean isMounted()
+ {
+ return m_filesystem.isMounted();
+ }</pre>
+</div>
+
+<a name="N10048"></a><a name="Modify+the+Host+Resource+Class"></a>
+<h2 class="boxed">Modify the Host Resource Class</h2>
+<div class="section">
+<p>Open <span class="codefrag">WORK_DIR/generated/host/src/java/org/apache/ws/resource/example/host/HostResource.java</span> and
+ replace the <span class="codefrag">public void init()</span> method with the following method:
+ </p>
+<pre class="code">
+ public void init()
+ {
+ super.init();
+
+ /**
+ * The ResourcePropertySet which contains all the defined ResourceProperties
+ */
+ org.apache.ws.resource.properties.ResourcePropertySet resourcePropertySet = getResourcePropertySet();
+ org.apache.ws.resource.properties.ResourceProperty resourceProperty = null;
+
+
+ try{
+ // init the {http://docs.oasis-open.org/wsdm/2004/12/muws/wsdm-muws-part1.xsd}ResourceId resource property
+ org.apache.ws.muws.MuwsUtils.initResourceIdProperty(this);
+ // NOTE: it's not necessary to add a property change listener, since the ResourceId prop is immutable
+
+ }
+ 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());
+ }
+ }</pre>
+<p>
+
+<img alt="go to the previous step" src="images/back.gif">
+ <a href="../tutorial/mod_home.html">Back</a>
+ <img alt="go to the next step" src="images/next.gif">
+ <a href="../tutorial/mod_service.html">Next</a>
+
+</p>
+</div>
+
+</div>
+<!--+
+ |end content
+ +-->
+<div class="clearboth"> </div>
+</div>
+<div id="footer">
+<!--+
+ |start bottomstrip
+ +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+// --></script>
+</div>
+<div class="copyright">
+ Copyright © 2004 The Apache Software Foundation.</div>
+<!--+
+ |end bottomstrip
+ +-->
+</div>
+</body>
+</html>
Added: webservices/muse/site/tutorial/mod_service.html
URL: http://svn.apache.org/viewcvs/webservices/muse/site/tutorial/mod_service.html?rev=230467&view=auto
==============================================================================
--- webservices/muse/site/tutorial/mod_service.html (added)
+++ webservices/muse/site/tutorial/mod_service.html Fri Aug 5 06:45:22 2005
@@ -0,0 +1,293 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.6">
+<meta name="Forrest-skin-name" content="pelt">
+<title>Modify the Service Class</title>
+<link type="text/css" href="../skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="../skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="../skin/print.css" rel="stylesheet">
+<link type="text/css" href="../skin/profile.css" rel="stylesheet">
+<script src="../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../skin/fontsize.js" language="javascript" type="text/javascript"></script>
+<link rel="shortcut icon" href="../images/apache.ico">
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache</a> > <a href="http://ws.apache.org">ws.apache</a><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+ |header
+ +-->
+<div class="header">
+<!--+
+ |start group logo
+ +-->
+<div class="grouplogo">
+<a href="http://ws.apache.org/"><img class="logoImage" alt="Web Services" src="../images/ws-logo.gif"></a>
+</div>
+<!--+
+ |end group logo
+ +-->
+<!--+
+ |start Project Logo
+ +-->
+<div class="projectlogoA1">
+<a href="http://ws.apache.org/ws-fx/muse/"><img class="logoImage" alt="Muse" src="../images/muse-logo.gif"></a>
+</div>
+<!--+
+ |end Project Logo
+ +-->
+<!--+
+ |start Tabs
+ +-->
+<ul id="tabs">
+<li>
+<a class="base-not-selected" href="../index.html">Project Info</a>
+</li>
+<li class="current">
+<a class="base-selected" href="../getting_started.html">Documentation</a>
+</li>
+<li>
+<a class="base-not-selected" href="../apidocs/index.html">API Docs</a>
+</li>
+</ul>
+<!--+
+ |end Tabs
+ +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+ |start Subtabs
+ +-->
+<div id="level2tabs"></div>
+<!--+
+ |end Endtabs
+ +-->
+<script type="text/javascript" language="JavaScript"><!--
+ document.write("Published: " + document.lastModified);
+ // --></script>
+</div>
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+
+
+ </div>
+<!--+
+ |start Menu, mainarea
+ +-->
+<!--+
+ |start Menu
+ +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_1.1', '../skin/')" id="menu_1.1Title" class="menutitle">Getting Started</div>
+<div id="menu_1.1" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../getting_started.html">Introduction</a>
+</div>
+<div class="menuitem">
+<a title="" href="../getting_started.html#install">Installation</a>
+</div>
+<div class="menuitem">
+<a title="" href="../getting_started.html#qd">Quick Demo</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.2', '../skin/')" id="menu_selected_1.2Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Tutorial</div>
+<div id="menu_selected_1.2" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a title="" href="../tutorial/index.html">Overview</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/setup.html">Create Workspace</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/wsdl.html">Create WSDLs</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/wsdl2java.html">Run wsdl2Java Tool</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/mod_home.html">Modify Home Classes</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/mod_resource.html">Modify Resource Classes</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">Modify Service Class</div>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/webapp.html">Deploy Services</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/test.html">Test</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.3', '../skin/')" id="menu_1.3Title" class="menutitle">Developer Guide</div>
+<div id="menu_1.3" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../dev_guide/index.html">Overview</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/wsdl.html">MuWS WSDL</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/wsdl_tool.html">Using Wsdl2Java</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/home.html">Home Class</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/muws_topics.html">MUWS-Specific Topics</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/relationships.html">Relationships</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/advertiser.html">Advertiser Service</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/deploy.html">Deploying</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/client.html">Using the SOAP Client</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/debug.html">Logging</a>
+</div>
+</div>
+<div id="credit"></div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+ |alternative credits
+ +-->
+</div>
+<!--+
+ |end Menu
+ +-->
+<!--+
+ |start content
+ +-->
+<div id="content">
+<div id="skinconf-txtlink"></div>
+<h1>Modify the Service Class</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#Introduction">Introduction</a>
+</li>
+<li>
+<a href="#Modify+the+Service+Class">Modify the Service Class</a>
+</li>
+</ul>
+</div>
+
+<a name="N1000C"></a><a name="Introduction"></a>
+<h2 class="boxed">Introduction</h2>
+<div class="section">
+<p>In this step of the tutorial, the generated Service class (<span class="codefrag">FilesystemService</span>) is modified to include an <span class="codefrag">updateOperationalStatus</span> method.
+ This method updates the <span class="codefrag">OperationalStatus</span> property whenever a <span class="codefrag">Mount</span> or <span class="codefrag">Unmount</span> operation is performed and publishes
+ a <span class="codefrag">ResourcePropertyValueChangeEvent</span> to the <span class="codefrag">OperationalStatus</span> notification topic. A client that subscribes to the
+ <span class="codefrag">OperationalStatus</span> notification topic receives a notification when this property changes. The <span class="codefrag">mount</span> and <span class="codefrag">unmount</span> methods are implemented to call the <span class="codefrag">updateOperationalStatus</span> method when they are invoked.
+ </p>
+</div>
+
+<a name="N10037"></a><a name="Modify+the+Service+Class"></a>
+<h2 class="boxed">Modify the Service Class</h2>
+<div class="section">
+<p>Open <span class="codefrag">WORK_DIR/generated/filesystem/src/java/org/apache/ws/resource/example/filesystem/FilesystemService.java</span> and
+ add/replace the following methods:</p>
+<pre class="code">
+ public org.apache.ws.resource.example.filesystem.UnmountResponseDocument unmount(org.apache.ws.resource.example.filesystem.UnmountDocument requestDoc)
+ throws org.apache.ws.resource.example.filesystem.MountDeviceBusyFaultException
+ {
+ try
+ {
+ ((FilesystemResource) getResource()).unmount();
+ updateOperationalStatus(org.oasisOpen.docs.wsdm.x2004.x12.muws.wsdmMuwsPart2.OperationalStatusDocument.OperationalStatus.UNAVAILABLE);
+ }
+ catch (Exception e)
+ {
+ throw new MountDeviceBusyFaultException(getNamespaceSet(), e.getLocalizedMessage());
+ }
+ org.apache.ws.resource.example.filesystem.UnmountResponseDocument responseDocument = org.apache.ws.resource.example.filesystem.UnmountResponseDocument.Factory.newInstance();
+ org.apache.ws.resource.example.filesystem.UnmountResponseDocument.UnmountResponse response = responseDocument.addNewUnmountResponse();
+ return responseDocument;
+ }
+
+ public org.apache.ws.resource.example.filesystem.MountResponseDocument mount(org.apache.ws.resource.example.filesystem.MountDocument requestDoc)
+ throws org.apache.ws.resource.example.filesystem.MountDeviceBusyFaultException
+ {
+ try
+ {
+ ((FilesystemResource) getResource()).mount();
+ updateOperationalStatus(org.oasisOpen.docs.wsdm.x2004.x12.muws.wsdmMuwsPart2.OperationalStatusDocument.OperationalStatus.AVAILABLE);
+ }
+ catch (Exception e)
+ {
+ throw new MountDeviceBusyFaultException(getNamespaceSet(), e.getLocalizedMessage());
+ }
+ org.apache.ws.resource.example.filesystem.MountResponseDocument responseDocument = org.apache.ws.resource.example.filesystem.MountResponseDocument.Factory.newInstance();
+ org.apache.ws.resource.example.filesystem.MountResponseDocument.MountResponse response = responseDocument.addNewMountResponse();
+ return responseDocument;
+ }
+
+public void updateOperationalStatus(org.oasisOpen.docs.wsdm.x2004.x12.muws.wsdmMuwsPart2.OperationalStatusDocument.OperationalStatus.Enum newStatus)
+ {
+ org.apache.ws.notification.base.NotificationProducerResource resource = (org.apache.ws.notification.base.NotificationProducerResource)getResource();
+ org.apache.ws.resource.properties.ResourceProperty statusProp = resource.getResourcePropertySet().get(FilesystemPropertyQNames.OPERATIONALSTATUS);
+ org.oasisOpen.docs.wsdm.x2004.x12.muws.wsdmMuwsPart2.OperationalStatusDocument.OperationalStatus currentStatus = (org.oasisOpen.docs.wsdm.x2004.x12.muws.wsdmMuwsPart2.OperationalStatusDocument.OperationalStatus) statusProp.get(0);
+ if (!currentStatus.enumValue().equals(newStatus))
+ {
+ org.apache.xmlbeans.XmlObject oldStatus = org.apache.ws.util.XmlBeanUtils.copyXmlBean(currentStatus);
+ currentStatus.set(newStatus);
+ org.apache.ws.notification.topics.TopicSpace muwsTopicSpace = resource.getTopicSpaceSet().getTopicSpace(org.apache.ws.muws.v1_0.MuwsConstants.NSURI_MUWS_PART2_TOPICS);
+ org.apache.ws.muws.v1_0.topics.impl.XmlBeansManagementEventTopicImpl statusTopic = (org.apache.ws.muws.v1_0.topics.impl.XmlBeansManagementEventTopicImpl) muwsTopicSpace.getTopic(org.apache.ws.muws.v1_0.capability.OperationalStatusCapability.TOPIC_NAME);
+ org.apache.ws.resource.properties.ResourcePropertyValueChangeEvent statusChangeEvent = new org.apache.ws.resource.properties.v2004_06.impl.XmlBeansResourcePropertyValueChangeEvent(new Object[]{oldStatus}, new Object[]{currentStatus});
+ statusTopic.propertyChanged(statusChangeEvent); // publish the event
+ }
+ return;
+ }</pre>
+<p>
+
+<img alt="go to the previous step" src="images/back.gif">
+ <a href="../tutorial/mod_resource.html">Back</a>
+ <img alt="go to the next step" src="images/next.gif">
+ <a href="../tutorial/webapp.html">Next</a>
+
+</p>
+</div>
+
+</div>
+<!--+
+ |end content
+ +-->
+<div class="clearboth"> </div>
+</div>
+<div id="footer">
+<!--+
+ |start bottomstrip
+ +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+// --></script>
+</div>
+<div class="copyright">
+ Copyright © 2004 The Apache Software Foundation.</div>
+<!--+
+ |end bottomstrip
+ +-->
+</div>
+</body>
+</html>
Added: webservices/muse/site/tutorial/setup.html
URL: http://svn.apache.org/viewcvs/webservices/muse/site/tutorial/setup.html?rev=230467&view=auto
==============================================================================
--- webservices/muse/site/tutorial/setup.html (added)
+++ webservices/muse/site/tutorial/setup.html Fri Aug 5 06:45:22 2005
@@ -0,0 +1,258 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.6">
+<meta name="Forrest-skin-name" content="pelt">
+<title>Create a Working Directory</title>
+<link type="text/css" href="../skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="../skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="../skin/print.css" rel="stylesheet">
+<link type="text/css" href="../skin/profile.css" rel="stylesheet">
+<script src="../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../skin/fontsize.js" language="javascript" type="text/javascript"></script>
+<link rel="shortcut icon" href="../images/apache.ico">
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache</a> > <a href="http://ws.apache.org">ws.apache</a><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+ |header
+ +-->
+<div class="header">
+<!--+
+ |start group logo
+ +-->
+<div class="grouplogo">
+<a href="http://ws.apache.org/"><img class="logoImage" alt="Web Services" src="../images/ws-logo.gif"></a>
+</div>
+<!--+
+ |end group logo
+ +-->
+<!--+
+ |start Project Logo
+ +-->
+<div class="projectlogoA1">
+<a href="http://ws.apache.org/ws-fx/muse/"><img class="logoImage" alt="Muse" src="../images/muse-logo.gif"></a>
+</div>
+<!--+
+ |end Project Logo
+ +-->
+<!--+
+ |start Tabs
+ +-->
+<ul id="tabs">
+<li>
+<a class="base-not-selected" href="../index.html">Project Info</a>
+</li>
+<li class="current">
+<a class="base-selected" href="../getting_started.html">Documentation</a>
+</li>
+<li>
+<a class="base-not-selected" href="../apidocs/index.html">API Docs</a>
+</li>
+</ul>
+<!--+
+ |end Tabs
+ +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+ |start Subtabs
+ +-->
+<div id="level2tabs"></div>
+<!--+
+ |end Endtabs
+ +-->
+<script type="text/javascript" language="JavaScript"><!--
+ document.write("Published: " + document.lastModified);
+ // --></script>
+</div>
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+
+
+ </div>
+<!--+
+ |start Menu, mainarea
+ +-->
+<!--+
+ |start Menu
+ +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_1.1', '../skin/')" id="menu_1.1Title" class="menutitle">Getting Started</div>
+<div id="menu_1.1" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../getting_started.html">Introduction</a>
+</div>
+<div class="menuitem">
+<a title="" href="../getting_started.html#install">Installation</a>
+</div>
+<div class="menuitem">
+<a title="" href="../getting_started.html#qd">Quick Demo</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.2', '../skin/')" id="menu_selected_1.2Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Tutorial</div>
+<div id="menu_selected_1.2" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a title="" href="../tutorial/index.html">Overview</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">Create Workspace</div>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/wsdl.html">Create WSDLs</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/wsdl2java.html">Run wsdl2Java Tool</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/mod_home.html">Modify Home Classes</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/mod_resource.html">Modify Resource Classes</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/mod_service.html">Modify Service Class</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/webapp.html">Deploy Services</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/test.html">Test</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.3', '../skin/')" id="menu_1.3Title" class="menutitle">Developer Guide</div>
+<div id="menu_1.3" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../dev_guide/index.html">Overview</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/wsdl.html">MuWS WSDL</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/wsdl_tool.html">Using Wsdl2Java</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/home.html">Home Class</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/muws_topics.html">MUWS-Specific Topics</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/relationships.html">Relationships</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/advertiser.html">Advertiser Service</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/deploy.html">Deploying</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/client.html">Using the SOAP Client</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/debug.html">Logging</a>
+</div>
+</div>
+<div id="credit"></div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+ |alternative credits
+ +-->
+</div>
+<!--+
+ |end Menu
+ +-->
+<!--+
+ |start content
+ +-->
+<div id="content">
+<div id="skinconf-txtlink"></div>
+<h1>Create a Working Directory</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#Introduction">Introduction</a>
+</li>
+<li>
+<a href="#Create+and+Populate+a+Working+Directory">Create and Populate a Working Directory</a>
+</li>
+</ul>
+</div>
+
+<a name="N1000C"></a><a name="Introduction"></a>
+<h2 class="boxed">Introduction</h2>
+<div class="section">
+<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 MUWS-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 MUWS development project by creating a working directory and using the
+ templates.
+ </p>
+</div>
+
+<a name="N10016"></a><a name="Create+and+Populate+a+Working+Directory"></a>
+<h2 class="boxed">Create and Populate a Working Directory</h2>
+<div class="section">
+<p>To create a working directory for the filesystem example:
+ </p>
+<ol>
+
+<li>Create a directory on your computer (e.g.,<span class="codefrag"> /filesystem</span>). This directory will be referred to as <span class="codefrag">WORK_DIR</span>.</li>
+
+<li>Copy all the files in <span class="codefrag">INSTALL_DIR/template</span> to <span class="codefrag">WORK_DIR</span>.</li>
+
+<li>Using a text editor, open <span class="codefrag">WORK_DIR/build.properties</span>.</li>
+
+<li>Uncomment the <span class="codefrag">muse.webapp.dir</span> property and set it to the location where the Muse Web application is installed. If you are using
+ Tomcat and have the <span class="codefrag">CATALINA_HOME</span> 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 alt="go to the previous step" src="images/back.gif">
+ <a href="../tutorial/index.html">Back</a>
+ <img alt="go to the next step" src="images/next.gif">
+ <a href="../tutorial/wsdl.html">Next</a>
+
+</p>
+</div>
+
+</div>
+<!--+
+ |end content
+ +-->
+<div class="clearboth"> </div>
+</div>
+<div id="footer">
+<!--+
+ |start bottomstrip
+ +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+// --></script>
+</div>
+<div class="copyright">
+ Copyright © 2004 The Apache Software Foundation.</div>
+<!--+
+ |end bottomstrip
+ +-->
+</div>
+</body>
+</html>
Added: webservices/muse/site/tutorial/test.html
URL: http://svn.apache.org/viewcvs/webservices/muse/site/tutorial/test.html?rev=230467&view=auto
==============================================================================
--- webservices/muse/site/tutorial/test.html (added)
+++ webservices/muse/site/tutorial/test.html Fri Aug 5 06:45:22 2005
@@ -0,0 +1,252 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.6">
+<meta name="Forrest-skin-name" content="pelt">
+<title>Test the Services</title>
+<link type="text/css" href="../skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="../skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="../skin/print.css" rel="stylesheet">
+<link type="text/css" href="../skin/profile.css" rel="stylesheet">
+<script src="../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../skin/fontsize.js" language="javascript" type="text/javascript"></script>
+<link rel="shortcut icon" href="../images/apache.ico">
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache</a> > <a href="http://ws.apache.org">ws.apache</a><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+ |header
+ +-->
+<div class="header">
+<!--+
+ |start group logo
+ +-->
+<div class="grouplogo">
+<a href="http://ws.apache.org/"><img class="logoImage" alt="Web Services" src="../images/ws-logo.gif"></a>
+</div>
+<!--+
+ |end group logo
+ +-->
+<!--+
+ |start Project Logo
+ +-->
+<div class="projectlogoA1">
+<a href="http://ws.apache.org/ws-fx/muse/"><img class="logoImage" alt="Muse" src="../images/muse-logo.gif"></a>
+</div>
+<!--+
+ |end Project Logo
+ +-->
+<!--+
+ |start Tabs
+ +-->
+<ul id="tabs">
+<li>
+<a class="base-not-selected" href="../index.html">Project Info</a>
+</li>
+<li class="current">
+<a class="base-selected" href="../getting_started.html">Documentation</a>
+</li>
+<li>
+<a class="base-not-selected" href="../apidocs/index.html">API Docs</a>
+</li>
+</ul>
+<!--+
+ |end Tabs
+ +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+ |start Subtabs
+ +-->
+<div id="level2tabs"></div>
+<!--+
+ |end Endtabs
+ +-->
+<script type="text/javascript" language="JavaScript"><!--
+ document.write("Published: " + document.lastModified);
+ // --></script>
+</div>
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+
+
+ </div>
+<!--+
+ |start Menu, mainarea
+ +-->
+<!--+
+ |start Menu
+ +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_1.1', '../skin/')" id="menu_1.1Title" class="menutitle">Getting Started</div>
+<div id="menu_1.1" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../getting_started.html">Introduction</a>
+</div>
+<div class="menuitem">
+<a title="" href="../getting_started.html#install">Installation</a>
+</div>
+<div class="menuitem">
+<a title="" href="../getting_started.html#qd">Quick Demo</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.2', '../skin/')" id="menu_selected_1.2Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Tutorial</div>
+<div id="menu_selected_1.2" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a title="" href="../tutorial/index.html">Overview</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/setup.html">Create Workspace</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/wsdl.html">Create WSDLs</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/wsdl2java.html">Run wsdl2Java Tool</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/mod_home.html">Modify Home Classes</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/mod_resource.html">Modify Resource Classes</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/mod_service.html">Modify Service Class</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/webapp.html">Deploy Services</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">Test</div>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.3', '../skin/')" id="menu_1.3Title" class="menutitle">Developer Guide</div>
+<div id="menu_1.3" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../dev_guide/index.html">Overview</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/wsdl.html">MuWS WSDL</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/wsdl_tool.html">Using Wsdl2Java</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/home.html">Home Class</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/muws_topics.html">MUWS-Specific Topics</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/relationships.html">Relationships</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/advertiser.html">Advertiser Service</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/deploy.html">Deploying</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/client.html">Using the SOAP Client</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/debug.html">Logging</a>
+</div>
+</div>
+<div id="credit"></div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+ |alternative credits
+ +-->
+</div>
+<!--+
+ |end Menu
+ +-->
+<!--+
+ |start content
+ +-->
+<div id="content">
+<div id="skinconf-txtlink"></div>
+<h1>Test the Services</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#intro">Introduction</a>
+</li>
+<li>
+<a href="#testing">Sending SOAP Requests</a>
+</li>
+</ul>
+</div>
+
+<a name="N1000C"></a><a name="intro"></a>
+<h2 class="boxed">Introduction</h2>
+<div class="section">
+<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
+ <span class="codefrag">INSTALL_DIR/examples/filesystem/requests</span>. 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 are provided in the
+ <a href="../dev_guide/client.html">Developer Guide</a>.
+ </p>
+</div>
+
+<a name="N1001D"></a><a name="testing"></a>
+<h2 class="boxed">Sending SOAP Requests</h2>
+<div class="section">
+<p>To send a request to the filesystem service:
+ </p>
+<ol>
+
+<li>From a command prompt, change directories to <span class="codefrag">WORK_DIR</span>.</li>
+
+<li>Run:
+ <pre class="code">
+ ant -f soapclient.xml -Durl=http://localhost:8080/muse/services/filesystem -Dxml=INSTALL_DIR/examples/filesystem/requests/GetMultipleResourceProperties.soap</pre>
+ Replace <span class="codefrag">INSTALL_DIR</span> in the <span class="codefrag">xml</span> property.</li>
+
+</ol>
+<p>You may also try other request messages in the
+ <span class="codefrag">requests</span> directory.</p>
+<p>
+
+<img alt="go to the previous step" src="images/back.gif">
+ <a href="../tutorial/webapp.html">Back</a>
+
+</p>
+</div>
+
+</div>
+<!--+
+ |end content
+ +-->
+<div class="clearboth"> </div>
+</div>
+<div id="footer">
+<!--+
+ |start bottomstrip
+ +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+// --></script>
+</div>
+<div class="copyright">
+ Copyright © 2004 The Apache Software Foundation.</div>
+<!--+
+ |end bottomstrip
+ +-->
+</div>
+</body>
+</html>
Added: webservices/muse/site/tutorial/webapp.html
URL: http://svn.apache.org/viewcvs/webservices/muse/site/tutorial/webapp.html?rev=230467&view=auto
==============================================================================
--- webservices/muse/site/tutorial/webapp.html (added)
+++ webservices/muse/site/tutorial/webapp.html Fri Aug 5 06:45:22 2005
@@ -0,0 +1,314 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.6">
+<meta name="Forrest-skin-name" content="pelt">
+<title>Compile and Deploy the Services</title>
+<link type="text/css" href="../skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="../skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="../skin/print.css" rel="stylesheet">
+<link type="text/css" href="../skin/profile.css" rel="stylesheet">
+<script src="../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../skin/fontsize.js" language="javascript" type="text/javascript"></script>
+<link rel="shortcut icon" href="../images/apache.ico">
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache</a> > <a href="http://ws.apache.org">ws.apache</a><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+ |header
+ +-->
+<div class="header">
+<!--+
+ |start group logo
+ +-->
+<div class="grouplogo">
+<a href="http://ws.apache.org/"><img class="logoImage" alt="Web Services" src="../images/ws-logo.gif"></a>
+</div>
+<!--+
+ |end group logo
+ +-->
+<!--+
+ |start Project Logo
+ +-->
+<div class="projectlogoA1">
+<a href="http://ws.apache.org/ws-fx/muse/"><img class="logoImage" alt="Muse" src="../images/muse-logo.gif"></a>
+</div>
+<!--+
+ |end Project Logo
+ +-->
+<!--+
+ |start Tabs
+ +-->
+<ul id="tabs">
+<li>
+<a class="base-not-selected" href="../index.html">Project Info</a>
+</li>
+<li class="current">
+<a class="base-selected" href="../getting_started.html">Documentation</a>
+</li>
+<li>
+<a class="base-not-selected" href="../apidocs/index.html">API Docs</a>
+</li>
+</ul>
+<!--+
+ |end Tabs
+ +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+ |start Subtabs
+ +-->
+<div id="level2tabs"></div>
+<!--+
+ |end Endtabs
+ +-->
+<script type="text/javascript" language="JavaScript"><!--
+ document.write("Published: " + document.lastModified);
+ // --></script>
+</div>
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+
+
+ </div>
+<!--+
+ |start Menu, mainarea
+ +-->
+<!--+
+ |start Menu
+ +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_1.1', '../skin/')" id="menu_1.1Title" class="menutitle">Getting Started</div>
+<div id="menu_1.1" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../getting_started.html">Introduction</a>
+</div>
+<div class="menuitem">
+<a title="" href="../getting_started.html#install">Installation</a>
+</div>
+<div class="menuitem">
+<a title="" href="../getting_started.html#qd">Quick Demo</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.2', '../skin/')" id="menu_selected_1.2Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Tutorial</div>
+<div id="menu_selected_1.2" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a title="" href="../tutorial/index.html">Overview</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/setup.html">Create Workspace</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/wsdl.html">Create WSDLs</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/wsdl2java.html">Run wsdl2Java Tool</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/mod_home.html">Modify Home Classes</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/mod_resource.html">Modify Resource Classes</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/mod_service.html">Modify Service Class</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">Deploy Services</div>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/test.html">Test</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.3', '../skin/')" id="menu_1.3Title" class="menutitle">Developer Guide</div>
+<div id="menu_1.3" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../dev_guide/index.html">Overview</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/wsdl.html">MuWS WSDL</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/wsdl_tool.html">Using Wsdl2Java</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/home.html">Home Class</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/muws_topics.html">MUWS-Specific Topics</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/relationships.html">Relationships</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/advertiser.html">Advertiser Service</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/deploy.html">Deploying</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/client.html">Using the SOAP Client</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/debug.html">Logging</a>
+</div>
+</div>
+<div id="credit"></div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+ |alternative credits
+ +-->
+</div>
+<!--+
+ |end Menu
+ +-->
+<!--+
+ |start content
+ +-->
+<div id="content">
+<div id="skinconf-txtlink"></div>
+<h1>Compile and Deploy the Services</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#intro">Introduction</a>
+</li>
+<li>
+<a href="#Run+the+Compile%2FDeploy+Ant+Script">Run the Compile/Deploy Ant Script</a>
+<ul class="minitoc">
+<li>
+<a href="#Compile+and+Deploy+FileSystem">Compile and Deploy FileSystem</a>
+</li>
+<li>
+<a href="#Compile+and+Deploy+Host">Compile and Deploy Host</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#Verify+the+Deployment">Verify the Deployment</a>
+</li>
+</ul>
+</div>
+
+<a name="N1000C"></a><a name="intro"></a>
+<h2 class="boxed">Introduction</h2>
+<div class="section">
+<p>In this step of the tutorial, the example code and the generated classes are compiled and deployed
+ to the Muse Web application. An Ant script is provided for compiling and deploying. Detailed instructions for
+ using the Ant script are provided in the <a href="../dev_guide/index.html">Developer Guide</a>.
+ </p>
+</div>
+
+<a name="N1001A"></a><a name="Run+the+Compile%2FDeploy+Ant+Script"></a>
+<h2 class="boxed">Run the Compile/Deploy Ant Script</h2>
+<div class="section">
+<p>Ant scripts are automatically generated for both the filesystem example and the host example. Each Ant script must be run separately.</p>
+<a name="N10023"></a><a name="Compile+and+Deploy+FileSystem"></a>
+<h3 class="boxed">Compile and Deploy FileSystem</h3>
+<p>To compile and deploy the FileSystem service:</p>
+<ol>
+
+<li>Copy <span class="codefrag">INSTALL_DIR/examples/filesystem/src/java/example</span> to
+ <span class="codefrag">WORK_DIR/generated/filesystem/src/java</span>.</li>
+
+<li>Using a text editor, open <span class="codefrag">WORK_DIR/generated/filesystem/build.properties</span>.</li>
+
+<li>Uncomment the <span class="codefrag">muse.webapp.dir</span> property and set it to the location where the Muse Web application is installed. If you are using
+ Tomcat and have <span class="codefrag">CATALINA_HOME</span> 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>From a command prompt, change directories to <span class="codefrag">WORK_DIR/generated/filesystem</span>.</li>
+
+<li>Run <span class="codefrag">ant compile deploy</span>. The service is compiled and deployed to the Muse Web application.</li>
+
+</ol>
+<a name="N1005A"></a><a name="Compile+and+Deploy+Host"></a>
+<h3 class="boxed">Compile and Deploy Host</h3>
+<p>To compile and deploy the Host service:</p>
+<ol>
+
+<li>Using a text editor, open <span class="codefrag">WORK_DIR/generated/host/build.properties</span>.</li>
+
+<li>Uncomment the <span class="codefrag">muse.webapp.dir</span> property and set it to the location where the Muse Web application is installed. If you are using
+ Tomcat and have <span class="codefrag">CATALINA_HOME</span> 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>From a command prompt, change directories to <span class="codefrag">WORK_DIR/generated/host</span>.</li>
+
+<li>Run <span class="codefrag">ant compile deploy</span>. The service is compiled and deployed to the Muse Web application.</li>
+
+<li>Using a text editor, open <span class="codefrag">TOMCAT_HOME/webapps/muse/WEB-INF/classes/jndi-config.xml</span>.</li>
+
+<li>From the <span class="codefrag"><service name="host"></span> block, remove the <span class="codefrag">resourceIdentifierReferenceParameterName</span>
+ parameter. This parameter is not required since this services is a singleton. Removing this entry ensures that Muse does not look for a resource id
+ in the WS Address headers.</li>
+
+<li>Save and close jndi-config.xml.</li>
+
+</ol>
+</div>
+
+<a name="N1009B"></a><a name="Verify+the+Deployment"></a>
+<h2 class="boxed">Verify the Deployment</h2>
+<div class="section">
+<p>To verify the deployment:</p>
+<ol>
+
+<li>Start Tomcat. If Tomcat is already started, you must restart it.</li>
+
+<li>Using a browser, go to <a class="external" href="http://localhost:8080/muse/services">
+ http://localhost:8080/muse/services</a> and verify that the filesystem and host services are deployed.</li>
+
+</ol>
+<p>
+
+<img alt="go to the previous step" src="images/back.gif">
+ <a href="../tutorial/mod_service.html">Back</a>
+ <img alt="go to the next step" src="images/next.gif">
+ <a href="../tutorial/test.html">Next</a>
+
+</p>
+</div>
+
+</div>
+<!--+
+ |end content
+ +-->
+<div class="clearboth"> </div>
+</div>
+<div id="footer">
+<!--+
+ |start bottomstrip
+ +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+// --></script>
+</div>
+<div class="copyright">
+ Copyright © 2004 The Apache Software Foundation.</div>
+<!--+
+ |end bottomstrip
+ +-->
+</div>
+</body>
+</html>
Added: webservices/muse/site/tutorial/wsdl.html
URL: http://svn.apache.org/viewcvs/webservices/muse/site/tutorial/wsdl.html?rev=230467&view=auto
==============================================================================
--- webservices/muse/site/tutorial/wsdl.html (added)
+++ webservices/muse/site/tutorial/wsdl.html Fri Aug 5 06:45:22 2005
@@ -0,0 +1,251 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.6">
+<meta name="Forrest-skin-name" content="pelt">
+<title>Create MUWS WSDLs</title>
+<link type="text/css" href="../skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="../skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="../skin/print.css" rel="stylesheet">
+<link type="text/css" href="../skin/profile.css" rel="stylesheet">
+<script src="../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../skin/fontsize.js" language="javascript" type="text/javascript"></script>
+<link rel="shortcut icon" href="../images/apache.ico">
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache</a> > <a href="http://ws.apache.org">ws.apache</a><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+ |header
+ +-->
+<div class="header">
+<!--+
+ |start group logo
+ +-->
+<div class="grouplogo">
+<a href="http://ws.apache.org/"><img class="logoImage" alt="Web Services" src="../images/ws-logo.gif"></a>
+</div>
+<!--+
+ |end group logo
+ +-->
+<!--+
+ |start Project Logo
+ +-->
+<div class="projectlogoA1">
+<a href="http://ws.apache.org/ws-fx/muse/"><img class="logoImage" alt="Muse" src="../images/muse-logo.gif"></a>
+</div>
+<!--+
+ |end Project Logo
+ +-->
+<!--+
+ |start Tabs
+ +-->
+<ul id="tabs">
+<li>
+<a class="base-not-selected" href="../index.html">Project Info</a>
+</li>
+<li class="current">
+<a class="base-selected" href="../getting_started.html">Documentation</a>
+</li>
+<li>
+<a class="base-not-selected" href="../apidocs/index.html">API Docs</a>
+</li>
+</ul>
+<!--+
+ |end Tabs
+ +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+ |start Subtabs
+ +-->
+<div id="level2tabs"></div>
+<!--+
+ |end Endtabs
+ +-->
+<script type="text/javascript" language="JavaScript"><!--
+ document.write("Published: " + document.lastModified);
+ // --></script>
+</div>
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+
+
+ </div>
+<!--+
+ |start Menu, mainarea
+ +-->
+<!--+
+ |start Menu
+ +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_1.1', '../skin/')" id="menu_1.1Title" class="menutitle">Getting Started</div>
+<div id="menu_1.1" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../getting_started.html">Introduction</a>
+</div>
+<div class="menuitem">
+<a title="" href="../getting_started.html#install">Installation</a>
+</div>
+<div class="menuitem">
+<a title="" href="../getting_started.html#qd">Quick Demo</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.2', '../skin/')" id="menu_selected_1.2Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Tutorial</div>
+<div id="menu_selected_1.2" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a title="" href="../tutorial/index.html">Overview</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/setup.html">Create Workspace</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">Create WSDLs</div>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/wsdl2java.html">Run wsdl2Java Tool</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/mod_home.html">Modify Home Classes</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/mod_resource.html">Modify Resource Classes</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/mod_service.html">Modify Service Class</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/webapp.html">Deploy Services</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/test.html">Test</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.3', '../skin/')" id="menu_1.3Title" class="menutitle">Developer Guide</div>
+<div id="menu_1.3" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../dev_guide/index.html">Overview</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/wsdl.html">MuWS WSDL</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/wsdl_tool.html">Using Wsdl2Java</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/home.html">Home Class</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/muws_topics.html">MUWS-Specific Topics</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/relationships.html">Relationships</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/advertiser.html">Advertiser Service</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/deploy.html">Deploying</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/client.html">Using the SOAP Client</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/debug.html">Logging</a>
+</div>
+</div>
+<div id="credit"></div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+ |alternative credits
+ +-->
+</div>
+<!--+
+ |end Menu
+ +-->
+<!--+
+ |start content
+ +-->
+<div id="content">
+<div id="skinconf-txtlink"></div>
+<h1>Create MUWS WSDLs</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#Introduction">Introduction</a>
+</li>
+<li>
+<a href="#Copy+the+WSDLs">Copy the WSDLs</a>
+</li>
+</ul>
+</div>
+
+<a name="N1000C"></a><a name="Introduction"></a>
+<h2 class="boxed">Introduction</h2>
+<div class="section">
+<p>In this step of the tutorial, MUWS-compliant WSDLs are created for the filesystem resource and the host resource. In the interest of time, the
+ <span class="codefrag">FileSystem.wsdl</span>, and <span class="codefrag">host.wsdl</span> have already been created for use in this tutorial.
+ </p>
+<p> The WSDLs were created using the MUWS WSDL template (<span class="codefrag">WORK_DIR/_TEMPLATE_.wsdl</span>). 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 MUWS-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 WSDM, WSRF, or WSN family of specifications. Detailed instructions for
+ composing the WSDLs using the template are provided in the <a href="../dev_guide/wsdl.html">Developer Guide</a>.
+ </p>
+<p>Both the FileSystem WSDL and Host WSDL are an example of a MUWS WSDL that contains a single portType
+ (<span class="codefrag">FileSystemPortType</span> and <span class="codefrag">HostPortType</span> respectively). The FileSystem WSDL exposes operations defined by the WSRF-RP,
+ WSRF-RL, WSN-BN, and MUWS. The WSDL also defines two custom operations, <span class="codefrag">Mount</span> and <span class="codefrag">Unmount</span>, as well as corresponding custom
+ resource properties. The Host WSDL is very basic and only contains a single operation from WSRF-RP (getResourceProperty). The host resource is only used to
+ demonstrate how different resources can be related. Most of the interaction with these WS Resources is done through FileSystem.
+ </p>
+</div>
+
+<a name="N10035"></a><a name="Copy+the+WSDLs"></a>
+<h2 class="boxed">Copy the WSDLs</h2>
+<div class="section">
+<p>Copy <span class="codefrag">INSTALL_DIR/examples/filesystem/src/wsdl/FileSystem.wsdl</span> and <span class="codefrag">Host.wsdl</span> to <span class="codefrag">WORK_DIR</span>.</p>
+<p>
+
+<img alt="go to the previous step" src="images/back.gif">
+ <a href="../tutorial/setup.html">Back</a>
+ <img alt="go to the next step" src="images/next.gif">
+ <a href="../tutorial/wsdl2java.html">Next</a>
+
+</p>
+</div>
+
+</div>
+<!--+
+ |end content
+ +-->
+<div class="clearboth"> </div>
+</div>
+<div id="footer">
+<!--+
+ |start bottomstrip
+ +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+// --></script>
+</div>
+<div class="copyright">
+ Copyright © 2004 The Apache Software Foundation.</div>
+<!--+
+ |end bottomstrip
+ +-->
+</div>
+</body>
+</html>
Added: webservices/muse/site/tutorial/wsdl2java.html
URL: http://svn.apache.org/viewcvs/webservices/muse/site/tutorial/wsdl2java.html?rev=230467&view=auto
==============================================================================
--- webservices/muse/site/tutorial/wsdl2java.html (added)
+++ webservices/muse/site/tutorial/wsdl2java.html Fri Aug 5 06:45:22 2005
@@ -0,0 +1,282 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.6">
+<meta name="Forrest-skin-name" content="pelt">
+<title>Run the Wsdl2Java Tool</title>
+<link type="text/css" href="../skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="../skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="../skin/print.css" rel="stylesheet">
+<link type="text/css" href="../skin/profile.css" rel="stylesheet">
+<script src="../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../skin/fontsize.js" language="javascript" type="text/javascript"></script>
+<link rel="shortcut icon" href="../images/apache.ico">
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache</a> > <a href="http://ws.apache.org">ws.apache</a><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+ |header
+ +-->
+<div class="header">
+<!--+
+ |start group logo
+ +-->
+<div class="grouplogo">
+<a href="http://ws.apache.org/"><img class="logoImage" alt="Web Services" src="../images/ws-logo.gif"></a>
+</div>
+<!--+
+ |end group logo
+ +-->
+<!--+
+ |start Project Logo
+ +-->
+<div class="projectlogoA1">
+<a href="http://ws.apache.org/ws-fx/muse/"><img class="logoImage" alt="Muse" src="../images/muse-logo.gif"></a>
+</div>
+<!--+
+ |end Project Logo
+ +-->
+<!--+
+ |start Tabs
+ +-->
+<ul id="tabs">
+<li>
+<a class="base-not-selected" href="../index.html">Project Info</a>
+</li>
+<li class="current">
+<a class="base-selected" href="../getting_started.html">Documentation</a>
+</li>
+<li>
+<a class="base-not-selected" href="../apidocs/index.html">API Docs</a>
+</li>
+</ul>
+<!--+
+ |end Tabs
+ +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+ |start Subtabs
+ +-->
+<div id="level2tabs"></div>
+<!--+
+ |end Endtabs
+ +-->
+<script type="text/javascript" language="JavaScript"><!--
+ document.write("Published: " + document.lastModified);
+ // --></script>
+</div>
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+
+
+ </div>
+<!--+
+ |start Menu, mainarea
+ +-->
+<!--+
+ |start Menu
+ +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_1.1', '../skin/')" id="menu_1.1Title" class="menutitle">Getting Started</div>
+<div id="menu_1.1" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../getting_started.html">Introduction</a>
+</div>
+<div class="menuitem">
+<a title="" href="../getting_started.html#install">Installation</a>
+</div>
+<div class="menuitem">
+<a title="" href="../getting_started.html#qd">Quick Demo</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.2', '../skin/')" id="menu_selected_1.2Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Tutorial</div>
+<div id="menu_selected_1.2" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a title="" href="../tutorial/index.html">Overview</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/setup.html">Create Workspace</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/wsdl.html">Create WSDLs</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">Run wsdl2Java Tool</div>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/mod_home.html">Modify Home Classes</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/mod_resource.html">Modify Resource Classes</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/mod_service.html">Modify Service Class</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/webapp.html">Deploy Services</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/test.html">Test</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.3', '../skin/')" id="menu_1.3Title" class="menutitle">Developer Guide</div>
+<div id="menu_1.3" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../dev_guide/index.html">Overview</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/wsdl.html">MuWS WSDL</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/wsdl_tool.html">Using Wsdl2Java</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/home.html">Home Class</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/muws_topics.html">MUWS-Specific Topics</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/relationships.html">Relationships</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/advertiser.html">Advertiser Service</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/deploy.html">Deploying</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/client.html">Using the SOAP Client</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/debug.html">Logging</a>
+</div>
+</div>
+<div id="credit"></div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+ |alternative credits
+ +-->
+</div>
+<!--+
+ |end Menu
+ +-->
+<!--+
+ |start content
+ +-->
+<div id="content">
+<div id="skinconf-txtlink"></div>
+<h1>Run the Wsdl2Java Tool</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#Introduction">Introduction</a>
+</li>
+<li>
+<a href="#Generating+the+Artifacts">Generating the Artifacts</a>
+</li>
+</ul>
+</div>
+
+<a name="N1000C"></a><a name="Introduction"></a>
+<h2 class="boxed">Introduction</h2>
+<div class="section">
+<p>In this step of the tutorial, the MUWS Wsdl2Java tool is used to generate a set of artifacts for the filesystem and host example. The tool takes any number of WSDL files
+ as its input and outputs the following artifacts for each WSDL:
+ </p>
+<ul>
+
+<li>
+
+<a class="external" href="http://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>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">The abstract classes and interfaces should NEVER be modified.</div>
+</div>
+</div>
+
+<a name="N10041"></a><a name="Generating+the+Artifacts"></a>
+<h2 class="boxed">Generating the Artifacts</h2>
+<div class="section">
+<p>The Ant script (<span class="codefrag">WORK_DIR/build.xml</span>) contains a target for the Wsdl2Java tool. To generate the artifacts for the
+ filesystem and host example:</p>
+<ol>
+
+<li>From a command prompt, change directories to <span class="codefrag">WORK_DIR</span>.</li>
+
+<li>Enter the following command: <span class="codefrag">ant generate</span>
+
+</li>
+
+</ol>
+<p>The artifacts are generated and placed in <span class="codefrag">WORK_DIR/generated</span>. For more information about the
+ WSDL2Java tool and the generated artifacts, see <a href="../dev_guide/wsdl_tool.html">Using the WSDL2Java Tool</a> in the Developer's Guide.</p>
+<p>
+
+<img alt="go to the previous step" src="images/back.gif">
+ <a href="../tutorial/wsdl.html">Back</a>
+ <img alt="go to the next step" src="images/next.gif">
+ <a href="../tutorial/mod_home.html">Next</a>
+
+</p>
+</div>
+
+</div>
+<!--+
+ |end content
+ +-->
+<div class="clearboth"> </div>
+</div>
+<div id="footer">
+<!--+
+ |start bottomstrip
+ +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+// --></script>
+</div>
+<div class="copyright">
+ Copyright © 2004 The Apache Software Foundation.</div>
+<!--+
+ |end bottomstrip
+ +-->
+</div>
+</body>
+</html>
---------------------------------------------------------------------
To unsubscribe, e-mail: muse-dev-unsubscribe@ws.apache.org
For additional commands, e-mail: muse-dev-help@ws.apache.org