Factory Pattern

Kenneth M. Anderson University of Colorado, Boulder CSCI 4448/6448 Lecture 21 11/06/2007

University of Colorado, 2007

Lecture Goals
Cover Material from Chapters 4 of the Design Patterns Textbook Factory Pattern Abstract Factory Pattern

The Problem With New

Each time we invoke the new command to create a new object, we violate the Code to an Interface design principle Example Duck duck = new DecoyDuck() Even though our variables type is set to an interface, in this case Duck, the class that contains this statement depends on DecoyDuck In addition, if you have code that checks a few variables and instantiates a particular type of class based on the state of those variables, then the containing class depends on each referenced concrete class
if (hunting) { return new DecoyDuck() } else { return new RubberDuck(); }

Obvious Problems: needs to be recompiled each time a dep. changes add new classes, change this code remove existing classes, change this code This means that this code violates the open-closed principle and the encapsulate what varies design principle
3

PizzaStore Example
We have a pizza store program that wants to separate the process of creating a pizza with the process of preparing/ordering a pizza Initial Code: mixed the two processes
1 public class PizzaStore { 2 Pizza orderPizza(String type) { 3 4 Pizza pizza; 5 6 if (type.equals("cheese")) { 7 pizza = new CheesePizza(); 8 } else if (type.equals("greek")) { 9 pizza = new GreekPizza(); 10 } else if (type.equals("pepperoni")) { 11 pizza = new PepperoniPizza(); 12 } 13 14 pizza.prepare(); 15 pizza.bake(); 16 pizza.cut(); 17 pizza.box(); 18 19 return pizza; 20 } 21 22 Note: excellent example of coding to an interface 23 } 24

Creation

Creation code has all the same problems as the code on the previous slide

Preparation

Encapsulate Creation Code

A simple way to encapsulate this code is to put it in a separate class That new class depends on the concrete classes, but those dependencies no longer impact the preparation code
1 public class PizzaStore { 2 3 private SimplePizzaFactory factory; 4 5 public PizzaStore(SimplePizzaFactory factory) { 6 this.factory = factory; 7 } 8 9 public Pizza orderPizza(String type) { 10 11 Pizza pizza = factory.createPizza(type); 12 13 pizza.prepare(); 14 pizza.bake(); 15 pizza.cut(); 16 pizza.box(); 17 18 return pizza; 19 } 20 21 } 22

1 public class SimplePizzaFactory { 2 3 public Pizza createPizza(String type) { 4 if (type.equals("cheese")) { 5 return new CheesePizza(); 6 } else if (type.equals("greek")) { 7 return new GreekPizza(); 8 } else if (type.equals("pepperoni")) { 9 return new PepperoniPizza(); 10 } 11 } 12 13 } 14

Class Diagram of New Solution

Client
PIzzaStore orderPizza(): Pizza

factory

SimplePizzaFactory createPizza(): Pizza

Factory Products
Pizza prepare() bake() cut() box()

CheesePizza

VeggiePizza

PepperoniPizza

While this is nice, its not as exible as it can be: to increase exibility we need to look at two design patterns: Factory Method and Abstract Factory
6

Factory Method
To demonstrate the factory method pattern, the pizza store example evolves to include the notion of different franchises that exist in different parts of the country (California, New York, Chicago) Each franchise will need its own factory to create pizzas that match the proclivities of the locals However, we want to retain the preparation process that has made PizzaStore such a great success The Factory Method Design Pattern allows you to do this by placing abstract, code to an interface code in a superclass placing object creation code in a subclass PizzaStore becomes an abstract class with an abstract createPizza() method We then create subclasses that override createPizza() for each region

New PizzaStore Class

1 public abstract class PizzaStore { 2 protected abstract createPizza(String type); 3 4 public Pizza orderPizza(String type) { 5 6 Pizza pizza = createPizza(type); 7 8 pizza.prepare(); 9 pizza.bake(); 10 pizza.cut(); 11 pizza.box(); 12 13 return pizza; 14 } 15 16 17 } 18

Factory Method
This class is a (very simple) OO framework. The framework provides one service prepare pizza. The framework invokes the createPizza() factory method to create a pizza that it can prepare using a welldened, consistent process. A client of the framework will subclass this class and provide an implementation of the createPizza() method. Any dependencies on concrete product classes are encapsulated in the subclass.
8

Beautiful Abstract Base Class!

New York Pizza Store

1 public class NYPizzaStore extends PizzaStore { public Pizza createPizza(String type) { 2 if (type.equals("cheese")) { 3 return new NYCheesePizza(); 4 } else if (type.equals("greek")) { 5 return new NYGreekPizza(); 6 } else if (type.equals("pepperoni")) { 7 return new NYPepperoniPizza(); 8 } 9 return null; 10 } 11 12 } 13

Nice and Simple. If you want a NY-Style Pizza, you create an instance of this class and call orderPizza() passing in the type. The subclass makes sure that the pizza is created using the correct style. If you need a different style, create a new subclass.
9

Factory Method: Denition and Structure

The factory method design pattern denes an interface for creating an object, but lets subclasses decide which class to instantiate. Factory Method lets a class defer instantiation to subclasses
Product Creator factoryMethod(): Product operation()

ConcreteProduct

ConcreteCreator factoryMethod(): ConcreteProduct

Factory Method leads to the creation of parallel class hierarchies; ConcreteCreators produce instances of ConcreteProducts that are operated on by Creators via the Product interface
10

Dependency Inversion Principle

Factory Method is one way of following the dependency inversion principle Depend upon abstractions. Do not depend upon concrete classes. Normally high-level classes depend on low-level classes; Instead, they BOTH should depend on an abstract interface DependentPizzaStore depends on eight concrete Pizza subclasses PizzaStore, however, depends on the Pizza interface as do the Pizza subclasses In this design, PizzaStore (the high-level class) no longer depends on the Pizza subclasses (the low level classes); they both depend on the abstraction Pizza. Nice.

11

Dependency Inversion Principle: How To?

To achieve the dependency inversion principle in your own designs, follow these GUIDELINES No variable should hold a reference to a concrete class No class should derive from a concrete class No method should override an implemented method of its base classes These are guidelines because if you were to blindly follow these instructions, you would never produce a system that could be compiled or executed Instead use them as instructions to help optimize your design And remember, not only should low-level classes depend on abstractions, but high-level classes should to this is the very embodiment of code to an interface

12

Demonstration
Lets look at some code The FactoryMethod directory of this lectures src.zip le contains an implementation of the pizza store using the factory method design pattern It even includes a le called DependentPizzaStore.java that shows how the code would be implemented without using this pattern DependentPizzaStore is dependent on 8 different concrete classes and 1 abstract interface (Pizza) PizzaStore is dependent on just the Pizza abstract interface (nice!) Each of its subclasses is only dependent on 4 concrete classes furthermore, they shield the superclass from these dependencies

13

Moving On
The factory method approach to the pizza store is a big success allowing our company to create multiple franchises across the country quickly and easily But, bad news, we have learned that some of the franchises while following our procedures (the abstract code in PizzaStore forces them to) are skimping on ingredients in order to lower costs and increase margins Our companys success has always been dependent on the use of fresh, quality ingredients so Something Must Be Done!

14

Abstract Factory to the Rescue!

We will alter our design such that a factory is used to supply the ingredients that are needed during the pizza creation process Since different regions use different types of ingredients, well create region-specic subclasses of the ingredient factory to ensure that the right ingredients are used But, even with region-specic requirements, since we are supplying the factories, well make sure that ingredients that meet our quality standards are used by all franchises Theyll have to come up with some other way to lower costs.

15

First, We need a Factory Interface

1 public interface PizzaIngredientFactory { 2 public Dough createDough(); 3 public Sauce createSauce(); 4 public Cheese createCheese(); 5 public Veggies[] createVeggies(); 6 public Pepperoni createPepperoni(); 7 public Clams createClam(); 8 9 10 } 11

Note the introduction of more abstract classes: Dough, Sauce, Cheese, etc.
16

Second, We implement a Region-Specic Factory

1 public class ChicagoPizzaIngredientFactory 2 implements PizzaIngredientFactory 3 { 4 5 public Dough createDough() { 6 return new ThickCrustDough(); 7 } 8 9 public Sauce createSauce() { 10 return new PlumTomatoSauce(); 11 } 12 13 public Cheese createCheese() { 14 return new MozzarellaCheese(); 15 } 16 17 public Veggies[] createVeggies() { 18 Veggies veggies[] = { new BlackOlives(), 19 new Spinach(), 20 new Eggplant() }; 21 return veggies; 22 } 23 24 public Pepperoni createPepperoni() { 25 return new SlicedPepperoni(); 26 } 27 28 public Clams createClam() { 29 return new FrozenClams(); 30 } 31 } 32

This factory ensures that quality ingredients are used during the pizza creation process while also taking into account the tastes of people who live in Chicago But how (or where) is this factory used?

17

Within Pizza Subclasses (I)

1 public abstract class Pizza { 2 String name; 3 4 Dough dough; 5 Sauce sauce; 6 Veggies veggies[]; 7 Cheese cheese; 8 Pepperoni pepperoni; 9 Clams clam; 10 11 abstract void prepare(); 12 13 void bake() { 14 System.out.println("Bake for 25 minutes at 350"); 15 } 16 17 void cut() { 18 System.out.println("Cutting the pizza into diagonal slices"); 19 } 20 21 void box() { 22 System.out.println("Place pizza in official PizzaStore box"); 23 } 24 25 void setName(String name) { 26 this.name = name; 27 } 28 29 String getName() {

First, alter the Pizza abstract base class to make the prepare method abstract
18

Within Pizza Subclasses (II)

1 public class CheesePizza extends Pizza { PizzaIngredientFactory ingredientFactory; 2 3 public CheesePizza(PizzaIngredientFactory ingredientFactory) { 4 this.ingredientFactory = ingredientFactory; 5 } 6 7 void prepare() { 8 System.out.println("Preparing " + name); 9 dough = ingredientFactory.createDough(); 10 sauce = ingredientFactory.createSauce(); 11 cheese = ingredientFactory.createCheese(); 12 } 13 14 } 15

Then, update Pizza subclasses to make use of the factory! Note: we no longer need subclasses like NYCheesePizza and ChicagoCheesePizza because the ingredient factory now handles regional differences
19

One last step

1 public class ChicagoPizzaStore extends PizzaStore { 2 3 protected Pizza createPizza(String item) { 4 Pizza pizza = null; 5 PizzaIngredientFactory ingredientFactory = 6 new ChicagoPizzaIngredientFactory(); 7 8 if (item.equals("cheese")) { 9 10 pizza = new CheesePizza(ingredientFactory); 11 pizza.setName("Chicago Style Cheese Pizza"); 12 13 } else if (item.equals("veggie")) { 14 15 pizza = new VeggiePizza(ingredientFactory); 16 pizza.setName("Chicago Style Veggie Pizza"); 17 18 } else if (item.equals("clam")) { 19 20 pizza = new ClamPizza(ingredientFactory); 21 pizza.setName("Chicago Style Clam Pizza"); 22 23 } else if (item.equals("pepperoni")) { 24 25 pizza = new PepperoniPizza(ingredientFactory); 26 pizza.setName("Chicago Style Pepperoni Pizza"); 27

We need to update our PizzaStore subclasses to create the appropriate ingredient factory and pass it to each Pizza subclass in the createPizza factory method.
20

Summary: What did we just do?

1. We created an ingredient factory interface to allow for the creation of a family of ingredients for a particular pizza 2. This abstract factory gives us an interface for creating a family of products 2.1.The factory interface decouples the client code from the actual factory implementations that produce context-specic sets of products 3. Our client code (PizzaStore) can then pick the factory appropriate to its region, plug it in, and get the correct style of pizza (Factory Method) with the correct set of ingredients (Abstract Factory)

21

Demonstration
Examine and execute the code located in the Abstract Factory directory of the src.zip le associated with this lecture

22

Abstract Factory: Denition and Structure

The abstract factory design pattern provides an interface for creating families of related or dependent objects without specifying their concrete classes
AbstractFactory Interface createProductA(): AbstractProductA createProductB(): AbstractProductB

factory

Client

ConcreteFactoryA createProductA(): ProductA1 createProductB(): ProductB1

ConcreteFactoryB createProductA(): ProductA2 createProductB(): ProductB2

AbstractProductA Interface

AbstractProductB Interface

ProductA1

ProductA2

ProductB1

ProductB2

23

Wrapping Up
All factories encapsulate object creation Simple Factory is not a bona de design pattern but it is simple to understand and implement Factory Method relies on inheritance: object creation occurs in subclasses Abstract Factory relies on composition: object creation occurs in concrete factories Both can be used to shield your applications from concrete classes And both can aide you in applying the dependency inversion principle in your designs

24

Coming Up Next
Lecture 22: Singleton and Command Patterns Read Chapters 5 and 6 of the Design Patterns Textbook Lecture 23: Adapters and Template Methods Read Chapters 7 and 8 of the Design Patterns Textbook

25