org.assertj.db.api.assertions.AssertOnValueCloseness Maven / Gradle / Ivy
Show all versions of assertj-db Show documentation
/*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
* an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
* specific language governing permissions and limitations under the License.
*
* Copyright 2015-2020 the original author or authors.
*/
package org.assertj.db.api.assertions;
import org.assertj.db.type.DateTimeValue;
import org.assertj.db.type.DateValue;
import org.assertj.db.type.TimeValue;
/**
* Defines the assertion methods on the closeness of a value.
*
* @param The "self" type of this assertion class. Please read "Emulating 'self types' using Java Generics to simplify fluent API implementation"
* for more details.
* @author Régis Pouiller
* @since 1.1.0
*/
public interface AssertOnValueCloseness> {
/**
* Verifies that the value is close to a number.
*
* Example where the assertion verifies that the value in the first {@code Column} of the first {@code Row} of the
* {@code Table} is close to number 3 with a tolerance of 1 (that means that all the numbers between 2 and 4
* included are close enough) :
*
*
*
*
* assertThat(table).row().value().isCloseTo(3, 1);
*
*
*
* Example where the assertion verifies that the value in the first {@code Column} of the {@code Row} at end point
* of the first {@code Change} is close to number 3 with a tolerance of 0.75 :
*
*
*
*
* assertThat(changes).change().rowAtEndPoint().value().isCloseTo(3, 0.75);
*
*
*
* @param expected The expected number value.
* @param tolerance The tolerance of the closeness.
* @return {@code this} assertion object.
* @throws AssertionError If the value is not close to the number in parameter.
* @see org.assertj.db.api.AbstractValueAssert#isCloseTo(Number, Number)
* @see org.assertj.db.api.AbstractAssertWithValues#isCloseTo(Number, Number)
*/
T isCloseTo(Number expected, Number tolerance);
/**
* Verifies that the value is close to a date.
*
* Example where the assertion verifies that the value in the first {@code Column} of the first {@code Row} of the
* {@code Table} is close to a date value with a tolerance of 2 days :
*
*
*
*
* assertThat(table).row().value().isCloseTo(DateValue.of(2014, 7, 7), DateValue.of(0, 0, 2));
*
*
*
* Example where the assertion verifies that the value in the first {@code Column} of the {@code Row} at end point
* of the first {@code Change} is close to a date value with a tolerance of 2 days :
*
*
*
*
* assertThat(changes).change().rowAtEndPoint().value().isCloseTo(DateValue.of(2014, 7, 7), DateValue.of(0, 0, 2));
*
*
*
* @param expected The expected date value.
* @param tolerance The tolerance of the closeness.
* @return {@code this} assertion object.
* @throws AssertionError If the value is not close to the date in parameter.
* @see org.assertj.db.api.AbstractValueAssert#isCloseTo(DateValue, DateValue)
* @see org.assertj.db.api.AbstractAssertWithValues#isCloseTo(DateValue, DateValue)
*/
T isCloseTo(DateValue expected, DateValue tolerance);
/**
* Verifies that the value is close to a date.
*
* Example where the assertion verifies that the value in the first {@code Column} of the first {@code Row} of the
* {@code Table} is close to a date value with a tolerance of 1 hour :
*
*
*
*
* assertThat(table).row().value().isCloseTo(DateValue.of(2014, 7, 7), TimeValue.of(1, 0));
*
*
*
* Example where the assertion verifies that the value in the first {@code Column} of the {@code Row} at end point
* of the first {@code Change} is close to a date value with a tolerance of 1 hour :
*
*
*
*
* assertThat(changes).change().rowAtEndPoint().value().isCloseTo(DateValue.of(2014, 7, 7), TimeValue.of(1, 0));
*
*
*
* @param expected The expected date value.
* @param tolerance The tolerance of the closeness.
* @return {@code this} assertion object.
* @throws AssertionError If the value is not close to the date in parameter.
* @see org.assertj.db.api.AbstractValueAssert#isCloseTo(DateValue, TimeValue)
* @see org.assertj.db.api.AbstractAssertWithValues#isCloseTo(DateValue, TimeValue)
*/
T isCloseTo(DateValue expected, TimeValue tolerance);
/**
* Verifies that the value is close to a date.
*
* Example where the assertion verifies that the value in the first {@code Column} of the first {@code Row} of the
* {@code Table} is close to a date value with a tolerance of 2 days and 1 hour :
*
*
*
*
* assertThat(table).row().value().isCloseTo(DateValue.of(2014, 7, 7),
* DateTimeValue.of(DateValue.of(0, 0, 2), TimeValue.of(1, 0)));
*
*
*
* Example where the assertion verifies that the value in the first {@code Column} of the {@code Row} at end point
* of the first {@code Change} is close to a date value with a tolerance of 2 days and 1 hour :
*
*
*
*
* assertThat(changes).change().rowAtEndPoint().value().isCloseTo(DateValue.of(2014, 7, 7),
* DateTimeValue.of(DateValue.of(0, 0, 2), TimeValue.of(1, 0)));
*
*
*
* @param expected The expected date value.
* @param tolerance The tolerance of the closeness.
* @return {@code this} assertion object.
* @throws AssertionError If the value is not close to the date in parameter.
* @see org.assertj.db.api.AbstractValueAssert#isCloseTo(DateValue, DateTimeValue)
* @see org.assertj.db.api.AbstractAssertWithValues#isCloseTo(DateValue, DateTimeValue)
*/
T isCloseTo(DateValue expected, DateTimeValue tolerance);
/**
* Verifies that the value is close to a time.
*
* Example where the assertion verifies that the value in the first {@code Column} of the first {@code Row} of the
* {@code Table} is close to a time value with a tolerance of 1 hour :
*
*
*
*
* assertThat(table).row().value().isCloseTo(TimeValue.of(21, 29, 30), TimeValue.of(1, 0));
*
*
*
* Example where the assertion verifies that the value in the first {@code Column} of the {@code Row} at end point
* of the first {@code Change} is close to a time value with a tolerance of 1 hour :
*
*
*
*
* assertThat(changes).change().rowAtEndPoint().value().isCloseTo(TimeValue.of(21, 29, 30), TimeValue.of(1, 0));
*
*
*
* @param expected The expected time value.
* @param tolerance The tolerance of the closeness.
* @return {@code this} assertion object.
* @throws AssertionError If the value is not close to the time in parameter.
* @see org.assertj.db.api.AbstractValueAssert#isCloseTo(TimeValue, TimeValue)
* @see org.assertj.db.api.AbstractAssertWithValues#isCloseTo(TimeValue, TimeValue)
*/
T isCloseTo(TimeValue expected, TimeValue tolerance);
/**
* Verifies that the value is close to a date/time.
*
* Example where the assertion verifies that the value in the first {@code Column} of the first {@code Row} of the
* {@code Table} is close to a date/time value with a tolerance of 2 days :
*
*
*
*
* assertThat(table).row().value().isCloseTo(DateTimeValue.of(DateValue.of(2014, 7, 7), TimeValue.of(21, 29, 30)),
* DateValue.of(0, 0, 2));
*
*
*
* Example where the assertion verifies that the value in the first {@code Column} of the {@code Row} at end point
* of the first {@code Change} is close to a date/time value with a tolerance of 2 days :
*
*
*
*
* assertThat(changes).change().rowAtEndPoint().value().isCloseTo(
* DateTimeValue.of(DateValue.of(2014, 7, 7), TimeValue.of(21, 29, 30)),
* DateValue.of(0, 0, 2));
*
*
*
* @param expected The expected date/time value.
* @param tolerance The tolerance of the closeness.
* @return {@code this} assertion object.
* @throws AssertionError If the value is not close to the date/time in parameter.
* @see org.assertj.db.api.AbstractValueAssert#isCloseTo(DateTimeValue, DateValue)
* @see org.assertj.db.api.AbstractAssertWithValues#isCloseTo(DateTimeValue, DateValue)
*/
T isCloseTo(DateTimeValue expected, DateValue tolerance);
/**
* Verifies that the value is close to a date/time.
*
* Example where the assertion verifies that the value in the first {@code Column} of the first {@code Row} of the
* {@code Table} is close to a date/time value with a tolerance of 1 hour :
*
*
*
*
* assertThat(table).row().value().isCloseTo(DateTimeValue.of(DateValue.of(2014, 7, 7), TimeValue.of(21, 29, 30)),
* TimeValue.of(1, 0));
*
*
*
* Example where the assertion verifies that the value in the first {@code Column} of the {@code Row} at end point
* of the first {@code Change} is close to a date/time value with a tolerance of 1 hour :
*
*
*
*
* assertThat(changes).change().rowAtEndPoint().value().isCloseTo(
* DateTimeValue.of(DateValue.of(2014, 7, 7), TimeValue.of(21, 29, 30)),
* TimeValue.of(1, 0));
*
*
*
* @param expected The expected date/time value.
* @param tolerance The tolerance of the closeness.
* @return {@code this} assertion object.
* @throws AssertionError If the value is not close to the date/time in parameter.
* @see org.assertj.db.api.AbstractValueAssert#isCloseTo(DateTimeValue, TimeValue)
* @see org.assertj.db.api.AbstractAssertWithValues#isCloseTo(DateTimeValue, TimeValue)
*/
T isCloseTo(DateTimeValue expected, TimeValue tolerance);
/**
* Verifies that the value is close to a date/time.
*
* Example where the assertion verifies that the value in the first {@code Column} of the first {@code Row} of the
* {@code Table} is close to a date/time value with a tolerance of 2 days and 1 hour :
*
*
*
*
* assertThat(table).row().value().isCloseTo(DateTimeValue.of(DateValue.of(2014, 7, 7), TimeValue.of(21, 29, 30)),
* DateTimeValue.of(DateValue.of(0, 0, 2), TimeValue.of(1, 0)));
*
*
*
* Example where the assertion verifies that the value in the first {@code Column} of the {@code Row} at end point
* of the first {@code Change} is close to a date/time value with a tolerance of 2 days and 1 hour :
*
*
*
*
* assertThat(changes).change().rowAtEndPoint().value().isCloseTo(
* DateTimeValue.of(DateValue.of(2014, 7, 7), TimeValue.of(21, 29, 30)),
* DateTimeValue.of(DateValue.of(0, 0, 2), TimeValue.of(1, 0)));
*
*
*
* @param expected The expected date/time value.
* @param tolerance The tolerance of the closeness.
* @return {@code this} assertion object.
* @throws AssertionError If the value is not close to the date/time in parameter.
* @see org.assertj.db.api.AbstractValueAssert#isCloseTo(DateTimeValue, DateTimeValue)
* @see org.assertj.db.api.AbstractAssertWithValues#isCloseTo(DateTimeValue, DateTimeValue)
*/
T isCloseTo(DateTimeValue expected, DateTimeValue tolerance);
}