You are viewing a plain text version of this content. The canonical link for it is here.
Posted to muse-commits@ws.apache.org by da...@apache.org on 2006/09/09 20:02:22 UTC
svn commit: r441835 [1/2] - in /webservices/muse/site: ./ docs/ docs/2.0.0/manual/ docs/2.0.0/manual/architecture/ docs/2.0.0/manual/capabilities/ docs/2.0.0/manual/how-to/ docs/2.0.0/manual/platforms/ docs/2.0.0/manual/tools/ docs/2.0.0/manual/trouble...

Author: danj
Date: Sat Sep  9 11:02:21 2006
New Revision: 441835

URL: http://svn.apache.org/viewvc?view=rev&rev=441835
Log:
1. Added docs/index.html that lists docs by version.

2. Added reference manual TOC with separate pages for each.

3. Added capability docs, but only one has the Muse web site HTML around it. However, every other capability HTML 
page has only its body content, so I can just copy over the HTML head/script/body start to the top and the HTML 
body end into each file, fix the heading, and we'll be good to go.

Added:
    webservices/muse/site/docs/2.0.0/manual/architecture/index.html
    webservices/muse/site/docs/2.0.0/manual/capabilities/index.html
    webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-abstract.html
    webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-adv.html
    webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-config.html
    webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-cp.html
    webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-desc.html
    webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-id.html
    webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-mc.html
    webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-metrics.html
    webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-opstatus.html
    webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-state.html
    webservices/muse/site/docs/2.0.0/manual/capabilities/wsn-nc.html
    webservices/muse/site/docs/2.0.0/manual/capabilities/wsn-np.html
    webservices/muse/site/docs/2.0.0/manual/capabilities/wsn-pullpoint-c.html
    webservices/muse/site/docs/2.0.0/manual/capabilities/wsn-pullpoint.html
    webservices/muse/site/docs/2.0.0/manual/capabilities/wsn-sub.html
    webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-abstract.html
    webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wsrl-immediate.html
    webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wsrl-scheduled.html
    webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wsrp-get.html
    webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wsrp-query.html
    webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wsrp-set.html
    webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wssg-sg.html
    webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wssg-sge.html
    webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wssg-sgr.html
    webservices/muse/site/docs/2.0.0/manual/capabilities/wsx.html
    webservices/muse/site/docs/2.0.0/manual/how-to/index.html
    webservices/muse/site/docs/2.0.0/manual/platforms/
    webservices/muse/site/docs/2.0.0/manual/platforms/index.html
    webservices/muse/site/docs/2.0.0/manual/tools/index.html
    webservices/muse/site/docs/2.0.0/manual/troubleshooting/index.html
Removed:
    webservices/muse/site/docs/index.html
Modified:
    webservices/muse/site/docs/2.0.0/manual/index.html
    webservices/muse/site/docs/2.0.0/specs/index.html
    webservices/muse/site/index.html

Added: webservices/muse/site/docs/2.0.0/manual/architecture/index.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/architecture/index.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/architecture/index.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/architecture/index.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,10 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<title>Apache Muse - Documentation</title>
+<meta http-equiv="refresh" content="0; url=../index.html#architecture">
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+</head>
+<body>
+</body>
+</html>
\ No newline at end of file

Added: webservices/muse/site/docs/2.0.0/manual/capabilities/index.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/capabilities/index.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/capabilities/index.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/capabilities/index.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,10 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<title>Apache Muse - Documentation</title>
+<meta http-equiv="refresh" content="0; url=../index.html#capabilities">
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+</head>
+<body>
+</body>
+</html>
\ No newline at end of file

Added: webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-abstract.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-abstract.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-abstract.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-abstract.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,196 @@
+<!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>Apache Muse - The Abstract WSDM MUWS Capability</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> &gt; <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="../../../../index.html"><img class="logoImage" alt="Apache Muse" src="../../../../images/muse-logo.gif"></a>
+</div>
+<!--+
+    |end Project Logo
+    +-->
+<!--+
+    |start Tabs
+    +-->
+<!--+
+    |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">
+             
+             &nbsp;
+           </div>
+<!--+
+    |start Menu, mainarea
+    +-->
+<!--+
+    |start Menu
+    +-->
+<div id="menu">
+<div id="menu_1.3Title" class="menutitle">Documentation</div>
+<div id="menu_1.3" class="selectedmenuitemgroup">
+<div class="menuitem">
+<a title="" href="../../tutorial/index.html">Getting Started</a>
+</div>
+<div class="menuitem">
+<a title="" href="../../manual/index.html">Reference Manual</a>
+</div>
+<div class="menuitem">
+<a title="" href="../../javadoc/index.html">JavaDoc</a>
+</div>
+<div class="menuitem">
+<a title="" href="../../specs/index.html">OASIS Standards</a>
+</div>
+</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>
+<h2>Apache Muse - The Abstract WSDM MUWS Capability</h2>
+<p>
+<b>Spec name and port type:</b> WS-DistributedManagement v1.1 (and any capability that depends on it)
+</p>
+<p>
+<b>Capability URI:</b> Provided by concrete capability types.
+</p>
+<p>
+<b>Description:</b> Muse defines an abstract base class that provides a simple
+feature in addition to those offered by the WsResourceCapability and
+AbstractWsResourceCapability types. AbstractManageabilityCapability ensures that
+each concrete implementation has its unique capability URI added to the
+muws1:ManageabilityCapability property set, which is defined by the WSDM MUWS
+ManageabilityCharacteristics capability. The muws1:ManageabilityCapability
+property can be read by clients to reason about the semantics of a manageable
+resource before manipulating it.
+</p>
+<p>
+<b>Java interface:</b>
+<a href="muse-wsdm-muws-api/src/org/apache/muse/ws/dm/muws/ManageabilityCapability.java?view=markup">org.apache.muse.ws.dm.muws.ManageabilityCapability</a>
+<blockquote>
+<b>JAR file:</b> muse-wsdm-muws-api.jar
+</blockquote>
+</p>
+<p>
+<b>Default Java implementation:</b> org.apache.muse.ws.dm.muws.impl.AbstractManageabilityCapability
+<blockquote>
+<b>JAR file:</b> muse-wsdm-muws-impl.jar
+</blockquote>
+</p>
+<p>
+<b>Action on initialize():</b> None.
+</p>
+<p>
+<b>Action on initializeCompleted():</b> Adds the capability's unique URI to the
+ManageabilityCapability property set using the
+<a href="wsdm-mc.html">ManageabilityCharacteristics</a> interface.
+</p>
+<p>
+<b>Action on prepareShutdown():</b> None.
+</p>
+<p>
+<b>Action on shutdown():</b> None.
+</p>
+<p>
+<b>Non-Core Dependencies:</b>
+<ul>
+<li><a href="wsdm-mc.html">http://docs.oasis-open.org/wsdm/muws/capabilities/ManageabilityCharacteristics</a></li>
+</ul><br>
+<p>
+<a name="behavior"><b>Behavior and Limitations:</b></a> This class does not offer a solution for
+clients wishing to reason about the existence of non-manageability capabilities, such as WSN
+NotificationProducer or WSRL ImmediateResourceTermination.
+</p>
+<p>
+<b>Initialization parameters:</b> None.
+</p>
+<br><br>
+
+
+<!--+
+    |end content
+    +-->
+<div class="clearboth">&nbsp;</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 &copy; 2006 The Apache Software Foundation.</div>
+
+<!--+
+    |end bottomstrip
+    +-->
+</div>
+</body>
+</html>
+
+
+

Added: webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-adv.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-adv.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-adv.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-adv.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,76 @@
+
+
+
+<p>
+<b>Apache Muse - WS-DistributedManagement - Advertisement Capability</b>
+
+</p>
+<p>
+<b>Spec name and port type:</b> WS-DistributedManagement v1.1 (no port type)
+<p>
+<b>Capability URI:</b> http://docs.oasis-open.org/wsdm/muws/capabilities/Advertisement
+</p>
+<p>
+<b>Description:</b> This capability has no properties or operations but defines two
+notifications - one each for the creation and destruction of manageability endpoints.
+Deploying a Muse application with an advertisement resource will allow you to send
+notifications to management clients about the existence of manageable resources rather
+than forcing them to perform discovery.
+</p>
+<p>
+<b>Java interface:</b>
+<a href="muse-wsdm-muws-adv-api/src/org/apache/muse/ws/dm/muws/adv/Advertisement.java?view=markup">org.apache.muse.ws.dm.muws.adv.Advertisement</a>
+<blockquote>
+<b>JAR file:</b> muse-wsdm-muws-adv-api.jar
+</blockquote>
+</p>
+<p>
+<b>Default Java implementation:</b> org.apache.muse.ws.dm.muws.adv.impl.SimpleAdvertisement
+<blockquote>
+<b>JAR file:</b> muse-wsdm-muws-adv-impl.jar
+</blockquote>
+</p>
+<p>
+<b>Action on initialize():</b> None.
+</p>
+<p>
+<b>Action on initializeCompleted():</b> Registers itself with the ResourceManager so it can
+learn of all resource creation and destruction events. Creates the creation and destruction
+topics so that management clients can subscribe to these notifications. The default implementation
+of Advertisement allows users to specify an initial consumer (using an EPR) that will be subscribed
+to the two Advertisement topics and immediately receive notifications.
+</p>
+<p>
+<b>Action on prepareShutdown():</b> None.
+</p>
+<p>
+<b>Action on shutdown():</b> None.
+</p>
+<p>
+<b>Non-Core Dependencies:</b>
+<ul>
+<li><a href="wsn-np.html">http://docs.oasis-open.org/wsn/bw-2/NotificationProducer</a></li>
+<li>The Muse WEF API, found in muse-wsdm-wef-api.jar</li>
+</ul>
+<p>
+<a name="behavior"><b>Behavior and Limitations:</b></a> This capability is separated out into a
+separate module from the other WSDM MUWS capabilities because of its dependence on WSN. All of the
+other capabilities have topics that <em>may</em> be published if WSN NotificationProducer is
+supported, but Advertisement is useless without it. It is the only capability that leverages all
+of the interface modules in Muse 2.0 (ironic given that the implementation is one small class!).
+</p>
+<p>
+<b>Initialization parameters:</b>
+<ul>
+<li><b>initial-consumer-reference</b> - The relative path of an XML file that contains the EPR
+of the initial advertisement consumer. This features allows users to point the advertisement
+resource to a well-known consumer and start alerting it of creation and destruction events as
+soon as it comes online, without the consumer having to subscribe itself. The use of the initial
+consumer is optional and does not preclude other resources from subscribing to notifications.</li>
+</ul>
+</p>
+<br><br>
+
+
+
+

Added: webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-config.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-config.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-config.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-config.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,55 @@
+
+
+
+<p>
+<b>Apache Muse - WS-DistributedManagement - Configuration Capability</b>
+
+</p>
+<p>
+<b>Spec name and port type:</b> WS-DistributedManagement v1.1 (no port type)
+<p>
+<b>Capability URI:</b> http://docs.oasis-open.org/wsdm/muws/capabilities/Configuration
+</p>
+<p>
+<b>Description:</b> This capability has no properties or operations and serves only
+to aid clients in semantic analysis of a resource's interface. In short, this
+capability does nothing!
+</p>
+<p>
+<b>Java interface:</b>
+<a href="muse-wsdm-muws-api/src/org/apache/muse/ws/dm/muws/Configuration.java?view=markup">org.apache.muse.ws.dm.muws.Configuration</a>
+<blockquote>
+<b>JAR file:</b> muse-wsdm-muws-api.jar
+</blockquote>
+</p>
+<p>
+<b>Default Java implementation:</b> org.apache.muse.ws.dm.muws.impl.SimpleConfiguration
+<blockquote>
+<b>JAR file:</b> muse-wsdm-muws-impl.jar
+</blockquote>
+</p>
+<p>
+<b>Action on initialize():</b> None.
+</p>
+<p>
+<b>Action on initializeCompleted():</b> None.
+</p>
+<p>
+<b>Action on prepareShutdown():</b> None.
+</p>
+<p>
+<b>Action on shutdown():</b> None.
+</p>
+<p>
+<b>Non-Core Dependencies:</b> None.
+<p>
+<a name="behavior"><b>Behavior and Limitations:</b></a> None.
+</p>
+<p>
+<b>Initialization parameters:</b> None.
+</p>
+<br><br>
+
+
+
+

Added: webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-cp.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-cp.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-cp.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-cp.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,75 @@
+
+
+<p>
+<b>Apache Muse - WS-DistributedManagement - CorrelatableProperties Capability</b>
+
+</p>
+<p>
+<b>Spec name and port type:</b> WS-DistributedManagement v1.1 (no port type)
+<p>
+<b>Capability URI:</b> http://docs.oasis-open.org/wsdm/muws/capabilities/CorrelatableProperties
+</p>
+<p>
+<b>Description:</b> This capability defines a property about other properties - the
+CorrelatableProperties property tells a client which property values have to match
+between two resource property documents in order for the two WS-resources that own
+them to be considered "equal". By "equal", we mean that the two resources actually
+point to the same physical resource despite being addressed with different EPRs.
+The API for this capability provides a means of defining the dialects for the
+CorrelatableProperties property, as well as evaluating the correlations against two EPRs.
+</p>
+<p>
+<b>Java interface:</b>
+<a href="muse-wsdm-muws-api/src/org/apache/muse/ws/dm/muws/CorrelatableProperties.java?view=markup">org.apache.muse.ws.dm.muws.CorrelatableProperties</a>
+<blockquote>
+<b>JAR file:</b> muse-wsdm-muws-api.jar
+</blockquote>
+</p>
+<p>
+<b>Default Java implementation:</b> org.apache.muse.ws.dm.muws.impl.SimpleCorrelatableProperties
+<blockquote>
+<b>JAR file:</b> muse-wsdm-muws-impl.jar
+</blockquote>
+</p>
+<p>
+<b>Action on initialize():</b> None.
+</p>
+<p>
+<b>Action on initializeCompleted():</b> None.
+</p>
+<p>
+<b>Action on prepareShutdown():</b> None.
+</p>
+<p>
+<b>Action on shutdown():</b> None.
+</p>
+<p>
+<b>Non-Core Dependencies:</b>
+<ul>
+<li>org.apache.muse.ws.dm.muws.Correlation</li><br>
+<li>org.apache.muse.ws.resource.remote.WsResourceClient</li>
+</ul>
+</p>
+<p>
+<a name="behavior"><b>Behavior and Limitations:</b></a> The default implementation of this
+capability allows users to add "correlations", or correlatable properties expressions, at
+runtime, and to evaluate them against resources at other EPRs. The standard correlation
+dialects - Property Boolean Match (PBM) and XPath - are implemented and allow users to
+easily create expression that can then be grouped together by the capability implementation
+and executed against a resource's WSRP document.
+<br><br>
+The capability has a matches() operation that allows server-side code to evaluate all of
+the current correlations against a resource by providing its EPR. The implementation will
+treat all EPRs as remote and will access the properties of the resource using SOAP even if
+the EPR belongs to a resource in the same application-space as the caller. It is assumed that
+if the user believes two internal resources two be equal despite having different EPRs, he
+could use a simple equality check to verify.
+</p>
+<p>
+<b>Initialization parameters:</b> None.
+</p>
+<br><br>
+
+
+
+

Added: webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-desc.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-desc.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-desc.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-desc.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,55 @@
+
+
+<p>
+<b>Apache Muse - WS-DistributedManagement - Description Capability</b>
+
+</p>
+<p>
+<b>Spec name and port type:</b> WS-DistributedManagement v1.1 (no port type)
+<p>
+<b>Capability URI:</b> http://docs.oasis-open.org/wsdm/muws/capabilities/Description
+</p>
+<p>
+<b>Description:</b> This capability defines three simple properties - muws2:Caption,
+muws2:Description, and muws2:Version.
+</p>
+<p>
+<b>Java interface:</b>
+<a href="muse-wsdm-muws-api/src/org/apache/muse/ws/dm/muws/Description.java?view=markup">org.apache.muse.ws.dm.muws.Description</a>
+<blockquote>
+<b>JAR file:</b> muse-wsdm-muws-api.jar
+</blockquote>
+</p>
+<p>
+<b>Default Java implementation:</b> org.apache.muse.ws.dm.muws.impl.SimpleDescription
+<blockquote>
+<b>JAR file:</b> muse-wsdm-muws-impl.jar
+</blockquote>
+</p>
+<p>
+<b>Action on initialize():</b> None.
+</p>
+<p>
+<b>Action on initializeCompleted():</b> None.
+</p>
+<p>
+<b>Action on prepareShutdown():</b> None.
+</p>
+<p>
+<b>Action on shutdown():</b> None.
+</p>
+<p>
+<b>Non-Core Dependencies:</b> None.
+</p>
+<p>
+<a name="behavior"><b>Behavior and Limitations:</b></a> The default implementation
+does not include the xml:lang attribute on the muws2:Caption and muws2:Description values.
+</p>
+<p>
+<b>Initialization parameters:</b> None.
+</p>
+<br><br>
+
+
+
+

Added: webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-id.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-id.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-id.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-id.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,64 @@
+
+
+<p>
+<b>Apache Muse - WS-DistributedManagement - Identity Capability</b>
+
+</p>
+<p>
+<b>Spec name and port type:</b> WS-DistributedManagement v1.1 (no port type)
+<p>
+<b>Capability URI:</b> http://docs.oasis-open.org/wsdm/muws/capabilities/Identity
+</p>
+<p>
+<b>Description:</b> This capability defines one property, muws1:ResourceId. It
+is the only manageability that is required by the WSDM MUWS specification. The
+muws1:ResourceId property is required to uniquely identify a manageable resource,
+although the rules and restrictions for how unique it must be and what its
+limitations are cannot be covered in this small space. Please see the MUWS specs
+for more details on the value of muws1:ResourceId.
+</p>
+<p>
+<b>Java interface:</b>
+<a href="muse-wsdm-muws-api/src/org/apache/muse/ws/dm/muws/Identity.java?view=markup">org.apache.muse.ws.dm.muws.Identity</a>
+<blockquote>
+<b>JAR file:</b> muse-wsdm-muws-api.jar
+</blockquote>
+</p>
+<p>
+<b>Default Java implementation:</b> org.apache.muse.ws.dm.muws.impl.SimpleIdentity
+<blockquote>
+<b>JAR file:</b> muse-wsdm-muws-impl.jar
+</blockquote>
+</p>
+<p>
+<b>Action on initialize():</b> The default implementation generates a random UUID
+for the value of muws1:ResourceId. The value is generated with the help of the
+java.security.SecureRandom API.
+</p>
+<p>
+<b>Action on initializeCompleted():</b> None.
+</p>
+<p>
+<b>Action on prepareShutdown():</b> None.
+</p>
+<p>
+<b>Action on shutdown():</b> None.
+</p>
+<p>
+<b>Non-Core Dependencies:</b> None.
+</p>
+<p>
+<a name="behavior"><b>Behavior and Limitations:</b></a> The fact that the value of muws1:ResourceId
+is random and unpredictable should not be problematic for clients because the WSDM spec does
+<b>not</b> support the use of muws1:ResourceId for addressing purposes. In other words, it
+is not expected to appear in WS-Addressing SOAP headers. It is <b>only</b> to be used for
+tests of equality between two WS-resources who may be represented by multiple EPRs.
+</p>
+<p>
+<b>Initialization parameters:</b> None.
+</p>
+<br><br>
+
+
+
+

Added: webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-mc.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-mc.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-mc.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-mc.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,61 @@
+
+
+
+<p>
+<b>Apache Muse - WS-DistributedManagement - ManageabilityCharacteristics Capability</b>
+
+</p>
+<p>
+<b>Spec name and port type:</b> WS-DistributedManagement v1.1 (no port type)
+<p>
+<b>Capability URI:</b> http://docs.oasis-open.org/wsdm/muws/capabilities/ManageabilityCharacteristics
+</p>
+<p>
+<b>Description:</b> This capability acts as a metadata collection, a way for a
+manageable resource to tell its clients about the <b>other</b> capabilities it supports. It
+defines one property, ManageabilityCapability, that is a collection of unique URIs, each
+representing another manageability capability. In Muse, these URIs are equivalent to the
+capability URI values that are specified for each capability in the deployment descriptor (muse.xml).
+You can see a match between the values in muse.xml's &lt;capability-uri&gt; elements and
+the values of the sole ManageabilityCharacteristics property.
+</p>
+<p>
+<b>Java interface:</b>
+<a href="muse-wsdm-muws-api/src/org/apache/muse/ws/dm/muws/ManageabilityCharacteristics.java?view=markup">org.apache.muse.ws.dm.muws.ManageabilityCharacteristics</a>
+<blockquote>
+<b>JAR file:</b> muse-wsdm-muws-api.jar
+</blockquote>
+</p>
+<p>
+<b>Default Java implementation:</b> org.apache.muse.ws.dm.muws.impl.SimpleManageabilityCharacteristics
+<blockquote>
+<b>JAR file:</b> muse-wsdm-muws-impl.jar
+</blockquote>
+</p>
+<p>
+<b>Action on initialize():</b> None.
+</p>
+<p>
+<b>Action on initializeCompleted():</b> None.
+</p>
+<p>
+<b>Action on prepareShutdown():</b> None.
+</p>
+<p>
+<b>Action on shutdown():</b> None.
+</p>
+<p>
+<b>Non-Core Dependencies:</b> None.
+</p>
+<p>
+<a name="behavior"><b>Behavior and Limitations:</b></a> None - acts as a simple container
+and is used at initialization <a href="wsdm-abstract.html">by other capabilities</a>.
+</p>
+<p>
+<b>Initialization parameters:</b> None.
+</p>
+<br><br>
+
+
+
+

Added: webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-metrics.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-metrics.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-metrics.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-metrics.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,72 @@
+
+
+<p>
+<b>Apache Muse - WS-DistributedManagement - Metrics Capability</b>
+
+</p>
+<p>
+<b>Spec name and port type:</b> WS-DistributedManagement v1.1 (no port type)
+<p>
+<b>Capability URI:</b> http://docs.oasis-open.org/wsdm/muws/capabilities/Metrics
+</p>
+<p>
+<b>Description:</b> This capability defines the muws2:CurrentTime property and,
+more importantly, manages the metric-related metadata for any resource property
+that is declared to be a WSDM metric. The MUWS Part 2 spec contains the definition
+of the various metric types and semantics - Muse's default implementation of
+the capability automatically updates the metric metadata when property values
+are updated and provides an API for accessing the metadata without parsing raw
+XML from WSRP GetResourceProperty.
+<p>
+<b>Java interface:</b>
+<a href="muse-wsdm-muws-api/src/org/apache/muse/ws/dm/muws/Metrics.java?view=markup">org.apache.muse.ws.dm.muws.Metrics</a>
+<blockquote>
+<b>JAR file:</b> muse-wsdm-muws-api.jar
+</blockquote>
+</p>
+<p>
+<b>Default Java implementation:</b> org.apache.muse.ws.dm.muws.impl.SimpleMetrics
+<blockquote>
+<b>JAR file:</b> muse-wsdm-muws-impl.jar
+</blockquote>
+</p>
+<p>
+<b>Action on initialize():</b> Reads through the resource's RMD file (if one
+exists) and, for each property that has WSDM Metrics metadata, creates listeners
+on the property that will update the metric metadata as appropriate. These
+listeners serve to store and update metric metadata, as well as to attach it
+to the results of WSRP GetResourceProperty requests so that clients can read it.
+</p>
+<p>
+<b>Action on initializeCompleted():</b> None.
+</p>
+<p>
+<b>Action on prepareShutdown():</b> None.
+</p>
+<p>
+<b>Action on shutdown():</b> None.
+</p>
+<p>
+<b>Non-Core Dependencies:</b> None.
+</p>
+<p>
+<a name="behavior"><b>Behavior and Limitations:</b></a> Metric metadata can be
+added to any resource property programmatically, but Muse provides a way to do
+it at design time using the WSRMD document. The wsrmd:Property element of a
+WSRMD document can be extended to include additional metadata child elements,
+the names and values of which are described in the MUWS Part 2 specification.
+The most important child element is the &lt;muws2:Capability/&gt; element, which
+must have the value of the Metrics capability URI (see above). The presence of
+this capability URI tells Muse that the property is a metric and that other
+metric metadata should be loaded from the WSRMD document. If there are any
+logical inconsistencies in the use of the metric metadata, the capability will
+fail to initialize.
+</p>
+<p>
+<b>Initialization parameters:</b> None.
+</p>
+<br><br>
+
+
+
+

Added: webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-opstatus.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-opstatus.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-opstatus.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-opstatus.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,57 @@
+
+<p>
+<b>Apache Muse - WS-DistributedManagement - OperationalStatus Capability</b>
+
+</p>
+<p>
+<b>Spec name and port type:</b> WS-DistributedManagement v1.1 (no port type)
+<p>
+<b>Capability URI:</b> http://docs.oasis-open.org/wsdm/muws/capabilities/OperationalStatus
+</p>
+<p>
+<b>Description:</b> This capability defines one property, muws2:OperationalStatus, which
+provides a high-level filter for clients wishing to reason about a resource's state. The
+property is an enumeration, and has four values: <em>Available</em>, <em>PartiallyAvailable</em>,
+<em>Unavailable</em>, and <em>Unknown</em>.
+</p>
+<p>
+<b>Java interface:</b>
+<a href="muse-wsdm-muws-api/src/org/apache/muse/ws/dm/muws/OperationalStatus.java?view=markup">org.apache.muse.ws.dm.muws.OperationalStatus</a>
+<blockquote>
+<b>JAR file:</b> muse-wsdm-muws-api.jar
+</blockquote>
+</p>
+<p>
+<b>Default Java implementation:</b> org.apache.muse.ws.dm.muws.impl.SimpleOperationalStatus
+<blockquote>
+<b>JAR file:</b> muse-wsdm-muws-impl.jar
+</blockquote>
+</p>
+<p>
+<b>Action on initialize():</b> Sets the muws2:OperationalStatus property to the default value (<em>Unknown</em>).
+</p>
+<p>
+<b>Action on initializeCompleted():</b> None.
+</p>
+<p>
+<b>Action on prepareShutdown():</b> None.
+</p>
+<p>
+<b>Action on shutdown():</b> None.
+</p>
+<p>
+<b>Non-Core Dependencies:</b> None.
+</p>
+<p>
+<a name="behavior"><b>Behavior and Limitations:</b></a> This capability cannot help resource implementors
+decide what the enumeration values mean for a particular resource type - it serves only to store the value
+and provide it to clients.
+</p>
+<p>
+<b>Initialization parameters:</b> None.
+</p>
+<br><br>
+
+
+
+

Added: webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-state.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-state.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-state.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/capabilities/wsdm-state.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,67 @@
+
+
+<p>
+<b>Apache Muse - WS-DistributedManagement - State Capability</b>
+
+</p>
+<p>
+<b>Spec name and port type:</b> WS-DistributedManagement v1.1 (no port type)
+<p>
+<b>Capability URI:</b> http://docs.oasis-open.org/wsdm/muws/capabilities/State
+</p>
+<p>
+<b>Description:</b> This capability defines the muws2:State property, which
+provides a detailed evaluation of what a resource is currently capable of doing.
+It also defines a muws2:StateTransition property, so that clients can always
+find out what the last state change was even if WSN NotificationProducer is not
+supported by the manageable resource.
+</p>
+<p>
+<b>Java interface:</b>
+<a href="muse-wsdm-muws-api/src/org/apache/muse/ws/dm/muws/State.java?view=markup">org.apache.muse.ws.dm.muws.State</a>
+<blockquote>
+<b>JAR file:</b> muse-wsdm-muws-api.jar
+</blockquote>
+</p>
+<p>
+<b>Default Java implementation:</b> org.apache.muse.ws.dm.muws.impl.SimpleState
+<blockquote>
+<b>JAR file:</b> muse-wsdm-muws-impl.jar
+</blockquote>
+</p>
+<p>
+<b>Action on initialize():</b> None.
+</p>
+<p>
+<b>Action on initializeCompleted():</b> None.
+</p>
+<p>
+<b>Action on prepareShutdown():</b> None.
+</p>
+<p>
+<b>Action on shutdown():</b> None.
+</p>
+<p>
+<b>Non-Core Dependencies:</b> None.
+</p>
+<p>
+<a name="behavior"><b>Behavior and Limitations:</b></a> The user is responsible for
+defining the valid values for muws2:State - this can be done with WS-RMD or through
+some other validation scheme. Muse cannot help the user determine what the proper
+state values are, how they should be interpreted, etc. - like
+<a href="wsdm-opstatus.html">OperationalStatus</a>, it is only present to help the
+resource communicate its state value in a standards-compliant way, not to model
+the state changes.
+<br><br>
+The default implementation of this capability handles the muws2:StateTransition
+property and sends the proper state change notifications to consumers when
+WSN NotificationProducer is exposed by the manageable resource.
+</p>
+<p>
+<b>Initialization parameters:</b> None.
+</p>
+<br><br>
+
+
+
+

Added: webservices/muse/site/docs/2.0.0/manual/capabilities/wsn-nc.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/capabilities/wsn-nc.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/capabilities/wsn-nc.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/capabilities/wsn-nc.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,64 @@
+
+
+<p>
+<b>Apache Muse - WS-BaseNotification - NotificationConsumer Capability</b>
+
+</p>
+<p>
+<b>Spec name and port type:</b> WS-BaseNotification v1.3, NotificationConsumer
+(<a href="../../specs/WS-BaseNotification-1_3.wsdl">WSDL</a>)
+</p>
+<p>
+<b>Capability URI:</b> http://docs.oasis-open.org/wsn/bw-2/NotificationConsumer
+</p>
+<p>
+<b>Description:</b> This capability exposes the WS-N Notify operation and provides
+a simple message listener API to other server-side components. Programmers can
+subscribe a resource that exposes this capability to messages from another resource(s)
+and then respond to incoming messages using the listener framework without having
+to write any message filtering code.
+</p>
+<p>
+<b>Java interface:</b>
+<a href="muse-wsn-api/src/org/apache/muse/ws/notification/NotificationConsumer.java?view=markup">org.apache.muse.ws.notification.NotificationConsumer</a>
+<blockquote>
+<b>JAR file:</b> muse-wsn-api.jar
+</blockquote>
+</p>
+<p>
+<b>Default Java implementation:</b> org.apache.muse.ws.notification.impl.SimpleNotificationConsumer
+<blockquote>
+<b>JAR file:</b> muse-wsn-impl.jar
+</blockquote>
+</p>
+<p>
+<b>Action on initialize():</b> Registers a serializer for the NotificationMessage type. This type
+is used in the method signature of NotificationConsumer.notify().
+</p>
+<p>
+<b>Action on initializeCompleted():</b> None.
+</p>
+<p>
+<b>Action on prepareShutdown():</b> None.
+</p>
+<p>
+<b>Action on shutdown():</b> None.
+</p>
+<p>
+<b>Non-Core Dependencies:</b> None.
+<p>
+<b>Behavior and Limitations:</b> The implementation of notify() spawns a new
+thread for every message (or message array) it receives and immediately returns.
+The thread loops through all of the current message listeners in the order that
+they were added and gives them a chance to process the message. Per the spec,
+no faults are thrown, no matter what content is found in the message(s); the
+implementation simply logs the error and continues.
+</p>
+<p>
+<b>Initialization parameters:</b> None.
+</p>
+<br><br>
+
+
+
+

Added: webservices/muse/site/docs/2.0.0/manual/capabilities/wsn-np.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/capabilities/wsn-np.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/capabilities/wsn-np.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/capabilities/wsn-np.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,97 @@
+
+
+<p>
+<b>Apache Muse - WS-BaseNotification - NotificationProducer Capability</b>
+
+</p>
+<p>
+<b>Spec name and port type:</b> WS-BaseNotification v1.3, NotificationProducer
+(<a href="../../specs/WS-BaseNotification-1_3.wsdl">WSDL</a>)
+</p>
+<p>
+<b>Capability URI:</b> http://docs.oasis-open.org/wsn/bw-2/NotificationProducer
+</p>
+<p>
+<b>Description:</b> This capability implements the WS-N publish-subscribe system
+so that resources can notify listeners as to events that have occurred. Through
+the Subscribe operation, clients can register to receive notifications about a
+subset (or all) of the events that happen to the resource. Subscribing to these
+notifications results in the creation of a Subscription WS-resource, the lifetime
+of which can be controlled by the requesting client. These subscriptions are managed
+by Muse's resource manager but are referenced by this capability in order to send
+out notifications to the right listeners at the right time.
+</p>
+<p>
+One cannot add this capability without also deploying the SubscriptionManager
+resource type. More details are provided in <em>Behavior and Limitations</em>.
+</p>
+<p>
+<b>Java interface:</b>
+<a href="muse-wsn-api/src/org/apache/muse/ws/notification/NotificationProducer.java?view=markup">org.apache.muse.ws.notification.NotificationProducer</a>
+<blockquote>
+<b>JAR file:</b> muse-wsn-api.jar
+</blockquote>
+</p>
+<p>
+<b>Default Java implementation:</b> org.apache.muse.ws.notification.impl.SimpleNotificationProducer
+<blockquote>
+<b>JAR file:</b> muse-wsn-impl.jar
+</blockquote>
+</p>
+<p>
+<b>Action on initialize():</b> Registers itself as a listener on ResourceManager change events (resource
+creation and destruction) so it can update its internal cache of subscription references as needed. Verifies
+that the SubcriptionManager resource type has been deployed. Initializes the resource's topic set from a
+file, if one exists.
+</p>
+<p>
+<b>Action on initializeCompleted():</b> Creates a topic for each resource property exposed by the resource type.
+If the type exposes either of the WSRL capabilities, the WSRL termination topic is also created.
+</p>
+<p>
+<b>Action on prepareShutdown():</b> None.
+</p>
+<p>
+<b>Action on shutdown():</b> None.
+</p>
+<p>
+<b>Non-Core Dependencies:</b><br>
+<ul>
+<li><a href="wsn-sub.html">http://docs.oasis-open.org/wsn/bw-2/SubscriptionManager</a></li>
+<li><a href="wsrf-wsrl-scheduled.html">http://docs.oasis-open.org/wsrf/rlw-2/ScheduledTermination</a></li>
+<li><a href="wsrf-abstract.html">The Abstract WSRF Capability</a></li>
+</ul>
+<p>
+<b>Behavior and Limitations:</b> Calls to subscribe() result in the creation of a subscription resource; in the
+default implementation, these subscriptions are persisted as XML files on disk and will be reloaded if the
+application's container reboots. The type representing subscriptions is any resource type deployed in muse.xml
+that has the <a href="wsn-sub.html">SubscriptionManager</a> capability. If no such resource type is
+deployed, the capability will fail to initialize, because the type is necessary in order to represent subscriptions
+in a standards-compliant way.
+<br><br>
+This capability provides a publish() method that allows users to send payload content to subscribers without
+knowing anything about the internal subscription management data structures, how many subscribers there are, etc.
+Users provide an optional topic and the payload (content for wsnt:Message), and the capability will handle the
+packaging of the notification and pushing it out to the consumers. Messages without a topic will be published to
+subscribers whose subscription filter matches the message's XML content.
+<br><br>
+The default implementation of WSN NotificationProducer includes all three standard filter types. Use of the
+message pattern filter may hurt performance, as it requires an XPath evaluation on each message that is published.
+The resource property filters will vary in performance depending on how many properties are being checked at the
+time of the notification; these filters inherently involve dynamic (mutable) properties, so a cache of equality
+test results is not likely to help. Topic filters provide the best performance because they only require a simple
+equality check against the filter's topic name and the message's topic name; the trade-off with topic filters is
+that they require more work at design time.
+</p>
+<p>
+<b>Initialization parameters:</b>
+<ul>
+<li><b>topic-set</b> - The relative path of an XML file containing the topic set that the resource type should publish. It does
+not have to include WSRP topics or WSRL topics, as these are added automatically.
+</ul>
+</p>
+<br><br>
+
+
+
+

Added: webservices/muse/site/docs/2.0.0/manual/capabilities/wsn-pullpoint-c.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/capabilities/wsn-pullpoint-c.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/capabilities/wsn-pullpoint-c.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/capabilities/wsn-pullpoint-c.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,73 @@
+
+<p>
+<b>Apache Muse - WS-BaseNotification - PullPointCreation Capability</b>
+
+</p>
+<p>
+<b>Spec name and port type:</b> WS-BaseNotification v1.3, PullPointCreation
+(<a href="../../specs/WS-BaseNotification-1_3.wsdl">WSDL</a>)
+</p>
+<p>
+<b>Capability URI:</b> http://docs.oasis-open.org/wsn/bw-2/PullPointCreation
+</p>
+<p>
+<b>Description:</b> This capability implements the WS-N CreatePullPoint operation,
+which allows a client to create a "pullpoint", or a place where the client can go
+to retrieve notifications produced by the resource on its own time. This is like
+a semi-broker system, and is not publish-subscribe - the pullpoint that is created
+by the CreatePullPoint operation will subscribe the resource's notifications and
+then save them for future retrieval rather than forwarding them.
+</p>
+<p>
+One cannot add this capability without also deploying the PullPoint
+resource type. More details are provided in <em>Behavior and Limitations</em>.
+</p>
+<p>
+<b>Java interface:</b>
+<a href="muse-wsn-api/src/org/apache/muse/ws/notification/PullPointCreation.java?view=markup">org.apache.muse.ws.notification.PullPointCreation</a>
+<blockquote>
+<b>JAR file:</b> muse-wsn-api.jar
+</blockquote>
+</p>
+<p>
+<b>Default Java implementation:</b> org.apache.muse.ws.notification.impl.SimplePullPointCreation
+<blockquote>
+<b>JAR file:</b> muse-wsn-impl.jar
+</blockquote>
+</p>
+<p>
+<b>Action on initialize():</b> Verifies that the PullPoint resource type has been deployed.
+</p>
+<p>
+<b>Action on initializeCompleted():</b> None.
+</p>
+<p>
+<b>Action on prepareShutdown():</b> None.
+</p>
+<p>
+<b>Action on shutdown():</b> None.
+</p>
+<p>
+<b>Non-Core Dependencies:</b><br>
+<ul>
+<li><a href="wsn-pullpoint.html">http://docs.oasis-open.org/wsn/bw-2/PullPoint</a></li>
+<li><a href="wsn-np.html">http://docs.oasis-open.org/wsn/bw-2/NotificationProducer</a></li>
+<li><a href="wsn-sub.html">http://docs.oasis-open.org/wsn/bw-2/SubscriptionManager</a></li>
+<li><a href="wsrf-abstract.html">The Abstract WSRF Capability</a></li>
+</ul>
+<p>
+<b>Behavior and Limitations:</b> Calls to createPullPoint() result in the creation of a pullpoint resource; in the
+default implementation, these pullpoints are persisted as XML files on disk and will be reloaded if the
+application's container reboots. The type representing pullpoints is any resource type deployed in muse.xml
+that has the <a href="wsn-pullpoint.html">PullPoint</a> capability. If no such resource type is
+deployed, the capability will fail to initialize, because the type is necessary in order to represent pullpoints
+in a standards-compliant way.
+</p>
+<p>
+<b>Initialization parameters:</b> None.
+</p>
+<br><br>
+
+
+
+

Added: webservices/muse/site/docs/2.0.0/manual/capabilities/wsn-pullpoint.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/capabilities/wsn-pullpoint.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/capabilities/wsn-pullpoint.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/capabilities/wsn-pullpoint.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,72 @@
+
+<p>
+<b>Apache Muse - WS-BaseNotification - PullPoint Capability</b>
+
+</p>
+<p>
+<b>Spec name and port type:</b> WS-BaseNotification v1.3, PullPoint
+(<a href="../../specs/WS-BaseNotification-1_3.wsdl">WSDL</a>)
+</p>
+<p>
+<b>Capability URI:</b> http://docs.oasis-open.org/wsn/bw-2/PullPoint
+</p>
+<p>
+<b>Description:</b> This capability exposes WS-N pullpoint resources, which act
+as temporary storage for notifications until clients retrieve them. This type of
+notification is different from publish-subscribe because clients will get the
+resource's messages by polling (or some other trigger) rather than expecting to
+receive the notification as soon as it occurs. Pullpoints work by acting as a
+semi-broker - they subscribe to notifications so clients don't have to, and then
+they store the notifications they receive until the clients ask for them.
+</p>
+<p>
+<b>Java interface:</b>
+<a href="muse-wsn-api/src/org/apache/muse/ws/notification/PullPoint.java?view=markup">org.apache.muse.ws.notification.PullPoint</a>
+<blockquote>
+<b>JAR file:</b> muse-wsn-api.jar
+</blockquote>
+</p>
+<p>
+<b>Default Java implementation:</b> org.apache.muse.ws.notification.impl.SimplePullPoint
+<blockquote>
+<b>JAR file:</b> muse-wsn-impl.jar
+</blockquote>
+</p>
+<p>
+<b>Action on initialize():</b> Creates an instance of PullPointDataStore, which is
+a generic interface for the component that is storing the notifications. Makes sure
+that the NotificationConsumer capability is present, and then registers itself to
+listen for all incoming notifications.
+</p>
+<p>
+<b>Action on initializeCompleted():</b> None.
+</p>
+<p>
+<b>Action on prepareShutdown():</b> None.
+</p>
+<p>
+<b>Action on shutdown():</b> None.
+</p>
+<p>
+<b>Non-Core Dependencies:</b>
+<ul>
+<li><a href="wsn-nc.html">http://docs.oasis-open.org/wsn/bw-2/NotificationConsumer</a></li>
+<li><a href="wsrf-abstract.html">The Abstract WSRF Capability</a></li>
+<li>org.apache.muse.ws.notification.PullPointDataStore</li>
+</ul>
+<p>
+<b>Behavior and Limitations:</b> Muse provides simple implementation of PullPointDataStore
+that keeps an in-memory collection of the notifications with an adjustable maximum size; most
+users will want to replace this component with one that stores the notifications in a more
+performant way. The current PullPointDataStore also deletes notifications once they have
+been read with the GetMessages operation - this is neither required or prohibited, as the
+spec is vague on what should happen after a notification has been retrieved by one client.
+</p>
+<p>
+<b>Initialization parameters:</b> None.
+</p>
+<br><br>
+
+
+
+

Added: webservices/muse/site/docs/2.0.0/manual/capabilities/wsn-sub.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/capabilities/wsn-sub.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/capabilities/wsn-sub.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/capabilities/wsn-sub.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,74 @@
+
+
+<p>
+<b>Apache Muse - WS-BaseNotification - SubscriptionManager Capability</b>
+
+</p>
+<p>
+<b>Spec name and port type:</b> WS-BaseNotification v1.3, SubscriptionManager
+(<a href="../../specs/WS-BaseNotification-1_3.wsdl">WSDL</a>)
+</p>
+<p>
+<b>Capability URI:</b> http://docs.oasis-open.org/wsn/bw-2/SubscriptionManager
+</p>
+<p>
+<b>Description:</b> This capability represents WSN subscription resources that
+were created by another WS-resource's NotificationProducer capability. Each
+subscription resource has a consumer that it publishes message to and a filter
+that allows it to determine which messages should be sent. Remote clients can
+manage the lifecycle of subscriptions if the subscription resource type is
+deployed with either of the WSRL capabilities.
+</p>
+<p>
+<b>Java interface:</b>
+<a href="muse-wsn-api/src/org/apache/muse/ws/notification/SubscriptionManager.java?view=markup">org.apache.muse.ws.notification.SubscriptionManager</a>
+<blockquote>
+<b>JAR file:</b> muse-wsn-api.jar
+</blockquote>
+</p>
+<p>
+<b>Default Java implementation:</b> org.apache.muse.ws.notification.impl.SimpleSubscriptionManager
+<blockquote>
+<b>JAR file:</b> muse-wsn-impl.jar
+</blockquote>
+</p>
+<p>
+<b>Action on initialize():</b> Creates an instance of NotificationConsumerClient using the
+consumer's EPR.
+</p>
+<p>
+<b>Action on initializeCompleted():</b> None.
+</p>
+<p>
+<b>Action on prepareShutdown():</b> None.
+</p>
+<p>
+<b>Action on shutdown():</b> None.
+</p>
+<p>
+<b>Non-Core Dependencies:</b><br>
+<ul>
+<li>org.apache.muse.core.ws.notification.remote.NotificationConsumerClient</li>
+</ul>
+<p>
+<b>Behavior and Limitations:</b>
+This capability provides a publish() method that allows users to send notifications (NotificationMessage objects)
+to the subscription's consumer. If multiple notification messages are published at once and one of them fails
+to reach the consumer, a warning message is logged and the next message is considered. The subscription's filter is
+used to determine if the message should be sent.
+<br><br>
+The pauseSubscription() and resumeSubscription() operations are implemented as a simple flag that is checked when
+a message is published, so pausing and resuming subscriptions does not require overhead or have an effect on performance.
+</p>
+<p>
+<b>Initialization parameters:</b>
+<ul>
+<li><b>trace-notifications</b> - A Boolean value that tells the capability implementation if it should log
+the outgoing notifications (SOAP messages). The default value is 'false'.
+</ul>
+</p>
+<br><br>
+
+
+
+

Added: webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-abstract.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-abstract.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-abstract.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-abstract.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,99 @@
+
+<p>
+<b>Apache Muse - The Abstract WSRF Capability</b>
+
+</p>
+<p>
+<b>Spec name and port type:</b> WS-ResourceFramework v1.2 (and any capability that depends on it)
+</p>
+<p>
+<b>Capability URI:</b> Provided by concrete capability types.
+</p>
+<p>
+<b>Description:</b> Muse defines an abstract base class that provides a simple
+feature in addition to those offered by the core Capability and AbstractCapability
+types. AbstractWsResourceCapability ensures that any resource class that is using
+the concrete capability is of type WsResource, and thus has a ResourcePropertyCollection.
+Based on this knowledge, the abstract class tries to discover and validate the
+resource properties defined by the concrete capability during its initialization.
+</p>
+<p>
+<b>Java interface:</b>
+<a href="muse-wsrf-api/src/org/apache/muse/ws/resource/WsResourceCapability.java?view=markup">org.apache.muse.ws.resource.WsResourceCapability</a>
+<blockquote>
+<b>JAR file:</b> muse-wsrf-api.jar
+</blockquote>
+</p>
+<p>
+<b>Default Java implementation:</b> org.apache.muse.ws.resource.impl.AbstractWsResourceCapability
+<blockquote>
+<b>JAR file:</b> muse-wsrf-impl.jar
+</blockquote>
+</p>
+<p>
+<b>Action on initialize():</b> For each property name returned by the
+getPropertyNames() method, the class will determine if there is a appropriate
+getter (method of form <b>getFoo()</b>) and setter (method of form <b>setFoo(Foo)</b>).
+There must at least be a getter; setters are only needed if the property is
+writeable.
+<br><br>
+Assuming the appropriate getter and setter are available, the class then
+registers the capability with the resource's ResourcePropertyCollection; this
+action will result in the ResourcePropertyCollection delegating all WSRP
+operations for the capability's properties to the its get/set methods.
+</p>
+<p>
+<b>Action on initializeCompleted():</b> None.
+</p>
+<p>
+<b>Action on prepareShutdown():</b> None.
+</p>
+<p>
+<b>Action on shutdown():</b> None.
+</p>
+<p>
+<b>Non-Core Dependencies:</b>
+<ul>
+<li>org.apache.muse.ws.resource.Resource</li><br>
+<li>org.apache.muse.ws.resource.properties.ResourcePropertyCollection</li>
+</ul>
+<p>
+<a name="behavior"><b>Behavior and Limitations:</b></a>
+The getter and setter methods for the resource
+properties must be of the form <b>get{LocalName}</b> and <b>set{LocalName}</b>,
+where <b>{LocalName}</b> is the local name of the property's QName. Assuming
+each capability defines its properties in its own schema namespace, there
+should be no name clashes with other capabilities' properties and methods.
+<br><br>
+The <b>{LocalName}</b> portion of the method must be the exact local name,
+even if the property has a cardinality greater than zero; in other words, if
+a property can have multiple values, its getter and setter name cannot use the
+plural form of the name. For example, if a capability defines a property
+{http://ws.apache.org/muse/test/example}Foo, the getter and setter for the
+property must be named getFoo() and setFoo() even if Foo is [0..n]. The
+names getFoos() or setFoos() will result in an initialization error.
+<br><br>
+Properties with a cardinality greater than one should be represented in their
+getters and setters with arrays. Users may use whatever they like to store the
+values internally (Java Collections Framework, persistent data store, etc.),
+but the values must come in and out as arrays.
+<br><br>
+When the class encounters a property that has a cardinality of [0..1] and
+is also nillable, the getProperty(QName) method will return an empty Element
+(null value) to the ResourcePropertyCollection if the value of the property
+is null. This is not 100% correct because the property could have no value,
+so returning one value (null) would be wrong. In general, it is best to
+avoid this ambiguity when defining your property schemas. However, if you
+must have such ambiguity, and the default behavior is not what you want,
+you can change the behavior by overriding the getProperty(QName) method and
+taking special action for the property in question; just remember to call
+super.getProperty(QName) to deal with the other properties in the capability!
+</p>
+<p>
+<b>Initialization parameters:</b> None.
+</p>
+<br><br>
+
+
+
+

Added: webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wsrl-immediate.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wsrl-immediate.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wsrl-immediate.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wsrl-immediate.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,58 @@
+
+
+<p>
+<b>Apache Muse - WS-ResourceLifetime - ImmediateResourceTermination Capability</b>
+
+</p>
+<p>
+<b>Spec name and port type:</b> WS-ResourceLifetime v1.2, ImmediateResourceTermination
+(<a href="../../specs/WS-ResourceLifetime-1_2.wsdl">WSDL</a>)
+</p>
+<p>
+<b>Capability URI:</b> http://docs.oasis-open.org/wsrf/rlw-2/ImmediateTermination
+</p>
+<p>
+<b>Description:</b> This capability exposes to remote clients the resource's
+shutdown() operation, meaning remote clients can initiate the resource's
+shutdown process. The WSRL name for the shutdown-related operation is Destroy.
+</p>
+<p>
+<b>Java interface:</b>
+<a href="muse-wsrf-api/src/org/apache/muse/ws/resource/lifetime/ImmediateTermination.java?view=markup">org.apache.muse.ws.resource.lifetime.ImmediateTermination</a>
+<blockquote>
+<b>JAR file:</b> muse-wsrf-api.jar
+</blockquote>
+</p>
+<p>
+<b>Default Java implementation:</b> org.apache.muse.ws.resource.lifetime.impl.SimpleImmediateTermination
+<blockquote>
+<b>JAR file:</b> muse-wsrf-impl.jar
+</blockquote>
+</p>
+<p>
+<b>Action on initialize():</b> None.
+</p>
+<p>
+<b>Action on initializeCompleted():</b> None.
+</p>
+<p>
+<b>Action on prepareShutdown():</b> None.
+</p>
+<p>
+<b>Action on shutdown():</b> None.
+</p>
+<p>
+<b>Non-Core Dependencies:</b> None.
+<p>
+<b>Behavior and Limitations:</b> The implementation of the WSRL Destroy operation
+is very simple - it calls the resource's shutdown() method, which in turn shuts
+down all of the resource's capabilities for a clean exit.
+</p>
+<p>
+<b>Initialization parameters:</b> None.
+</p>
+<br><br>
+
+
+
+

Added: webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wsrl-scheduled.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wsrl-scheduled.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wsrl-scheduled.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wsrl-scheduled.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,70 @@
+
+
+<p>
+<b>Apache Muse - WS-ResourceLifetime - ScheduledResourceTermination Capability</b>
+
+</p>
+<p>
+<b>Spec name and port type:</b> WS-ResourceLifetime v1.2, ScheduledResourceTermination
+(<a href="../../specs/WS-ResourceLifetime-1_2.wsdl">WSDL</a>)
+</p>
+<p>
+<b>Capability URI:</b> http://docs.oasis-open.org/wsrf/rlw-2/ScheduledTermination
+</p>
+<p>
+<b>Description:</b> This capability defines two properties - CurrentTime and
+TerminationTime - and one operation - SetTerminationTime. The CurrentTime
+property is the current time according to the resource, and is used to determine
+how far off the TerminationTime is. Per the spec, the TerminationTime property
+must be set using the SetTerminationTime operation, <b>not</b> the WSRP
+SetResourceProperties operation. When the TerminationTime arrives, the resource
+will initiate its own destruction.
+</p>
+<p>
+<b>Java interface:</b>
+<a href="muse-wsrf-api/src/org/apache/muse/ws/resource/lifetime/ScheduledTermination.java?view=markup">org.apache.muse.ws.resource.lifetime.ScheduledTermination</a>
+<blockquote>
+<b>JAR file:</b> muse-wsrf-api.jar
+</blockquote>
+</p>
+<p>
+<b>Default Java implementation:</b> org.apache.muse.ws.resource.lifetime.impl.SimpleScheduledTermination
+<blockquote>
+<b>JAR file:</b> muse-wsrf-impl.jar
+</blockquote>
+</p>
+<p>
+<b>Action on initialize():</b> This implementation creates a java.util.Timer
+that can be scheduled (and rescheduled) according to the current TerminationTime.
+It is <b>not</b> scheduled until a valid TerminationTime is set using the
+SetTerminationTime operation.
+</p>
+<p>
+<b>Action on initializeCompleted():</b> None.
+</p>
+<p>
+<b>Action on prepareShutdown():</b> None.
+</p>
+<p>
+<b>Action on shutdown():</b> The termination timer is cancelled. If the
+timer has already fired, this is a no-op.
+</p>
+<p>
+<b>Non-Core Dependencies:</b> None.
+<p>
+<b>Behavior and Limitations:</b> The termination timer is scheduled the first
+time the TerminationTime is set to a non-null value. It is rescheduled (cancelled
+and then scheduled again) for each subsequent non-null value. It is cancelled
+when the TerminationTime is set to null. Cancelling an already cancelled timer
+is a no-op.
+<br><br>
+When the termination timer fires, it invokes the resource's shutdown method.
+</p>
+<p>
+<b>Initialization parameters:</b> None.
+</p>
+<br><br>
+
+
+
+

Added: webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wsrp-get.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wsrp-get.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wsrp-get.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wsrp-get.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,65 @@
+
+<p>
+<b>Apache Muse - WS-ResourceProperties - Get Capability</b>
+
+</p>
+<p>
+<b>Spec name and port type:</b> WS-ResourceProperties v1.2, GetResourceProperty,
+GetResourcePropertyDocument, and GetMultipleResourceProperties
+(<a href="../../specs/WS-ResourceProperties-1_2.wsdl">WSDL</a>)
+</p>
+<p>
+<b>Capability URI:</b> http://docs.oasis-open.org/wsrf/rpw-2/Get
+</p>
+<p>
+<b>Description:</b> This capability exposes to remote clients the
+"Get" operations of the resource's ResourcePropertyCollection; these operations
+are already available to internal (service-side) code, but they cannot be invoked
+by remote clients unless this capability is included. The three operations
+defined by this capability are GetResourceProperty, GetResourcePropertyDocument,
+and GetMultipleResourceProperties.
+</p>
+<p>
+<b>Java interface:</b>
+<a href="muse-wsrf-api/src/org/apache/muse/ws/resource/properties/get/GetCapability.java?view=markup">org.apache.muse.ws.resource.properties.get.GetCapability</a>
+<blockquote>
+<b>JAR file:</b> muse-wsrf-api.jar
+</blockquote>
+</p>
+<p>
+<b>Default Java implementation:</b> org.apache.muse.ws.resource.properties.get.impl.SimpleGetCapability
+<blockquote>
+<b>JAR file:</b> muse-wsrf-impl.jar
+</blockquote>
+</p>
+<p>
+<b>Action on initialize():</b> None.
+</p>
+<p>
+<b>Action on initializeCompleted():</b> None.
+</p>
+<p>
+<b>Action on prepareShutdown():</b> None.
+</p>
+<p>
+<b>Action on shutdown():</b> None.
+</p>
+<p>
+<b>Non-Core Dependencies:</b>
+<ul>
+<li><a href="wsrf-abstract.html">The Abstract WSRF Capability</a></li>
+</ul>
+<p>
+<b>Behavior and Limitations:</b> The implementations of the operations are
+simple "pass-throughs" to the equivalent methods in ResourcePropertyCollection.
+For more information on the actual process of reading property values, see the
+<a href="wsrf-abstract.html">Abstract WSRF Capability</a>.
+</p>
+<p>
+<b>Initialization parameters:</b> None.
+</p>
+<br><br>
+
+
+
+

Added: webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wsrp-query.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wsrp-query.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wsrp-query.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wsrp-query.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,75 @@
+
+
+<p>
+<b>Apache Muse - WS-ResourceProperties - Query Capability</b>
+
+</p>
+<p>
+<b>Spec name and port type:</b> WS-ResourceProperties v1.2, QueryResourceProperties
+(<a href="../../specs/WS-ResourceProperties-1_2.wsdl">WSDL</a>)
+</p>
+<p>
+<b>Capability URI:</b> http://docs.oasis-open.org/wsrf/rpw-2/Query
+</p>
+<p>
+<b>Description:</b> This capability exposes to remote clients the WSRP QueryResourceProperties
+operation, which allows them to execute queries against the resource's WSRP document. All
+implementations must support XPath 1.0 as a query dialect, but other query languages are allowed.
+The results of QueryResourceProperties may be any XML fragment - they are not necessarily the
+top-level elements that are returned from the WSRP "Get" operations.
+</p>
+<p>
+<b>Java interface:</b>
+<a href="muse-wsrf-api/src/org/apache/muse/ws/resource/properties/query/QueryCapability.java?view=markup">org.apache.muse.ws.resource.properties.query.QueryCapability</a>
+<blockquote>
+<b>JAR file:</b> muse-wsrf-api.jar
+</blockquote>
+</p>
+<p>
+<b>Default Java implementation:</b> org.apache.muse.ws.resource.properties.query.impl.SimpleQueryCapability
+<blockquote>
+<b>JAR file:</b> muse-wsrf-impl.jar
+</blockquote>
+</p>
+<p>
+<b>Action on initialize():</b> The implementation creates a QueryExpressionFactory
+that that will be used to construct QueryExpressions from the query and dialect
+strings passed to the QueryResourceProperties operation.
+</p>
+<p>
+<b>Action on initializeCompleted():</b> None.
+</p>
+<p>
+<b>Action on prepareShutdown():</b> None.
+</p>
+<p>
+<b>Action on shutdown():</b> None.
+</p>
+<p>
+<b>Non-Core Dependencies:</b>
+<ul>
+<li><a href="wsrf-wsrp-get.html">http://docs.oasis-open.org/wsrf/rpw-2/Get</a></li>
+</ul>
+<p>
+<b>Behavior and Limitations:</b> The default QueryExpressionFactory used by
+the implementation is an instance of XPathQueryExpressionFactory - it supports
+query strings that are XPath 1.0 compliant. Only the XPath 1.0 namespace URI
+should be used for the dialect URI.
+<br><br>
+The factory instance is created at initialization time using a protected method
+named createQueryExpressionFactory(). Users can sub-class and override this
+method in order to provide an alternate factory implementation that supports
+other dialects.
+<br><br>
+There is no query-like method on the ResourcePropertyCollection interface. This
+implementation works by calling GetResourcePropertyDocument and then evaluating
+the query string against the resulting XML document.
+</p>
+<p>
+<b>Initialization parameters:</b> None.
+</p>
+<br><br>
+
+
+
+

Added: webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wsrp-set.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wsrp-set.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wsrp-set.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wsrp-set.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,71 @@
+
+
+<p>
+<b>Apache Muse - WS-ResourceProperties - Set Capability</b>
+
+</p>
+<p>
+<b>Spec name and port type:</b> WS-ResourceProperties v1.2, SetResourceProperties
+and PutResourcePropertyDocument
+(<a href="../../specs/WS-ResourceProperties-1_2.wsdl">WSDL</a>)
+</p>
+<p>
+<b>Capability URI:</b> http://docs.oasis-open.org/wsrf/rpw-2/Set
+</p>
+<p>
+<b>Description:</b> This capability exposes to remote clients the
+SetResourceProperties and PutResourcePropertyDocument operations of the
+resource's ResourcePropertyCollection; these operations are already available
+to internal (service-side) code, but they cannot be invoked by remote clients
+unless this capability is included.
+</p>
+<p>
+<b>Java interface:</b>
+<a href="muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/SetCapability.java?view=markup">org.apache.muse.ws.resource.properties.set.SetCapability</a>
+<blockquote>
+<b>JAR file:</b> muse-wsrf-api.jar
+</blockquote>
+</p>
+<p>
+<b>Default Java implementation:</b> org.apache.muse.ws.resource.properties.set.impl.SimpleSetCapability
+<blockquote>
+<b>JAR file:</b> muse-wsrf-impl.jar
+</blockquote>
+</p>
+<p>
+<b>Action on initialize():</b> None.
+</p>
+<p>
+<b>Action on initializeCompleted():</b> None.
+</p>
+<p>
+<b>Action on prepareShutdown():</b> None.
+</p>
+<p>
+<b>Action on shutdown():</b> None.
+</p>
+<p>
+<b>Non-Core Dependencies:</b>
+<ul>
+<li><a href="wsrf-abstract.html">The Abstract WSRF Capability</a></li>
+</ul>
+<p>
+<b>Behavior and Limitations:</b> The implementations of the operations are
+simple "pass-throughs" to the equivalent methods in ResourcePropertyCollection.
+For more information on the actual process of writing property values, see the
+<a href="wsrf-abstract.html">Abstract WSRF Capability</a>.
+<br><br>
+The interface and implementation of this capability does not address the
+optional InsertResourceProperties, UpdateResourceProperties, and
+DeleteResourceProperties operations defined by WSRP. Each of these is a
+convenience operation that restricts the SetResourceProperties operation,
+providing no additional value.
+</p>
+<p>
+<b>Initialization parameters:</b> None.
+</p>
+<br><br>
+
+
+
+

Added: webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wssg-sg.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wssg-sg.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wssg-sg.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wssg-sg.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,90 @@
+
+
+<p>
+<b>Apache Muse - WS-ServiceGroup - ServiceGroup Capability</b>
+
+</p>
+<p>
+<b>Spec name and port type:</b> WS-ServiceGroup v1.2, ServiceGroup
+(<a href="../../specs/WS-ServiceGroup-1_2.wsdl">WSDL</a>)
+</p>
+<p>
+<b>Capability URI:</b> http://docs.oasis-open.org/wsrf/sgw-2/ServiceGroup
+</p>
+<p>
+<b>Description:</b> This capability allows users to create service groups whose
+entries represent local or remote resources (that is, resources that are created
+in the same application space or in other applications). Each entry in the
+service group is represented as a WS-resource.
+</p>
+<p>
+<b>Java interface:</b>
+<a href="muse-wsrf-api/src/org/apache/muse/ws/resource/sg/ServiceGroup.java?view=markup">org.apache.muse.ws.resource.sg.ServiceGroup</a>
+<blockquote>
+<b>JAR file:</b> muse-wsrf-api.jar
+</blockquote>
+</p>
+<p>
+<b>Default Java implementation:</b> org.apache.muse.ws.resource.sg.impl.SimpleServiceGroup
+<blockquote>
+<b>JAR file:</b> muse-wsrf-impl.jar
+</blockquote>
+</p>
+<p>
+<b>Action on initialize():</b> The implementation checks to make sure that a
+resource with the WSSG ServiceGroupEntry capability has been deployed in the
+same application so that it can create ServiceGroupEntry resources for each of
+its entries. If no such resource type is deployed, initialization will fail.
+<br><br>
+The capability also registers itself as a listener on the ResourceManager so
+that it can create (and destroy) the appropriate ServiceGroupEntry resources
+each time other resource types are instantiated (or destroyed). This allows
+users to collect resource types in service groups without writing code to do
+so explicitly.
+</p>
+<p>
+<b>Action on initializeCompleted():</b> None.
+</p>
+<p>
+<b>Action on prepareShutdown():</b> None.
+</p>
+<p>
+<b>Action on shutdown():</b> All of the ServiceGroup's ServiceGroupEntry
+resources are shutdown.
+</p>
+<p>
+<b>Non-Core Dependencies:</b>
+<ul>
+<li><a href="wsrf-wsrl-scheduled.html">http://docs.oasis-open.org/wsrf/rlw-2/ScheduledTermination</a></li><br>
+<li><a href="wsrf-wssg-sge.html">http://docs.oasis-open.org/wsrf/sgw-2/ServiceGroupEntry</a></li>
+</ul>
+<p>
+<b>Behavior and Limitations:</b> This implementation of WSSG ServiceGroup is
+somewhat unique in that it does not use the static wsrf-sg:Content data provided
+during the creation of a ServiceGroupEntry resource. Instead, the implementation
+uses the EPR of the potential member service to create a client for the service
+and read the property values listed in the group's wsrf-sg:MembershipContentRule
+property. If the service's current properties document has the required properties,
+the service will become a member of the group; the wsrf-sg:Content element is
+ignored, since it may be inaccurate or simply wrong.
+<br><br>
+The ServiceGroup implementation is a ResourceManagerListener. For every notification
+it receives of a newly-added resource, a new ServiceGroupEntry resource is created
+to represent it. The only exceptions are for the ServiceGroup resource itself and
+the ServiceGroupEntry resources (creating entries for entries would result in an
+infinite recursion). Similarly, resources are removed from the group when a
+notification is received that the ResourceManager has removed them.
+<br><br>
+While this capability allows internal (service-side) code to add entries to the
+service group manually, it does not expose the WSSG Add operation to remote
+clients. This is done by adding in the
+<a href="wsrf-wssg-sgr.html">ServiceGroupRegistration</a> capability.
+</p>
+<p>
+<b>Initialization parameters:</b> None.
+</p>
+<br><br>
+
+
+
+

Added: webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wssg-sge.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wssg-sge.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wssg-sge.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wssg-sge.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,64 @@
+
+<p>
+<b>Apache Muse - WS-ServiceGroup - ServiceGroupEntry Capability</b>
+
+</p>
+<p>
+<b>Spec name and port type:</b> WS-ServiceGroup v1.2, ServiceGroupEntry
+(<a href="../../specs/WS-ServiceGroupEntry-1_2.wsdl">WSDL</a>)
+</p>
+<p>
+<b>Capability URI:</b> http://docs.oasis-open.org/wsrf/sgw-2/ServiceGroupEntry
+</p>
+<p>
+<b>Description:</b> This capability represents the WSSG ServiceGroupEntry type,
+which is the unit of measure in a WSSG ServiceGroup. There is one entry resource
+representing every member resource of a service group.
+</p>
+<p>
+<b>Java interface:</b>
+<a href="muse-wsrf-api/src/org/apache/muse/ws/resource/sg/Entry.java?view=markup">org.apache.muse.ws.resource.sg.Entry</a>
+<blockquote>
+<b>JAR file:</b> muse-wsrf-api.jar
+</blockquote>
+</p>
+<p>
+<b>Default Java implementation:</b> org.apache.muse.ws.resource.sg.impl.SimpleEntry
+<blockquote>
+<b>JAR file:</b> muse-wsrf-impl.jar
+</blockquote>
+</p>
+<p>
+<b>Action on initialize():</b> None.
+</p>
+<p>
+<b>Action on initializeCompleted():</b> None.
+</p>
+<p>
+<b>Action on prepareShutdown():</b> None.
+</p>
+<p>
+<b>Action on shutdown():</b> The implementation removes the entry resource from
+the containing service group so that it is no longer visible to clients.
+</p>
+<p>
+<b>Non-Core Dependencies:</b>
+<ul>
+<li>org.apache.muse.ws.resource.remote.WsResourceClient</li><br>
+<li><a href="wsrf-wssg-sg.html">http://docs.oasis-open.org/wsrf/sgw-2/ServiceGroup</a></li>
+</ul>
+<p>
+<b>Behavior and Limitations:</b> This implementation reads the value of the
+wsrf-sg:Content property dynamically by creating a web services client for
+the member service and calling the WSRP GetMultipleResourceProperties operation.
+If an InvalidResourcePropertyQNameFault is returned, a ContentCreationFailedFault
+is re-thrown to the caller. The wsrf-sg:Content value is never cached.
+</p>
+<p>
+<b>Initialization parameters:</b> None.
+</p>
+<br><br>
+
+
+
+

Added: webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wssg-sgr.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wssg-sgr.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wssg-sgr.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/capabilities/wsrf-wssg-sgr.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,64 @@
+
+
+<p>
+<b>Apache Muse - WS-ServiceGroup - ServiceGroupRegistration Capability</b>
+
+</p>
+<p>
+<b>Spec name and port type:</b> WS-ServiceGroup v1.2, ServiceGroupRegistration
+(<a href="../../specs/WS-ServiceGroup-1_2.wsdl">WSDL</a>)
+</p>
+<p>
+<b>Capability URI:</b> http://docs.oasis-open.org/wsrf/sgw-2/ServiceGroupRegistration
+</p>
+<p>
+<b>Description:</b> This capability simply allows remote clients to create
+new entries in a service group via the WSSG Add operation; this operation
+is already available to internal (service-side) code, but it cannot be invoked
+by remote clients unless this capability is included.
+</p>
+<p>
+<b>Java interface:</b>
+<a href="muse-wsrf-api/src/org/apache/muse/ws/resource/sg/ServiceGroupRegistration.java?view=markup">org.apache.muse.ws.resource.sg.ServiceGroupRegistration</a>
+<blockquote>
+<b>JAR file:</b> muse-wsrf-api.jar
+</blockquote>
+</p>
+<p>
+<b>Default Java implementation:</b> org.apache.muse.ws.resource.sg.impl.SimpleServiceGroupRegistration
+<blockquote>
+<b>JAR file:</b> muse-wsrf-impl.jar
+</blockquote>
+</p>
+<p>
+<b>Action on initialize():</b> This capability checks to make sure that the
+resource type implements the <a href="wsrf-wssg-sg.html">ServiceGroup</a>
+capability, which it relies on for its implementation.
+</p>
+<p>
+<b>Action on initializeCompleted():</b> None.
+</p>
+<p>
+<b>Action on prepareShutdown():</b> None.
+</p>
+<p>
+<b>Action on shutdown():</b> None.
+</p>
+<p>
+<b>Non-Core Dependencies:</b>
+<ul>
+<li><a href="wsrf-wssg-sg.html">http://docs.oasis-open.org/wsrf/sgw-2/ServiceGroup</a></li>
+</ul>
+<p>
+<b>Behavior and Limitations:</b> The implementation of the WSSG Add operation
+is a simple "pass-through" to ServiceGroup.addEntry(). The EPR of the new
+ServiceGroupEntry resource is returned to the caller.
+</p>
+<p>
+<b>Initialization parameters:</b> None.
+</p>
+<br><br>
+
+
+
+

Added: webservices/muse/site/docs/2.0.0/manual/capabilities/wsx.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/capabilities/wsx.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/capabilities/wsx.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/capabilities/wsx.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,73 @@
+
+
+<p>
+<b>Apache Muse - WS-MetadataExchange - MetadataExchange Capability</b>
+
+</p>
+<p>
+<b>Spec name and port type:</b> WS-MetadataExchange v09/2004, MetadataExchange
+(<a href="../../specs/WS-MetadataExchange-2004_09.wsdl">WSDL</a>)
+</p>
+<p>
+<b>Capability URI:</b> http://schemas.xmlsoap.org/ws/2004/09/mex
+</p>
+<p>
+<b>Description:</b> This capability implements the GetMetadata operation
+defined by the WS-MetadataExchange specification. Clients can provide a
+dialect (URI) representing a certain type of metadata, and the capability
+will return an XML document(s) describing that metadata. The spec defines
+a standard dialect for requesting and receiving WSDL documents.
+</p>
+<p>
+<b>Java interface:</b>
+<a href="muse-wsx-api/src/org/apache/muse/ws/metadata/MetadataExchange.java?view=markup">org.apache.muse.ws.metadata.MetadataExchange</a>
+<blockquote>
+<b>JAR file:</b> muse-wsx-api.jar
+</blockquote>
+</p>
+<p>
+<b>Default Java implementation:</b> org.apache.muse.ws.metadata.impl.SimpleMetadataExchange
+<blockquote>
+<b>JAR file:</b> muse-wsx-impl.jar
+</blockquote>
+</p>
+<p>
+<b>Action on initialize():</b> None.
+</p>
+<p>
+<b>Action on initializeCompleted():</b> None.
+</p>
+<p>
+<b>Action on prepareShutdown():</b> None.
+</p>
+<p>
+<b>Action on shutdown():</b> None.
+</p>
+<p>
+<b>Non-Core Dependencies:</b> None.
+<p>
+<b>Behavior and Limitations:</b>
+The WSDL dialect defined by the spec is implemented such that GetMetadata
+requests that use the WSDL dialect will receive the entire WSDL document,
+including all imported schemas and WSDLs. No additional metadata dialects
+are defined or implemented.
+<br><br>
+The implementation reads and constructs the WSDL document for every
+GetMetadata request in order to avoid having the WSDL document in
+memory at all times. This might be a significant burden given that
+many "real world" resource types will import a number of other WSDL
+and XSD files, creating a very large in-memory structure.
+<br><br>
+The spec does not define any fault types or undesirable behavior, so the
+implementation (which is spec-compliant) does not differentiate
+between invalid dialects and valid dialects that simply have no metadata
+documents to return.
+</p>
+<p>
+<b>Initialization parameters:</b> None.
+</p>
+<br><br>
+
+
+
+

Added: webservices/muse/site/docs/2.0.0/manual/how-to/index.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/how-to/index.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/how-to/index.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/how-to/index.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,10 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<title>Apache Muse - Documentation</title>
+<meta http-equiv="refresh" content="0; url=../index.html#how-to">
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+</head>
+<body>
+</body>
+</html>
\ No newline at end of file

Modified: webservices/muse/site/docs/2.0.0/manual/index.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/index.html?view=diff&rev=441835&r1=441834&r2=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/index.html (original)
+++ webservices/muse/site/docs/2.0.0/manual/index.html Sat Sep  9 11:02:21 2006
@@ -125,18 +125,167 @@
 <strong>Table of Contents</strong> 
 <div id="minitoc-area">
 <ul class="minitoc">
-<li><a name="architecture"><strong>Architecture</strong></a>
+<li><a name="architecture"></a><strong>Architecture</strong>
+<p>
 	<ul class="minitoc">
-	<li><a name="programming-model">Programming Model</a></li>
-	</ul>
+	<li><a href="architecture/programming-model.html">Programming Model</a></li>
+	<li><a href="architecture/application-layout.html">Application Layout</a></li>
+	<li><a href="architecture/deployment-descriptor.html">Deployment Descriptor</a></li>
+	<li><a href="architecture/request-response.html">Request-Response Cycle</a></li>
+	</ul><br>
+</p>
+</li>
+<li><a name="platforms"></a><strong>Platforms</strong>
+<p>
+	<ul class="minitoc">
+	<li><a href="platforms/axis2.html">Apache Axis2</a></li>
+	<li><a href="platforms/osgi.html">OSGi</a></li>
+	</ul><br>
+</p>
 </li>
-<li><a name="capabilities"><strong>Capabilities</strong></a>
+<li><a name="tools"></a><strong>Tools</strong>
+<p>
+	<ul class="minitoc">
+	<li><a href="tools/wsdl-conventions.html">WSDL Conventions</a></li>
+	<li><a href="tools/wsdl2java.html">WSDL2Java</a></li>
+	<li><a href="tools/wsdlmerge.html">WSDLMerge</a></li>
+	</ul><br>
+</p>
 </li>
-<li><a name="tools"><strong>Tools</strong></a>
+<li><a name="capabilities""></a><strong>Capabilities</strong>
+<p><br/>
+	<ul class="minitoc">
+	
+	<li><b>WS-MetadataExchange v09/2004 (WSMEX)</b>
+		<br><br>
+		<ul>
+		<li>
+		<a href="capabilities/wsx.html">MetadataExchange</a>
+		</li>
+		</ul>
+		</li><br>
+		
+		<li><b>WS-ResourceFramework v1.2 (WSRF)</b>
+		<br><br>
+		<ul>
+		<li>
+		<a href="capabilities/wsrf-abstract.html">The Abstract WSRF Capability</a>
+		</li>
+		</ul>
+		</li><br>
+		
+		
+		<li><b>WS-ResourceProperties v1.2 (WSRP)</b>
+		<br><br>
+		<ul>
+		<li>
+		<a href="capabilities/wsrf-wsrp-get.html">GetResourceProperty</a>
+		</li>
+		<li>
+		<a href="capabilities/wsrf-wsrp-query.html">QueryResourceProperties</a>
+		</li>
+		<li>
+		<a href="capabilities/wsrf-wsrp-set.html">SetResourceProperties</a>
+		</li>
+		</ul>
+		</li><br>
+		
+		<li><b>WS-ResourceLifetime v1.2 (WSRL)</b>
+		<br><br>
+		<ul>
+		<li>
+		<a href="capabilities/wsrf-wsrl-immediate.html">ImmediateResourceTermination</a>
+		</li>
+		<li>
+		<a href="capabilities/wsrf-wsrl-scheduled.html">ScheduledResourceTermination</a>
+		</li>
+		</ul>
+		</li><br>
+		
+		<li><b>WS-ServiceGroup v1.2 (WSSG)</b>
+		<br><br>
+		<ul>
+		<li>
+		<a href="capabilities/wsrf-wssg-sg.html">ServiceGroup</a>
+		</li>
+		<li>
+		<a href="capabilities/wsrf-wssg-sgr.html">ServiceGroupRegistration</a>
+		</li>
+		<li>
+		<a href="capabilities/wsrf-wssg-sge.html">ServiceGroupEntry</a>
+		</li>
+		</ul>
+		</li><br>
+		
+		
+		<li><b>WS-Notification v1.3 (WSN)</b>
+		<br><br>
+		<ul>
+		<li>
+		<a href="capabilities/wsn-nc.html">NotificationConsumer</a>
+		</li>
+		<li>
+		<a href="capabilities/wsn-np.html">NotificationProducer</a>
+		</li>
+		<li>
+		<a href="capabilities/wsn-pullpoint.html">PullPoint</a>
+		</li>
+		<li>
+		<a href="capabilities/wsn-pullpoint-c.html">PullPointCreation</a>
+		</li>
+		<li>
+		<a href="capabilities/wsn-sub.html">SubscriptionManager</a>
+		</li>
+		</ul>
+		</li><br>
+		
+		<li><b>WS-DistributedManagement v1.1 (WSDM)</b>
+		<br><br>
+		<ul>
+		<li>
+		<a href="capabilities/wsdm-abstract.html">The Abstract WSDM MUWS Capability</a>
+		</li>
+		<li>
+		<a href="capabilities/wsdm-adv.html">Advertisement</a>
+		</li>
+		<li>
+		<a href="capabilities/wsdm-config.html">Configuration</a>
+		</li>
+		<li>
+		<a href="capabilities/wsdm-cp.html">CorrelatableProperties</a>
+		</li>
+		<li>
+		<a href="capabilities/wsdm-desc.html">Description</a>
+		</li>
+		<li>
+		<a href="capabilities/wsdm-id.html">Identity</a>
+		</li>
+		<li>
+		<a href="capabilities/wsdm-mc.html">ManageabilityCharacteristics</a>
+		</li>
+		<li>
+		<a href="capabilities/wsdm-metrics.html">Metrics</a>
+		</li>
+		<li>
+		<a href="capabilities/wsdm-opstatus.html">OperationalStatus</a>
+		</li>
+		<li>
+		<a href="capabilities/wsdm-rel.html">Relationships</a>
+		</li>
+		<li>
+		<a href="capabilities/wsdm-relr.html">RelationshipResource</a>
+		</li>
+		<li>
+		<a href="capabilities/wsdm-state.html">State</a>
+		</li>
+		</ul>
+		</li><br>
+	</ul>
+	</p>
 </li>
-<li><a name="how-to"><strong>How to...</strong></a>
+<li><a name="how-to"></a><strong>How to...</strong>
 </li>
-<li><a name="troubleshooting"><strong>Troubleshooting</strong></a>
+<li><a name="troubleshooting"></a><strong>Troubleshooting</strong>
 </li>
 </ul>	
 </div>

Added: webservices/muse/site/docs/2.0.0/manual/platforms/index.html
URL: http://svn.apache.org/viewvc/webservices/muse/site/docs/2.0.0/manual/platforms/index.html?view=auto&rev=441835
==============================================================================
--- webservices/muse/site/docs/2.0.0/manual/platforms/index.html (added)
+++ webservices/muse/site/docs/2.0.0/manual/platforms/index.html Sat Sep  9 11:02:21 2006
@@ -0,0 +1,10 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<title>Apache Muse - Documentation</title>
+<meta http-equiv="refresh" content="0; url=../index.html#platforms">
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+</head>
+<body>
+</body>
+</html>
\ No newline at end of file



---------------------------------------------------------------------
To unsubscribe, e-mail: muse-commits-unsubscribe@ws.apache.org
For additional commands, e-mail: muse-commits-help@ws.apache.org