org.assertj.db.api.navigation

Interface ToValueFromRow<V extends ValueAssert>

Type Parameters:

V - The class of a assertion on a value (an sub-class of ValueAssert).

All Known Subinterfaces:

OriginWithValuesFromRow

All Known Implementing Classes:

AbstractRowAssert, AbstractRowValueAssert, ChangeRowAssert, ChangeRowValueAssert, RequestRowAssert, RequestRowValueAssert, TableRowAssert, TableRowValueAssert

public interface ToValueFromRow<V extends ValueAssert>

Defines methods to navigate to a value from a Row.

The different methods return an assertion on one value ValueAssert.

These methods exists when navigating (at the beginning assertThat()) from changes, from a Table or from a Request.

As shown in the diagram below, if navigating from table or request, it is possible to call the method to navigate to a ValueAssert from :

• a row (AbstractRowAssert)
• a value of a row (AbstractRowValueAssert)

If navigating from table or request, it is important to keep in mind that the methods are executed from the point of view of the last instance with assertion methods on a row (AbstractRowAssert).
So all the lines of code below are equivalent : they point on the value called "name" of first column.

 
 assertThat(table_or_request).row().value("name")......;                                // Point directly on the value called "name"
 assertThat(table_or_request).row().value().returnToOrigin().value("name")......;       // Use the returnToOrigin() method of AbstractAssertWithOrigin
                                                                                        // to return on the table or request and access to the value called "name"
 assertThat(table_or_request).row().value().value("name")......;                        // Same as precedent but returnToOrigin() is implicit
 assertThat(table_or_request).row().value(2).value(0).value("name")......;              // Idem
 assertThat(table_or_request).row().value().row().value("name")......;
 // Equivalent to the precedent but with the use of the returnToOrigin() method of AbstractAssertWithOrigin
 assertThat(table_or_request).row().value().returnToOrigin().returnToOrigin().row().value("name")......;
 
 

As shown in the diagram below, if navigating from changes, it is possible to call the method to navigate to a ValueAssert from :

• a row of a change (ChangeRowAssert)
• a value of a row of a change (ChangeRowValueAssert)

If navigating from changes, it is important to keep in mind that the methods are executed from the point of view of the last instance with assertion methods on a row of a change (ChangeRowAssert).
So all the lines of code below are equivalent : they point on the value called "name" of first row.

 
 assertThat(changes).change().row().value("name")......;                                 // Point directly on the value called "name"
 // Use the returnToOrigin() method of AbstractAssertWithOrigin to return on the row and access to the value called "name"
 assertThat(changes).change().row().value().returnToOrigin().value("name")......;
 assertThat(changes).change().row().value().value("name")......;                         // Same as precedent but returnToOrigin() is implicit
 assertThat(changes).change().row().value(2).value(0).value("name")......;               // Idem
 assertThat(changes).change().row().value().change(0).row().value("name")......;
 // Equivalent to the precedent but with the use of the returnToOrigin() method of AbstractAssertWithOrigin
 assertThat(changes).change().row().value().returnToOrigin().returnToOrigin().returnToOrigin().change(0).row().value("name")......;
 
 

Author:

Régis Pouiller

Method Summary

Methods

Modifier and Type	Method and Description
V	value(String columnName) Returns assertion methods on the value corresponding to the column name in parameter.

Method Detail

value

V value(String columnName)

Returns assertion methods on the value corresponding to the column name in parameter.

Parameters:

columnName - The column name.

Returns:

An object to make assertions on the value.

Throws:

NullPointerException - If the column name in parameter is null.

AssertJDBException - If there is no column with this name.

See Also:

AbstractRowAssert.value(String), AbstractRowValueAssert.value(String), ChangeRowAssert.value(String), ChangeRowValueAssert.value(String)