assert.java

MoMEUnit是一个单元测试的J2ME的应用程序xUnit架构实例。这是来自JUnit框架

   * Asserts that two booleans are equal. If they are not throws an
   * AssertionFailedError.
   * 
   * @param expected
   *          boolean to be tested.
   * @param actual
   *          boolean to be tested.
   * @since 1.0
   */
  static public void assertEquals(boolean expected, boolean actual)
  {
    assertEquals(null, expected, actual);
  }

  /**
   * Asserts that two bytes are equal. If they are not throws an
   * AssertionFailedError with the given message.
   * 
   * @param message
   *          descriptive message of failure.
   * @param expected
   *          byte to be tested.
   * @param actual
   *          byte to be tested.
   * @since 1.0
   */
  static public void assertEquals(String message, byte expected, byte actual)
  {
    assertEquals(message, new Byte(expected), new Byte(actual));
  }

  /**
   * Asserts that two bytes are equal. If they are not throws an
   * AssertionFailedError.
   * 
   * @param expected
   *          byte to be tested.
   * @param actual
   *          byte to be tested.
   * @since 1.0
   */
  static public void assertEquals(byte expected, byte actual)
  {
    assertEquals(null, expected, actual);
  }

  /**
   * Asserts that two chars are equal. If they are not throws an
   * AssertionFailedError with the given message.
   * 
   * @param message
   *          descriptive message of failure.
   * @param expected
   *          char to be tested.
   * @param actual
   *          char to be tested.
   * @since 1.0
   */
  static public void assertEquals(String message, char expected, char actual)
  {
    assertEquals(message, new Character(expected), new Character(actual));
  }

  /**
   * Asserts that two chars are equal. If they are not throws an
   * AssertionFailedError.
   * 
   * @param expected
   *          char to be tested.
   * @param actual
   *          char to be tested.
   * @since 1.0
   */
  static public void assertEquals(char expected, char actual)
  {
    assertEquals(null, expected, actual);
  }

  /**
   * Asserts that two shorts are equal. If they are not throws an
   * AssertionFailedError with the given message.
   * 
   * @param message
   *          descriptive message of failure.
   * @param expected
   *          short to be tested.
   * @param actual
   *          short to be tested.
   * @since 1.0
   */
  static public void assertEquals(String message, short expected, short actual)
  {
    assertEquals(message, new Short(expected), new Short(actual));
  }

  /**
   * Asserts that two shorts are equal. If they are not throws an
   * AssertionFailedError.
   * 
   * @param expected
   *          short to be tested.
   * @param actual
   *          short to be tested.
   * 
   * @since 1.0
   */
  static public void assertEquals(short expected, short actual)
  {
    assertEquals(null, expected, actual);
  }

  /**
   * Asserts that two ints are equal. If they are not throws an
   * AssertionFailedError with the given message.
   * 
   * @param message
   *          descriptive message of failure.
   * @param expected
   *          int to be tested.
   * @param actual
   *          int to be tested.
   * @since 1.0
   */
  static public void assertEquals(String message, int expected, int actual)
  {
    assertEquals(message, new Integer(expected), new Integer(actual));
  }

  /**
   * Asserts that two ints are equal. If they are not throws an
   * AssertionFailedError.
   * 
   * @param expected
   *          int to be tested.
   * @param actual
   *          int to be tested.
   * @since 1.0
   */
  static public void assertEquals(int expected, int actual)
  {
    assertEquals(null, expected, actual);
  }

  /**
   * Asserts that an object isn't null. If it is null throws an
   * AssertionFailedError.
   * 
   * @param object
   *          to test.
   * @since 1.0
   */
  static public void assertNotNull(Object object)
  {
    assertNotNull(null, object);
  }

  /**
   * Asserts that an object isn't null. If it is null throws an
   * AssertionFailedError with the given message.
   * 
   * @param message
   *          descriptive message of failure.
   * @param object
   *          to test.
   * @since 1.0
   */
  static public void assertNotNull(String message, Object object)
  {
    assertTrue(message, object != null);
  }

  /**
   * Asserts that an object is null. If it is not null throws an
   * AssertionFailedError.
   * 
   * @param object
   *          to test.
   * @since 1.0
   */
  static public void assertNull(Object object)
  {
    assertNull(null, object);
  }

  /**
   * Asserts that an object is null. If it is not null throws an
   * AssertionFailedError with the given message.
   * 
   * @param message
   *          descriptive message of failure.
   * @param object
   *          to test.
   * @since 1.0
   */
  static public void assertNull(String message, Object object)
  {
    assertTrue(message, object == null);
  }

  /**
   * Asserts that two objects refer to the same object. If they are not throws
   * AssertionFailedError with the given message.
   * 
   * @param message
   *          descriptive message of failure.
   * @param expected
   *          object to test.
   * @param actual
   *          object to test.
   * @since 1.0
   */
  static public void assertSame(String message, Object expected, Object actual)
  {
    if (expected != actual) failNotSame(message, expected, actual);
  }

  /**
   * Asserts that two objects refer to the same object. If they are not throws
   * AssertionFailedError.
   * 
   * @param expected
   *          object to test.
   * @param actual
   *          object to test.
   * @since 1.0
   */
  static public void assertSame(Object expected, Object actual)
  {
    assertSame(null, expected, actual);
  }

  /**
   * Asserts that two objects don't refer to the same object. If they are throws
   * AssertionFailedError with the given message.
   * 
   * @param message
   *          descriptive message of failure.
   * @param expected
   *          object to test.
   * @param actual
   *          object to test.
   * @since 1.0
   */
  static public void assertNotSame(String message, Object expected,
      Object actual)
  {
    if (expected == actual) failSame(message);
  }

  /**
   * Asserts that two objects don't refer to the same object. If they are throws
   * AssertionFailedError.
   * 
   * @param expected
   *          object to test.
   * @param actual
   *          object to test.
   * @since 1.0
   */
  static public void assertNotSame(Object expected, Object actual)
  {
    assertNotSame(null, expected, actual);
  }

  /**
   * Throws {@link AssertionFailedError} for same assertion with the specified
   * message.
   * 
   * @param message
   *          descriotive message.
   * @since 1.0
   */
  static private void failSame(String message)
  {
    String formatted = "";
    if (message != null) formatted = message + " ";
    fail(formatted + "expected not same");
  }

  /**
   * Throws {@link AssertionFailedError} for not same assertion with the
   * specified message.
   * 
   * @param message
   *          descriotive message.
   * @param expected
   *          object to test.
   * @param actual
   *          object to test.
   * @since 1.0
   */
  static private void failNotSame(String message, Object expected, Object actual)
  {
    String formatted = "";
    if (message != null) formatted = message + " ";
    fail(formatted + "expected same:<" + expected + "> was not:<" + actual
        + ">");
  }

  /**
   * Throws {@link AssertionFailedError} for not equal assertion with the
   * specified message.
   * 
   * @param message
   *          descriotive message.
   * @param expected
   *          object to test.
   * @param actual
   *          object to test.
   * @since 1.0
   */
  static private void failNotEquals(String message, Object expected,
      Object actual)
  {
    fail(format(message, expected, actual));
  }

  /**
   * Returns the formatted message based on specified message and compared
   * objects.
   * 
   * @param message
   *          descriotive message.
   * @param expected
   *          expected tested object.
   * @param actual
   *          actual tested object.
   * @return the formatted string.
   * @since 1.0
   */
  static String format(String message, Object expected, Object actual)
  {
    String formatted = "";
    if (message != null) formatted = message + " ";
    return formatted + "expected:<" + expected + "> but was:<" + actual + ">";
  }

}