com.googlecode.gwt.test.assertions.BaseWidgetAssert Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of gwt-test-utils Show documentation

There is a newer version: 0.63

package com.googlecode.gwt.test.assertions;

import com.google.gwt.user.client.ui.UIObject;
import com.google.gwt.user.client.ui.Widget;

/**
 * Base class for all {@link Widget} assertions.
 * 
 * @author Gael Lazzari
 * 
 * @param  used to simulate "self types." For more information please read "Emulating 'self types' using Java Generics to simplify fluent API
 *           implementation."
 * @param  the type of the "actual" value.
 */
public abstract class BaseWidgetAssert, A extends Widget> extends
         BaseUIObjectAssert {

   /**
    * Creates a new {@link BaseWidgetAssert}.
    * 
    * @param actual the actual value to verify.
    * @param selfType the "self type."
    */
   protected BaseWidgetAssert(A actual, Class selfType) {
      super(actual, selfType);
   }

   /**
    * Verifies that the actual {@link Widget} is currently attached to the browser's document (i.e.,
    * there is an unbroken chain of widgets between this widget and the underlying browser
    * document).
    * 
    * @return this assertion object.
    * @throws AssertionError if the actual {@link UIObject} is not visible.
    */
   public S isAttached() {
      if (actual.isAttached())
         return myself;

      throw failWithMessage("should be attached");
   }

   /**
    * Verifies that the actual {@link Widget} is not currently attached to the browser's document
    * (i.e., there is a broken chain of widgets between this widget and the underlying browser
    * document).
    * 
    * @return this assertion object.
    * @throws AssertionError if the actual {@link UIObject} is visible.
    */
   public S isNotAttached() {
      if (!actual.isAttached())
         return myself;

      throw failWithMessage("should not be attached");

   }

}