Changes between Version 8 and Version 9 of ApertureDataObject


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

--

Legend:

Unmodified
Added
Removed
Modified
  • ApertureDataObject

    v8 v9  
    88 
    99 * 'Metadata' is one word, hence getMetadata, not getMetaData. 
     10 
     11 * TODO: what is the semantics and use of getParent() and getChildren()? 
    1012 
    1113== Java Interface == 
     
    3335 
    3436        /** 
    35          * Returns the byte size of the represented resource. This has been defined at 
    36          * this global level due to the importance of this attribute for performance reasons. 
    37          * @return the size of the binary resource in bytes, or a negative value when the 
    38          * size is unknown or does not make sense for this particular DataObject implementation. 
    39          */ 
    40         public long getSize(); 
    41  
    42         /** 
    4337         * Gets the DataSource from which this DataObject conceptually originated. 
    4438         *  
     
    5953         */ 
    6054        public Iterator<DataObject> getChildren(); 
    61      
    62         /** 
    63          * Gets an InputStream containing the content represented by the DataObject. 
    64          * The returned InputStream is required to support marking (markSupported() 
    65          * returns true). Calling this method multiple times may references to 
    66          * one-and-the-same InputStream instance. Care should therefore be taken to mark 
    67          * and reset the stream when the stream's content is to be read again later. 
    68          *  
    69          * @return An InputStream from which the content of the data object can be read. 
    70          * @throws IOException If an I/O error occurred. 
    71          */ 
    72         public InputStream getContent() throws IOException; 
    7355 
    74         /** 
    75          * Instructs the DataObject that its content stream will most likely be used multiple 
    76          * times in its entirety, making the mark-and-reset procedure difficult to work,  
    77          * and that it better should cache the entire contents. 
    78          * @throws IOException when an IOException occured during caching of the content. 
    79          */ 
    80  ´      public void cacheContent() throws IOException; 
    8156     
    8257        /** 
     
    9065        public RDFMap getMetadata(); 
    9166 
    92         /** 
    93          * what is the mime-type of the content, if there is content? 
    94          * This is set by the DataAccessor 
    95          * @return null or a mimetype identifier like "text/plain" 
    96          */ 
    97         public String getContentMimeType(); 
    98  
    99         /** 
    100          * what is the character-encoding (using ansi identifiers like "UTF-8" 
    101          * or "ISO-8859-1") of the content, if there is content. Will  
    102          * return null if not known or if content is null. 
    103          * This is set by the DataAccessor 
    104          * @return null or a encoding identifier like "UTF-8" 
    105          */ 
    106         public String getContentEncoding(); 
    10767} 
    10868}}}