org.assertj.db.navigation.ToChanges Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of assertj-db Show documentation
AssertJ-DB - Rich and fluent assertions for testing with database
There is a newer version: 2.0.2
/*
 * 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.ChangesElement;

/**
 * Defines methods to navigate to changes or to a {@link org.assertj.db.type.Change}.
 * The different methods return an assertion on changes {@link org.assertj.db.api.ChangesAssert}.
 * These methods exists when navigating (at the beginning {@code assertThat()}) from changes.
 * As shown in the diagram below, it is possible to call the method to navigate to changes from :
 * 
 *     changes ({@link org.assertj.db.api.ChangesAssert})
 *     another change ({@link org.assertj.db.api.ChangeAssert})
 *     a column of a change ({@link org.assertj.db.api.ChangeColumnAssert})
 *     a value of a column of a change ({@link org.assertj.db.api.ChangeColumnValueAssert})
 *     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})
 * 
 * 
 * 
 * 
 * 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 changes ({@link org.assertj.db.api.ChangesAssert}).

 * So all the lines of code below are equivalent : they point on all the changes.
 * 
 *  * 
 * assertThat(changes)......;                                               // Point on all the changes
 * assertThat(changes).ofAll()......;                                       // Idem
 * assertThat(changes).change().returnToChanges().ofAll()......;             // Use the returnToChanges() to return to origin
 *                                                                          // to return on the changes and access to the next/second change of the list
 * assertThat(changes).change().ofAll()......;                              // Same as precedent but returnToChanges() is implicit
 * assertThat(changes).change().column().ofAll()......;
 * assertThat(changes).change().rowAtEndPoint().ofAll()......;
 * assertThat(changes).change().column().value().ofAll()......;
 * assertThat(changes).change().rowAtEndPoint().value().ofAll()......;
 * // Equivalent to the precedent but with the use of the methods to return to origin
 * assertThat(changes).change().rowAtEndPoint().value().returnToRow().returnToChange().returnToChanges().ofAll()......;
 * 
 * 
 * @author Régis Pouiller
 *
 * @param  The class of a assertion on changes (an sub-class of {@link org.assertj.db.navigation.element.ChangesElement}).
 */
public interface ToChanges extends Navigation {

  /**
   * Returns an assertion of all the changes.
   *
   * @return An object to make assertions on all the changes.
   * @see org.assertj.db.api.ChangesAssert#ofAll()
   * @see org.assertj.db.api.ChangeAssert#ofAll()
   * @see org.assertj.db.api.ChangeColumnAssert#ofAll()
   * @see org.assertj.db.api.ChangeColumnValueAssert#ofAll()
   * @see org.assertj.db.api.ChangeRowAssert#ofAll()
   * @see org.assertj.db.api.ChangeRowValueAssert#ofAll()
   */
  CHS ofAll();

  /**
   * Returns an assertion of the changes of creation ({@link org.assertj.db.type.ChangeType#CREATION}).
   *
   * @return An object to make assertions on the changes of creation ({@link org.assertj.db.type.ChangeType#CREATION}).
   * @see org.assertj.db.api.ChangesAssert#ofCreation()
   * @see org.assertj.db.api.ChangeAssert#ofCreation()
   * @see org.assertj.db.api.ChangeColumnAssert#ofCreation()
   * @see org.assertj.db.api.ChangeColumnValueAssert#ofCreation()
   * @see org.assertj.db.api.ChangeRowAssert#ofCreation()
   * @see org.assertj.db.api.ChangeRowValueAssert#ofCreation()
   */
  CHS ofCreation();

  /**
   * Returns an assertion of the changes of modification ({@link org.assertj.db.type.ChangeType#MODIFICATION}).
   *
   * @return An object to make assertions on the changes of modification ({@link org.assertj.db.type.ChangeType#MODIFICATION}).
   * @see org.assertj.db.api.ChangesAssert#ofModification()
   * @see org.assertj.db.api.ChangeAssert#ofModification()
   * @see org.assertj.db.api.ChangeColumnAssert#ofModification()
   * @see org.assertj.db.api.ChangeColumnValueAssert#ofModification()
   * @see org.assertj.db.api.ChangeRowAssert#ofModification()
   * @see org.assertj.db.api.ChangeRowValueAssert#ofModification()
   */
  CHS ofModification();

  /**
   * Returns an assertion of the changes of deletion ({@link org.assertj.db.type.ChangeType#DELETION}).
   *
   * @return An object to make assertions on the changes of deletion ({@link org.assertj.db.type.ChangeType#DELETION}).
   * @see org.assertj.db.api.ChangesAssert#ofDeletion()
   * @see org.assertj.db.api.ChangeAssert#ofDeletion()
   * @see org.assertj.db.api.ChangeColumnAssert#ofDeletion()
   * @see org.assertj.db.api.ChangeColumnValueAssert#ofDeletion()
   * @see org.assertj.db.api.ChangeRowAssert#ofDeletion()
   * @see org.assertj.db.api.ChangeRowValueAssert#ofDeletion()
   */
  CHS ofDeletion();

  /**
   * Returns an assertion of the changes of creation ({@link org.assertj.db.type.ChangeType#CREATION}) on a table.
   *
   * @param tableName The table name
   * @return An object to make assertions on the changes of creation ({@link org.assertj.db.type.ChangeType#CREATION}) on the table.
   * @see org.assertj.db.api.ChangesAssert#ofCreationOnTable(String)
   * @see org.assertj.db.api.ChangeAssert#ofCreationOnTable(String)
   * @see org.assertj.db.api.ChangeColumnAssert#ofCreationOnTable(String)
   * @see org.assertj.db.api.ChangeColumnValueAssert#ofCreationOnTable(String)
   * @see org.assertj.db.api.ChangeRowAssert#ofCreationOnTable(String)
   * @see org.assertj.db.api.ChangeRowValueAssert#ofCreationOnTable(String)
   */
  CHS ofCreationOnTable(String tableName);

  /**
   * Returns an assertion of the changes of modification ({@link org.assertj.db.type.ChangeType#MODIFICATION}) on a table.
   *
   * @param tableName The table name
   * @return An object to make assertions on the changes of modification ({@link org.assertj.db.type.ChangeType#MODIFICATION}) on the table.
   * @see org.assertj.db.api.ChangesAssert#ofModificationOnTable(String)
   * @see org.assertj.db.api.ChangeAssert#ofModificationOnTable(String)
   * @see org.assertj.db.api.ChangeColumnAssert#ofModificationOnTable(String)
   * @see org.assertj.db.api.ChangeColumnValueAssert#ofModificationOnTable(String)
   * @see org.assertj.db.api.ChangeRowAssert#ofModificationOnTable(String)
   * @see org.assertj.db.api.ChangeRowValueAssert#ofModificationOnTable(String)
   */
  CHS ofModificationOnTable(String tableName);

  /**
   * Returns an assertion of the changes of deletion ({@link org.assertj.db.type.ChangeType#DELETION}) on a table.
   *
   * @param tableName The table name
   * @return An object to make assertions on the changes of deletion ({@link org.assertj.db.type.ChangeType#DELETION}) on the table.
   * @see org.assertj.db.api.ChangesAssert#ofDeletionOnTable(String)
   * @see org.assertj.db.api.ChangeAssert#ofDeletionOnTable(String)
   * @see org.assertj.db.api.ChangeColumnAssert#ofDeletionOnTable(String)
   * @see org.assertj.db.api.ChangeColumnValueAssert#ofDeletionOnTable(String)
   * @see org.assertj.db.api.ChangeRowAssert#ofDeletionOnTable(String)
   * @see org.assertj.db.api.ChangeRowValueAssert#ofDeletionOnTable(String)
   */
  CHS ofDeletionOnTable(String tableName);

  /**
   * Returns an assertion of the changes on a table.
   *
   * @param tableName The table name
   * @return An object to make assertions on the changes on the table.
   * @see org.assertj.db.api.ChangesAssert#onTable(String)
   * @see org.assertj.db.api.ChangeAssert#onTable(String)
   * @see org.assertj.db.api.ChangeColumnAssert#onTable(String)
   * @see org.assertj.db.api.ChangeColumnValueAssert#onTable(String)
   * @see org.assertj.db.api.ChangeRowAssert#onTable(String)
   * @see org.assertj.db.api.ChangeRowValueAssert#onTable(String)
   */
  CHS onTable(String tableName);
}