Changes between Version 4 and Version 5 of ApertureDataOpener

Timestamp:

10/17/05 23:11:14 (19 years ago)

Author:

sauermann

Comment:

--

ApertureDataOpener

@@ -8 +8 @@
 
 /**
- * A commandExecutor is the handler of an Adapter that implements the ability
- * to execute commands. The handler can be seperated from the adapter.
+ * A DataOpener is a handler, tightly coupled to a DataSource, that
+ * knows how to open DataObjects (identified by URI) to be seen by the user.
+ * The DataOpener will open a file using the operating system or open an email
+ * using an email application or open a KOrganizer address book entry using
+ * KOrganizer.
  */
 
-public interface CommandExecutor {
+public interface DataOpener {
         
   /**
-   * Executes a command on the uri.
-   * @param command a command identifier (uri).
-   * preferably one from http://www.gnowsis.org/ont/appworkspace/cmd/0.1#
-   * @param url url of the resource that should be manipulated
+   * opens the passed DataObject in the application that the user
+   * typically would use to access the object.
+   * @param uri uri of the resource that should be opened
    * @throws an Exception when something goes wrong.
+   * @throws ResourceNotFoundException when the uri does not point 
+   * to a known resource, perhaps the resource was deleted?
    */
-  public void executeCommand(String command, String url) throws
+  public void openDataObject(URI uri) throws
       ResourceNotFoundException, ExecuteException;