Changes between Version 11 and Version 12 of ApertureDataObject


Ignore:
Timestamp:
10/20/05 15:02:32 (19 years ago)
Author:
sauermann
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • ApertureDataObject

    v11 v12  
    99 * 'Metadata' is one word, hence getMetadata, not getMetaData. 
    1010 
    11  * TODO: what is the semantics and use of getParent() and getChildren()? 
     11 * Semantics and use of getParent() and getChildren()? Chris: about getParent, getChildren, etc.: I thought the idea was to just put the URIs of these objects, when known in the metadata of the DataObject. When you are interested in its parent, you should then retrieve the parent's URI from the metadata and approach the DataAccessor again with that URI. this way you can get rid of these specialized methods and are also more future-proof, when someone invents more DataSource-DataSource relations - Leo: ok, I deleted them without replacement. 
     12 
    1213 
    1314== Java Interface == 
    … …  
    2425 * and DataObjectFolder. Handling a DataObject, you should always (via type checking using 'instanceof') 
    2526 * handle additional information provided by the sub-interfaces. 
    26  *  
     27 * <h3>metadata and data</h3> 
     28 * Calling the getMetadata() method will retrieve structured data that exists in the datasource already, 
     29 * including important metadata like size in bytes, last change date, title, author, subject, etc. 
     30 * The metadata can be also data of the object: when you access a contact from an address book, the  
     31 * whole contact information (including address, tel, etc) will be inside the metadata object. 
     32 * Also, relations to parents and children related to this DataObject may be inside the metadata. 
     33 * Note, that folder-like relations are always returned when the DataObject is an instance of 
     34 * DataObjectFolder, then the metadata will contain links to all children of the folder (including 
     35 * sub-folders and sub-objects) 
    2736 */ 
    2837public interface DataObject { 
    … …  
    4251        public DataSource getDataSource(); 
    4352     
    44         /** 
    45          * Gets the data object's parent, if any. 
    46          *  
    47          * @return the parent DataObject, or null when this DataObject has no parent. 
    48          */ 
    49         public DataObject getParent(); 
    50      
    51         /** 
    52          * Gets the data object's children, if any. This may be null to indicate that there 
    53          * are no children.  
    54          * @return an Iterator over DataObject objects 
    55          */ 
    56         public Iterator getChildren(); 
    57  
    58      
    5953        /** 
    6054         * Get the source-specific metadata and data.