You are viewing a plain text version of this content. The canonical link for it is here.
Posted to pubscribe-commits@ws.apache.org by sc...@apache.org on 2005/08/05 15:44:13 UTC
svn commit: r230466 [2/5] - in /webservices/pubscribe/site: ./ dev_guide/
images/ skin/ skin/css/ skin/images/ skin/scripts/ tutorial/ tutorial/images/
Added: webservices/pubscribe/site/dev_guide/producer.html
URL: http://svn.apache.org/viewcvs/webservices/pubscribe/site/dev_guide/producer.html?rev=230466&view=auto
==============================================================================
--- webservices/pubscribe/site/dev_guide/producer.html (added)
+++ webservices/pubscribe/site/dev_guide/producer.html Fri Aug 5 06:43:47 2005
@@ -0,0 +1,294 @@
+<!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>Notification Producer</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/pubscribe/"><img class="logoImage" alt="Pubscribe" src="../images/pubscribe-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 WSDL</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 Class</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/mod_resource.html">Modify Resource Class</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/webapp.html">Deploy Service</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">WSRF/WSN 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="menupage">
+<div class="menupagetitle">Notification Producer</div>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/consumer.html">Notification Consumer</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/subscription.html">Subscription Manager</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>Notification Producer</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#intro">Introduction</a>
+</li>
+<li>
+<a href="#Adding+Topics">Adding Topics</a>
+<ul class="minitoc">
+<li>
+<a href="#Topics+for+All+Resource+Properties">Topics for All Resource Properties</a>
+</li>
+<li>
+<a href="#Topics+for+Specific+Resource+Properties">Topics for Specific Resource Properties</a>
+</li>
+<li>
+<a href="#Resource+Termination+Topic">Resource Termination Topic</a>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+
+<a name="N1000C"></a><a name="intro"></a>
+<h2 class="boxed">Introduction</h2>
+<div class="section">
+<p>This section provides instructions for adding notification topics for a resource. Each resource that is configured to be a notification producer (implements the WSN
+ <span class="codefrag">NotificationProducer</span> portType) is associated with a <span class="codefrag">TopicSet</span> object. The resource publishes notifications to a topic in the topic set.
+ Notification consumers can then subscribe to a topic and receive notifications from the resource. As the service developer of the notification producer resource, you are
+ responsible for adding the topics you want to support to the topic set. In addition, you must initialize all topics. This is done using Pubscribe APIs.
+ </p>
+</div>
+
+<a name="N1001C"></a><a name="Adding+Topics"></a>
+<h2 class="boxed">Adding Topics</h2>
+<div class="section">
+<p>Notification topics must be added to the <span class="codefrag">init()</span> method of your service's resource class. If you used the Wsdl2Java tool, the resource class
+ (<em>
+ <span class="codefrag">service_name</span>
+ </em>
+ <span class="codefrag">Resource.java</span>) is automatically generated, but will need to modified. The resource class is the stateful
+ instance-representation of your Web service. In addition to notification topics, the resource class maintains the resource <span class="codefrag">id</span> and the <span class="codefrag">
+ ResourcePropertySet</span>. The <span class="codefrag">ResourcePropertySet</span> is the Java representation of the Resource Properties document defined in the schema section of
+ your WSDL file.
+ </p>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">The notification producer portType resource properties (Topic, FixedTopicSet, TopicExpressionDialects) are initialized by default and do not have to be initalized here.</div>
+</div>
+<p>This section discusses how to add topics to a resource class for each resource property. Topics emit notifications if any resource property changes in any way. Initially, you
+ should model your resource off of the included FileSystemResource example to ensure that you write a valid resource class. When adding topics to the resource class, you can
+ select to add topics for all resource properties or you can add topics for specific resource properties. Each style is discussed below.
+ </p>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">This section does not include instructions for initializing resource properties and adding them to the <span class="codefrag">ResourcePropertySet</span>. See the
+ <a href="http://ws.apache.org/wsrf/dev_guide/resource.html">Resource Class</a> documentation included with Apache WSRF.</div>
+</div>
+<a name="N1004A"></a><a name="Topics+for+All+Resource+Properties"></a>
+<h3 class="boxed">Topics for All Resource Properties</h3>
+<p>The easiest way to add notification topics is to add topics for all resource properties that a WS resource exposes. In this case, the following method is added to the
+ resource class:
+ </p>
+<pre class="code">
+try
+ {
+ org.apache.ws.notification.topics.util.TopicUtils.addResourcePropertyValueChangeTopics( getResourcePropertySet(), getTopicSpaceSet() );
+ }
+</pre>
+<p>In the above example, a notification topic is added for all resource properties that have been added to <span class="codefrag">ResourcePropertySet</span>.
+ </p>
+<a name="N1005E"></a><a name="Topics+for+Specific+Resource+Properties"></a>
+<h3 class="boxed">Topics for Specific Resource Properties</h3>
+<p>Notification topics can be added for specific resource properties. This allows you to control which topics will be available to a notification consumer. In this case,
+ the following method can be used for each resource property for which you want to add a topic:
+ </p>
+<pre class="code">
+try
+ {
+ org.apache.ws.notification.topics.util.TopicUtils.addResourcePropertyValueChangeTopic( getResourcePropertySet().get( FilesystemPropertyQNames.FSCKPASSNUMBER ), getTopicSpaceSet() );
+ }</pre>
+<p>In the above example a topic is created specifically for the <span class="codefrag">FSCKPASSNUMBER</span> resource property.
+ </p>
+<a name="N10072"></a><a name="Resource+Termination+Topic"></a>
+<h3 class="boxed">Resource Termination Topic</h3>
+<p>The resource termination topic is used for notifications when a resource is terminated. The use of this topic is optional. To add this topic to the resource class, use
+ the following method:
+ </p>
+<pre class="code">
+org.apache.ws.notification.topics.util.TopicUtils.addResourceTerminationTopic( getTopicSpaceSet(), this, SPEC_NAMESPACE_SET );</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/pubscribe/site/dev_guide/subscription.html
URL: http://svn.apache.org/viewcvs/webservices/pubscribe/site/dev_guide/subscription.html?rev=230466&view=auto
==============================================================================
--- webservices/pubscribe/site/dev_guide/subscription.html (added)
+++ webservices/pubscribe/site/dev_guide/subscription.html Fri Aug 5 06:43:47 2005
@@ -0,0 +1,352 @@
+<!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 Subscription Manager</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/pubscribe/"><img class="logoImage" alt="Pubscribe" src="../images/pubscribe-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 WSDL</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 Class</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/mod_resource.html">Modify Resource Class</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/webapp.html">Deploy Service</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">WSRF/WSN 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/producer.html">Notification Producer</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/consumer.html">Notification Consumer</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">Subscription Manager</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 Subscription Manager</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#Introduction">Introduction</a>
+</li>
+<li>
+<a href="#Subscription+Manager+Messages">Subscription Manager Messages</a>
+<ul class="minitoc">
+<li>
+<a href="#PauseSubscription">PauseSubscription</a>
+</li>
+<li>
+<a href="#ResumeSubscription">ResumeSubscription</a>
+</li>
+<li>
+<a href="#Destroy">Destroy</a>
+</li>
+<li>
+<a href="#Getting+the+Subscription+Manager%27s+WSDL">Getting the Subscription Manager's WSDL</a>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+
+<a name="N1000C"></a><a name="Introduction"></a>
+<h2 class="boxed">Introduction</h2>
+<div class="section">
+<p>The WS-BaseNotification specification includes a portType called <span class="codefrag">SubscriptionManager</span>. The portType includes two operations
+ (<span class="codefrag">PauseSubscription</span> and <span class="codefrag"> ResumeSubscription</span>) and a set of resource properties: <span class="codefrag">ConsumerReference</span>,
+ <span class="codefrag">TopicExpression</span>, <span class="codefrag">UseNotify</span>, <span class="codefrag">Precondition</span>, <span class="codefrag">Selector</span>, <span class="codefrag">SubscriptionPolicy</span>, and
+ <span class="codefrag">CreationTime</span>. Pubscribe implements this portType and its required resource properties by default. Therefore, it does not have to be defined in a WSRF/WSN WSDL.
+ This insures that all the resource properties are initialized without having to directly interact with the subscription manager.
+ </p>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">In Pubscribe, a notification producer uses the subscription manager to create a subscription whenever a <span class="codefrag">Subscribe</span> message is received for a topic.</div>
+</div>
+</div>
+
+<a name="N1003A"></a><a name="Subscription+Manager+Messages"></a>
+<h2 class="boxed">Subscription Manager Messages</h2>
+<div class="section">
+<p>Messages to pause or resume a subscription are sent to the <span class="codefrag">SubscriptionManager</span> service. This service is deployed by default when you deploy the Pubscribe Web
+ application. The <span class="codefrag">SubscriptionManager</span> service can also be used to send <span class="codefrag">Destroy</span>, <span class="codefrag">SetTerminationTime</span>, and
+ <span class="codefrag">GetResourceProperty</span> messages. These operations are defined in the WSRF WS-ResourceLifetime and WS-ResourceProperties specifications respectively.
+ When you send messages to the subscription manager, the SOAP header must include the ResourceIdentifier obtained from the EPR of the subscription this value
+ is returned in the response message when you subscribe to a topic.
+ </p>
+<p>The below requests demonstrate the messages to pause, resume, and destroy a subscription and are taken from the filesystem example. In the header, notice the EPR that is entered in
+ the <span class="codefrag">wsa:To</span> element and the subscription identifier that is entered in the <span class="codefrag">sub:ResourceIdentifier</span> element.
+ </p>
+<a name="N1005B"></a><a name="PauseSubscription"></a>
+<h3 class="boxed">PauseSubscription</h3>
+<pre class="code">
+<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/"
+ xmlns:wsnt="http://docs.oasis-open.org/wsn/2004/06/wsn-WS-BaseNotification-1.2-draft-01.xsd"
+ xmlns:sub="http://ws.apache.org/notification/base/service/SubscriptionManager">
+
+ <Header xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/03/addressing">
+ <wsa:To mustUnderstand="1">http://localhost:8080/pubscribe/services/SubscriptionManager</wsa:To>
+ <wsa:Action mustUnderstand="1">http://localhost:8080/pubscribe/services/SubscriptionManager/yourWsdlRequestName</wsa:Action>
+ <sub:ResourceIdentifier mustUnderstand="1">4623a820-7483-11d9-9a53-fe396408008d</sub:ResourceIdentifier>
+ </Header>
+
+ <Body>
+ <wsnt:PauseSubscription />
+ </Body>
+
+</Envelope></pre>
+<a name="N10066"></a><a name="ResumeSubscription"></a>
+<h3 class="boxed">ResumeSubscription</h3>
+<pre class="code">
+<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/"
+ xmlns:wsnt="http://docs.oasis-open.org/wsn/2004/06/wsn-WS-BaseNotification-1.2-draft-01.xsd"
+ xmlns:sub="http://ws.apache.org/notification/base/service/SubscriptionManager">
+
+ <Header xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/03/addressing">
+ <wsa:To mustUnderstand="1">http://localhost:8080/pubscribe/services/SubscriptionManager</wsa:To>
+ <wsa:Action mustUnderstand="1">http://localhost:8080/pubscribe/services/SubscriptionManager/yourWsdlRequestName</wsa:Action>
+ <sub:ResourceIdentifier mustUnderstand="1">4623a820-7483-11d9-9a53-fe396408008d</sub:ResourceIdentifier>
+ </Header>
+
+ <Body>
+ <wsnt:ResumeSubscription />
+ </Body>
+
+</Envelope></pre>
+<a name="N10071"></a><a name="Destroy"></a>
+<h3 class="boxed">Destroy</h3>
+<p>The <span class="codefrag">SubscriptionManager</span> also includes the Destroy operation. This operation is defined in the WS-ResourceLifetime specifcation. The Destroy operation can be
+ used to destroy a subscription. Like pause and resume, you must provide the EPR and the subscription's <span class="codefrag">ResourceIdentifier</span>.</p>
+<pre class="code">
+<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/"
+ xmlns:wsnt="http://docs.oasis-open.org/wsn/2004/06/wsn-WS-BaseNotification-1.2-draft-01.xsd"
+ xmlns:wsrlw="http://docs.oasis-open.org/wsrf/2004/06/wsrf-WS-ResourceLifetime-1.2-draft-01.xsd"
+ xmlns:sub="http://ws.apache.org/notification/base/service/SubscriptionManager">
+
+ <Header xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/03/addressing">
+ <wsa:To mustUnderstand="1">http://localhost:8080/pubscribe/services/SubscriptionManager</wsa:To>
+ <wsa:Action mustUnderstand="1">http://localhost:8080/pubscribe/services/SubscriptionManager/yourWsdlRequestName</wsa:Action>
+ <sub:ResourceIdentifier mustUnderstand="1">6d8e2160-f89f-11d9-9c4c-9e6bfb2aa2bf</sub:ResourceIdentifier>
+ </Header>
+
+ <Body>
+ <wsrlw:Destroy />
+ </Body>
+
+</Envelope></pre>
+<a name="N10085"></a><a name="Getting+the+Subscription+Manager%27s+WSDL"></a>
+<h3 class="boxed">Getting the Subscription Manager's WSDL</h3>
+<p>The subscription manager publishes its WSDL as metadata using Pubscribe's implementation of the WS-Metadata Exchange specification. The following examples
+ demonstrate SOAP requests that can be used to retrieve the WSDL. For instructions on providing metadata about your service, see the
+ <a href="http://ws.apache.org/wsrf/dev_guide/metadata.html">Adding Service Metadata</a> section of the Apache
+ WSRF documentation. </p>
+<pre class="code">
+<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/"
+ xmlns:wsx="http://schemas.xmlsoap.org/ws/2004/09/mex"
+ xmlns:sub="http://ws.apache.org/notification/base/service/SubscriptionManager">
+
+ <Header xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/03/addressing">
+ <wsa:To mustUnderstand="1">http://localhost:8080/foobar</wsa:To>
+ <wsa:Action mustUnderstand="1">http://schemas.xmlsoap.org/ws/2004/09/mex/GetMetadata/Request</wsa:Action>
+ <sub:ResourceIdentifier mustUnderstand="1">52082a10-ff9f-11d9-b386-b35a385b29cd</sub:ResourceIdentifier>
+ </Header>
+
+ <Body>
+ <wsx:GetMetadata />
+ </Body>
+
+</Envelope></pre>
+<pre class="code">
+<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/"
+ xmlns:wsx="http://schemas.xmlsoap.org/ws/2004/09/mex"
+ xmlns:sub="http://ws.apache.org/notification/base/service/SubscriptionManager">
+
+ <Header xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/03/addressing">
+ <wsa:To mustUnderstand="1">http://localhost:8080/foobar</wsa:To>
+ <wsa:Action mustUnderstand="1">http://schemas.xmlsoap.org/ws/2004/09/mex/Get/Request</wsa:Action>
+ <sub:ResourceIdentifier mustUnderstand="1">52082a10-ff9f-11d9-b386-b35a385b29cd</sub:ResourceIdentifier>
+ </Header>
+
+ <Body>
+ <!-- no body needed. Action defines request for wsx -->
+ </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/pubscribe/site/dev_guide/wsdl.html
URL: http://svn.apache.org/viewcvs/webservices/pubscribe/site/dev_guide/wsdl.html?rev=230466&view=auto
==============================================================================
--- webservices/pubscribe/site/dev_guide/wsdl.html (added)
+++ webservices/pubscribe/site/dev_guide/wsdl.html Fri Aug 5 06:43:47 2005
@@ -0,0 +1,328 @@
+<!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>Composing a WSRF/WSN WSDL</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/pubscribe/"><img class="logoImage" alt="Pubscribe" src="../images/pubscribe-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 WSDL</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 Class</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/mod_resource.html">Modify Resource Class</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/webapp.html">Deploy Service</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="menupage">
+<div class="menupagetitle">WSRF/WSN WSDL</div>
+</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/producer.html">Notification Producer</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/consumer.html">Notification Consumer</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/subscription.html">Subscription Manager</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>Composing a WSRF/WSN WSDL</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#Using+the+WSRF%2FWSN+WSDL+Template">Using the WSRF/WSN WSDL Template</a>
+</li>
+<li>
+<a href="#Defining+the+WSRF%2FWSN+PortType">Defining the WSRF/WSN PortType</a>
+<ul class="minitoc">
+<li>
+<a href="#WS-BaseNotification+PortTypes">WS-BaseNotification PortTypes</a>
+</li>
+<li>
+<a href="#Metadata+Operations">Metadata Operations</a>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+
+<a name="N1000C"></a><a name="Using+the+WSRF%2FWSN+WSDL+Template"></a>
+<h2 class="boxed">Using the WSRF/WSN WSDL Template</h2>
+<div class="section">
+<p>Resources and notifications are exposed as WS-Resources using the Web Services Description Language (WSDL). The WSDL must
+ conform to the conventions as described in the <a href="http://ws.apache.org/wsrf/wsrf.html">WSRF</a> and <a href="../wsn.html">WSN</a> Specifications. To make it
+ easier to write a WSRF/WSN WSDL, Pubscribe provides a template WSDL that can be used as a starting point. The template saves a good deal of time
+ and is less error-prone than writing a WSRF/WSN-compliant WSDL from scratch.
+ </p>
+<p>To use the template:</p>
+<ol>
+
+<li>Using a text or XML editor, open <span class="codefrag">INSTALL_DIR/template/_TEMPLATE_.wsdl</span>.</li>
+
+<li>Save the file with a new name (e.g., <em>nameOfYourService</em>.wsdl).</li>
+
+<li>Modify your WSDL based on the instructions in the template and the information below.</li>
+
+</ol>
+<div class="frame warning">
+<div class="label">Warning</div>
+<div class="content">Do not modify the original template file.</div>
+</div>
+</div>
+
+<a name="N10036"></a><a name="Defining+the+WSRF%2FWSN+PortType"></a>
+<h2 class="boxed">Defining the WSRF/WSN PortType</h2>
+<div class="section">
+<p>A WSRF/WSN WSDL should contain only one portType. The portType aggregates operations from WSRF and WSN specification-defined portTypes
+ and custom resource-specific operations. If you copied the WSDL template file as described above, your WSDL file
+ already contains a WSRF/WSN-compliant portType. You simply have to rename the portType (<span class="codefrag">MyPortType</span>) and the binding (MySoapHttpBinding) and uncomment the
+ blocks corresponding to whichever optional portTypes you want your WS-Resource to support.
+ </p>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">The WSRF portTypes - WS-ResourceProperties (WSRF-RP) and WS-ResourceLifetime (WSRF-RL)- and their associated operations are described in the Apache WSRF
+ <a href="http://ws.apache.org/wsrf/dev_guide/wsrf_wsdl.html">WSDL Documentation</a>. The instructions include defining the resource properties document, custom properties, and custom
+ operations.</div>
+</div>
+<a name="N10049"></a><a name="WS-BaseNotification+PortTypes"></a>
+<h3 class="boxed">WS-BaseNotification PortTypes</h3>
+<p>The WS-BaseNotification specification defines three portTypes:</p>
+<ul>
+
+<li>NotificationProducer - This portType allows a resource to advertise notification topics and allows clients to subscribe to these topics. To implement this portType,
+ uncomment the three NotificationProducer property references (<span class="codefrag">wsnt:Topic</span>, <span class="codefrag">wsnt:FixedTopicSet</span>, and
+ <span class="codefrag">wsnt:TopicExpressionDialects</span>) within the types/schema section of the WSDL. Then, uncomment the two NotificationProducer
+ operations (<span class="codefrag">Subscribe</span> and <span class="codefrag">GetCurrentMessage</span>) within both the portType and binding sections. See <a href="../dev_guide/producer.html">Notification
+ Producer</a>.</li>
+
+<li>NotificationConsumer - This portType allows a resource to receive notification messages from a notification producer. To implement this portType, uncomment the
+ <span class="codefrag">Notify</span> operation. See <a href="../dev_guide/consumer.html">Notification Consumer</a>.</li>
+
+<li>SubscriptionManager - This portType defines message exchanges to manipulate (pause and resume) Subscription resources. An implementation of this portType is
+ included in Pubscribe as a separate service and therefore does not have to be included in the WSRF/WSN WSDL for a resource. For more information on the Subscription
+ Manager service, see <a href="../dev_guide/subscription.html">Using the Subscription Manager</a>.</li>
+
+</ul>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">Typically, a resource will be either be a Consumer or a Producer. However, you can implement both in a single resource.</div>
+</div>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+
+<tr>
+
+<th colspan="1" rowspan="1">PortType</th>
+ <th colspan="1" rowspan="1">Operations</th>
+ <th colspan="1" rowspan="1">Properties</th>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">NotificationProducer</td>
+ <td colspan="1" rowspan="1">Subscribe, GetCurrentMessage</td>
+ <td colspan="1" rowspan="1">Topic, FixedTopicSet, TopicExpressionDialects</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">NotificationConsumer</td>
+ <td colspan="1" rowspan="1">Notify</td>
+ <td colspan="1" rowspan="1"></td>
+
+</tr>
+
+</table>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">In addition to operations, the <span class="codefrag">NotificationProducer</span> portType also includes three properties. If a
+ WS-Resource implements this portType, it must also expose these properties.</div>
+</div>
+<p>The PortType element must have a
+ <span class="codefrag">{http://docs.oasis-open.org/wsrf/2004/11/wsrf-WS-ResourceProperties-1.2-draft-05.xsd}ResourceProperties</span>
+ attribute whose value is the <span class="codefrag">QName</span> of the resource properties document element defined in the types/schema section of the WSDL file.
+ </p>
+<a name="N100C7"></a><a name="Metadata+Operations"></a>
+<h3 class="boxed">Metadata Operations</h3>
+<p>The template contains two operations that are not defined by the WSRF or WSN specification that can be used in your service to retrieve metadata
+ about your services. The operations and messages are defined in the
+ <a class="external" href="http://msdn.microsoft.com/library/en-us/dnglobspec/html/ws-metadataexchange.pdf">WS-Metadata Exchange</a> specification defined by Microsoft and other industry
+ contributors. For instructions on providing metadata about your service, see the <a href="http://ws.apache.org/wsrf/dev_guide/metadata.html">Adding Service Metadata</a> section of the Apache
+ WSRF documentation.</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/pubscribe/site/dev_guide/wsdl_tool.html
URL: http://svn.apache.org/viewcvs/webservices/pubscribe/site/dev_guide/wsdl_tool.html?rev=230466&view=auto
==============================================================================
--- webservices/pubscribe/site/dev_guide/wsdl_tool.html (added)
+++ webservices/pubscribe/site/dev_guide/wsdl_tool.html Fri Aug 5 06:43:47 2005
@@ -0,0 +1,402 @@
+<!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 Wsdl2Java</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/pubscribe/"><img class="logoImage" alt="Pubscribe" src="../images/pubscribe-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 WSDL</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 Class</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/mod_resource.html">Modify Resource Class</a>
+</div>
+<div class="menuitem">
+<a title="" href="../tutorial/webapp.html">Deploy Service</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">WSRF/WSN WSDL</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">Using Wsdl2Java</div>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/home.html">Home Class</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/producer.html">Notification Producer</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/consumer.html">Notification Consumer</a>
+</div>
+<div class="menuitem">
+<a title="" href="../dev_guide/subscription.html">Subscription Manager</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>Using Wsdl2Java</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#Introduction">Introduction</a>
+</li>
+<li>
+<a href="#Ant+Task">Ant Task</a>
+</li>
+</ul>
+</div>
+
+<a name="N1000C"></a><a name="Introduction"></a>
+<h2 class="boxed">Introduction</h2>
+<div class="section">
+<p>The Wsdl2Java tool is used to generate a set of artificats for a WSRF/WSN WS Resource. The artifiacts include:</p>
+<ul>
+
+<li>A set of Java classes based on the WSDL definition. This includes a service, resource, and
+ home class. Some of the Java code will need to be manually edited after the files are generated.</li>
+
+<li>Interfaces for custom operations.</li>
+
+<li>Java bindings for all Types that are defined in the WSDL. The interfaces and classes are
+ created using the <a class="external" href="http://xmlbeans.apache.org/">XMLBeans</a> schema compiler</li>
+
+<li>An Axis Web Service Deployment Descriptor (WSDD) for your service (<em>service</em>_deploy.wsdd). This file is used to deploy your service to
+ Axis.</li>
+
+<li>A JNDI Resource configuration file for your service (<em>service</em>_jndi-config.xml). The file is used to setup the in-memory JNDI context for
+ your generated service, resource, and home classes.</li>
+
+</ul>
+<p>The tool saves you a great deal of time, since these files do not have to be created from scratch. You simply pass the tool a WSRF/WSN WSDL and the files
+ are automatically generated. You can use the tool directly or you can use an Ant task.
+ </p>
+</div>
+
+<a name="N10035"></a><a name="Ant+Task"></a>
+<h2 class="boxed">Ant Task</h2>
+<div class="section">
+<p>The Wsdl2Java tool can be invoked using the <span class="codefrag">wsdl2Java</span> Ant task (<span class="codefrag">org.apache.ws.notification.tool.WsnWsdl2JavaTask</span>) which extends the
+ Apache WSRF Ant task (<span class="codefrag">org.apache.ws.resource.tool.Wsdl2JavaTask</span>). The
+ <span class="codefrag">INSTALL_DIR/template/build.xml</span> script contains a target that already implements this task.</p>
+<p>To use the target:</p>
+<ol>
+
+<li>Copy INSTALL_DIR/template/build.xml and build.properties to any directory. This directory will be referred to as <span class="codefrag">WORK_DIR</span>.</li>
+
+<li>Using a text editor, open <span class="codefrag">WORK_DIR/build.properties</span>.</li>
+
+<li>Uncomment the <span class="codefrag">pubscribe.webapp.dir</span> property and set it to the location where the Pubscribe Web application is installed. If you are using
+ Tomcat and have the <span class="codefrag">CATALINA_HOME</span> environment variable set, you do not need to modify this property.</li>
+
+<li>Uncomment and modify the proxy settings if you require a proxy to connect to external Web sites.</li>
+
+<li>Copy your WSRF/WSN WSDL to <span class="codefrag">WORK_DIR</span>. If your WSDL depends on a schema that is not accessible over the network, you must copy the
+ schema to this directory as well.</li>
+
+<li>From a command prompt, change directories to <span class="codefrag">WORK_DIR</span>.</li>
+
+<li>Run the following command.
+ <pre class="code">ant generate</pre>
+
+<p>Check <span class="codefrag">WORK_DIR/generated</span> to see the generated files.
+ </p>
+
+</li>
+
+</ol>
+<a name="N10081"></a><a name="Task+Definition"></a>
+<h3 class="boxed">Task Definition</h3>
+<p>The task is defined as follows :</p>
+<pre class="code">
+<taskdef name="wsdl2Java"
+ classname="org.apache.ws.notification.tool.WsnWsdl2JavaTask"
+ classpath="path/to/pubscribe.jar" /> </pre>
+<p>
+
+<strong>Parameters</strong>
+
+</p>
+<p>The task takes the following parameters:</p>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+
+<tr>
+
+<th colspan="1" rowspan="1">Attribute</th>
+ <th colspan="1" rowspan="1">Description</th>
+ <th colspan="1" rowspan="1">Required</th>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">wsdl</td>
+ <td colspan="1" rowspan="1">Enter the full path to a WSRF WSDL file.</td>
+ <td colspan="1" rowspan="1">Yes, unless a <span class="codefrag">wsdls</span> parameter is used. </td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">wsdls</td>
+ <td colspan="1" rowspan="1">Entered as a nested element following the rules of fileset. This parameter is used instead of the <span class="codefrag">wsdl</span> parameter to indicate multiple
+ WSRF WSDLs to be converted.</td>
+ <td colspan="1" rowspan="1">No</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">classpath</td>
+ <td colspan="1" rowspan="1">The classpath to be passed to the XMLBeans schema compiler. The classpath should reference all the jars in the
+ <span class="codefrag">INSTALL_DIR/wsrf/webapp/lib</span> and <span class="codefrag">/classes</span> directories.</td>
+ <td colspan="1" rowspan="1">Yes</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">classpathref</td>
+ <td colspan="1" rowspan="1">Adds a classpath, given as reference to a path defined elsewhere.</td>
+ <td colspan="1" rowspan="1">No</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">outputdir</td>
+ <td colspan="1" rowspan="1">Enter a directory where the generated files will be placed.</td>
+ <td colspan="1" rowspan="1">Yes</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">verbose</td>
+ <td colspan="1" rowspan="1">Enter <span class="codefrag">true</span> to increase build message output.</td>
+ <td colspan="1" rowspan="1">No, default is <span class="codefrag">false</span>
+ </td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">proxyHost</td>
+ <td colspan="1" rowspan="1">Enter the Host IP address of a proxy that is used to connect to the Internet.</td>
+ <td colspan="1" rowspan="1">No</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">proxyPort</td>
+ <td colspan="1" rowspan="1">Enter the Port number of a proxy that is used to connect to the Internet.</td>
+ <td colspan="1" rowspan="1">No</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">nonProxyHosts</td>
+ <td colspan="1" rowspan="1">Enter the Host IP address separated by "|" to indicate Hosts that do not require a proxy.</td>
+ <td colspan="1" rowspan="1">No</td>
+
+</tr>
+
+</table>
+<p>
+
+<strong>Example</strong>
+
+</p>
+<p>The following example generates files for a single WSDL and places the generated files in a directory
+ named <span class="codefrag">/generated</span>. To simplify the example, the classpath is referenced. You must set the <span class="codefrag">${pubscribe.home}</span> Ant property to <span class="codefrag">
+ INSTALL_DIR</span> (e.g. /opt/pubscribe-1.0beta).</p>
+<pre class="code">
+
+ <property name="pubscribe.webapp.dir" location="${pubscribe.home}/webapps/pubscribe" />
+ <path id="pubscribe.classpath.id">
+ <pathelement location="${pubscribe.webapp.dir}/WEB-INF/classes" />
+ <fileset dir="${pubscribe.webapp.dir}/WEB-INF/lib" includes="*.jar" />
+ </path>
+
+ <taskdef name="wsdl2Java" classname="org.apache.ws.notification.tool.WsnWsdl2JavaTask" classpath="pubscribe.classpath.id" />
+
+ <wsdl2Java wsdl="path/to/your.wsdl"
+ outputdir="generated"
+ classpath="pubscribe.classpath.id" /></pre>
+<p>If you want to generate the files for multiple WSDLs, you can use:</p>
+<pre class="code">
+
+ <wsdl2Java outputdir="generated" classpath="pubscribe.classpath.id" />
+ <wsdls dir="path/to/wsdls/">
+ <include name="**/*.wsdl" />
+ </wsdls>
+ </wsdl2Java></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/pubscribe/site/getting_started.html
URL: http://svn.apache.org/viewcvs/webservices/pubscribe/site/getting_started.html?rev=230466&view=auto
==============================================================================
--- webservices/pubscribe/site/getting_started.html (added)
+++ webservices/pubscribe/site/getting_started.html Fri Aug 5 06:43:47 2005
@@ -0,0 +1,394 @@
+<!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>Getting Started with Apache Pubscribe</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/pubscribe/"><img class="logoImage" alt="Pubscribe" src="images/pubscribe-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_selected_1.1', 'skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('skin/images/chapter_open.gif');">Getting Started</div>
+<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
+<div class="menupage">
+<div class="menupagetitle">Introduction</div>
+</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 WSDL</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 Class</a>
+</div>
+<div class="menuitem">
+<a title="" href="tutorial/mod_resource.html">Modify Resource Class</a>
+</div>
+<div class="menuitem">
+<a title="" href="tutorial/webapp.html">Deploy Service</a>
+</div>
+<div class="menuitem">
+<a title="" href="tutorial/test.html">Test</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.3', 'skin/')" id="menu_1.3Title" class="menutitle">Developer Guide</div>
+<div id="menu_1.3" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="dev_guide/index.html">Overview</a>
+</div>
+<div class="menuitem">
+<a title="" href="dev_guide/wsdl.html">WSRF/WSN 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/producer.html">Notification Producer</a>
+</div>
+<div class="menuitem">
+<a title="" href="dev_guide/consumer.html">Notification Consumer</a>
+</div>
+<div class="menuitem">
+<a title="" href="dev_guide/subscription.html">Subscription Manager</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>Getting Started with Apache Pubscribe</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#Introduction">Introduction</a>
+</li>
+<li>
+<a href="#install">Installation</a>
+</li>
+<li>
+<a href="#qd">Quick Demonstration</a>
+</li>
+</ul>
+</div>
+
+<a name="N1000C"></a><a name="Introduction"></a>
+<h2 class="boxed">Introduction</h2>
+<div class="section">
+<p>The topics in this section detail how to install Apache Pubscribe and use the quick demonstration to verify the installation as well
+ as exercise some of the features that are included in the release. It is suggested that you complete these sections before starting any
+ development work. Once you get a good feel for the example in the demonstration, you can recreate it by completing the
+ <a href="tutorial/index.html">tutorial</a>.
+ </p>
+<p>The tutorial takes a step-by-step approach to learning Apache Pubscribe. It highlights the most common procedures that are used to implement
+ Web Services Notification (WSN). The tutorial also includes steps for deploying Apache Pubscribe.
+ </p>
+<p>Lastly, refer to the <a href="dev_guide/index.html">Developer Guide</a> for basic and advanced tasks as well as general information about Apache
+ Pubscribe. Much of the information that is covered in the demonstration and the tutorial is discussed in more detail in the Developer Guide. </p>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">Pubscribe is tightly integrated with <a href="http://ws.apache.org/wsrf/">Apache WSRF</a> as its WSRF foundation. While it is not required, it is a good idea to start with Apache WSRF.
+ You should also consult the Apache WSRF documentation while completing the instructions in this documentation. All of the tasks required in Apache WSRF are also applicable
+ in Pubscribe.
+ </div>
+</div>
+</div>
+
+<a name="N1002B"></a><a name="install"></a>
+<h2 class="boxed">Installation</h2>
+<div class="section">
+<p> Apache Pubscribe is packaged as a Web application. In particular, it is an Apache Axis-based Web application with
+ additional functionality that is required to implement the WSN family of specifications. Since WSN builds on WSRF, the Web application also includes
+ Apache WSRF.
+ </p>
+<p>To run and install Apache Pubscribe, you must first:</p>
+<ul>
+
+<li>install Apache Tomcat or a similar Web container. The documentation assumes Tomcat and refers to the Tomcat
+ home directory (e.g., <span class="codefrag">c:\jakarta-tomcat-4.1.30</span>) as <span class="codefrag">TOMCAT_HOME</span>. In addition, it is assumed that Tomcat
+ is configured to listen at the default HTTP port (8080).</li>
+
+<li>install Apache Ant 1.6.X and include its <span class="codefrag">bin</span> directory in the <span class="codefrag">PATH</span> environment variable. Set an
+ ANT_HOME environment variable to the Ant installation directory.</li>
+
+</ul>
+<p>To install Apache Pubscribe:</p>
+<ol>
+
+<li>Download the Apache Pubscribe <a href="release.html">binary distribution</a>.</li>
+
+<li>Unzip the distribution to a location on your computer. This location is referred to as <span class="codefrag">INSTALL_DIR</span>.</li>
+
+<li>From <span class="codefrag">INSTALL_DIR</span>, copy the <span class="codefrag">webapps/pubscribe</span> directory to <span class="codefrag">TOMCAT_HOME/webapps</span>.</li>
+
+<li>Start Tomcat.</li>
+
+<li>Using a browser, go to <a class="external" href="http://localhost:8080/pubscribe">http://localhost:8080/pubscribe</a>. The Apache Pubscribe welcome page
+ displays.</li>
+
+<li>Click <a class="external" href="http://localhost:8080/pubscribe/services">View</a>. The list of
+ deployed Web services displays. Three services are deployed: <span class="codefrag">SubscriptionManager</span>,
+ <span class="codefrag">AdminService</span>, and <span class="codefrag">Version</span>. The <span class="codefrag">AdminService</span> and <span class="codefrag">Version</span> services are default
+ Apache-Axis services. The <span class="codefrag">SubscriptionManager</span> is used to pause, resume, destroy, or update subscriptions.</li>
+
+<li>Click on the respective WSDL links to view and ensure that the WSDL for the services are published.</li>
+
+</ol>
+</div>
+
+<a name="N10092"></a><a name="qd"></a>
+<h2 class="boxed">Quick Demonstration</h2>
+<div class="section">
+<p>The Quick Demonstration shows some of the features and implementation details of Apache Pubscribe. The demo uses an example that is
+ included in the distribution. The example represents a UNIX file system resource whose management capabilities are exposed as a WSRF-compliant Web service
+ and includes a notification producer used to subscribe to events.
+ </p>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">The <a href="tutorial/index.html">tutorial</a> provides a step-by-step approach for implementing notifications for WSRF-based resources. In essence, the
+ tutorial builds and deploys the example that is used in this demo.</div>
+</div>
+<p>Complete the following steps:
+ </p>
+<ol>
+
+<li>Using a text editor, open <span class="codefrag">INSTALL_DIR/examples/filesystem/build.properties</span>.</li>
+
+<li>Change the <span class="codefrag">pubscribe.webapp.dir</span> property and set it to the location where the Pubscribe 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>Open a command prompt and change directories to <span class="codefrag">INSTALL_DIR/examples/filesystem</span>.</li>
+
+<li>Run the following command:
+ <p>
+
+<span class="codefrag">ant compile deploy</span>
+
+</p>
+
+</li>
+
+<li>Start Tomcat. If Tomcat is already started, you must restart it.</li>
+
+<li>Using a browser, go to <a class="external" href="http://localhost:8080/pubscribe/services">
+ http://localhost:8080/pubscribe/services</a> and verify that the filesystem service is deployed.
+ </li>
+
+<li>From a command prompt change directories to <span class="codefrag">INSTALL_DIR/examples/filesystem</span> directory. An ANT-based SOAP client that is included in
+ the distribution is used to send a SOAP request to the filesystem Web service.</li>
+
+<li>
+
+<strong>Subscribe to a Notification Topic: </strong>
+
+<br>
+
+<p>In this step, a request is sent to subscribe to the notification topic for the <span class="codefrag">MountPointDirectory</span> resource property of the UNIX file
+ system resource. </p>
+
+<pre class="code">
+ ant -f soapclient.xml -Durl=http://localhost:8080/pubscribe/services/filesystem -Dxml=requests/Subscribe_updateMountPointProp.soap</pre>
+
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">To complete step 13 later in this demonstration, you must copy the <span class="codefrag">ResourceIdentifier</span> value that is returned in the SOAP body of
+ the response for this request. This is the look up key for the subscription.
+ </div>
+</div>
+
+<br>
+
+</li>
+
+<li>
+
+<strong>Cause an Event:</strong>
+
+<br>
+
+<p>In this step, the <span class="codefrag">MountPointDirectory</span> resource property is changed. This will cause a notification to be published.</p>
+
+<pre class="code">
+ ant -f soapclient.xml -Durl=http://localhost:8080/pubscribe/services/filesystem -Dxml=requests/SetResourceProperties_updateMountPointProp.soap</pre>
+
+</li>
+
+<li>
+
+<strong>View Notification: </strong>
+
+<br>
+
+<p>In this step, we will retrieve the notification that was published when the <span class="codefrag">MountPointDirectory</span> resource property was changed in
+ the previous step.</p>
+
+<pre class="code">
+ ant -f soapclient.xml -Durl=http://localhost:8080/pubscribe/services/filesystem -Dxml=requests/GetCurrentMessage.soap</pre>
+
+</li>
+
+<li>
+
+<strong>Destroy Subscription:</strong>
+
+<br>
+
+<p>In this step, a request is sent to destroy the notification topic subscription. Before completing this step, open the
+ <span class="codefrag">requests/Destroy_Subscription.soap</span> file and update the <span class="codefrag">sub:ResourceIdentifier</span> element with the value that was copied
+ in step 10. Save and close the file.</p>
+
+<pre class="code">
+ ant -f soapclient.xml -Durl=http://localhost:8080/pubscribe/services/SubscriptionManager -Dxml=requests/Destroy_Subscription.soap</pre>
+
+</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/pubscribe/site/images/apache.ico
URL: http://svn.apache.org/viewcvs/webservices/pubscribe/site/images/apache.ico?rev=230466&view=auto
==============================================================================
Binary file - no diff available.
Propchange: webservices/pubscribe/site/images/apache.ico
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: webservices/pubscribe/site/images/built-with-forrest-button.png
URL: http://svn.apache.org/viewcvs/webservices/pubscribe/site/images/built-with-forrest-button.png?rev=230466&view=auto
==============================================================================
Binary file - no diff available.
Propchange: webservices/pubscribe/site/images/built-with-forrest-button.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: webservices/pubscribe/site/images/pubscribe-logo.gif
URL: http://svn.apache.org/viewcvs/webservices/pubscribe/site/images/pubscribe-logo.gif?rev=230466&view=auto
==============================================================================
Binary file - no diff available.
Propchange: webservices/pubscribe/site/images/pubscribe-logo.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: webservices/pubscribe/site/images/ws-logo.gif
URL: http://svn.apache.org/viewcvs/webservices/pubscribe/site/images/ws-logo.gif?rev=230466&view=auto
==============================================================================
Binary file - no diff available.
Propchange: webservices/pubscribe/site/images/ws-logo.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: webservices/pubscribe/site/index.html
URL: http://svn.apache.org/viewcvs/webservices/pubscribe/site/index.html?rev=230466&view=auto
==============================================================================
--- webservices/pubscribe/site/index.html (added)
+++ webservices/pubscribe/site/index.html Fri Aug 5 06:43:47 2005
@@ -0,0 +1,242 @@
+<!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 WebServices - Pubscribe</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/pubscribe/"><img class="logoImage" alt="Pubscribe" src="images/pubscribe-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="menupage">
+<div class="menupagetitle">Overview</div>
+</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="menuitem">
+<a title="" href="contact_info.html">Contact Info</a>
+</div>
+<div class="menuitem">
+<a title="" href="release_notes.html">Release Notes</a>
+</div>
+<div class="menuitem">
+<a title="" href="wsn.html">WSN 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">
+<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>Apache WebServices - Pubscribe</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#Overview">Overview</a>
+</li>
+<li>
+<a href="#Features">Features</a>
+</li>
+<li>
+<a href="#News">News</a>
+</li>
+<li>
+<a href="#History">History</a>
+</li>
+</ul>
+</div>
+
+<a name="N1000C"></a><a name="Overview"></a>
+<h2 class="boxed">Overview</h2>
+<div class="section">
+<p>Pubscribe is a robust Java implementation of the <a href="wsn.html">Web Services Notification (WSN)</a> family of specifications.
+ </p>
+<p>WSN defines a set of specifications that standardize the way Web services can interact using the Notification pattern, which defines a way for consumers
+ to subscribe to a producer for notifications whenever a particular event occurs.
+ </p>
+<p>WSN builds upon the WS-ResourceFramework (WSRF) family of specifications. Pubscribe leverages the <a href="http://ws.apache.org/wsrf/">WSRF</a> project as its
+ implementation of the WSRF foundation.
+ </p>
+</div>
+
+<a name="N10024"></a><a name="Features"></a>
+<h2 class="boxed">Features</h2>
+<div class="section">
+<p>This release provides the following features:</p>
+<ul>
+
+<li>An Apache WSRF handler/service framework and WS-RP/WS-RL/WS-MeX portType impls</li>
+
+<li>A WSDL to Java generator that will generate the classes and configuration entries from a WSRF/WSN WSDL that are required to deploy it as a service to
+ the Apache WSRF framework</li>
+
+<li>Full implementations of all portTypes defined by the WS-BaseNotification specification</li>
+
+<li>Full implementations of all portTypes defined by the WS-Eventing specification</li>
+
+<li>Evaluators for all three topic expression dialects defined by the WS-Topics specification</li>
+
+<li>Generic Publish/Subscribe APIs that hide the details of the underlying notification mechanism (WSN or WSE) being used</li>
+
+<li>And more...</li>
+
+</ul>
+<p>Any feedback is welcomed and can be sent to our <a href="contact_info.html">mailing list</a>.
+ </p>
+</div>
+
+<a name="N1004D"></a><a name="News"></a>
+<h2 class="boxed">News</h2>
+<div class="section">
+<ul>
+
+<li>(August 5, 2005) <a href="http://ws.apache.org/pubscribe/release.html">Pubscribe 1.0</a> is now available!</li>
+
+<li>(June 3, 2005) Pubscribe has graduated from incubation and is now an official Apache project!</li>
+
+<li>(May 25, 2005) <a href="http://ws.apache.org/pubscribe/release.html">Pubscribe 1.0 Beta</a> is now available!</li>
+
+</ul>
+</div>
+
+<a name="N10068"></a><a name="History"></a>
+<h2 class="boxed">History</h2>
+<div class="section">
+<p>Much of the code in Pubscribe is based on code from the GTK4 WSRF/WSN implementation that was donated by the Globus Consortium. This code was
+ refactored to make extensive use of Apache XMLBeans to add improved runtime schema type validation and to enable portability to SOAP engines other than Axis.
+ The original GTK4 WSRF/WSN code is checked in to SVN <a class="external" href="http://svn.apache.org/viewcvs.cgi/incubator/apollo/globus/">here</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>
+<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>
Added: webservices/pubscribe/site/issue_tracking.html
URL: http://svn.apache.org/viewcvs/webservices/pubscribe/site/issue_tracking.html?rev=230466&view=auto
==============================================================================
--- webservices/pubscribe/site/issue_tracking.html (added)
+++ webservices/pubscribe/site/issue_tracking.html Fri Aug 5 06:43:47 2005
@@ -0,0 +1,166 @@
+<!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>Pubscribe Issue Tracking</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/pubscribe/"><img class="logoImage" alt="Pubscribe" src="images/pubscribe-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="menupage">
+<div class="menupagetitle">Issue Tracking</div>
+</div>
+<div class="menuitem">
+<a title="" href="contact_info.html">Contact Info</a>
+</div>
+<div class="menuitem">
+<a title="" href="release_notes.html">Release Notes</a>
+</div>
+<div class="menuitem">
+<a title="" href="wsn.html">WSN 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>Pubscribe Issue Tracking</h1>
+
+<p>
+ Pubscribe issues (bugs, as well as enhancement requests) are tracked in
+ Apache JIRA <a class="external" href="http://issues.apache.org/jira/browse/HERMES">here</a>.
+ If you aren't sure whether something is a bug, post a question on the
+ <a href="contact_info.html">mailing list</a>.
+ </p>
+
+</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>