1 //---------------------------------------------------------------------- 2 // 3 // PerfectJPattern: "Design patterns are good but components are better!" 4 // IFactoryMethod.java Copyright (c) 2009 Giovanni Azua Garcia 5 // bravegag@hotmail.com 6 // 7 // This program is free software; you can redistribute it and/or 8 // modify it under the terms of the GNU General Public License 9 // as published by the Free Software Foundation; either version 3 10 // of the License, or (at your option) any later version. 11 // 12 // This program is distributed in the hope that it will be useful, 13 // but WITHOUT ANY WARRANTY; without even the implied warranty of 14 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 15 // GNU General Public License for more details. 16 // 17 // You should have received a copy of the GNU General Public License 18 // along with this program; if not, see <http://www.gnu.org/licenses/>. 19 // 20 //---------------------------------------------------------------------- 21 package org.perfectjpattern.core.api.creational.factorymethod; 22 23 /** 24 * <b>Factory Method Design Pattern</b>: Define an interface for creating an 25 * object, but let subclasses decide which class to instantiate. 26 * Factory Method lets a class defer instantiation to subclasses. 27 * (Gamma et al, Design Patterns) 28 * <br/><br/> 29 * 30 * <b>Responsibility</b> Abstract definition of the "Creator": <br/> 31 * <br/> 32 * <ul> 33 * <li>Declares the factory method, which returns an object of type 34 * Product.</li> 35 * <li>Creator may also define a default implementation of the factory 36 * method that returns a default ConcreteProduct object. 37 * may call the factory method to create a Product object.</li> 38 * </ul> 39 * 40 * <br/> 41 * Example usage: 42 * <pre><code> 43 * import org.perfectjpattern.core.api.creational.factorymethod.*; 44 * 45 * // 46 * // Example of Factory Method subtype that creates Product with a 47 * // name parameter. 48 * // 49 * public IProductFactory 50 * extends IFactoryMethod<Product> 51 * { 52 * //-------------------------------------------------------------------- 53 * // public 54 * //-------------------------------------------------------------------- 55 * public void 56 * setName(String aName); 57 * } 58 * 59 * </code></pre> 60 * @param <T> Type of elements created. 61 * 62 * @author <a href="mailto:bravegag@hotmail.com">Giovanni Azua</a> 63 * @version $Revision: 1.0 $ $Date: Jun 19, 2007 11:01:51 PM $ 64 */ 65 public 66 interface IFactoryMethod<T> 67 { 68 //------------------------------------------------------------------------ 69 // public 70 //------------------------------------------------------------------------ 71 /** 72 * Returns newly created instance 73 * 74 * @return Newly created instance 75 */ 76 T create(); 77 }