[jboss-cvs] jboss-seam/src/main/org/jboss/seam/interceptors ...
Gavin King
gavin.king at jboss.com
Thu Jun 21 01:27:28 EDT 2007
User: gavin
Date: 07/06/21 01:27:28
Modified: src/main/org/jboss/seam/interceptors
AsynchronousInterceptor.java
BusinessProcessInterceptor.java
ConversationInterceptor.java
ConversationalInterceptor.java
EventInterceptor.java MethodContextInterceptor.java
OptimizedInterceptor.java
Log:
lots of new javadoc
Revision Changes Path
1.18 +8 -0 jboss-seam/src/main/org/jboss/seam/interceptors/AsynchronousInterceptor.java
(In the diff below, changes in quantity of whitespace are not shown.)
Index: AsynchronousInterceptor.java
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/src/main/org/jboss/seam/interceptors/AsynchronousInterceptor.java,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -b -r1.17 -r1.18
--- AsynchronousInterceptor.java 20 Jun 2007 17:45:56 -0000 1.17
+++ AsynchronousInterceptor.java 21 Jun 2007 05:27:28 -0000 1.18
@@ -9,6 +9,14 @@
import org.jboss.seam.contexts.Contexts;
import org.jboss.seam.intercept.InvocationContext;
+/**
+ * Dispatches method calls to @Asynchronous methods
+ * asynchronously, and returns the "timer" object
+ * if necessary.
+ *
+ * @author Gavin King
+ *
+ */
@Interceptor(stateless=true, type=InterceptorType.CLIENT)
public class AsynchronousInterceptor extends AbstractInterceptor
{
1.59 +1 -1 jboss-seam/src/main/org/jboss/seam/interceptors/BusinessProcessInterceptor.java
(In the diff below, changes in quantity of whitespace are not shown.)
Index: BusinessProcessInterceptor.java
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/src/main/org/jboss/seam/interceptors/BusinessProcessInterceptor.java,v
retrieving revision 1.58
retrieving revision 1.59
diff -u -b -r1.58 -r1.59
--- BusinessProcessInterceptor.java 20 Jun 2007 17:45:56 -0000 1.58
+++ BusinessProcessInterceptor.java 21 Jun 2007 05:27:28 -0000 1.59
@@ -24,7 +24,7 @@
import org.jboss.util.Strings;
/**
- * Interceptor which handles interpretation of jBPM-related annotations.
+ * Implements annotation-based business-process demarcation.
*
* @author <a href="mailto:steve at hibernate.org">Steve Ebersole</a>
* @author Gavin King
1.68 +2 -3 jboss-seam/src/main/org/jboss/seam/interceptors/ConversationInterceptor.java
(In the diff below, changes in quantity of whitespace are not shown.)
Index: ConversationInterceptor.java
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/src/main/org/jboss/seam/interceptors/ConversationInterceptor.java,v
retrieving revision 1.67
retrieving revision 1.68
diff -u -b -r1.67 -r1.68
--- ConversationInterceptor.java 20 Jun 2007 17:45:56 -0000 1.67
+++ ConversationInterceptor.java 21 Jun 2007 05:27:28 -0000 1.68
@@ -1,4 +1,4 @@
-//$Id: ConversationInterceptor.java,v 1.67 2007/06/20 17:45:56 gavin Exp $
+//$Id: ConversationInterceptor.java,v 1.68 2007/06/21 05:27:28 gavin Exp $
package org.jboss.seam.interceptors;
import java.lang.reflect.Method;
@@ -22,8 +22,7 @@
import org.jboss.seam.persistence.PersistenceContexts;
/**
- * After the end of the invocation, begin or end a long running
- * conversation, if necessary.
+ * Implements annotation-based conversation demarcation.
*
* @author Gavin King
*/
1.21 +3 -2 jboss-seam/src/main/org/jboss/seam/interceptors/ConversationalInterceptor.java
(In the diff below, changes in quantity of whitespace are not shown.)
Index: ConversationalInterceptor.java
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/src/main/org/jboss/seam/interceptors/ConversationalInterceptor.java,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -b -r1.20 -r1.21
--- ConversationalInterceptor.java 20 Jun 2007 17:45:56 -0000 1.20
+++ ConversationalInterceptor.java 21 Jun 2007 05:27:28 -0000 1.21
@@ -1,4 +1,4 @@
-//$Id: ConversationalInterceptor.java,v 1.20 2007/06/20 17:45:56 gavin Exp $
+//$Id: ConversationalInterceptor.java,v 1.21 2007/06/21 05:27:28 gavin Exp $
package org.jboss.seam.interceptors;
import java.lang.reflect.Method;
@@ -18,7 +18,8 @@
/**
* Check that a conversational bean is not being invoked
- * outside the scope of a long-running conversation.
+ * outside the scope of a long-running conversation. If
+ * it is, throw an exception.
*
* @author Gavin King
*/
1.8 +2 -0 jboss-seam/src/main/org/jboss/seam/interceptors/EventInterceptor.java
(In the diff below, changes in quantity of whitespace are not shown.)
Index: EventInterceptor.java
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/src/main/org/jboss/seam/interceptors/EventInterceptor.java,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -b -r1.7 -r1.8
--- EventInterceptor.java 20 Jun 2007 17:45:56 -0000 1.7
+++ EventInterceptor.java 21 Jun 2007 05:27:28 -0000 1.8
@@ -1,10 +1,12 @@
package org.jboss.seam.interceptors;
+
import java.lang.reflect.Method;
import org.jboss.seam.annotations.AroundInvoke;
import org.jboss.seam.annotations.RaiseEvent;
import org.jboss.seam.annotations.intercept.Interceptor;
import org.jboss.seam.core.Events;
import org.jboss.seam.intercept.InvocationContext;
+
/**
* Raises Seam events connected with a bean lifecycle.
*
1.5 +2 -0 jboss-seam/src/main/org/jboss/seam/interceptors/MethodContextInterceptor.java
(In the diff below, changes in quantity of whitespace are not shown.)
Index: MethodContextInterceptor.java
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/src/main/org/jboss/seam/interceptors/MethodContextInterceptor.java,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -b -r1.4 -r1.5
--- MethodContextInterceptor.java 20 Jun 2007 17:45:56 -0000 1.4
+++ MethodContextInterceptor.java 21 Jun 2007 05:27:28 -0000 1.5
@@ -1,10 +1,12 @@
package org.jboss.seam.interceptors;
+
import org.jboss.seam.annotations.AroundInvoke;
import org.jboss.seam.annotations.intercept.Interceptor;
import org.jboss.seam.contexts.Context;
import org.jboss.seam.contexts.Contexts;
import org.jboss.seam.contexts.Lifecycle;
import org.jboss.seam.intercept.InvocationContext;
+
/**
* Sets up the METHOD context and unproxies the SFSB
* for the duration of the call.
1.2 +7 -0 jboss-seam/src/main/org/jboss/seam/interceptors/OptimizedInterceptor.java
(In the diff below, changes in quantity of whitespace are not shown.)
Index: OptimizedInterceptor.java
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/src/main/org/jboss/seam/interceptors/OptimizedInterceptor.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -b -r1.1 -r1.2
--- OptimizedInterceptor.java 9 Feb 2007 03:44:22 -0000 1.1
+++ OptimizedInterceptor.java 21 Jun 2007 05:27:28 -0000 1.2
@@ -2,6 +2,13 @@
import org.jboss.seam.intercept.InvocationContext;
+/**
+ * Interface that may be optionally implemented by an
+ * interceptor, to make the stacktrace smaller.
+ *
+ * @author Gavin King
+ *
+ */
public interface OptimizedInterceptor
{
public Object aroundInvoke(InvocationContext ic) throws Exception;
More information about the jboss-cvs-commits
mailing list