[jboss-svn-commits] JBL Code SVN: r21561 - in labs/jbossrules/trunk/drools-api/src/main/java/org/drools: time and 1 other directory.

[jboss-svn-commits at lists.jboss.org]

Author: mark.proctor at jboss.com
Date: 2008-08-15 03:38:38 -0400 (Fri, 15 Aug 2008)
New Revision: 21561

Added:
   labs/jbossrules/trunk/drools-api/src/main/java/org/drools/time/
   labs/jbossrules/trunk/drools-api/src/main/java/org/drools/time/SessionClock.java
Modified:
   labs/jbossrules/trunk/drools-api/src/main/java/org/drools/StatefulRuleSession.java
Log:
JBRULES-1734 Drools-API
-added SessionClock

Modified: labs/jbossrules/trunk/drools-api/src/main/java/org/drools/StatefulRuleSession.java
===================================================================
--- labs/jbossrules/trunk/drools-api/src/main/java/org/drools/StatefulRuleSession.java	2008-08-15 06:06:51 UTC (rev 21560)
+++ labs/jbossrules/trunk/drools-api/src/main/java/org/drools/StatefulRuleSession.java	2008-08-15 07:38:38 UTC (rev 21561)
@@ -1,5 +1,7 @@
 package org.drools;
 
+import org.drools.time.SessionClock;
+
 public interface StatefulRuleSession {
     FactHandle insertObject(Object object);
     void retractObject(FactHandle factHandle);
@@ -7,4 +9,12 @@
     void updateObject(FactHandle factHandle, Object object);
     
     void fireAllRules();
+    
+    void halt();
+    
+    /**
+     * Returns the session clock instance associated with this session
+     * @return
+     */
+    public SessionClock getSessionClock();    
 }

Added: labs/jbossrules/trunk/drools-api/src/main/java/org/drools/time/SessionClock.java
===================================================================
--- labs/jbossrules/trunk/drools-api/src/main/java/org/drools/time/SessionClock.java	                        (rev 0)
+++ labs/jbossrules/trunk/drools-api/src/main/java/org/drools/time/SessionClock.java	2008-08-15 07:38:38 UTC (rev 21561)
@@ -0,0 +1,39 @@
+/*
+ * Copyright 2007 JBoss Inc
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ * 
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * Created on Oct 17, 2007
+ */
+package org.drools.time;
+
+
+/**
+ * A clock interface that all engine clocks must implement
+ * 
+ */
+public interface SessionClock {
+
+    /**
+     * Returns the current time. There is no semantics attached
+     * to the long return value, so it will depend on the actual
+     * implementation. For isntance, for a real clock it may be
+     * milliseconds.
+     * 
+     * @return The current time. The unit of the time, depends on
+     * the actual clock implementation.
+     * 
+     */
+    public long getCurrentTime();
+
+}