com.googlecode.gwt.test.assertions.GwtGenericAssert Maven / Gradle / Ivy
package com.googlecode.gwt.test.assertions;
import com.googlecode.gwt.test.utils.GwtReflectionUtils;
import org.assertj.core.api.AbstractAssert;
import org.assertj.core.description.Description;
import org.assertj.core.error.BasicErrorMessageFactory;
import org.assertj.core.internal.Failures;
import org.assertj.core.presentation.StandardRepresentation;
import static java.lang.String.format;
import static org.assertj.core.error.ShouldBeEqual.shouldBeEqual;
/**
* Template for all gwt-test-utils assertions.
*
* @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.
* @author Gael Lazzari
*/
public abstract class GwtGenericAssert, A> extends
AbstractAssert {
protected final GwtWritableAssertionInfo gwtInfo;
private final Failures failures = Failures.instance();
/**
* Creates a new {@link GwtGenericAssert}.
*
* @param actual the actual value to verify.
* @param selfType the "self type."
*/
protected GwtGenericAssert(A actual, Class selfType) {
super(actual, selfType);
// hack because assertj "info" is not configurable..
gwtInfo = new GwtWritableAssertionInfo();
GwtReflectionUtils.setPrivateFieldValue(this, "info", gwtInfo);
}
/**
* Sets the description of this object.
*
* @param description the new description to set.
* @param args the args used to fill description as in {@link String#format(String, Object...)}.
* @return {@code this} object.
* @throws NullPointerException if the description is {@code null}.
* @see #describedAs(String, Object...)
*/
@Override
public S as(String description, Object... args) {
return describedAs(format(description, args));
}
/**
* Prefixes the assertion {@link Description} with a raw prefix string.
*
* @param prefix the error message prefix.
* @return this assertion object.
*/
public S withPrefix(String prefix) {
this.gwtInfo.prefix(prefix);
return myself;
}
/**
* Returns a {@link AssertionError} describing an assertion failure. A default
* description is set if the default error message is not overrided and a custom description is
* not applied. In both case, the resulting description would be prefixed by the message
* eventually supplied through {@link GwtGenericAssert#withPrefix(String)}.
*
* @param format the format string.
* @param arguments arguments referenced by the format specifiers in the format string.
* @return a {@code AssertionError} describing the assertion failure based on the supplied
* message.
*/
@Override
protected void failWithMessage(String format, Object... arguments) {
GwtWritableAssertionInfo info = new GwtWritableAssertionInfo();
info.prefix(gwtInfo.prefix());
info.overridingErrorMessage(gwtInfo.overridingErrorMessage());
Description d = gwtInfo.superDescription();
String newDescription = d != null ? d.value() : this.actual.getClass().getSimpleName();
info.description(newDescription);
throw failures.failure(info, new BasicErrorMessageFactory(format, arguments));
}
/**
* Returns a {@link AssertionError} describing a property comparison failure. A
* default description is set if the default error message is not overrided and a custom
* description is not applied. In both case, the resulting description would be prefixed by the
* message eventually supplied through {@link GwtGenericAssert#withPrefix(String)}.
*
* @param propertyName the compared property name
* @param actual the actual value.
* @param expected the expected value.
* @return a {@code AssertionError} describing the comparison failure.
*/
protected AssertionError propertyComparisonFailed(String propertyName, Object actual,
Object expected) {
GwtWritableAssertionInfo info = new GwtWritableAssertionInfo();
info.prefix(gwtInfo.prefix());
info.overridingErrorMessage(gwtInfo.overridingErrorMessage());
Description d = gwtInfo.superDescription();
String newDescription = d != null ? d.value() + " " + propertyName
: this.actual.getClass().getSimpleName() + "'s " + propertyName;
info.description(newDescription);
return failures.failure(info, shouldBeEqual(actual, expected, new StandardRepresentation()));
}
}