/*
- * 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);
}