From: Fred T. Hamster <fred@gruntose.com>
Date: Fri, 14 Feb 2014 17:50:30 +0000 (-0500)
Subject: improving this a little bit so it can be used someday.
X-Git-Tag: 2.140.90~828
X-Git-Url: https://feistymeow.org/gitweb/?a=commitdiff_plain;h=f2aa040bbb4b45acf77d75675934176e52d26df5;p=feisty_meow.git

improving this a little bit so it can be used someday.
---

diff --git a/kona/src/org/feistymeow/process/ethread.java b/kona/src/org/feistymeow/process/ethread.java
index 280a0830..913af7a1 100644
--- a/kona/src/org/feistymeow/process/ethread.java
+++ b/kona/src/org/feistymeow/process/ethread.java
@@ -1,68 +1,94 @@
-
 package org.feistymeow.process;
 
-//still in progress...
-// not compilable yet probably, 
-// plus missing the timed features of ethread.
-
 import org.apache.commons.logging.Log;
 import org.apache.commons.logging.LogFactory;
 
 /**
  * A simple java thread that hearkens back to the HOOPLE C++ ethread in features.
- *
+ * 
  * @author Chris Koeritz
+ * @copyright Copyright (c) 2010-$now By Feisty Meow Concerns Ltd.
+ * @license This file is free software; you can modify and redistribute it under the terms of the
+ *          Apache License v2.0: http://www.apache.org/licenses/LICENSE-2.0
  */
-class ethread implements Runnable
+public abstract class ethread implements Runnable
 {
-//fix below to use better way to get class object.
-  private static Log c_logger = LogFactory.getLog(ethread.class);
+	private static Log c_logger = LogFactory.getLog(ethread.class);
+
+	// the actual java thread object.
+	private volatile Thread c_RealThread = null;
+	// provides synchronization for the thread.
+	private volatile Object c_lock = new Object();
+
+	/**
+	 * creates a new ethread without starting it.
+	 */
+	public ethread()
+	{
+	}
 
-  private volatile Thread c_RealThread = null;
+	/**
+	 * Begins execution of the thread.
+	 */
+	public void start()
+	{
+		synchronized (c_lock) {
+			if (null == this.c_RealThread) {
+				this.c_RealThread = new Thread(this);
+				c_logger.debug("starting thread " + c_RealThread.getId());
+				this.c_RealThread.start();
+			}
+		}
+	}
 
-  // the only variable on which both synchronize is the "thread finished" variable.
-  public ethread()
-  {
-	  c_logger.warn("this class needs to be implemented and used in an example.");
-  }
+	/**
+	 * Stops execution of the thread, or at least attempts to.
+	 */
+	public void stop()
+	{
+		synchronized (c_lock) {
+			Thread goAway = c_RealThread;
+			c_RealThread = null;
+			if (null != goAway) {
+				goAway.interrupt();
+			}
+		}
+	}
 
-  /**
-   * Begins execution of the thread.
-   */
-  public void start()
-  {
-    if( null == this.c_RealThread )
-    {
-      this.c_RealThread = new Thread(this);
-      this.c_RealThread.start();
-    }
-  }
-  
-  /**
-   * Stops execution of the thread, or at least attempts to.
-   */
-  public void stop()
-  {
-    Thread goAway = c_RealThread;
-    c_RealThread = null;
-    if (null != goAway) { goAway.interrupt(); }
-  }
-  
-  /**
-   * Returns true if the thread isn't null.
-   */
-  public boolean threadRunning()
-  {
-    return (null != this.c_RealThread);
-  }
-  
-  public void run()
-  {
-    if (false == threadRunning())
-    {
-      return; // stopped before it ever started
-    }
-    
-  }
+	/**
+	 * this is the main function that derived classes must implement. it does the actual work that
+	 * the thread is intended to perform. note that the derived version must not do anything to
+	 * cause the thread to be ripped out while performActivity is still being invoked.
+	 */
+	// hmmm: should this stay void, or use a bool status to indicate if the thread should die?
+	abstract void performActivity();
 
+	/**
+	 * Returns true if the thread isn't null.
+	 */
+	public boolean threadRunning()
+	{
+		synchronized (c_lock) {
+			return (null != this.c_RealThread);
+		}
+	}
+
+	/**
+	 * this is the override from Runnable that allows us to call our own performActivity method.
+	 * implementors should not override this; they should override performActivity instead.
+	 */
+	public void run()
+	{
+		synchronized (c_lock) {
+			if (false == threadRunning()) {
+				return; // stopped before it ever started. how can this be? we just got invoked.
+			}
+			performActivity();
+		}
+	}
 }
+
+// hmmm: still in progress...
+// hmmm: missing the timed features of ethread.
+// hmmm: missing cancel, exempt_stop, sleep_time, should_stop,
+