org.assertj.db.api.navigation

Interface ToColumn<C extends ColumnAssert>

Type Parameters:

C - The class of a assertion on a column (an sub-class of ColumnAssert).

All Known Subinterfaces:

OriginWithColumnsAndRows<C,R>, OriginWithColumnsAndRowsFromChange, OriginWithValuesFromColumn, OriginWithValuesFromRow

All Known Implementing Classes:

AbstractAssertWithOriginWithColumnsAndRows, AbstractAssertWithOriginWithColumnsAndRowsFromChange, AbstractAssertWithValues, AbstractColumnAssert, AbstractColumnValueAssert, AbstractDbAssert, AbstractRowAssert, AbstractRowValueAssert, AbstractSubAssert, AbstractValueAssert, ChangeAssert, ChangeColumnAssert, ChangeColumnValueAssert, ChangeRowAssert, ChangeRowValueAssert, RequestAssert, RequestColumnAssert, RequestColumnValueAssert, RequestRowAssert, RequestRowValueAssert, TableAssert, TableColumnAssert, TableColumnValueAssert, TableRowAssert, TableRowValueAssert

public interface ToColumn<C extends ColumnAssert>

Defines methods to navigate to a Column.

The different methods return an assertion on one column ColumnAssert.

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 ColumnAssert from :

• a table (TableAssert)
• a request (RequestAssert)
• a column (AbstractColumnAssert)
• a value of a column (AbstractColumnValueAssert)
• 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 table (TableAssert) or on a request (RequestAssert).
So all the lines of code below are equivalent : they point on the column at index 1 (as usual, the list start at index 0).

 
 assertThat(table_or_request).column(1)......;                                   // Point directly on the column at index 1
 assertThat(table_or_request).column().returnToColumn().column()......;          // Use the returnToColumn() method to return to origin
                                                                                 // to return on the table or request and access to the next/second column of the list
 assertThat(table_or_request).column().column()......;                           // Same as precedent but returnToColumn() is implicit
 assertThat(table_or_request).column().column(1)......;                          // The method with the index can be call too
 assertThat(table_or_request).column(2).column(0).column(1)......;               // Idem
 assertThat(table_or_request).column().value().column()......;
 assertThat(table_or_request).column().value().column(1)......;
 // Equivalent to the precedent but with the use of the methods to return to origin
 assertThat(table_or_request).column().value().returnToColumn().returnToChange().column(1)......;
 
 

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

• a change (ChangeAssert)
• a column of a change (ChangeColumnAssert)
• a value of a column of a change (ChangeColumnValueAssert)
• 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 change (ChangeAssert).
So all the lines of code below are equivalent : they point on the column at index 1 (as usual, the list start at index 0).

 
 assertThat(changes).change().column(1)......;                                   // Point directly on the column at index 1
 // Use the returnToChange() method to return on the change and access to the next/second column of the list
 assertThat(changes).change().column().returnToChange().column()......;
 assertThat(changes).change().column().column()......;                           // Same as precedent but returnToChange() is implicit
 assertThat(changes).change().column().column(1)......;                          // The method with the index can be call too
 assertThat(changes).change().column(2).column(0).column(1)......;               // Idem
 assertThat(changes).change().column().value().column()......;
 assertThat(changes).change().column().value().column(1)......;
 // Equivalent to the precedent but with the use of the methods to return to origin
 assertThat(changes).change().column().value().returnToColumn().returnToChange().column(1)......;
 
 

Author:

Régis Pouiller

Method Summary

Modifier and Type	Method and Description
C	column() Returns assertion methods on the next Column in the list of Columns.
C	column(int index) Returns assertion methods on the Column at the index in parameter.
C	column(String columnName) Returns assertion methods on the Column corresponding to the column name in parameter.

Method Detail

column

C column()

Returns assertion methods on the next Column in the list of Columns.

Returns:

An object to make assertions on the next Column.

Throws:

AssertJDBException - If there are no more Column in the list of Columns.

See Also:

AbstractDbAssert.column(), AbstractDbAssert.column(), AbstractAssertWithOriginWithColumnsAndRows.column(), AbstractAssertWithOriginWithColumnsAndRows.column(), AbstractAssertWithOriginWithColumnsAndRows.column(), AbstractAssertWithOriginWithColumnsAndRows.column(), ChangeAssert.column(), AbstractAssertWithOriginWithColumnsAndRowsFromChange.column(), AbstractAssertWithOriginWithColumnsAndRowsFromChange.column(), AbstractAssertWithOriginWithColumnsAndRowsFromChange.column(), AbstractAssertWithOriginWithColumnsAndRowsFromChange.column()

column

C column(int index)

Returns assertion methods on the Column at the index in parameter.

Parameters:

index - The index corresponding to the Column.

Returns:

An object to make assertions on the Column.

Throws:

AssertJDBException - If the index is out of the bounds.

See Also:

AbstractDbAssert.column(int), AbstractDbAssert.column(int), AbstractAssertWithOriginWithColumnsAndRows.column(int), AbstractAssertWithOriginWithColumnsAndRows.column(int), AbstractAssertWithOriginWithColumnsAndRows.column(int), AbstractAssertWithOriginWithColumnsAndRows.column(int), ChangeAssert.column(int), AbstractAssertWithOriginWithColumnsAndRowsFromChange.column(int), AbstractAssertWithOriginWithColumnsAndRowsFromChange.column(int), AbstractAssertWithOriginWithColumnsAndRowsFromChange.column(int), AbstractAssertWithOriginWithColumnsAndRowsFromChange.column(int)

column

C column(String columnName)

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

Parameters:

columnName - The column name.

Returns:

An object to make assertions on the Column.

Throws:

NullPointerException - If the column name in parameter is null.

AssertJDBException - If there is no Column with this name.

See Also:

AbstractDbAssert.column(String), AbstractDbAssert.column(String), AbstractAssertWithOriginWithColumnsAndRows.column(String), AbstractAssertWithOriginWithColumnsAndRows.column(String), AbstractAssertWithOriginWithColumnsAndRows.column(String), AbstractAssertWithOriginWithColumnsAndRows.column(String), ChangeAssert.column(String), AbstractAssertWithOriginWithColumnsAndRowsFromChange.column(String), AbstractAssertWithOriginWithColumnsAndRowsFromChange.column(String), AbstractAssertWithOriginWithColumnsAndRowsFromChange.column(String), AbstractAssertWithOriginWithColumnsAndRowsFromChange.column(String)