svn commit: r567385 - /myfaces/orchestra/trunk/core15/src/main/java/org/apache/myfaces/orchestra/viewController/AnnotationsViewControllerManager.java

[sk...@apache.org]

Author: skitching
Date: Sun Aug 19 03:50:38 2007
New Revision: 567385

URL: http://svn.apache.org/viewvc?view=rev&rev=567385
Log:
Add javadoc only.

Modified:
    myfaces/orchestra/trunk/core15/src/main/java/org/apache/myfaces/orchestra/viewController/AnnotationsViewControllerManager.java

Modified: myfaces/orchestra/trunk/core15/src/main/java/org/apache/myfaces/orchestra/viewController/AnnotationsViewControllerManager.java
URL: http://svn.apache.org/viewvc/myfaces/orchestra/trunk/core15/src/main/java/org/apache/myfaces/orchestra/viewController/AnnotationsViewControllerManager.java?view=diff&rev=567385&r1=567384&r2=567385
==============================================================================
--- myfaces/orchestra/trunk/core15/src/main/java/org/apache/myfaces/orchestra/viewController/AnnotationsViewControllerManager.java (original)
+++ myfaces/orchestra/trunk/core15/src/main/java/org/apache/myfaces/orchestra/viewController/AnnotationsViewControllerManager.java Sun Aug 19 03:50:38 2007
@@ -31,12 +31,16 @@
 import java.io.IOException;
 
 /**
- * <p/>
  * A {@link org.apache.myfaces.orchestra.viewController.ViewControllerManager} implementation which uses
- * the org.apache.myfaces.orchestra.viewController.annotations.* to determine the beans responsible
- * for a given view and executes its annotated methods
- * </p>
+ * annotations on backing beans to determine the beans responsible for a given view and execute
+ * the appropriate annotated methods.
  *
+ * <p>When using Spring, every bean declaration in the spring config files is checked to see if the
+ * referenced class has annotations, and if so that information is cached. Here, that information is
+ * then used to locate a bean which has a ViewController annotation that references the current view.</p>
+ * 
+ * <p>See also org.apache.myfaces.orchestra.viewController.annotations.*.</p>
+ * 
  * @see org.apache.myfaces.orchestra.viewController.ViewControllerManager
  */
 public class AnnotationsViewControllerManager extends AbstractViewControllerManager
@@ -52,6 +56,8 @@
 
 	public void initManager()
 	{
+		// Set things up so that finding a bean-name for a viewId looks first using an
+		// AnnotationsViewControllerNameMapper, then a DefaultViewControllerNameMapper.
 		viewControllerNameMapper =
 			new CompositeViewControllerNameMapper(
 				new ViewControllerNameMapper[]