Author: jruzzi
Date: Mon Aug 1 14:10:03 2005
New Revision: 226884
URL: http://svn.apache.org/viewcvs?rev=226884&view=rev
Log:
updated content
Modified:
webservices/muse/trunk/src/ReadMe.txt
webservices/muse/trunk/src/site/content/xdocs/dev_guide/home.xml
webservices/muse/trunk/src/site/content/xdocs/release_notes.xml
Modified: webservices/muse/trunk/src/ReadMe.txt
URL:
http://svn.apache.org/viewcvs/webservices/muse/trunk/src/ReadMe.txt?rev=226884&r1=226883&r2=226884&view=diff
==============================================================================
--- webservices/muse/trunk/src/ReadMe.txt (original)
+++ webservices/muse/trunk/src/ReadMe.txt Mon Aug 1 14:10:03 2005
@@ -14,11 +14,6 @@
/examples/filesystem - used in the documentation Quick Demonstration and
Tutorial. It demonstrates managing resources using WSDM.
-/examples/ieeedemo - used in the IBM/HP IEEE ICAC demonstration.
-
-/examples/interop - used for an interoperability session conducted
-by the WSDM OASIS working group.
-
**************************************************************************
/template
Modified: webservices/muse/trunk/src/site/content/xdocs/dev_guide/home.xml
URL:
http://svn.apache.org/viewcvs/webservices/muse/trunk/src/site/content/xdocs/dev_guide/home.xml?rev=226884&r1=226883&r2=226884&view=diff
==============================================================================
--- webservices/muse/trunk/src/site/content/xdocs/dev_guide/home.xml (original)
+++ webservices/muse/trunk/src/site/content/xdocs/dev_guide/home.xml Mon Aug 1
14:10:03 2005
@@ -27,6 +27,8 @@
<source>public class FileSystemHome
extends AbstractResourceHome
implements Serializable</source>
+ <note>Many of the operations in the
<code>AbstractResourceHome</code> may be overridden in your Home
+ class, if you have a need to extend its
functionality.</note>
</section>
<section id="ops">
<title>Operations</title>
@@ -39,8 +41,15 @@
add( createInstance( LVOL1_ID ) );
add( createInstance( LVOL2_ID ) );
}</source>
- <note>Many of the operations in the
<code>AbstractResourceHome</code> may be overridden in your Home
- class, if you have a need to extend its
functionality.</note>
+ <p>The <code>createInstance()</code> method:</p>
+ <ul>
+ <li>Creates an instance of the resource.</li>
+ <li>Sets an endpoint reference on the
resource.</li>
+ <li>Calls <code>init()</code> on the
resource.</li>
+ </ul>
+ <note>If you choose to not use the
<code>createInstance()</code> method (e.g. if you have a non-empty
constructor), then you must manually set the EPR then call
+ the <code>init()</code> method on the resource. The
generated home class contains a utility method from the
<code>AbstractResourceHome</code> that can be used
+ to build an EPR.</note>
</section>
</body>
</document>
Modified: webservices/muse/trunk/src/site/content/xdocs/release_notes.xml
URL:
http://svn.apache.org/viewcvs/webservices/muse/trunk/src/site/content/xdocs/release_notes.xml?rev=226884&r1=226883&r2=226884&view=diff
==============================================================================
--- webservices/muse/trunk/src/site/content/xdocs/release_notes.xml (original)
+++ webservices/muse/trunk/src/site/content/xdocs/release_notes.xml Mon Aug 1
14:10:03 2005
@@ -2,22 +2,52 @@
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN"
"http://forrest.apache.org/dtd/document-v20.dtd";>
<document>
<header>
- <title>Muse Release Notes</title>
+ <title>Apache MUSE Release Notes</title>
</header>
<body>
- <section>
+ <note>If you have any services created prior to this release,
it is strongly suggested that you regenerate the services (including
XmlBeans-generated types) to a
+ clean directory and manually port any added code to the newly
generated files. This will avoid any problems associated with the changes in
this release.</note>
+ <section>
<title>Change History</title>
+
<p>Changes since the 1.0 Beta release:</p>
<ul>
- <li>New and improved documentation including a
Getting Started section and Developer Guide.</li>
- <li>Updated Tutorial.</li>
+ <li>Removed the <code>getInstance(..)</code>
method from the generated Home classes. The init() method should be used for
initializing Resources at startup.
+ See method call/comment in the generated
<code>...Home.java</code> file.</li>
+ <li>Added the generation of an Abstract...Home
class which maintains the static Resource map specific to a Home. This was
necessary to ensure each Home type
+ maintains its cache across all instances.</li>
+ <li>Added
<code>getNamespaceVersionHolder</code> method to the generated Home class. This
returns the previously generated member variable.</li>
+ <li>Removed the<code> ResourceKey</code>
interface. The <code>AbstractResourceHome.find(..)</code> method now takes an
Object so that simple types
+ like Strings may easily be used for
lookups.</li>
+ <li>Changed the behavior of the<code>
AbstractResourceHome.add(..)</code> and
<code>AbstractResourceHome.createInstance(..)</code> method to determine
+ if a Resource's EndpointReference (EPR) has
been set, if it is <code>null</code> the EPR is generated and set on the
Resource instance. This allows the
+ implementor the opportunity to set the EPR
themselves in the <code>Home.init(..)</code> method or let the
<code>createInstance/add(..)</code> methods do it for
+ them.</li>
+ <li>Added extra parameter to the
<code>jndi-config.xml</code> file called <code>baseWebAppUrl</code> which by
default is generated with the value of
+ <code>http://$IP_ADDRESS$:8080/muse</code> (or
wsrf or pubscribe). The parameter is used at runtime for building EPR's for a
Resource. This URL may be
+ modified to explicitly set a static IP address
or host name, else you may replace <code>$IP_ADDRESS$</code> with
<code>$HOST_NAME$</code> in which case
+ the host name will be determined at
runtime.</li>
+ <li>Changed the <code>jndi-config.xml
resourceKeyName</code> parameter name to
<code>resourceIdentifierReferenceParameterName</code> for better
+ clarity.</li>
+ <li>Updated the schema for the
<code>jndi-config.xml</code> for the metadata elements to make them more
consistent.</li>
+ <li>Regenerated all XmlBeans-generated
artifacts for the XmlBeans 2.0 release. This was necessary due to changes in
their generated artifacts. <strong>Please
+ regenerate any of your own XmlBeans-generated
types</strong>.</li>
+ <li>Add Documentation: Enhanced Javadocs,
Installation, Quick Demo, Tutorial, and Developers Guide.</li>
+ <li>Added a <code>ServletContextListener</code>
implementation for initializing JNDI at startup. The original method of
initializing JNDI was via an extension to
+ <code>AxisServlet</code> which is now
unnecessary.</li>
+ <li>Removed the
<code>TopicUtils.initNotificationProducerProperties()</code> method and its
generated method call from Resources which implement the
+ <code>NotificationProducer</code> portType.
The resource properties: <code>Topic</code>, <code>FixedTopicSet</code>,
+ <code>TopicExpressionDialects</code> are now
handled via a callback object which is registered in the generated
<code>Abstract...Resource.init()</code>
+ method. This allows for the properties to be
more dynamic as the implementor adds and removes Topics.</li>
</ul>
+ <p/>
</section>
<section>
<title>Known Issues</title>
- <ul>
- <li>TODO</li>
- </ul>
+ <p>There are currently no issues reported with this
release. Please submit all issues to the Apache Pubscribe project in
+ <a
href="http://issues.apache.org/jira/browse/Muse";>Apache JIRA</a>. If you are
not sure whether something is a bug, post a question on the MUSE
+ <a href="contact_info.html">mailing list</a>.
+ </p>
</section>
</body>
-</document>
+</document>
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
