org.assertj.db.navigation.ToValue 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.navigation;
import org.assertj.db.navigation.element.ValueElement;
/**
* Defines methods to navigate to a value.
* The different methods return an assertion on one value {@link org.assertj.db.navigation.element.ValueElement}.
* These methods exists when navigating (at the beginning {@code assertThat()}) from changes, from a {@link org.assertj.db.type.Table} or from a {@link org.assertj.db.type.Request}.
* As shown in the diagram below, if navigating from table or request, it is possible to call the method to navigate to a {@link org.assertj.db.navigation.element.ValueElement} from :
*
* - a column ({@link org.assertj.db.api.AbstractColumnAssert})
* - a value of a column ({@link org.assertj.db.api.AbstractColumnValueAssert})
* - a row ({@link org.assertj.db.api.AbstractRowAssert})
* - a value of a row ({@link org.assertj.db.api.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 column ({@link org.assertj.db.api.AbstractColumnAssert}) or on a row ({@link org.assertj.db.api.AbstractRowAssert}).
* So all the lines of code below are equivalent : they point on the value at index 1 (as usual, the list start at index 0) of first column.
*
*
*
* assertThat(table_or_request).column().value(1)......; // Point directly on the value at index 1
* assertThat(table_or_request).column().value().returnToColumn().value()......; // Use the returnToColumn() method to return to origin
* // to return on the column and access to the next/second value of the list
* assertThat(table_or_request).column().value().value()......; // Same as precedent but returnToColumn() is implicit
* assertThat(table_or_request).column().value().value(1)......; // The method with the index can be call too
* assertThat(table_or_request).column().value(2).value(0).value(1)......; // Idem
* assertThat(table_or_request).column().value().column().value(1)......;
* // Equivalent to the precedent but with the use of the methods to return to origin
* assertThat(table).column().value().returnToColumn().returnToTable().column().value(1)......;
* assertThat(request).column().value().returnToColumn().returnToRequest().column().value(1)......;
*
*
* As shown in the diagram below, if navigating from changes, it is possible to call the method to navigate to a {@link org.assertj.db.navigation.element.ValueElement} from :
*
* - a row of a change ({@link org.assertj.db.api.ChangeRowAssert})
* - a value of a row of a change ({@link org.assertj.db.api.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 ({@link org.assertj.db.api.ChangeRowAssert}).
* So all the lines of code below are equivalent : they point on the value at index 1 (as usual, the list start at index 0) of first row.
*
*
*
* assertThat(changes).change().row().value(1)......; // Point directly on the value at index 1
* // Use the returnToRow() method return on the row and access to the next/second value of the list
* assertThat(changes).change().row().value().returnToRow().value()......;
* assertThat(changes).change().row().value().value()......; // Same as precedent but returnToRow() is implicit
* assertThat(changes).change().row().value().value(1)......; // The method with the index can be call too
* assertThat(changes).change().row().value(2).value(0).value(1)......; // Idem
* assertThat(changes).change().row().value().change(0).row().value(1)......;
* // Equivalent to the precedent but with the use of the methods to return to origin
* assertThat(changes).change().row().value().returnToRow().returnToChange().returnToChanges().change(0).row().value(1)......;
*
*
*
* @author Régis Pouiller
*
* @param The class of a assertion on a value (an sub-class of {@link org.assertj.db.navigation.element.ValueElement}).
*/
public interface ToValue extends Navigation {
/**
* Returns assertion methods on the next value in the list of values.
*
* @return An object to make assertions on the next value.
* @throws org.assertj.db.exception.AssertJDBException If there are no more value in the list of values.
* @see org.assertj.db.api.AbstractColumnAssert#value()
* @see org.assertj.db.api.AbstractColumnValueAssert#value()
* @see org.assertj.db.api.AbstractRowAssert#value()
* @see org.assertj.db.api.AbstractRowValueAssert#value()
* @see org.assertj.db.api.ChangeRowAssert#value()
* @see org.assertj.db.api.ChangeRowValueAssert#value()
*/
V value();
/**
* Returns assertion methods on the value at the {@code index} in parameter.
*
* @param index The index corresponding to the value.
* @return An object to make assertions on the value.
* @throws org.assertj.db.exception.AssertJDBException If the {@code index} is out of the bounds.
* @see org.assertj.db.api.AbstractColumnAssert#value(int)
* @see org.assertj.db.api.AbstractColumnValueAssert#value(int)
* @see org.assertj.db.api.AbstractRowAssert#value(int)
* @see org.assertj.db.api.AbstractRowValueAssert#value(int)
* @see org.assertj.db.api.ChangeRowAssert#value(int)
* @see org.assertj.db.api.ChangeRowValueAssert#value(int)
*/
V value(int index);
}