Author: hlship
Date: Fri Jun 25 00:05:58 2010
New Revision: 957762
URL: http://svn.apache.org/viewvc?rev=957762&view=rev
Log:
TAP5-1190: Add note clarifying why using ComponentInstanceOperation can be
better than ComponentMethodAdvice
Modified:
tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentInstanceOperation.java
Modified:
tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentInstanceOperation.java
URL:
http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentInstanceOperation.java?rev=957762&r1=957761&r2=957762&view=diff
==============================================================================
---
tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentInstanceOperation.java
(original)
+++
tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentInstanceOperation.java
Fri Jun 25 00:05:58 2010
@@ -18,7 +18,9 @@ import org.apache.tapestry5.runtime.Comp
/**
* An operation that requires an instance of a component.
- * This is a simpler alternative to a {...@link ComponentMethodAdvice}.
+ * This is a simpler alternative to a {...@link ComponentMethodAdvice} that
avoids
+ * the most common error case: forgetting to invoke {...@link
ComponentMethodInvocation#proceed()} (which
+ * can be very difficult to track down!).
*
* @since 5.2.0
* @see TransformMethod#addOperationAfter(ComponentInstanceOperation)
