Changes between Version 6 and Version 7 of ApertureDataAccessor

Timestamp:

10/18/05 20:52:54 (19 years ago)

Author:

sauermann

Comment:

--

ApertureDataAccessor

@@ -27 +27 @@
  * The !CrawlData interface allows us in the future to get rid of the !CrawlDataBase implementation class, which has its own storage format, and create an adapter that works on top of the Sesame Repository that also contains all extracted metadata. This way all known metadata of a resource is stored in a single place, ensuring consistency, lower resource comsumption, improved caching behaviour, etc.
 
+ * Leo: to simplify and seperate the '''get (=get it now!)''' and '''getCrawl (=check if changed, get if changed)''' I would suggest to define two methods,  one for really getting a resource and one in the crawling scenario. The getCrawl method would be the existing one, the get method a simpler one.
+
 
 == Java Interface ==
@@ -36 +38 @@
   * A DataAccessor provides access to physical resources by creating DataObjects
   * representing the resource, based on a url and optionally data about a previous access
-  * and other parameters.
+  * and other parameters. 
+  * The main task of a DataAccessor is to find the resource identified by the URL String
+  * and create a DataObject that represents the resource. When crawling, the DataAccessor
+  * additionally uses the passed CrawlData interface to check and update information about
+  * the last crawl. 
+  * About the returned DataObject: i n most cases, the DataObject is just a passive container
+  * of information, the DataAccessor will have filled it with information. However, it may 
+  * also have returned a dedicated DataObject implementation that determines some things 
+  * dynamically, that is up to the DataAccessor to decide. 
   */
 public interface DataAccessor {
@@ -57 +67 @@
          * @param uri         The uri used to address the resource.
          * @param dataSource  The source that will be registered as the source of the DataObject.
-         * @param accessData  Optional database containing information about previous accesses.
+         * @param crawlData   Optional database containing information about previous accesses.
          * @param params      Optional additional parameters needed to access the physical resource.
+         *                  also, parameters may be passed that determine how the metadata should be 
+                            extracted or which detail
+         *                  of metadata is needed. Applications may pass params through the whole chain.
          * @return A DataObject for the specified URI, or null when an AccessData instance has been
          * specified and the binary resource has not been modified since the last access.
@@ -65 +78 @@
          */
         public DataObject get(URI uri, DataSource source,
-            AccessData accessData, Map<?,?> params) throws UriNotFoundException, IOException;
+            CrawlData crawlData , Map<?,?> params) throws UriNotFoundException, IOException;
 }
 }}}