[maven-release-plugin] copy for tag wamblee-utils-0.2.2
[utils] / support / general / src / main / java / org / wamblee / general / BeanFactory.java
index 56844bd78541c7e68ecc065c008a24b6f7e65803..bee62b1b9bc99de54a367023ae240d623d077f08 100644 (file)
@@ -1,5 +1,5 @@
 /*
- * Copyright 2005 the original author or authors.
+ * Copyright 2005-2010 the original author or authors.
  * 
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
 package org.wamblee.general;
 
 /**
- * Bean factory used to obtain objects in a transparent way. 
- *
+ * Bean factory used to obtain objects in a transparent way.
+ * 
  * @author Erik Brakkee
  */
 public interface BeanFactory {
-
-    /**
-     * Finds a bean based on id. 
-     * @param aId Id of the bean. 
-     * @return Object  (always non-null). 
-     * @throws BeanFactoryException In case the object could not be found. 
-     */
-    Object find(String aId);  
-    
     /**
-     * Finds a bean of the given class and which can be cast to the 
-     * specified class. This is typically used by specifying the interface
-     * class for retrieving an implementation of that class. This 
-     * means that the bean implementing the class is configured in the bean factory
-     * with id equal to the class name of the interface.  
-     * @param aClass Class of the object to find. 
+     * Finds a bean based on id.
+     * 
+     * @param aId
+     *            Id of the bean.
      * @return Object (always non-null).
-     * @throws BeanFactoryException In case the object could not be found. 
+     * @throws BeanFactoryException
+     *             In case the object could not be found.
      */
-     <T> T find(Class<T> aClass);
-     
-     /**
-      * Finds a bean with the given id which can be cast to the specified
-      * class.  
-      * @param <T> Type of the object to get. 
-      * @param aId Id of the object to lookup. 
-      * @param aClass Class that the object must extends. 
-      * @return Object, always non-null. 
-      * @throws BeanFactoryException In case the object could not be found. 
-      */
-     <T> T find(String aId, Class<T> aClass); 
+    Object find(String aId);
+
+    <T> T find(Class<T> aClass);
+
+    <T> T find(String aId, Class<T> aClass);
 }