db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From kahat...@apache.org
Subject svn commit: r596262 - /db/derby/code/trunk/java/engine/org/apache/derby/iapi/services/daemon/DaemonService.java
Date Mon, 19 Nov 2007 10:50:43 GMT
Author: kahatlen
Date: Mon Nov 19 02:50:41 2007
New Revision: 596262

URL: http://svn.apache.org/viewvc?rev=596262&view=rev
Log:
DERBY-3208: Callers of DaemonService.serviceNow() assume behaviour not
guaranteed by the interface

Expanded the javadoc comment in the interface so that it guarantees
what the callers implicitly assume.

Modified:
    db/derby/code/trunk/java/engine/org/apache/derby/iapi/services/daemon/DaemonService.java

Modified: db/derby/code/trunk/java/engine/org/apache/derby/iapi/services/daemon/DaemonService.java
URL: http://svn.apache.org/viewvc/db/derby/code/trunk/java/engine/org/apache/derby/iapi/services/daemon/DaemonService.java?rev=596262&r1=596261&r2=596262&view=diff
==============================================================================
--- db/derby/code/trunk/java/engine/org/apache/derby/iapi/services/daemon/DaemonService.java
(original)
+++ db/derby/code/trunk/java/engine/org/apache/derby/iapi/services/daemon/DaemonService.java
Mon Nov 19 02:50:41 2007
@@ -87,12 +87,19 @@
 	public void unsubscribe(int clientNumber);
 
 
-	/**
-	    Service this subscription ASAP.  Does not guarantee that the daemon
-		will actually do anything about it.
-
-		@param clientNumber the number that uniquely identify the client
-	 */
+    /**
+     * Service this subscription ASAP. When this method is called, the
+     * subscriber's <code>performWork()</code> method is guaranteed to be
+     * invoked at some point in the future. However, there is no guarantee that
+     * a subscriber's <code>performWork()</code> is called the same number of
+     * times as the subscriber calls this method. More precisely, if a
+     * subscriber is waiting for this daemon service to invoke its
+     * <code>performWork()</code> method, the daemon service may, but is not
+     * required to, ignore requests from that subscriber until the
+     * <code>performWork()</code> method has been invoked.
+     *
+     * @param clientNumber the number that uniquely identifies the client
+     */
 	public void serviceNow(int clientNumber);
 
 



Mime
View raw message