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 [1/6] - in /webservices/muse/site: ./ dev_guide/ images/
skin/ skin/css/ skin/images/ skin/scripts/ tutorial/ tutorial/images/
Author: scamp
Date: Fri Aug 5 06:45:22 2005
New Revision: 230467
URL: http://svn.apache.org/viewcvs?rev=230467&view=rev
Log:
added new
Added:
webservices/muse/site/contact_info.html
webservices/muse/site/dev_guide/
webservices/muse/site/dev_guide/advertiser.html
webservices/muse/site/dev_guide/client.html
webservices/muse/site/dev_guide/debug.html
webservices/muse/site/dev_guide/deploy.html
webservices/muse/site/dev_guide/home.html
webservices/muse/site/dev_guide/index.html
webservices/muse/site/dev_guide/muws_topics.html
webservices/muse/site/dev_guide/relationships.html
webservices/muse/site/dev_guide/wsdl.html
webservices/muse/site/dev_guide/wsdl_tool.html
webservices/muse/site/getting_started.html
webservices/muse/site/images/
webservices/muse/site/images/apache.ico (with props)
webservices/muse/site/images/built-with-forrest-button.png (with props)
webservices/muse/site/images/muse-logo.gif (with props)
webservices/muse/site/images/ws-logo.gif (with props)
webservices/muse/site/index.html
webservices/muse/site/issue_tracking.html
webservices/muse/site/linkmap.html
webservices/muse/site/muws.html
webservices/muse/site/release.html
webservices/muse/site/release_notes.html
webservices/muse/site/skin/
webservices/muse/site/skin/basic.css
webservices/muse/site/skin/breadcrumbs-optimized.js
webservices/muse/site/skin/breadcrumbs.js
webservices/muse/site/skin/css/
webservices/muse/site/skin/fontsize.js
webservices/muse/site/skin/forrest.css.xslt
webservices/muse/site/skin/getBlank.js
webservices/muse/site/skin/getMenu.js
webservices/muse/site/skin/images/
webservices/muse/site/skin/images/README.txt
webservices/muse/site/skin/images/add.jpg (with props)
webservices/muse/site/skin/images/built-with-forrest-button.png (with props)
webservices/muse/site/skin/images/chapter.gif (with props)
webservices/muse/site/skin/images/chapter_open.gif (with props)
webservices/muse/site/skin/images/corner-imports.svg.xslt
webservices/muse/site/skin/images/current.gif (with props)
webservices/muse/site/skin/images/dc.svg.xslt
webservices/muse/site/skin/images/error.png (with props)
webservices/muse/site/skin/images/external-link.gif (with props)
webservices/muse/site/skin/images/fix.jpg (with props)
webservices/muse/site/skin/images/forrest-credit-logo.png (with props)
webservices/muse/site/skin/images/hack.jpg (with props)
webservices/muse/site/skin/images/header_white_line.gif (with props)
webservices/muse/site/skin/images/info.png (with props)
webservices/muse/site/skin/images/label.gif (with props)
webservices/muse/site/skin/images/page.gif (with props)
webservices/muse/site/skin/images/pdfdoc.gif (with props)
webservices/muse/site/skin/images/poddoc.png (with props)
webservices/muse/site/skin/images/poddoc.svg.xslt
webservices/muse/site/skin/images/printer.gif (with props)
webservices/muse/site/skin/images/rc-b-l-15-1body-2menu-3menu.png (with props)
webservices/muse/site/skin/images/rc-b-r-15-1body-2menu-3menu.png (with props)
webservices/muse/site/skin/images/rc-b-r-5-1header-2tab-selected-3tab-selected.png (with props)
webservices/muse/site/skin/images/rc-t-l-5-1header-2searchbox-3searchbox.png (with props)
webservices/muse/site/skin/images/rc-t-l-5-1header-2tab-selected-3tab-selected.png (with props)
webservices/muse/site/skin/images/rc-t-l-5-1header-2tab-unselected-3tab-unselected.png (with props)
webservices/muse/site/skin/images/rc-t-r-15-1body-2menu-3menu.png (with props)
webservices/muse/site/skin/images/rc-t-r-5-1header-2searchbox-3searchbox.png (with props)
webservices/muse/site/skin/images/rc-t-r-5-1header-2tab-selected-3tab-selected.png (with props)
webservices/muse/site/skin/images/rc-t-r-5-1header-2tab-unselected-3tab-unselected.png (with props)
webservices/muse/site/skin/images/rc.svg.xslt
webservices/muse/site/skin/images/remove.jpg (with props)
webservices/muse/site/skin/images/rss.png (with props)
webservices/muse/site/skin/images/spacer.gif (with props)
webservices/muse/site/skin/images/success.png (with props)
webservices/muse/site/skin/images/update.jpg (with props)
webservices/muse/site/skin/images/valid-html401.png (with props)
webservices/muse/site/skin/images/vcss.png (with props)
webservices/muse/site/skin/images/warning.png (with props)
webservices/muse/site/skin/images/xmldoc.gif (with props)
webservices/muse/site/skin/menu.js
webservices/muse/site/skin/note.txt
webservices/muse/site/skin/print.css
webservices/muse/site/skin/profile.css
webservices/muse/site/skin/profile.css.xslt
webservices/muse/site/skin/screen.css
webservices/muse/site/skin/scripts/
webservices/muse/site/skin/skinconf.xsl
webservices/muse/site/tutorial/
webservices/muse/site/tutorial/images/
webservices/muse/site/tutorial/images/back.gif (with props)
webservices/muse/site/tutorial/images/next.gif (with props)
webservices/muse/site/tutorial/index.html
webservices/muse/site/tutorial/mod_home.html
webservices/muse/site/tutorial/mod_resource.html
webservices/muse/site/tutorial/mod_service.html
webservices/muse/site/tutorial/setup.html
webservices/muse/site/tutorial/test.html
webservices/muse/site/tutorial/webapp.html
webservices/muse/site/tutorial/wsdl.html
webservices/muse/site/tutorial/wsdl2java.html
webservices/muse/site/version_control.html
Added: webservices/muse/site/contact_info.html
URL: http://svn.apache.org/viewcvs/webservices/muse/site/contact_info.html?rev=230467&view=auto
==============================================================================
--- webservices/muse/site/contact_info.html (added)
+++ webservices/muse/site/contact_info.html Fri Aug 5 06:45:22 2005
@@ -0,0 +1,269 @@
+<!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>Muse Contact Information</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 class="current">
+<a class="base-selected" href="index.html">Project Info</a>
+</li>
+<li>
+<a class="base-not-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_selected_1.1', 'skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('skin/images/chapter_open.gif');">Project Info</div>
+<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a title="" href="index.html">Overview</a>
+</div>
+<div class="menuitem">
+<a title="" href="version_control.html">Version Control</a>
+</div>
+<div class="menuitem">
+<a title="" href="issue_tracking.html">Issue Tracking</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">Contact Info</div>
+</div>
+<div class="menuitem">
+<a title="" href="release_notes.html">Release Notes</a>
+</div>
+<div class="menuitem">
+<a title="" href="muws.html">WSDM Specs</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.2', 'skin/')" id="menu_1.2Title" class="menutitle">Downloads</div>
+<div id="menu_1.2" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="release.html">Releases</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>Muse Contact Information</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#Mailing+Lists">Mailing Lists</a>
+<ul class="minitoc">
+<li>
+<a href="#muse-user">muse-user</a>
+</li>
+<li>
+<a href="#muse-dev">muse-dev</a>
+</li>
+<li>
+<a href="#muse-commits">muse-commits</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#Chat+Room">Chat Room</a>
+</li>
+</ul>
+</div>
+
+<a name="N1000C"></a><a name="Mailing+Lists"></a>
+<h2 class="boxed">Mailing Lists</h2>
+<div class="section">
+<p>
+ There are currently three mailing lists for the project: muse-user, muse-dev, and muse-commits.
+ </p>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">In order to post to one of the lists, it is necessary to first subscribe to it.</div>
+</div>
+<a name="N10018"></a><a name="muse-user"></a>
+<h3 class="boxed">muse-user</h3>
+<p>This list is for developers that are using Muse in their own projects to ask questions,
+ share knowledge, and discuss issues related to using Muse.</p>
+<ul>
+
+<li>
+<a href="mailto:muse-user-subscribe.at.ws.apache.org">Subscribe to List</a>
+</li>
+
+<li>
+<a href="mailto:muse-user-unsubscribe.at.ws.apache.org">Unsubscribe from List</a>
+</li>
+
+<li>
+<a href="mailto:muse-user.at.ws.apache.org">Post to List</a>
+</li>
+
+<li>Archives: <a href="http://ws.apache.org/mail/muse-user/">Apache</a> ,
+ <a class="external" href="http://marc.theaimsgroup.com/?l=muse-user&r=1&w=2/">MARC</a>
+</li>
+
+</ul>
+<a name="N1003E"></a><a name="muse-dev"></a>
+<h3 class="boxed">muse-dev</h3>
+<p>This is the list where developers of the Muse project discuss issues, code changes/additions, etc.</p>
+<ul>
+
+<li>
+<a href="mailto:muse-dev-subscribe.at.ws.apache.org">Subscribe to List</a>
+</li>
+
+<li>
+<a href="mailto:muse-dev-unsubscribe.at.ws.apache.org">Unsubscribe from List</a>
+</li>
+
+<li>
+<a href="mailto:muse-dev.at.ws.apache.org">Post to List</a>
+</li>
+
+<li>Archives: <a href="http://ws.apache.org/mail/muse-dev/">Apache</a> ,
+ <a class="external" href="http://marc.theaimsgroup.com/?l=muse-dev&r=1&w=2/">MARC</a>
+</li>
+
+</ul>
+<a name="N10064"></a><a name="muse-commits"></a>
+<h3 class="boxed">muse-commits</h3>
+<p>This list is for those who wish to be notified whenever files are committed to the Muse SVN repository.</p>
+<ul>
+
+<li>
+<a href="mailto:muse-commits-subscribe.at.ws.apache.org">Subscribe to List</a>
+</li>
+
+<li>
+<a href="mailto:muse-commits-unsubscribe.at.ws.apache.org">Unsubscribe from List</a>
+</li>
+
+<li>
+<a href="mailto:muse-commits.at.ws.apache.org">Post to List</a>
+</li>
+
+<li>Archives: <a href="http://ws.apache.org/mail/muse-commits/">Apache</a> ,
+ <a class="external" href="http://marc.theaimsgroup.com/?l=muse-commits&r=1&w=2/">MARC</a>
+</li>
+
+</ul>
+</div>
+
+<a name="N1008B"></a><a name="Chat+Room"></a>
+<h2 class="boxed">Chat Room</h2>
+<div class="section">
+<p>
+ Muse developers can often be found on the
+ <a class="external" href="irc://irc.freenode.net/apache-ws"><span class="codefrag">#apache-ws</span> channel on the
+ <span class="codefrag">irc.freenode.net</span> IRC server</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/dev_guide/advertiser.html
URL: http://svn.apache.org/viewcvs/webservices/muse/site/dev_guide/advertiser.html?rev=230467&view=auto
==============================================================================
--- webservices/muse/site/dev_guide/advertiser.html (added)
+++ webservices/muse/site/dev_guide/advertiser.html Fri Aug 5 06:45:22 2005
@@ -0,0 +1,330 @@
+<!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>Using the Resource Advertiser Service</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_1.2', '../skin/')" id="menu_1.2Title" class="menutitle">Tutorial</div>
+<div id="menu_1.2" class="menuitemgroup">
+<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="menuitem">
+<a title="" href="../tutorial/test.html">Test</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.3', '../skin/')" id="menu_selected_1.3Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Developer Guide</div>
+<div id="menu_selected_1.3" class="selectedmenuitemgroup" style="display: block;">
+<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="menupage">
+<div class="menupagetitle">Advertiser Service</div>
+</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>Using the Resource Advertiser Service</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#Introduction">Introduction</a>
+</li>
+<li>
+<a href="#Resource+Advertiser+Messages">Resource Advertiser Messages</a>
+<ul class="minitoc">
+<li>
+<a href="#Subscribe+to+Creation+Notifications">Subscribe to Creation Notifications</a>
+</li>
+<li>
+<a href="#Subscribe+to+Destruction+Notifications">Subscribe to Destruction Notifications</a>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+
+<a name="N1000C"></a><a name="Introduction"></a>
+<h2 class="boxed">Introduction</h2>
+<div class="section">
+<p>The MUWS specification defines an Advertisement capability that provides a notification whenever a manageable resource is created or destroyed. The
+ capability includes no operations or properties, but contains four topics:</p>
+<ul>
+
+<li>
+
+<span class="codefrag">ManageableResourceCreation</span>
+
+</li>
+
+<li>
+
+<span class="codefrag">ManageableResourceDestruction</span>
+
+</li>
+
+<li>
+
+<span class="codefrag">ManageabilityEndpointCreation</span>
+
+</li>
+
+<li>
+
+<span class="codefrag">ManageabilityEndpointDestruction</span>
+
+</li>
+
+</ul>
+<p>Muse implements these topics as part of the <span class="codefrag">ResourceAdvertiser</span> service that is deployed by default in Muse. Therefore, it does not have to be
+ defined in a MUWS WSDL. This ensures that these topics are always created without having to directly implement them in your WS Resource.
+ </p>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">Muse does not implement the <span class="codefrag">ManageabilityEndpointCreation</span> and <span class="codefrag">ManageabilityEndpointDestruction</span> topics.</div>
+</div>
+</div>
+
+<a name="N10040"></a><a name="Resource+Advertiser+Messages"></a>
+<h2 class="boxed">Resource Advertiser Messages</h2>
+<div class="section">
+<p>Messages to subscribe to advertisement topics are sent to the <span class="codefrag">ResourceAdvertiser</span> service. This service is deployed by default when you deploy
+ the Muse Web application. The service utilizes the <span class="codefrag">Subscribe</span> and <span class="codefrag">GetCurrentMessage</span> operations that are defined in the
+ WS-BaseNotification specification and implemented in Apache Pubscribe. The service can also be used to send <span class="codefrag">GetResourceProperty</span> and
+ <span class="codefrag">GetMultipleResourceProperties</span> messages. These operations are defined in the WS-ResourceProperties specification and implemented in Apache
+ WSRF.
+ </p>
+<p>The below requests demonstrate how to subscribe to the resource creation and destruction topics. The requests would be sent to the advertiser service (e.g. http://localhost:8080/muse/services/ResourceAdvertiser
+ </p>
+<p>A selector can optionally be included in the subscribe requests to indicate that you are only interested in the creation or destruction of resources of a particular type.</p>
+<a name="N1005E"></a><a name="Subscribe+to+Creation+Notifications"></a>
+<h3 class="boxed">Subscribe to Creation Notifications</h3>
+<pre class="code">
+<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/"
+ xmlns:wsa03="http://schemas.xmlsoap.org/ws/2003/03/addressing">
+
+ <Header>
+ <wsa03:To mustUnderstand="1">http://localhost:8080/muse/services/ResourceAdvertiser</wsa03:To>
+ <wsa03:Action mustUnderstand="1">http://docs.oasis-open.org/wsn/2004/06/WS-BaseNotification/Subscribe</wsa03:Action>
+ </Header>
+
+ <Body>
+ <wsnt:Subscribe xmlns:wsnt="http://docs.oasis-open.org/wsn/2004/06/wsn-WS-BaseNotification-1.2-draft-01.xsd">
+
+ <wsnt:ConsumerReference>
+ <wsa03:Address>http://localhost:909/services/consumer</wsa03:Address>
+ </wsnt:ConsumerReference>
+
+ <wsnt:TopicExpression Dialect="http://docs.oasis-open.org/wsn/2004/06/TopicExpression/Concrete"
+ xmlns:muws-p2-topics="http://docs.oasis-open.org/wsdm/2004/12/muws/wsdm-muws-part2-events.xml">muws-p2-topics:ManageabilityEndpointCreation/ManageableResourceCreation</wsnt:TopicExpression>
+
+ </wsnt:Subscribe>
+ </Body>
+
+</Envelope></pre>
+<a name="N10069"></a><a name="Subscribe+to+Destruction+Notifications"></a>
+<h3 class="boxed">Subscribe to Destruction Notifications</h3>
+<pre class="code">
+<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/"
+ xmlns:wsa03="http://schemas.xmlsoap.org/ws/2003/03/addressing">
+
+ <Header>
+ <wsa03:To mustUnderstand="1">http://localhost:8080/muse/services/ResourceAdvertiser</wsa03:To>
+ <wsa03:Action mustUnderstand="1">http://docs.oasis-open.org/wsn/2004/06/WS-BaseNotification/Subscribe</wsa03:Action>
+ </Header>
+
+ <Body>
+ <wsnt:Subscribe xmlns:wsnt="http://docs.oasis-open.org/wsn/2004/06/wsn-WS-BaseNotification-1.2-draft-01.xsd">
+
+ <wsnt:ConsumerReference>
+ <wsa03:Address>http://localhost:909/services/consumer</wsa03:Address>
+ </wsnt:ConsumerReference>
+
+ <wsnt:TopicExpression Dialect="http://docs.oasis-open.org/wsn/2004/06/TopicExpression/Concrete"
+ xmlns:muws-p2-topics="http://docs.oasis-open.org/wsdm/2004/12/muws/wsdm-muws-part2-events.xml">muws-p2-topics:ManageabilityEndpointDestruction/ManageableResourceDestruction</wsnt:TopicExpression>
+
+ </wsnt:Subscribe>
+ </Body>
+
+</Envelope></pre>
+</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/dev_guide/client.html
URL: http://svn.apache.org/viewcvs/webservices/muse/site/dev_guide/client.html?rev=230467&view=auto
==============================================================================
--- webservices/muse/site/dev_guide/client.html (added)
+++ webservices/muse/site/dev_guide/client.html Fri Aug 5 06:45:22 2005
@@ -0,0 +1,263 @@
+<!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>SOAP Client</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_1.2', '../skin/')" id="menu_1.2Title" class="menutitle">Tutorial</div>
+<div id="menu_1.2" class="menuitemgroup">
+<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="menuitem">
+<a title="" href="../tutorial/test.html">Test</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.3', '../skin/')" id="menu_selected_1.3Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Developer Guide</div>
+<div id="menu_selected_1.3" class="selectedmenuitemgroup" style="display: block;">
+<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="menupage">
+<div class="menupagetitle">Using the SOAP Client</div>
+</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>SOAP Client</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#intro">Introduction</a>
+</li>
+<li>
+<a href="#SOAP+Files">SOAP Files</a>
+</li>
+<li>
+<a href="#Running+the+Client">Running the Client</a>
+</li>
+</ul>
+</div>
+
+<a name="N1000C"></a><a name="intro"></a>
+<h2 class="boxed">Introduction</h2>
+<div class="section">
+<p>Muse includes a lightweight SOAP client that can be used to test your services. The client is invoked using an Ant script, which is located in
+ <span class="codefrag">INSTALL_DIR/template/soapclient.xml</span>. Request and response messages are viewed in the Ant output. This section explains how to use the client and
+ how to build request SOAP messages for the client.</p>
+</div>
+
+<a name="N10019"></a><a name="SOAP+Files"></a>
+<h2 class="boxed">SOAP Files</h2>
+<div class="section">
+<p>The client reads a <span class="codefrag">.soap</span> file which contains the SOAP envelope to be sent. Examples of SOAP files are located in
+ <span class="codefrag">INSTALL_DIR/examples/filesystem/requests/</span>. Each file is named appropriately based on the operation it contains. Use these files as models when
+ creating your own .soap files. Make sure you modify the WS-Addressing header for the resource identifier to match the entry that is in the JNDI
+ configuration file and the resource identifier for the instance you would like to invoke. The id is used by the invocation framework to lookup a particular resource instance.</p>
+</div>
+
+<a name="N10029"></a><a name="Running+the+Client"></a>
+<h2 class="boxed">Running the Client</h2>
+<div class="section">
+<p>To invoke the script:</p>
+<ol>
+
+<li>Make sure your WS Resource is deployed.</li>
+
+<li>open a command prompt and change directories to <span class="codefrag">INSTALL_DIR/template/soapclient.xml</span>.</li>
+
+<li>Run:
+ <pre class="code">ant -f soapclient.xml sendRequest -Durl=http://localhost:8080/muse/services/<em>your_service</em> -Dxml=./requests/Subscribe_updateMountPointProp.soap</pre>
+
+<p>Where <em>your_service</em> represents your WS Resource endpoint name, and the script name should be the name (including the path) of your .soap file.
+ </p>
+
+</li>
+
+</ol>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">You can add an entry to <span class="codefrag">build.properties</span> for the <span class="codefrag">url</span> property, which alleviates the need
+ to specify it on the command line.</div>
+</div>
+</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/dev_guide/debug.html
URL: http://svn.apache.org/viewcvs/webservices/muse/site/dev_guide/debug.html?rev=230467&view=auto
==============================================================================
--- webservices/muse/site/dev_guide/debug.html (added)
+++ webservices/muse/site/dev_guide/debug.html Fri Aug 5 06:45:22 2005
@@ -0,0 +1,257 @@
+<!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>Logging</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_1.2', '../skin/')" id="menu_1.2Title" class="menutitle">Tutorial</div>
+<div id="menu_1.2" class="menuitemgroup">
+<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="menuitem">
+<a title="" href="../tutorial/test.html">Test</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.3', '../skin/')" id="menu_selected_1.3Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Developer Guide</div>
+<div id="menu_selected_1.3" class="selectedmenuitemgroup" style="display: block;">
+<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="menupage">
+<div class="menupagetitle">Logging</div>
+</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>Logging</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#Introduction">Introduction</a>
+</li>
+<li>
+<a href="#Changing+Log+Levels">Changing Log Levels</a>
+</li>
+</ul>
+</div>
+
+<a name="N1000C"></a><a name="Introduction"></a>
+<h2 class="boxed">Introduction</h2>
+<div class="section">
+<p>Muse uses the Apache Commons Logging Framework with Log4j as the underlying logging system. You can configure Log4j using the log4j.properties
+ file. This includes changing log levels or where the output is emitted (e.g. stdout, log file, etc...). The properties file is located in the Muse Web application in
+ the WEB-INF/classes directory.
+ </p>
+</div>
+
+<a name="N10016"></a><a name="Changing+Log+Levels"></a>
+<h2 class="boxed">Changing Log Levels</h2>
+<div class="section">
+<p>Log4j uses the following log levels: DEBUG, INFO, WARN, ERROR, and FATAL. By default, Apache WSRF is configured at the INFO level, which means messages logged
+ at INFO or higher level (i.e. INFO, WARN, ERROR, and FATAL) are included in the output. To see more detailed log messages, you must change the log level.
+ The following example assumes Tomcat.
+ </p>
+<p>To change the logging level:</p>
+<ol>
+
+<li>Using a text editor, open the log4j.properties file located in the WEB-INF/classes directory of the deployed Muse Web application.</li>
+
+<li>Change the log level associated with all classes below the <span class="codefrag">log4j.category.org.apache.ws</span> package. For example:<pre class="code">
+log4j.category.org.apache.ws=DEBUG</pre>
+
+</li>
+
+<li>Save the log4j.properties file.</li>
+
+<li>Restart Tomcat.
+ <div class="frame note">
+<div class="label">Note</div>
+<div class="content">Log messages are displayed in Tomcat's standard output. If you are not using Tomcat, you may need to configure your Web container to include the output
+ in its standard output.</div>
+</div>
+
+</li>
+
+</ol>
+</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/dev_guide/deploy.html
URL: http://svn.apache.org/viewcvs/webservices/muse/site/dev_guide/deploy.html?rev=230467&view=auto
==============================================================================
--- webservices/muse/site/dev_guide/deploy.html (added)
+++ webservices/muse/site/dev_guide/deploy.html Fri Aug 5 06:45:22 2005
@@ -0,0 +1,404 @@
+<!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>Deploy the Service to the Muse Web Application</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_1.2', '../skin/')" id="menu_1.2Title" class="menutitle">Tutorial</div>
+<div id="menu_1.2" class="menuitemgroup">
+<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="menuitem">
+<a title="" href="../tutorial/test.html">Test</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.3', '../skin/')" id="menu_selected_1.3Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Developer Guide</div>
+<div id="menu_selected_1.3" class="selectedmenuitemgroup" style="display: block;">
+<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="menupage">
+<div class="menupagetitle">Deploying</div>
+</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>Deploy the Service to the Muse Web Application</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#intro">Introduction</a>
+</li>
+<li>
+<a href="#Using+the+generated+build+scripts">Using the generated build scripts</a>
+</li>
+<li>
+<a href="#steps">Manually Deploying your Service</a>
+</li>
+</ul>
+</div>
+
+<a name="N1000C"></a><a name="intro"></a>
+<h2 class="boxed">Introduction</h2>
+<div class="section">
+<p>The quickest way to deploy your WS Resource is to use the generated build scripts. The scripts compile and delploy your WS
+ Resource to the Muse Web application, which is an Apache-Axis Web application. This section describes how to use the
+ generated build scripts and also how the script works so you can build your own scripts.</p>
+</div>
+
+<a name="N10016"></a><a name="Using+the+generated+build+scripts"></a>
+<h2 class="boxed">Using the generated build scripts</h2>
+<div class="section">
+<p>The Wsdl2Java tool generates an Ant build script that is used to compile and deploy your WS Resource. The script is located in the
+ output directory under the subdirectory for you WS Resource (e.g., <span class="codefrag">generated/</span>
+ <em>
+ <span class="codefrag">service_name</span>
+ </em>).</p>
+<p>To compile and deploy using the Ant script</p>
+<ol>
+
+<li>from your output directory, edit build.properties and 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">generated/</span>
+ <em>
+ <span class="codefrag">service_name</span>
+ </em>
+
+</li>
+
+<li>Run:</li>
+
+</ol>
+<pre class="code">
+ ant compile deploy </pre>
+<p>Start Tomcat and verify that the service is deployed by going to
+ <a class="external" href="http://localhost:8080/muse/services">http://localhost:8080/muse/services</a>
+
+</p>
+</div>
+
+<a name="N10058"></a><a name="steps"></a>
+<h2 class="boxed">Manually Deploying your Service</h2>
+<div class="section">
+<p>In this section we will describe how to manually deploy your service. We will describe each step in the process.</p>
+<ol>
+
+<li>
+
+<strong>Copy your WSDL file.</strong>
+
+<p>Your WSDL file needs to be copied to an appropriate location in the webapp. We recommend you put it in the
+ <span class="codefrag">muse/WEB-INF/classes/wsdl</span> directory. This allows Axis to reference it from the classpath and avoids the need to
+ hard-code a location on your file system. This location is used when registering the service in the
+ <span class="codefrag">server-config.wsdd</span> file.
+ </p>
+
+</li>
+
+<li>
+
+<strong>Copy your classes.</strong>
+
+<p>You will need to copy any .class files, generated by Wsdl2Java or hand written, to the <span class="codefrag">muse/WEB-INF/classes/</span> directory so that your service
+ can be created by Axis and Muse.</p>
+
+</li>
+
+<li>
+
+<strong>Update the jndi-config.xml file.</strong>
+
+<p>The jndi-config.xml contains information about your service, resource, home and resource identifier. This information is necessary for
+ Muse to create your home and handle requests for your service. It will setup the in-memory JNDI context for your classes.
+ Here is the entry that was used for the FileSystem example:</p>
+
+<pre class="code"> <service name="filesystem">
+ <resource name="home" type="example.filesystem.FileSystemHome">
+ <resourceParams>
+ <parameter>
+ <name>baseWebappUrl</name>
+ <value>http://$IP_ADDRESS$:8080/muse</value>
+ </parameter>
+ <parameter>
+ <name>serviceClassName</name>
+ <value>example.filesystem.FileSystemService</value>
+ </parameter>
+ <parameter>
+ <name>resourceClassName</name>
+ <value>example.filesystem.FileSystemResource</value>
+ </parameter>
+ <parameter>
+ <name>wsdlTargetNamespace</name>
+ <value>http://ws.apache.org/resource/example/filesystem</value>
+ </parameter>
+ <parameter>
+ <name>resourceIdentifierReferenceParameterName</name>
+ <value>{http://ws.apache.org/resource/example/filesystem}ResourceIdentifier</value>
+ </parameter>
+ </resourceParams>
+ </resource>
+ </service></pre>
+
+<p>The<span class="codefrag"> name</span> attribute is a unique name in the config file to denote your service in JNDI. The resource "name" attribute is used for locating your home
+ instance, and is named <span class="codefrag">home</span>. Notice <span class="codefrag">serviceClassName</span> points to the clasname for the service class. The same is said for the
+ <span class="codefrag">resourceClassName</span>. The <span class="codefrag">wsdlTargetNamespace </span> is the target namespace from your WSDL.
+ </p>
+
+<p>The <span class="codefrag">baseWebappUrl</span> parameter is used to define the URL of your Web application. You can include a static host, or as an
+ alternative, you can use the following markers which are replaced at runtime:
+ </p>
+
+<ul>
+
+<li>
+
+<span class="codefrag">$IP_ADDRESS$</span> - An attempt is made to determine the IP address at runtime. (Do not use on multi-homed systems).</li>
+
+<li>
+
+<span class="codefrag">$HOST_NAME$</span> - An attempt is made to determine the host name at runtime.</li>
+
+</ul>
+
+<p>The <span class="codefrag">resourceIdentifierReferenceParameterName</span> parameter represents the name of the WS-Addressing-header that is used to
+ extract a unique resource identifier to lookup a specific WS-Resource instance. This value should be a QName that includes the local
+ reference parameter name in the format <em>
+ <span class="codefrag">{namespaceURI}localPart</span>
+ </em>, where namesapaceURI and localPart are the namespace and URI and local
+ part of the qualified name of the reference paramater that should contain the resource identifier. If you omit this entry, it is assumed that the service is a
+ <strong>
+ <span class="codefrag">SINGLETON</span>
+ </strong> service and no resource id is expected in the
+ WS-Addressing headers.
+ </p>
+
+</li>
+
+<li>
+
+<strong>Update the server-config.wsdd file</strong>
+
+<p>The <span class="codefrag">server-config.wsdd</span> file is the configuration file for the Axis SOAP engine,
+ which is bundled with Muse. This file is located in the <span class="codefrag">muse/WEB-INF/</span> directory.
+ See the <a href="http://ws.apache.org/axis/">Axis</a> documentation for complete instructions about <span class="codefrag">server-config.wsdd</span>
+
+</p>
+
+<p>The file contains a deployment entry for each Web service. For example, the FileSystem service example is:
+ </p>
+
+<pre class="code"> <service name="filesystem" provider="java:WSRF" style="document" use="literal">
+ <wsdlFile>/wsdl/FileSystem.wsdl</wsdlFile>
+ <requestFlow>
+ <handler type="java:org.apache.axis.handlers.JAXRPCHandler">
+ <parameter name="className" value="org.apache.axis.message.addressing.handler.AxisServerSideAddressingHandler"/>
+ <parameter name="referencePropertyNames" value="*"/>
+ </handler>
+ </requestFlow>
+ </service></pre>
+
+<p>The service <span class="codefrag">name</span> attribute is the endpoint name and should be the same as the port's <span class="codefrag">name</span> attribute
+ from your WSDL file. This will ensure people consuming your WSDL will be able to invoke your service.
+ </p>
+
+<p>Notice the entry for <span class="codefrag">wsdlFile</span> which points to the <span class="codefrag">/wsdl/FileSystem.wsdl</span>.
+ This translates to the wsdl directory under the <span class="codefrag">WEB-INF/classes</span> directory.
+ </p>
+
+<p>The last part is the <span class="codefrag">requestFlow</span>. This xml fragment is necessary to ensure the
+ requests are routed through the WS-Addressing handler. This is static and should
+ always be present. We did not define it globally in case there were other services
+ defined which will not use WS-Addressing.
+ </p>
+
+</li>
+
+</ol>
+</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/dev_guide/home.html
URL: http://svn.apache.org/viewcvs/webservices/muse/site/dev_guide/home.html?rev=230467&view=auto
==============================================================================
--- webservices/muse/site/dev_guide/home.html (added)
+++ webservices/muse/site/dev_guide/home.html Fri Aug 5 06:45:22 2005
@@ -0,0 +1,284 @@
+<!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>Writing a Home 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_1.2', '../skin/')" id="menu_1.2Title" class="menutitle">Tutorial</div>
+<div id="menu_1.2" class="menuitemgroup">
+<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="menuitem">
+<a title="" href="../tutorial/test.html">Test</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.3', '../skin/')" id="menu_selected_1.3Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Developer Guide</div>
+<div id="menu_selected_1.3" class="selectedmenuitemgroup" style="display: block;">
+<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="menupage">
+<div class="menupagetitle">Home Class</div>
+</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>Writing a Home class</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#intro">Introduction</a>
+</li>
+<li>
+<a href="#class-declaration">Class Declaration</a>
+</li>
+<li>
+<a href="#ops">Operations</a>
+</li>
+</ul>
+</div>
+
+<a name="N1000C"></a><a name="intro"></a>
+<h2 class="boxed">Introduction</h2>
+<div class="section">
+<p>The home class is used to lookup the 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>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">If your service is a singleton and only requires a single resource instance, see the <a href="http://ws.apache.org/wsrf/dev_guide/singleton.html">Creating a Singleton Service</a> in the Apache WSRF
+ documentation.</div>
+</div>
+<p>If you use the Wsdl2Java tool, the home class is automatically generated but will need to be modified to create instances of your resource. This section will
+ describe how to write a home class for your resource. Initially, you should model your resource off of the included <span class="codefrag">FilesystemHome</span> example
+ to ensure that you write a valid home class for your resource.</p>
+</div>
+
+<a name="N10023"></a><a name="class-declaration"></a>
+<h2 class="boxed">Class Declaration</h2>
+<div class="section">
+<p>The generated home class extends <span class="codefrag">AbstractResourceHome</span>. Extending <span class="codefrag">AbstractResourceHome</span>
+ provides services for caching instances and looking them up. It also ensures
+ that the correct interfaces are implemented so that Apache WSRF can interact with your home.
+ </p>
+<p>The <span class="codefrag">FileSystemHome</span> class extends <span class="codefrag">AbstractResourceHome</span> and implements <span class="codefrag">Serializable</span>:</p>
+<pre class="code">public class FileSystemHome
+ extends AbstractResourceHome
+ implements Serializable</pre>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">Many of the operations in the <span class="codefrag">AbstractResourceHome</span> may be overridden in your Home
+ class, if you have a need to extend its functionality.</div>
+</div>
+</div>
+
+<a name="N10049"></a><a name="ops"></a>
+<h2 class="boxed">Operations</h2>
+<div class="section">
+<p>If you extend <span class="codefrag">AbstractResourceHome</span>, the only required operation you will need to implement is:</p>
+<pre class="code">public void init()</pre>
+<p>The <span class="codefrag">init()</span> operation can be used to initialize any instances at startup. In the FileSystem example, the <span class="codefrag">init()</span> method is used:</p>
+<pre class="code">public void init() throws Exception
+ {
+ super.init();
+ add( createInstance( LVOL1_ID ) );
+ add( createInstance( LVOL2_ID ) );
+ }</pre>
+<p>The <span class="codefrag">createInstance()</span> method:</p>
+<ul>
+
+<li>Creates an instance of the resource.</li>
+
+<li>Sets an endpoint reference on the resource.</li>
+
+<li>Calls <span class="codefrag">init()</span> on the resource.</li>
+
+</ul>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">If you choose to not use the <span class="codefrag">createInstance()</span> method (e.g. if you have a non-empty constructor), then you must manually set the EPR then call
+ the <span class="codefrag">init()</span> method on the resource. The generated home class contains a utility method from the <span class="codefrag">AbstractResourceHome</span> that can be used
+ to build an EPR.</div>
+</div>
+</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/dev_guide/index.html
URL: http://svn.apache.org/viewcvs/webservices/muse/site/dev_guide/index.html?rev=230467&view=auto
==============================================================================
--- webservices/muse/site/dev_guide/index.html (added)
+++ webservices/muse/site/dev_guide/index.html Fri Aug 5 06:45:22 2005
@@ -0,0 +1,317 @@
+<!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>Muse Developer Guide</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_1.2', '../skin/')" id="menu_1.2Title" class="menutitle">Tutorial</div>
+<div id="menu_1.2" class="menuitemgroup">
+<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="menuitem">
+<a title="" href="../tutorial/test.html">Test</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.3', '../skin/')" id="menu_selected_1.3Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Developer Guide</div>
+<div id="menu_selected_1.3" class="selectedmenuitemgroup" style="display: block;">
+<div class="menupage">
+<div class="menupagetitle">Overview</div>
+</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">
+<a href="http://forrest.apache.org/"><img border="0" title="Built with Apache Forrest" alt="Built with Apache Forrest - logo" src="../images/built-with-forrest-button.png" style="width: 88px;height: 31px;"></a>
+</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>Muse Developer Guide</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#About+this+Guide">About this Guide</a>
+</li>
+<li>
+<a href="#WSDM+Overview">WSDM Overview</a>
+</li>
+<li>
+<a href="#Conceptual+Overview">Conceptual Overview</a>
+</li>
+<li>
+<a href="#Design-Time">Design-Time</a>
+</li>
+</ul>
+</div>
+
+<a name="N1000C"></a><a name="About+this+Guide"></a>
+<h2 class="boxed">About this Guide</h2>
+<div class="section">
+<p>The Developer Guide provides instructions for using many of the features that are included in Muse. If you are new to this project, you should start
+ with the <a href="../getting_started.html">Getting Started</a> and the <a href="../tutorial/index.html">Tutorial</a> before reading this guide. They provide a good starting point for
+ learning how to use Muse.</p>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">Muse is tightly integrated with <a href="http://ws.apache.org/wsrf/">Apache WSRF</a> as its WSRF foundation and <a href="http://ws.apache.org/pubscribe/">Apache Pubscribe</a> as its WSN
+ foundation. While it is not required, it is a good idea to start with Apache WSRF and Apache Pubscribe to learn more about these respective foundations.
+ You should also consult the Apache WSRF and Apache Pubscribe documentation while completing the instructions in this document. All of the tasks required in Apache WSRF and
+ Apache Pubscribe are also required in Muse.
+ </div>
+</div>
+<p>The Developer guide often refers to different parts of the <a href="../muws.html">Web Services Distributed Management (WSDM) specifications</a> that are defined by
+ the OASIS standards body. You should become familiar with these specifications and refer to them as needed.
+ </p>
+<p>The Developer Guide guide often refers to Apache WSRF, Apache Pubscribe, Apache Axis, Apache Tomcat, Apache Ant, and Apache XMLBeans. Instructions for these
+ packages are included as required and are not meant to replace the formal documentation for these projects. Consult them as necessary.
+ </p>
+</div>
+
+<a name="N10033"></a><a name="WSDM+Overview"></a>
+<h2 class="boxed">WSDM Overview</h2>
+<div class="section">
+<p>
+
+<a href="../muws.html">WSDM</a> is defined by the OASIS standards body and is comprised of two separate specifcations:
+ </p>
+<ul>
+
+<li>Management using Web Services (MUWS) - MUWS defines how to represent and access the manageability interfaces of resources as Web services. It is the
+ foundation of enabling management applications to be built using Web services and allows resources to be managed by many managers with one set of instrumentation. The
+ specification provides interoperable, base manageability for monitoring and control managers using Web services. WSDM MUWS is defined in two specifications,
+ MUWS Part 1, which defines the base architectural concepts and required components, and MUWS Part 2 which defines standard composeable support for manageability
+ capabilities.</li>
+
+<li>Management of WebServices (MOWS)- MOWS defines the manageability model for managing Web services as a resource and how to describe and access that
+ manageability using MUWS.</li>
+
+</ul>
+<p>Muse is an implementation of both parts of the MUWS specification.</p>
+</div>
+
+<a name="N1004D"></a><a name="Conceptual+Overview"></a>
+<h2 class="boxed">Conceptual Overview</h2>
+<div class="section">
+<p>Muse builds on top of Apache WSRF and Apache Pubscribe and provides three deliverables:</p>
+<ul>
+
+<li>APIs for MUWS management events, relationships, etc.</li>
+
+<li>implementation of the <span class="codefrag">QueryRelationshipsByType</span> operation defined by the MUWS specification</li>
+
+<li>an Advertiser service that exposes the MUWS-defined <span class="codefrag">ManageableResourceCreation</span> and <span class="codefrag">ManageableResourceDestruction</span> topics and
+ publishes notifications to those topics whenever any Resource instances are added or removed to any deployed MUWS services</li>
+
+</ul>
+<p>The MUWS specification defines a capability as a set of related operations, properties, and topics that a management resource may implement. The specification defines many
+ standard capabilities. Most of the standard capabilities include properties and/or topics, but not operations. There is only one capability that defines any operations, and it only
+ defines one. Hence, what Muse primarily provides is not implementations of operations, but rather implementations of the specification-defined topics that will automatically publish
+ notifications when the corresponding situation occurs. It also provides helper utility methods that can be used to easily add the various MUWS-defined topics to a producer
+ resource’s topic set.
+ </p>
+</div>
+
+<a name="N1006F"></a><a name="Design-Time"></a>
+<h2 class="boxed">Design-Time</h2>
+<div class="section">
+<p>A set of tools and integrations are provided that facilitate developing MUWS-compliant Web services. They are provided to help developers focus on
+ defining their WS Resource and Notification Topics without having to deal with low-level implementation details.</p>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">These tools and integrations are not required to create MUWS-compliant Web services, but are instead provided to save you time.</div>
+</div>
+<p>The tools and integrations include:</p>
+<ul>
+
+<li>A MUWS WSDL template for writing MUWS-compliant WSDLs</li>
+
+<li>A Wsdl2Java tool for generating Java Classes from a WSDL.</li>
+
+<li>An integration with Apache XMLBeans for generating custom types defined in the WSDL</li>
+
+<li>an integration with Apache Axis for automatically deploying WS Resources</li>
+
+</ul>
+</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>
+<div id="logos">
+<a href="http://validator.w3.org/check/referer"><img style="height: 31px; width: 88px;" title="Valid HTML 4.01!" alt="Valid HTML 4.01!" src="../skin/images/valid-html401.png" class="logoImage"></a><a href="http://jigsaw.w3.org/css-validator/"><img style="height: 31px; width: 88px;" title="Valid CSS!" alt="Valid CSS!" src="../skin/images/vcss.png" class="logoImage"></a>
+</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