svn commit: r289890 - /jakarta/velocity/core/trunk/src/java/org/apache/velocity/app/event/ContextAware.java

[wg...@apache.org]

Author: wglass
Date: Sat Sep 17 22:33:20 2005
New Revision: 289890

URL: http://svn.apache.org/viewcvs?rev=289890&view=rev
Log:
Added warning about thread safety

Modified:
    jakarta/velocity/core/trunk/src/java/org/apache/velocity/app/event/ContextAware.java

Modified: jakarta/velocity/core/trunk/src/java/org/apache/velocity/app/event/ContextAware.java
URL: http://svn.apache.org/viewcvs/jakarta/velocity/core/trunk/src/java/org/apache/velocity/app/event/ContextAware.java?rev=289890&r1=289889&r2=289890&view=diff
==============================================================================
--- jakarta/velocity/core/trunk/src/java/org/apache/velocity/app/event/ContextAware.java (original)
+++ jakarta/velocity/core/trunk/src/java/org/apache/velocity/app/event/ContextAware.java Sat Sep 17 22:33:20 2005
@@ -23,6 +23,12 @@
  * have the method setContext called before each event.  This
  * allows the event handler to use information in the latest context
  * when responding to the event.
+ * 
+ * <P>Important Note: Only local event handlers attached to the context
+ * (as opposed to global event handlers initialized in the velocity.properties
+ * file) should implement ContextAware.  Since global event handlers are
+ * singletons individual requests will not be able to count on the 
+ * correct context being loaded before a request.
  *
  * @author <a href="mailto:wglass@wglass@forio.com">Will Glass-Husain</a>
  * @version $Id: GlobalEventHandler.java,v 1.4 2004/03/19 17:13:33 dlr Exp $



---------------------------------------------------------------------
To unsubscribe, e-mail: velocity-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: velocity-dev-help@jakarta.apache.org