[jboss-cvs] JBossAS SVN: r62544 - in projects/microcontainer/trunk/kernel/src/main/org/jboss/beans/metadata/plugins: annotations and 1 other directory.

[jboss-cvs-commits at lists.jboss.org]

Author: alesj
Date: 2007-04-25 09:53:31 -0400 (Wed, 25 Apr 2007)
New Revision: 62544

Modified:
   projects/microcontainer/trunk/kernel/src/main/org/jboss/beans/metadata/plugins/CallbackCreatorUtil.java
   projects/microcontainer/trunk/kernel/src/main/org/jboss/beans/metadata/plugins/annotations/AnnotationDependencyBuilder.java
   projects/microcontainer/trunk/kernel/src/main/org/jboss/beans/metadata/plugins/annotations/CallbackFactoryAdapter.java
Log:
javadocs

Modified: projects/microcontainer/trunk/kernel/src/main/org/jboss/beans/metadata/plugins/CallbackCreatorUtil.java
===================================================================
--- projects/microcontainer/trunk/kernel/src/main/org/jboss/beans/metadata/plugins/CallbackCreatorUtil.java	2007-04-25 13:36:59 UTC (rev 62543)
+++ projects/microcontainer/trunk/kernel/src/main/org/jboss/beans/metadata/plugins/CallbackCreatorUtil.java	2007-04-25 13:53:31 UTC (rev 62544)
@@ -165,6 +165,13 @@
       return createCallback(context, new MethodAttributeInfo(mi), whenRequired, dependentState, cardinality);
    }
 
+   /**
+    * Get the collection callback item factory.
+    * You can use org.jboss.dependency.collectionCallbackItemFactory name
+    * in System properties to override default implementation class.
+    *
+    * @return get the underlying factory
+    */
    public static CollectionCallbackItemFactory getCollectionFactory()
    {
       if (factory == null)
@@ -184,6 +191,7 @@
       return factory;
    }
 
+   // Privileged system property lookup
    private static class FactoryLookup implements PrivilegedExceptionAction<String>
    {
       public String run() throws Exception

Modified: projects/microcontainer/trunk/kernel/src/main/org/jboss/beans/metadata/plugins/annotations/AnnotationDependencyBuilder.java
===================================================================
--- projects/microcontainer/trunk/kernel/src/main/org/jboss/beans/metadata/plugins/annotations/AnnotationDependencyBuilder.java	2007-04-25 13:36:59 UTC (rev 62543)
+++ projects/microcontainer/trunk/kernel/src/main/org/jboss/beans/metadata/plugins/annotations/AnnotationDependencyBuilder.java	2007-04-25 13:53:31 UTC (rev 62544)
@@ -48,6 +48,12 @@
             Uninstall.class
          };
 
+   /**
+    * Get expected annotation classes.
+    * Can be overridden for additional annotations.
+    *
+    * @return expected/supported annotation classes
+    */
    @SuppressWarnings("unchecked")
    protected Class<? extends Annotation>[] getExpectedAnnotations()
    {
@@ -76,6 +82,13 @@
       return null;
    }
 
+   /**
+    * Check if annotation exists on method.
+    *
+    * @param mi method info
+    * @param annotation annotation to check for
+    * @param list existing dependency item list
+    */
    @SuppressWarnings("unchecked")
    protected void checkAnnotation(MethodInfo mi, Class<? extends Annotation> annotation, List<DependencyBuilderListItem> list)
    {
@@ -90,6 +103,13 @@
       }
    }
 
+   /**
+    * Create dependency factory from anntoation info.
+    * Can be overridden for caching factory instances.
+    *
+    * @param dfl dependency factory lookup
+    * @return dependecny factory instance
+    */
    protected DependencyFactory createDependencyFactory(DependencyFactoryLookup dfl)
    {
       try

Modified: projects/microcontainer/trunk/kernel/src/main/org/jboss/beans/metadata/plugins/annotations/CallbackFactoryAdapter.java
===================================================================
--- projects/microcontainer/trunk/kernel/src/main/org/jboss/beans/metadata/plugins/annotations/CallbackFactoryAdapter.java	2007-04-25 13:36:59 UTC (rev 62543)
+++ projects/microcontainer/trunk/kernel/src/main/org/jboss/beans/metadata/plugins/annotations/CallbackFactoryAdapter.java	2007-04-25 13:53:31 UTC (rev 62544)
@@ -36,16 +36,40 @@
  */
 public abstract class CallbackFactoryAdapter
 {
+   /**
+    * Create new dependency builder list item.
+    * Install or uninstall phase item.
+    *
+    * @param info callback info
+    * @param method method info
+    * @return new dependency builder list item
+    */
    protected DependencyBuilderListItem<KernelControllerContext> getDependency(CallbackInfo info, MethodInfo method)
    {
       return getDependency(info, new MethodAttributeInfo(method));
    }
 
+   /**
+    * Create new dependency builder list item.
+    * Install or uninstall phase item.
+    *
+    * @param info callback info
+    * @param property property info
+    * @return new dependency builder list item
+    */
    protected DependencyBuilderListItem<KernelControllerContext> getDependency(CallbackInfo info, PropertyInfo property)
    {
       return getDependency(info, new PropertyAttributeInfo(property));
    }
 
+   /**
+    * Create new dependency builder list item.
+    * Install or uninstall phase item.
+    *
+    * @param info callback info
+    * @param attribute attribute info
+    * @return new dependency builder list item
+    */
    protected DependencyBuilderListItem<KernelControllerContext> getDependency(CallbackInfo info, AttributeInfo attribute)
    {
       if (info.isInstallPhase())