org.assertj.db.api.assertions.AssertOnColumnContent 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;
import java.util.UUID;
/**
* Defines the assertion methods on the content of a column.
*
* @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 AssertOnColumnContent> {
/**
* Verifies that the values of a column contains objects.
*
* Example where the assertion verifies that the values in the first {@code Column} of the {@code Table} are containing
* the objects in parameter :
*
*
*
* assertThat(table).column().containsValues(Locale.FRENCH, Locale.ENGLISH, Locale.FRENCH);
*
*
* @param expected The expected object values.
* @return {@code this} assertion object.
* @throws AssertionError If the column are not containing the objects in parameter.
* @see org.assertj.db.api.AbstractColumnAssert#containsValues(Object...)
*/
T containsValues(Object... expected);
/**
* Verifies that the values of a column contains booleans.
*
* Example where the assertion verifies that the values in the first {@code Column} of the {@code Table} are containing
* the booleans in parameter :
*
*
*
* assertThat(table).column().containsValues(true, false, true);
*
*
* @param expected The expected boolean values.
* @return {@code this} assertion object.
* @throws AssertionError If the column are not containing the booleans in parameter.
* @see org.assertj.db.api.AbstractColumnAssert#containsValues(Boolean...)
*/
T containsValues(Boolean... expected);
/**
* Verifies that the values of a column contains numbers.
*
* Example where the assertion verifies that the values in the first {@code Column} of the {@code Table} are containing
* the numbers in parameter :
*
*
*
* assertThat(table).column().containsValues(5, 10.5, 6);
*
*
* @param expected The expected numbers values.
* @return {@code this} assertion object.
* @throws AssertionError If the column are not containing the numbers in parameter.
* @see org.assertj.db.api.AbstractColumnAssert#containsValues(Number...)
*/
T containsValues(Number... expected);
/**
* Verifies that the values of a column contains bytes.
*
* Example where the assertion verifies that the values in the first {@code Column} of the {@code Table} are containing
* arrays of bytes loaded from files in the classpath :
*
*
*
* byte[] bytes1 = bytesContentFromClassPathOf("file1.png");
* byte[] bytes2 = bytesContentFromClassPathOf("file2.png");
* assertThat(table).column().containsValues(bytes1, bytes2);
*
*
* @param expected The expected bytes values.
* @return {@code this} assertion object.
* @throws AssertionError If the column are not containing the bytes in parameter.
* @see org.assertj.db.api.AbstractColumnAssert#containsValues(byte[]...)
*/
T containsValues(byte[]... expected);
/**
* Verifies that the values of a column contains texts.
*
* Example where the assertion verifies that the values in the first {@code Column} of the {@code Table} are containing
* the texts in parameter :
*
*
*
* assertThat(table).column().containsValues("text", "text2", "text3");
*
*
* @param expected The expected text values.
* @return {@code this} assertion object.
* @throws AssertionError If the column are not containing the texts in parameter.
* @see org.assertj.db.api.AbstractColumnAssert#containsValues(String...)
*/
T containsValues(String... expected);
/**
* Verifies that the values of a column contains characters.
*
* Example where the assertion verifies that the values in the first {@code Column} of the {@code Table} are containing
* the characters in parameter :
*
*
*
* assertThat(table).column().containsValues('t', 'e', 'x', 't');
*
*
* @param expected The expected character values.
* @return {@code this} assertion object.
* @throws AssertionError If the column are not containing the characters in parameter.
* @see org.assertj.db.api.AbstractColumnAssert#containsValues(Character...)
* @since 1.2.0
*/
T containsValues(Character... expected);
/**
* Verifies that the values of a column containsUUIDs.
*
* Example where the assertion verifies that the values in the first {@code Column} of the {@code Table} are containing
* the UUIDs in parameter :
*
*
*
* assertThat(table).column().containsValues(UUID.fromString("30B443AE-C0C9-4790-9BEC-CE1380808435"),
* UUID.fromString("16319617-AE95-4087-9264-D3D21BF611B6"), UUID.fromString("D735221B-5DE5-4112-AA1E-49090CB75ADA"));
*
*
* @param expected The expected UUID values.
* @return {@code this} assertion object.
* @throws AssertionError If the column are not containing the UUIDs in parameter.
* @see org.assertj.db.api.AbstractColumnAssert#containsValues(java.util.UUID...)
*/
T containsValues(UUID... expected);
/**
* Verifies that the values of a column contains date values.
*
* Example where the assertion verifies that the values in the first {@code Column} of the {@code Table} are containing
* the date values in parameter :
*
*
*
* assertThat(table).column().containsValues(DateValue.of(2014, 7, 7), DateValue.of(2014, 10, 3),
* DateValue.of(2014, 12, 23));
*
*
* @param expected The expected date values.
* @return {@code this} assertion object.
* @throws AssertionError If the column are not containing the date values in parameter.
* @see org.assertj.db.api.AbstractColumnAssert#containsValues(org.assertj.db.type.DateValue...)
*/
T containsValues(DateValue... expected);
/**
* Verifies that the values of a column contains time values.
*
* Example where the assertion verifies that the values in the first {@code Column} of the {@code Table} are containing
* the time values in parameter :
*
*
*
* assertThat(table).column().containsValues(TimeValue.of(21, 29, 30), TimeValue.of(10, 1, 25), TimeValue.of(9, 1));
*
*
* @param expected The expected time values.
* @return {@code this} assertion object.
* @throws AssertionError If the column are not containing the time values in parameter.
* @see org.assertj.db.api.AbstractColumnAssert#containsValues(org.assertj.db.type.TimeValue...)
*/
T containsValues(TimeValue... expected);
/**
* Verifies that the values of a column contains date/time values.
*
* Example where the assertion verifies that the values in the first {@code Column} of the {@code Table} are containing
* the date/time values in parameter :
*
*
*
* assertThat(table).column().containsValues(DateTimeValue.of(DateValue.of(2014, 7, 7), TimeValue.of(21, 29)),
* DateTimeValue.of(DateValue.of(2014, 7, 7), TimeValue.of(10, 1, 25)),
* DateTimeValue.of(DateValue.of(2014, 7, 7), TimeValue.of(9, 1)));
*
*
* @param expected The expected date/time values.
* @return {@code this} assertion object.
* @throws AssertionError If the column are not containing the date/time values in parameter.
* @see org.assertj.db.api.AbstractColumnAssert#containsValues(org.assertj.db.type.DateTimeValue...)
*/
T containsValues(DateTimeValue... expected);
}