com.fitbur.assertj.api.AbstractObjectAssert Maven / Gradle / Ivy

* Private fields are matched by default but this can be changed by calling {@link Assertions#setAllowExtractingPrivateFields(boolean) Assertions.setAllowExtractingPrivateFields(false)}. *

* * Example: *

 public class TolkienCharacter {
   *
   *   private String name;
   *   private int age;
   *   // constructor omitted
   *      
   *   public String getName() {
   *     return this.name;
   *   }
   * }
   *
   * TolkienCharacter frodo = new TolkienCharacter("Frodo", 33);
   * 
   * // assertions will pass :
   * assertThat(frodo).hasFieldOrProperty("name")
   *                  .hasFieldOrProperty("age"); // private field are matched by default
   *         
   * // assertions will fail :
   * assertThat(frodo).hasFieldOrProperty("not_exists");
   * assertThat(frodo).hasFieldOrProperty(null);
   * // disable looking for private fields
   * Assertions.setAllowExtractingPrivateFields(false);
   * assertThat(frodo).hasFieldOrProperty("age"); 

* Private fields are matched by default but this can be changed by calling {@link Assertions#setAllowExtractingPrivateFields(boolean) Assertions.setAllowExtractingPrivateFields(false)}. *

* * Example: *

 public class TolkienCharacter {
   *   private String name;
   *   private int age;
   *   // constructor omitted
   *
   *   public String getName() {
   *     return this.name;
   *   }
   * }
   *
   * TolkienCharacter frodo = new TolkienCharacter("Frodo", 33);
   * TolkienCharacter noname = new TolkienCharacter(null, 33);
   *
   * // assertions will pass :
   * assertThat(frodo).hasFieldOrProperty("name", "Frodo");
   * assertThat(frodo).hasFieldOrProperty("age", 33);
   * assertThat(noname).hasFieldOrProperty("name", null);
   *
   * // assertions will fail :
   * assertThat(frodo).hasFieldOrProperty("name", "not_equals"); 
   * assertThat(frodo).hasFieldOrProperty(null, 33);             
   * assertThat(frodo).hasFieldOrProperty("age", null);          
   * assertThat(noname).hasFieldOrProperty("name", "Frodo");
   * // disable extracting private fields
   * Assertions.setAllowExtractingPrivateFields(false);
   * assertThat(frodo).hasFieldOrProperty("age", 33); 

* If you extract "id", "name" and "email" fields/properties then the array will contain the id, name and email values * of the object under test, you can then perform array assertions on the extracted values. *

* Nested fields/properties are supported, specifying "adress.street.number" is equivalent to get the value * corresponding to actual.getAdress().getStreet().getNumber() *

* Private fields can be extracted unless you call {@link Assertions#setAllowExtractingPrivateFields(boolean) Assertions.setAllowExtractingPrivateFields(false)}. *

* Example: *

 // Create frodo, setting its name, age and Race (Race having a name property)
   * TolkienCharacter frodo = new TolkienCharacter("Frodo", 33, HOBBIT);
   * 
   * // let's verify Frodo's name, age and race name:
   * assertThat(frodo).extracting("name", "age", "race.name")
   *                  .containsExactly("Frodo", 33, "Hobbit");

* Note that the order of extracted property/field values is consistent with the iteration order of the array under * test. * * @param propertiesOrFields the properties/fields to extract from the initial array under test * @return a new assertion object whose object under test is the array containing the extracted properties/fields values * @throws IntrospectionError if one of the given name does not match a field or property */ public AbstractObjectArrayAssert extracting(String... propertiesOrFields) { Tuple values = byName(propertiesOrFields).extract(actual); return new ObjectArrayAssert