code: public boolean restoreState(Object savedState) {
          if (savedState instanceof SavedState) {
              if (((SavedState) savedState).restoreState(this)) {
                  iSavedState = savedState;
                  return true;
              }
          }
          return false;
      }
docs: Restores the state of this bucket from a previously saved state. The
  state object passed into this method is not consumed, and it can be used
  later to restore to that state again.
  
  @param savedState opaque saved state, returned from saveState
  @return true state object is valid and state restored