[Cogkit-svn] SF.net SVN: cogkit: [1747] trunk/current/src/cog/modules/abstraction-common /src/org/globus/cog/abstraction/interfaces/TaskHandler.java

[<ha...@us...>]

Revision: 1747
          http://cogkit.svn.sourceforge.net/cogkit/?rev=1747&view=rev
Author:   hategan
Date:     2007-09-19 13:38:52 -0700 (Wed, 19 Sep 2007)

Log Message:
-----------
clarified cases in which an exception is thrown and when task status is set

Modified Paths:
--------------
    trunk/current/src/cog/modules/abstraction-common/src/org/globus/cog/abstraction/interfaces/TaskHandler.java

Modified: trunk/current/src/cog/modules/abstraction-common/src/org/globus/cog/abstraction/interfaces/TaskHandler.java
===================================================================
--- trunk/current/src/cog/modules/abstraction-common/src/org/globus/cog/abstraction/interfaces/TaskHandler.java	2007-09-19 20:38:04 UTC (rev 1746)
+++ trunk/current/src/cog/modules/abstraction-common/src/org/globus/cog/abstraction/interfaces/TaskHandler.java	2007-09-19 20:38:52 UTC (rev 1747)
@@ -75,19 +75,22 @@
      * {@link ExecutableObject#addStatusListener(StatusListener)}and
      * {@link Task#addOutputListener(OutputListener)}methods respectively.
      * 
+     * If the submission fails, the task handler should throw an exception
+     * and not set the status of the task to {@link Task#FAILED}.
+     * 
      * @param task
      *            the <code>Task</code> to be submitted
      * @throws IllegalSpecException
-     *             when the {@link Specification}associated with the task is
+     *             when the {@link Specification} associated with the task is
      *             illegal
      * @throws InvalidSecurityContextException
-     *             when the {@link SecurityContext}associated with the task is
+     *             when the {@link SecurityContext} associated with the task is
      *             invalid
      * @throws InvalidServiceContactException
-     *             when the {@link ServiceContact}associated with the task is
+     *             when the {@link ServiceContact} associated with the task is
      *             invalid
      * @throws TaskSubmissionException
-     *             when generic errors occur during task submission
+     *             when a generic errors occur during task submission
      */
     public void submit(Task task) throws IllegalSpecException,
             InvalidSecurityContextException, InvalidServiceContactException,


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.