State Design Pattern 1.2 2008/06/26 14:54:12 GMT-5 2008/07/22 11:10:55.535 GMT-5 Stephen Wong swong@rice.edu Dung X. Nguyen dxnguyen@rice.edu Stephen Wong swong@rice.edu Dung X. Nguyen dxnguyen@rice.edu design dynamic reclassification encapsulation object oriented OOD OOP pattern programming state The State Design Pattern models objects that changes state, i.e. change behavior as a result of what has happened to them. This is also called "dynamic reclassification". Objects are often discussed in terms of having a "state" that describes their exact conditions in a given time, based upon the values of their properties. The particular values of the properties affect the object's behavior. For instance, one can say that the exact behavior of an object's getColor() method is different if the "color" property of the given object is set to "blue" instead of "red" because getColor() returns a different value in the two situations. Furthermore, the object may make decisions at run time as to exactly what to do dependent upon the values its properties possess. For instance, if the sky is blue (sky.setColor(Color.blue)), then the sun should be visible.


public boolean sunIsVisible() {
    if(getColor()==Color.blue) {
        return true;
    }
    else {
        return false;
    }
}

One issue with the above solution is that it is a hard-coded logic solution, not an architected solution. The sky does not intrinsically behave a certain way if it is blue, but rather it should figure out what to do in that situation. Wouldn't it be better if the sky intrinsically acted properly if it were blue? One could imagine two objects: a SkyBlue and a SkyNonBlue. The SkyBlue class' sunIsVisible() method would always return true while the SkyNonBlue version would always return false. What one needs now is the ability for a sky object to dynamically (i.e. at run time) change its class to/from SkyBlue and SkyNonBlue. What we'd like to accomplish is called "dynamic reclassification". We've seen code that does change its specific behavior depending on what particular strategy was installed. So, the setColor() method could install a strategy that would always return true if its sunIsVisible() method were to be called. But does the user of the Sky class care about the stratregy?

The State Design Pattern is a fully encapsulated, self-modifying Strategy Design Pattern.

UML Class Diagram of the State Design Pattern One design pattern that is used very often in conjunction with the state pattern is the Null Object Pattern. Notice these things about the pattern: Any methods whose behaviors depend on the state of the object are simply delegated on in to the state, and handled there. Thus you will see the same methods in the context as in the states. Since the states are separate objects from the context, all the properties of the context need to have accessor methods that are at least package visible. The "Context" object needs to add a "set" accessor method so the states can modify which state is the active state. This method would be package visible so as to encapsulate the behavior away from the sight of the user.