ACE-4744 javadoc and cleanup

git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@119697 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261

source/java/org/alfresco/traitextender/ExtendedTrait.java

@@ -16,10 +16,18 @@
  * You should have received a copy of the GNU Lesser General Public License
  * along with Alfresco. If not, see http://www.gnu.org/licenses/.
  */
+
 package org.alfresco.traitextender;
 
 import java.util.concurrent.ConcurrentHashMap;
 
+/**
+ * Trait based extension reference holder.<br>
+ * Keeps track of extension references for one extensible and allows the
+ * collection of those extensions when the extensible is collected.
+ * 
+ * @author Bogdan Horje
+ */
 public class ExtendedTrait<T extends Trait>
 {
     private ConcurrentHashMap<Class<?>, Object> extensions = new ConcurrentHashMap<Class<?>, Object>();
@@ -40,23 +48,24 @@ public class ExtendedTrait<T extends Trait>
     public <E> E getExtension(Class<E> extensionAPI)
     {
         @SuppressWarnings("unchecked")
-        E extension=(E) extensions.get(extensionAPI);
-        
+        E extension = (E) extensions.get(extensionAPI);
+
         return extension;
     }
-    
+
     public synchronized <E> E extend(Class<E> extensionAPI, ExtensionFactory<E> factory)
     {
         @SuppressWarnings("unchecked")
-        E extension=(E) extensions.get(extensionAPI);
-        
-        if (extension==null)
+        E extension = (E) extensions.get(extensionAPI);
+
+        if (extension == null)
         {
             extension = factory.createExtension(trait);
-            extensions.put(extensionAPI, extension);
-            
+            extensions.put(extensionAPI,
+                           extension);
+
         }
-        
+
         return extension;
     }
 }