Author: cziegeler
Date: Wed Dec 5 05:02:05 2007
New Revision: 601323
URL: http://svn.apache.org/viewvc?rev=601323&view=rev
Log:
Fix javadoc according to latest changes of the resource interface.
Modified:
incubator/sling/trunk/api/src/main/java/org/apache/sling/api/resource/ResourceManager.java
incubator/sling/trunk/api/src/main/java/org/apache/sling/api/resource/ResourceResolver.java
Modified:
incubator/sling/trunk/api/src/main/java/org/apache/sling/api/resource/ResourceManager.java
URL:
http://svn.apache.org/viewvc/incubator/sling/trunk/api/src/main/java/org/apache/sling/api/resource/ResourceManager.java?rev=601323&r1=601322&r2=601323&view=diff
==============================================================================
---
incubator/sling/trunk/api/src/main/java/org/apache/sling/api/resource/ResourceManager.java
(original)
+++
incubator/sling/trunk/api/src/main/java/org/apache/sling/api/resource/ResourceManager.java
Wed Dec 5 05:02:05 2007
@@ -24,7 +24,8 @@
* The <code>ResourceManager</code> interface extends the
* [EMAIL PROTECTED] ResourceResolver} in case the Sling Framework supports
Object Content
* Mapping of some sort and thus able to manage the
- * [EMAIL PROTECTED] Resource#getObject() data field of the resource}.
+ * [EMAIL PROTECTED] Resource#adaptTo(Class) data field of the resource} (The
class argument
+ * for the [EMAIL PROTECTED] Resource#adaptTo(Class)} method would be
<code>Object.class</code.
* <p>
* Any data modification operations executed through objects of this interface
* must be persisted explicitly by calling the [EMAIL PROTECTED] #save()}
method. Likewise
@@ -33,13 +34,14 @@
* Implementations of this interface will (of course) also implement the
methods
* of the base interface. In addition to just loading the [EMAIL PROTECTED]
Resource}
* instances, though, implementations of this interface are expected to also
try
- * to set the [EMAIL PROTECTED] Resource#getObject() data field} of the
resource if possible.
+ * to provide the [EMAIL PROTECTED] Resource#adaptTo(Class)
Resource.adaptTo(Object.class) data field}
+ * of the resource if possible.
*/
public interface ResourceManager extends ResourceResolver {
/**
- * Stores the [EMAIL PROTECTED] Resource#getObject() resource data}
mapping the Java
- * object back into the underlying persistence structure.
+ * Stores the [EMAIL PROTECTED] Resource#adaptTo(Class)
Resource.adaptTo(Object.class) resource data}
+ * mapping the Java object back into the underlying persistence structure.
* <p>
* This method may be used to update existing data or to create new data in
* the persistence. The implementation of the method must make care to
@@ -58,7 +60,8 @@
/**
* Returns a <code>Resource</code> object whose
- * [EMAIL PROTECTED] Resource#getObject() data field} is mapped from the
persistent data
+ * [EMAIL PROTECTED] Resource#adaptTo(Class)
Resource.adaptTo(Object.class) data field}
+ * is mapped from the persistent data
* to an instance of the given <code>type</code>. If persistent data can
* be found at the requested path which cannot be mapped into an object of
* the requested type a <code>ResourceNotFoundException</code> is thrown
Modified:
incubator/sling/trunk/api/src/main/java/org/apache/sling/api/resource/ResourceResolver.java
URL:
http://svn.apache.org/viewvc/incubator/sling/trunk/api/src/main/java/org/apache/sling/api/resource/ResourceResolver.java?rev=601323&r1=601322&r2=601323&view=diff
==============================================================================
---
incubator/sling/trunk/api/src/main/java/org/apache/sling/api/resource/ResourceResolver.java
(original)
+++
incubator/sling/trunk/api/src/main/java/org/apache/sling/api/resource/ResourceResolver.java
Wed Dec 5 05:02:05 2007
@@ -41,9 +41,9 @@
* [EMAIL PROTECTED] Resource} object is returned whose
* [EMAIL PROTECTED] Resource#getResourceType() resource type} is set to
* [EMAIL PROTECTED] Resource#RESOURCE_TYPE_NON_EXISTING} and the
- * [EMAIL PROTECTED] Resource#getURI() resource URI} set to the request
URI. Both the
- * [EMAIL PROTECTED] Resource#getRawData() raw data} and
- * [EMAIL PROTECTED] Resource#getObject() object} fields will be
<code>null</code>.
+ * [EMAIL PROTECTED] Resource#getURI() resource URI} set to the request
URI.
+ * [EMAIL PROTECTED] Resource#adaptTo(Class) object} returns
<code>null</code>
+ * for all classes.
*
* @param request The servlet request object used to resolve the resource
* for.
