anthill
Interface Resource

All Known Implementing Classes:
RandomResource, FileResource, UrlResource

public interface Resource

The Resource interface describes resources that may be stored in a nests. Each resource is uniquely identified by its string name.


Method Summary
 java.lang.String getAttribute(java.lang.String name)
          Returns the value associated to the specified attribute name, or null if there is no attribute with that name.
 long getContentLength()
          Return the lenght of the content of the resource, if available; otherwise, it returns -1.
 java.io.InputStream getInputStream()
          Return an input stream to download the contents of the resource.
 java.lang.String getName()
          Returns the string identifier of the object.
 

Method Detail

getName

public java.lang.String getName()
Returns the string identifier of the object.

getAttribute

public java.lang.String getAttribute(java.lang.String name)
Returns the value associated to the specified attribute name, or null if there is no attribute with that name.
Parameters:
name - the name of the attribute

getInputStream

public java.io.InputStream getInputStream()
                                   throws java.io.IOException
Return an input stream to download the contents of the resource. Depending on the implementation, the contents may be read from the local storage, if the resource has been copied locally; or downloaded remotely, otherwise.
Returns:
an input stream to read the contents of a resource;

getContentLength

public long getContentLength()
Return the lenght of the content of the resource, if available; otherwise, it returns -1.