From f7f1027d02c5c1e6fc3639ca225cb93929dae5ab Mon Sep 17 00:00:00 2001 From: Marc Philipp Date: Fri, 13 Nov 2026 11:12:34 +0100 Subject: [PATCH 01/13] Add Antora-based documentation Migrate the AssertJ DB user guide from assertj/doc to an Antora component in `docs`. The component version and the `assertj-db-version` attribute are taken from `docs/pom.xml`, which also compiles the included example. Build the site in the CI workflow and let Dependabot update the Maven and npm dependencies of `docs`. --- .github/dependabot.yml | 8 + .github/workflows/build.yml | 14 +- docs/.gitignore | 2 + docs/antora-playbook.yml | 17 + docs/antora-resources/antora.yml | 19 + docs/antora.yml | 14 + docs/modules/ROOT/images/assertj-db_icon.png | Bin 0 -> 114573 bytes .../ROOT/images/db-changes-concept.png | Bin 0 -> 1681 bytes docs/modules/ROOT/nav.adoc | 5 + docs/modules/ROOT/pages/concepts.adoc | 1081 ++++++++++ docs/modules/ROOT/pages/features.adoc | 1762 +++++++++++++++++ docs/modules/ROOT/pages/index.adoc | 38 + docs/modules/ROOT/pages/quickstart.adoc | 79 + docs/modules/ROOT/pages/release-notes.adoc | 239 +++ docs/package.json | 7 + docs/pom.xml | 104 + .../example/db/TableAssertionExamples.java | 49 + 17 files changed, 3437 insertions(+), 1 deletion(-) create mode 100644 docs/.gitignore create mode 100644 docs/antora-playbook.yml create mode 100644 docs/antora-resources/antora.yml create mode 100644 docs/antora.yml create mode 100644 docs/modules/ROOT/images/assertj-db_icon.png create mode 100644 docs/modules/ROOT/images/db-changes-concept.png create mode 100644 docs/modules/ROOT/nav.adoc create mode 100644 docs/modules/ROOT/pages/concepts.adoc create mode 100644 docs/modules/ROOT/pages/features.adoc create mode 100644 docs/modules/ROOT/pages/index.adoc create mode 100644 docs/modules/ROOT/pages/quickstart.adoc create mode 100644 docs/modules/ROOT/pages/release-notes.adoc create mode 100644 docs/package.json create mode 100644 docs/pom.xml create mode 100644 docs/src/test/java/example/db/TableAssertionExamples.java diff --git a/.github/dependabot.yml b/.github/dependabot.yml index 06c31a89..12417830 100644 --- a/.github/dependabot.yml +++ b/.github/dependabot.yml @@ -18,3 +18,11 @@ updates: github-actions: patterns: - "*" + - package-ecosystem: "maven" + directory: "/docs" + schedule: + interval: "weekly" + - package-ecosystem: "npm" + directory: "/docs" + schedule: + interval: "weekly" diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 320e27fc..18221a8a 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -24,7 +24,19 @@ jobs: java-version: '21' cache: 'maven' - name: Build with Maven - run: ./mvnw -B verify javadoc:javadoc + run: ./mvnw -B install javadoc:javadoc + - name: Set up Node.js + uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0 + with: + node-version: '26' + - name: Generate documentation + run: ./mvnw -B -f docs test-compile antora -Dnode.executable=node + - name: Upload documentation + uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2 + with: + name: docs + if-no-files-found: error + path: docs/target/site # - name: Sonar Analysis # if: ${{ github.event_name == 'push' || github.event.pull_request.head.repo.full_name == github.repository }} # run: ./mvnw -B sonar:sonar diff --git a/docs/.gitignore b/docs/.gitignore new file mode 100644 index 00000000..050c6035 --- /dev/null +++ b/docs/.gitignore @@ -0,0 +1,2 @@ +/node_modules +/target diff --git a/docs/antora-playbook.yml b/docs/antora-playbook.yml new file mode 100644 index 00000000..c2dd461e --- /dev/null +++ b/docs/antora-playbook.yml @@ -0,0 +1,17 @@ +antora: + extensions: + - '@antora/collector-extension' +site: + title: AssertJ Docs + start_page: assertj-db::index.adoc +content: + sources: + - url: ./.. # the local repository, relative to this playbook + branches: HEAD # use the worktree so that uncommitted changes are included + start_path: docs +ui: + bundle: + url: https://github.com/assertj/antora-ui/releases/latest/download/ui-bundle.zip + snapshot: true +output: + dir: ./target/site diff --git a/docs/antora-resources/antora.yml b/docs/antora-resources/antora.yml new file mode 100644 index 00000000..86f57c2a --- /dev/null +++ b/docs/antora-resources/antora.yml @@ -0,0 +1,19 @@ +version: ${antora-component.version} +prerelease: ${antora-component.prerelease} +asciidoc: + attributes: + idprefix: '' + idseparator: '-' + tabsize: '3' + source-indent: '0' + assertj-db-version: '${project.version}' + assertj-core-github: 'https://github.com/assertj/assertj' + assertj-doc-github: 'https://github.com/assertj/doc' + assertj-examples-github: 'https://github.com/assertj/assertj-examples' + assertj-examples-base-package: 'https://github.com/assertj/assertj-examples/blob/main/assertions-examples/src/test/java/org/assertj/examples' + assertj-guava-github: 'https://github.com/assertj/assertj' + assertj-swing-github: 'https://github.com/assertj/assertj-swing' + release-branch: 'main' + current-branch: 'https://github.com/assertj/assertj/tree/main' + AssertJ: 'https://assertj.github.io/doc/[AssertJ]' + StackOverflow: 'https://stackoverflow.com/questions/tagged/assertj[Stack Overflow]' diff --git a/docs/antora.yml b/docs/antora.yml new file mode 100644 index 00000000..a163db1f --- /dev/null +++ b/docs/antora.yml @@ -0,0 +1,14 @@ +name: assertj-db +title: AssertJ DB +version: true +nav: + - modules/ROOT/nav.adoc +ext: + collector: + - run: + command: ./mvnw -q -f docs process-resources + local: true + scan: + - dir: docs/target/antora + - dir: docs/src/test/java + into: modules/ROOT/examples/java diff --git a/docs/modules/ROOT/images/assertj-db_icon.png b/docs/modules/ROOT/images/assertj-db_icon.png new file mode 100644 index 0000000000000000000000000000000000000000..4911df1b1099a23226824135eed30a6eb043390c GIT binary patch literal 114573 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 literal 0 HcmV?d00001 diff --git a/docs/modules/ROOT/images/db-changes-concept.png b/docs/modules/ROOT/images/db-changes-concept.png new file mode 100644 index 0000000000000000000000000000000000000000..02cad892fd17c98b90b8e9de344a25853a335e1c GIT binary patch literal 1681 zcmV;C25$L@P)_L3FZ}8*`PCO_c{0n5G zB4jV>LGT?>ylguHa$;2Q?DQ*A|fJ7eeZHP3!`Qh{$vl$VHlAfXSf!FJ;s+mIAp* zbF2eP-q$c{iDV(96v+LIrWe@XozZn>aUPK>?0x6n6t4$6tb&hv=$9y;2Vv5Y%5R=Hb z$;-J&WswL{3goUKrs3yg!7&|7;9ezr04V#Gn07f@M_#rXZw-^Y*w<~>Q9zM8g&H0G zH$jiXjYXlxAin`KR4?hDM?|DZnGP93_8(Q0$+&%RZLs#MRyG+Q$V2B5k#-C9I8vMt z5m``k|J0sp9l3}|Q}|UY{`eGI#p`Yh^}6%N!(636E+R62XF1%-!ge9G+x%X4J#YUy zPB2#>7ZI7ib?1BA#d*uw=JvYlU;_Jwv%in&a@qyBww^MI$Q*Sr8QoIsf=I1$d%h?m z7iosjTq|WqXAY?r#5K*tV)CarUczMN3goDdr!>J^bUcX2l`{vXg49&c2w^1gQpc-vD!CyDO^{Wh8kkv20-85VkIJt-d19O&3!a>rNiF zL^=x%(*mcXN#m7$d%2Mw~Ki&`E_lfhg9CDnldXbRb6i~)XtGR zvW@V(Ig7?$eA)g@LXDnU%1y3HDUd6hsm=z+OiF=V*-Uj+K4nz-lrnCmCHM9A6O%h??H%v6V@I}) zJm-ABMOrQTYnX@C0p^}QL%9cV$c}R^RiP!I4I?|P=(ci>Z=y2oEqUE!{VuejbGh641?Q3l zlu|}sMA=N34Vcq(MVoe|r7G)9=8kM53ud9J8xfJD*+xh|=#5)o!)}{&r6s?Qv^#3e zHfnafZFwWxx)gUQ6-ioKGIGh+C##lldwrDcS~(<}hSR>b>e{FNdXu5X=%SHreQ)1B zlUJRINCK9DJAhkb7o^3MQ6KdX@GJ09?1D)1C?h}WLEwAf{n!O*5nDxLox^lTl*}>U zCg6tH1(8zj0Zz>8VhZHa1bs~Kb_e=w`Dwg2~8V#RT*hf#b8jkOH}gNIfnBA38tZ47>sS0K5RK z%<4i4hZc9`z=v?p2sSAaiC9CtgWtJg)~%Nom5mp_4j zV;5o$ek1)ZitasoH}EX52fQ1tMD_TKqromE8^HYq`+ox7#td-#dy)&-K%V*=LPVtL zeg>WaKCSvfJ89MvGc8Ut9ivqz%*9iipJWB&KoGw})v6{RH@L+KVWVi-^=?8F=2?wg$;=Y86BTyoag00000NkvXXu0mjfHA*I9 literal 0 HcmV?d00001 diff --git a/docs/modules/ROOT/nav.adoc b/docs/modules/ROOT/nav.adoc new file mode 100644 index 00000000..00281f97 --- /dev/null +++ b/docs/modules/ROOT/nav.adoc @@ -0,0 +1,5 @@ +* xref:index.adoc[Overview] +* xref:quickstart.adoc[] +* xref:concepts.adoc[] +* xref:features.adoc[] +* xref:release-notes.adoc[] diff --git a/docs/modules/ROOT/pages/concepts.adoc b/docs/modules/ROOT/pages/concepts.adoc new file mode 100644 index 00000000..afb4a087 --- /dev/null +++ b/docs/modules/ROOT/pages/concepts.adoc @@ -0,0 +1,1081 @@ += Concepts + +For the examples below, suppose that the database contains these three tables : + +.MEMBERS +|==== +|ID |NAME |FIRSTNAME |SURNAME |BIRTHDATE |SIZE + +|1 |'Hewson' |'Paul David' |'Bono' |05-10-60 |1.75 +|2 |'Evans' |'David Howell' |'The Edge' |08-08-61 |1.77 +|3 |'Clayton' |'Adam' | |03-13-60 |1.78 +|4 |'Mullen' |'Larry' | |10-31-61 |1.70 +|==== + +.ALBUMS +|==== +|ID |RELEASE |TITLE |NUMBEROFSONGS |DURATION |LIVE + +|1 |10-20-80 |'Boy' |12 |42:17 | +|2 |10-12-81 |'October' |11 |41:08 | +|3 |02-28-83 |'War' |10 |42:07 | +|4 |11-07-83 |'Under a Blood Red Sky' |8 |33:25 |true +|5 |10-01-84 |'The Unforgettable Fire' |10 |42:42 | +|6 |06-10-85 |'Wide Awake in America' |4 |20:30 |true +|7 |03-09-87 |'The Joshua Tree' |11 |50:11 | +|8 |10-10-88 |'Rattle and Hum' |17 |72:27 | +|9 |11-18-91 |'Achtung Baby' |12 |55:23 | +|10 |07-06-93 |'Zooropa' |10 |51:15 | +|11 |03-03-97 |'Pop' |12 |60:08 | +|12 |10-30-00 |'All That You Can't Leave Behind' |11 |49:23 | +|13 |11-22-04 |'How to Dismantle an Atomic Bomb' |11 |49:08 | +|14 |03-02-09 |'No Line on the Horizon' |11 |53:44 | +|15 |09-09-14 |'Songs of Innocence' |11 |48:11 | +|==== + +.GROUP +|==== +|ID |NAME + +|1 |'U2' +|2 |'Coldplay' +|==== + +[[connection]] +== Connection to the database + +To make assertions on a database, it is necessary to connect. The concept of `AssertDbConnection` represent how +AssertJ-DB can retrieve data and schema information from database. + +It's also with a `AssertDbConnection` that you can instantiate the following element : `Table`, `Request`, `Changes`. + +[[assertdbconnection]] +=== AssertDbConnection + +A https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/AssertDbConnection.html[AssertDbConnection] +is created with the factory https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/AssertDbConnectionFactory.html[AssertDbConnectionFactory]. + +There are 2 way to begin the AssertDbConnectionFactory, with a https://docs.oracle.com/javase/6/docs/api/javax/sql/DataSource.html[DataSource] ( the classic Java way +to get a https://docs.oracle.com/javase/6/docs/api/java/sql/Connection.html[Connection] to a database ) or with JDBC connection information. + +Below is an example of using a DataSource to connect to H2 in memory database : + +[source,java] +---- +AssertDbConnection connection = AssertDbConnectionFactory.of("jdbc:h2:mem:test", "sa", "").create(); +---- + +And using a DataSource to connect : + +[source,java] +---- +AssertDbConnection connection = AssertDbConnectionFactory.of(dataSource).create(); +---- + +[[assertdbconnectionlettercase]] +=== LetterCase setup + +https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/AssertDbConnectionFactory.html[AssertDbConnectionFactory] +provide the capacity to indicate the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] +to use for the tables, columns and primary keys. + +[source,java] +---- +AssertDbConnection connection = AssertDbConnectionFactory + .of(dataSource) + .letterCase(tableLetterCase, columnLetterCase, pkLetterCase) + .create(); +---- + +For more information, see the <>. + +[[assertdbconnectionmetadata]] +=== Schema retrieval mode + +Since xref:release-notes.adoc#v1-1-0-release-notes[3.0.0] + +For many assertions, AssertJ-DB require to discover database schema metadata ( list of tables, columns, ... ). +When the schema contains many tables this operation can slow down the tests executions. + +To avoid that and when the database schema is not updated during the test session, you can use the option +https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/SchemaMetaDataMode.html[SchemaMetaDataMode] of +https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/AssertDbConnectionFactory.html[AssertDbConnectionFactory] +to keep in memory the schema. + +Available mode are : + + - DYNAMIC ( default ): Retrieve schema metadata each time is required. + - STATIC : Retrieve schema metadata only once and keep in memory for all duration of connection. + +Below is an example of using the STATIC mode for a connection : + +[source,java] +---- +AssertDbConnection connection = AssertDbConnectionFactory.of(dataSource) + .schemaMetaDataMode(SchemaMetaDataMode.STATIC) + .create(); +---- + +[[elements]] +== Elements of the database + +Here the elements on which it is possible to make assertions. + +Note that, there are only 3 root elements : https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table], + https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.html[Request] +and https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Changes.html[Changes]. + +That means that the other elements are components or sub components of a root element. + +A root element is an element on which the assertion start (in practice, the parameter of a `assertThat(...)` method). + +[[table]] +=== Table + +A https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table] represents +a table in the database. + +A https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table] can be constructed with the builder method `table(String name)` from +https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/AssertDbConnection.html[AssertDbConnection]. + +[source,java] +---- +// Prepare the connection +AssertDbConnection connection = ... +// Declare the "members" table by using a AssertDbConnection table builder +Table table1 = connection.table("members").build(); +---- + +For more information about table construction, see the +https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.Builder.html[Table.Builder] javadoc. + +.Representation of "table1" +|==== +|ID |NAME |FIRSTNAME |SURNAME |BIRTHDATE |SIZE + +|1 |'Hewson' |'Paul David' |'Bono' |05-10-60 |1.75 +|2 |'Evans' |'David Howell' |'The Edge' |08-08-61 |1.77 +|3 |'Clayton' |'Adam' | |03-13-60 |1.78 +|4 |'Mullen' |'Larry' | |10-31-61 |1.70 +|==== + +For a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table], +it is possible to choose the columns to include and to exclude in the assertions. + +[source,java] +---- +// Get the data of the "id" and "name" columns of the "members" table +Table table2 = connection.table("members").columnsToCheck(new String[] { "id", "name" }).build(); +// Get the data of the "members" table but not of the "birthdate" column +Table table3 = connection.table("members").columnsToExclude(new String[] { "birthdate" }).build(); +// Get the data of the "name" column of the "members" table (because "id" is included and excluded) +Table table4 = connection.table("members").columnsToCheck(new String[] { "id", "name" }).columnsToExclude(new String[] { "id" }).build(); +---- + +.Representation of "table2" +|==== +|ID |NAME + +|1 |'Hewson' +|2 |'Evans' +|3 |'Clayton' +|4 |'Mullen' +|==== + +.Representation of "table3" +|==== +|ID |NAME |FIRSTNAME |SURNAME |SIZE + +|1 |'Hewson' |'Paul David' |'Bono' |1.75 +|2 |'Evans' |'David Howell' |'The Edge' |1.77 +|3 |'Clayton' |'Adam' | |1.78 +|4 |'Mullen' |'Larry' | |1.70 +|==== + +.Representation of "table4" +|==== +|NAME + +|'Hewson' +|'Evans' +|'Clayton' +|'Mullen' +|==== + +Since version xref:release-notes.adoc#v1-2-0-release-notes[1.2.0], there are the possibility to indicate delimiters (start delimiter and end delimiter) and `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.Order.html[Order]`. + +The delimiters are useful when the table name or column name is a reserved word or contains special characters (like space or '%'). + `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.Order.html[Order]` allows to choose the order of the `Row`. + +[source,java] +---- +// The line code below throws SQLException because "group" is SQL reserved word +Table table5 = connection.table("group").build(); +// Get the data of the "group" table by using "`" delimiter +// That generates a request +Table table6 = connection.table("group").delimiters('`', '`').build(); + +// Get the data from "members" table and order on "name" column in ascending order +Table table7 = connection.table("members").columnsToOrder(new Order[] { Order.asc("name") }).build(); +---- + +.Representation of "table6" +|==== +|ID |NAME + +|1 |'U2' +|2 |'Colplay' +|==== + +.Representation of "table7" +|==== +|ID |NAME |FIRSTNAME |SURNAME |BIRTHDATE |SIZE + +|3 |'Clayton' |'Adam' | |03-13-60 |1.78 +|2 |'Evans' |'David Howell' |'The Edge' |08-08-61 |1.77 +|1 |'Hewson' |'Paul David' |'Bono' |05-10-60 |1.75 +|4 |'Mullen' |'Larry' | |10-31-61 |1.70 +|==== + +[[request]] +=== Request + +A https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.html[Request] represents +a SQL request on the database. + +Like a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table], +a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.html[Request] +can be constructed with the builder method `request(String sql)` from +https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/AssertDbConnection.html[AssertDbConnection]. + +[source,java] +---- +// Prepare the connection +AssertDbConnection connection = ... +// Declare a request which gets the name and the firstname of the corresponding members +Request request1 = connection.request("select name, firstname from members where id = 2 or id = 3").build(); +---- + +For more information about request construction, see the +https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.Builder.html[Request.Builder] javadoc. + +.Representation of "request1" +|==== +|NAME |FIRSTNAME |SURNAME + +|'Evans' |'David Howell' |'The Edge' +|'Clayton' |'Adam' | +|==== + +For a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.html[Request], +it is possible to use a simple SQL request or a SQL request with one or many parameters. + +[source,java] +---- +// Declare a request which gets the name and the firstname of the members +// and use "%e%" as a parameter +Request request2 = connection.request( + "select name, firstname from members " + + "where name like ?;") + .parameters("%e%") + .build(); +// Declare a request which gets the name and the firstname of the members +// and use "%e%" and "%Paul%" as parameters +Request request3 = connection.request( + "select name, firstname from members " + + "where name like ? and firstname like ?;") + .parameters("%e%", "%Paul%") + .build(); +---- + +.Representation of "request2" +|==== +|NAME |FIRSTNAME |SURNAME + +|'Hewson' |'Paul David' |'Bono' +|'Evans' |'David Howell' |'The Edge' +|'Mullen' |'Larry' | +|==== + +.Representation of "request3" +|==== +|NAME |FIRSTNAME |SURNAME + +|'Hewson' |'Paul David' |'Bono' +|==== + +[[changes]] +=== Changes + +The https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Changes.html[Changes] +are the differences of states in database between a `start point` and a `end point`. + +image::db-changes-concept.png[] + +Assume that there are these SQL statements between the start point and the end point. + +[source,java] +---- +DELETE FROM ALBUMS WHERE ID = 15; +INSERT INTO MEMBERS(ID, NAME, FIRSTNAME) VALUES(5, 'McGuiness', 'Paul'); +UPDATE MEMBERS SET SURNAME = 'Bono Vox' WHERE ID = 1; +UPDATE ALBUMS SET NAME = 'Rattle & Hum', LIVE = true WHERE ID = 8; + +---- + +[source,java] +---- +// Prepare the connection +AssertDbConnection connection = ... +// The changes can be on a DataSource or on a Source +Changes changes1 = connection.changes().build(); +// The changes can also be on a Table or on a Request +Changes changes2 = connection.changes().table(table3).build(); +Changes changes3 = connection.changes().request(request2).build(); +// The names of the columns used for the primary key are found in the metadata for a table +// but for a request it can be important to set the primary key +Changes changes4 = connection.changes().request("select name, firstname from members", r -> r.pksName("name")).build(); +---- + +For more information about changes construction, see the +https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Changes.Builder.html[Changes.Builder] javadoc. + +The changes are ordered : + +* First by the type of the change : creation, modification and after deletion +* After if it is a change on a table by the name of the table +* To finish by the values of the primary key and if there are no primary key by the values of the row (for a modification) + +As indicated above, the primary key is used to order the changes. +But more important, the primary key is used to determinate which rows at the same with modifications. + +In Representation of "changes3" the modification of first row of the table become a creation and deletion. + +.Representation of "changes1" +[cols="1,2,3,4a"] +|==== +|Creation |"MEMBERS" table |`5` as PK | +!==== +!!ID !NAME !FIRSTNAME !SURNAME !BIRTHDATE !SIZE + +!At start point !!!!!! +!At end point !5 !'McGuiness' !'Paul' !!! +!==== +|Modification |"ALBUMS" table |`8` as PK | +!==== +!!ID !RELEASE !TITLE !NUMBEROFSONGS !DURATION !LIVE + +!At start point !8 !10-10-88 !'Rattle and Hum' !17 !72:27 ! +!At end point !8 !10-10-88 !'Rattle & Hum' !17 !72:27 !true +!==== +|Modification |"MEMBERS" table |`1` as PK | +!==== +!!ID !NAME !FIRSTNAME !SURNAME !BIRTHDATE !SIZE + +!At start point !1 !'Hewson' !'Paul David' !'Bono' !05-10-60 !1.75 +!At end point !1 !'Hewson' !'Paul David' !'Bono Vox' !05-10-60 !1.75 +!==== +|Deletion |"ALBUMS" table |`15` as PK | +!==== +!!ID !RELEASE !TITLE !NUMBEROFSONGS !DURATION !LIVE + +!At start point !15 !09-09-14 !'Songs of Innocence' !11 !48:11! +!At end point !!!!!! +!==== +|==== + +.Representation of "changes2" +[cols="1,2,3,4a"] +|==== +|Creation |"MEMBERS" table |`5` as PK | +!==== +!!ID !NAME !FIRSTNAME !SURNAME !SIZE + +!At start point !!!!! +!At end point !5 !'McGuiness' !'Paul' ! ! +!==== +|Modification |"MEMBERS" table |`1` as PK | +!==== +!!ID !NAME !FIRSTNAME !SURNAME !SIZE + +!At start point !1 !'Hewson' !'Paul David' !'Bono' !1.75 +!At end point !1 !'Hewson' !'Paul David' !'Bono Vox' !1.75 +!==== +|==== + +.Representation of "changes3" +[cols="1,2,3,4a"] +|==== +|Creation | |No PK | +!==== +!!NAME !FIRSTNAME !SURNAME + +!At start point !!! +!At end point !'Hewson' !'Paul David' !'Bono Vox' +!==== +|Creation | |No PK | +!==== +!!NAME !FIRSTNAME !SURNAME + +!At start point !!! +!At end point !'McGuiness' !'Paul' ! +!==== +|Deletion | |No PK | +!==== +!!NAME !FIRSTNAME !SURNAME + +!At start point !!! +!At end point !'Hewson' !'Paul David' !'Bono Vox' +!==== +|==== + +.Representation of "changes4" +[cols="1,2,3,4a"] +|==== +|Creation | |`'McGuiness'` as PK | +!==== +!!NAME !FIRSTNAME !SURNAME + +!At start point !!! +!At end point !'McGuiness' !'Paul' ! +!==== +|Modification | |`'Hewson'` as PK | +!==== +!!NAME !FIRSTNAME !SURNAME + +!At start point !'Hewson' !'Paul David' !'Bono' +!At end point !'Hewson' !'Paul David' !'Bono Vox' +!==== +|==== + +[[change]] +=== Change + +A https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Change.html[Change] +is an element of the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Changes.html[Changes]. + +Below framed in red the first https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Change.html[Change] +of "changes2". + +.Representation of "changes2" +[cols="1,2,3,4a"] +|==== +|Creation |"MEMBERS" table |`5` as PK | +!==== +!!ID !NAME !FIRSTNAME !SURNAME !SIZE + +!At start point !!!!! +!At end point !5 !'McGuiness' !'Paul' ! ! +!==== +|Modification |"MEMBERS" table |`1` as PK | +!==== +!!ID !NAME !FIRSTNAME !SURNAME !SIZE + +!At start point !1 !'Hewson' !'Paul David' !'Bono' !1.75 +!At end point !1 !'Hewson' !'Paul David' !'Bono Vox' !1.75 +!==== +|==== + +[[row]] +=== Row + +A https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Row.html[Row] +can represent a row of a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table] +, of a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.html[Request] or +of a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Change.html[Change]. + +Below framed in red the third https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Row.html[Row] of "table3". + +.Representation of "table3" +|==== +|ID |NAME |FIRSTNAME |SURNAME |SIZE + +|1 |'Hewson' |'Paul David' |'Bono' |1.75 +|2 |'Evans' |'David Howell' |'The Edge' |1.77 +|3 |'Clayton' |'Adam' | |1.78 +|4 |'Mullen' |'Larry' | |1.70 +|==== + +Below framed in red the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Row.html[Row] of "request2". + +.Representation of "request2" +|==== +|NAME |FIRSTNAME |SURNAME + +|'Hewson' |'Paul David' |'Bono' +|'Evans' |'David Howell' |'The Edge' +|'Mullen' |'Larry' | +|==== + +Below framed in red the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Row.html[Row] at end point of +the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Change.html[Change] +of "changes3". + +.Representation of "changes2" +[cols="1,2,3,4a"] +|==== +|Creation |"MEMBERS" table |`5` as PK | +!==== +!!ID !NAME !FIRSTNAME !SURNAME !SIZE + +!At start point !!!!! +!At end point !5 !'McGuiness' !'Paul' ! ! +!==== +|Modification |"MEMBERS" table |`1` as PK | +!==== +!!ID !NAME !FIRSTNAME !SURNAME !SIZE + +!At start point !1 !'Hewson' !'Paul David' !'Bono' !1.75 +!At end point !1 !'Hewson' !'Paul David' !'Bono Vox' !1.75 +!==== +|==== + +[[column]] +=== Column + +A https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Column.html[Column] +can represent a column of a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table] +, of a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.html[Request] or +of a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Change.html[Change]. + +Below framed in red the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Column.html[Column] of "table3". + +.Representation of "table3" +|==== +|ID |NAME |FIRSTNAME |SURNAME |SIZE + +|1 |'Hewson' |'Paul David' |'Bono' |1.75 +|2 |'Evans' |'David Howell' |'The Edge' |1.77 +|3 |'Clayton' |'Adam' | |1.78 +|4 |'Mullen' |'Larry' | |1.70 +|==== + +Below framed in red the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Column.html[Column] of "request2". + +.Representation of "request2" +|==== +|NAME |FIRSTNAME |SURNAME + +|'Hewson' |'Paul David' |'Bono' +|'Evans' |'David Howell' |'The Edge' +|'Mullen' |'Larry' | +|==== + +Below framed in red the fourth https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Column.html[Column] of +the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Change.html[Change] +of "changes3". + +.Representation of "changes2" +[cols="1,2,3,4a"] +|==== +|Creation |"MEMBERS" table |`5` as PK | +!==== +!!ID !NAME !FIRSTNAME !SURNAME !SIZE + +!At start point !!!!! +!At end point !5 !'McGuiness' !'Paul' ! ! +!==== +|Modification |"MEMBERS" table |`1` as PK | +!==== +!!ID !NAME !FIRSTNAME !SURNAME !SIZE + +!At start point !1 !'Hewson' !'Paul David' !'Bono' !1.75 +!At end point !1 !'Hewson' !'Paul David' !'Bono Vox' !1.75 +!==== +|==== + +[[value]] +=== Value + +A value can be in a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Row.html[Row] +or in a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Column.html[Column]. + +Below framed in red (depending of the path) : + +* the second value of the third https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Row.html[Row] of "table3" +* the third value of the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Column.html[Column] of "table3" + +.Representation of "table3" +|==== +|ID |NAME |FIRSTNAME |SURNAME |SIZE + +|1 |'Hewson' |'Paul David' |'Bono' |1.75 +|2 |'Evans' |'David Howell' |'The Edge' |1.77 +|3 |'Clayton' |'Adam' | |1.78 +|4 |'Mullen' |'Larry' | |1.70 +|==== + +Below framed in red (depending of the path) : + +* the second value of the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Row.html[Row] of "request2" +* the second value of the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Column.html[Column] of "request2" + +.Representation of "request2" +|==== +|NAME |FIRSTNAME |SURNAME + +|'Hewson' |'Paul David' |'Bono' +|'Evans' |'David Howell' |'The Edge' +|'Mullen' |'Larry' | +|==== + +Below framed in red (depending of the path) : + +* the fourth value of the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Row.html[Row] at end point of +the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Change.html[Change] +of "changes2" +* the value at end point of the fourth https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Column.html[Column] of +the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Change.html[Change] +of "changes2" + +.Representation of "changes2" +[cols="1,2,3,4a"] +|==== +|Creation |"MEMBERS" table |`5` as PK | +!==== +!!ID !NAME !FIRSTNAME !SURNAME !SIZE + +!At start point !!!!! +!At end point !5 !'McGuiness' !'Paul' ! ! +!==== +|Modification |"MEMBERS" table |`1` as PK | +!==== +!!ID !NAME !FIRSTNAME !SURNAME !SIZE + +!At start point !1 !'Hewson' !'Paul David' !'Bono' !1.75 +!At end point !1 !'Hewson' !'Paul David' !'Bono Vox' !1.75 +!==== +|==== + +[[type]] +== Type + +[[datatype]] +=== Data Type + +As see above there are three root elements of database, but only https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table] and https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.html[Request] are data elements. +All the possible types of data are contained in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/DataType.html[DataType] enumeration. + +The type of the data can be : + +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/DataType.html#TABLE[TABLE]` +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/DataType.html#REQUEST[REQUEST]` + +[[changetype]] +=== Change Type + +The change can be a creation, a modification or a deletion. +All the possible types of change are contained in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ChangeType.html[ChangeType] enumeration. + +The type of the change depends of operation on database : + +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ChangeType.html#CREATION[CREATION]` for a `insert` sql request +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ChangeType.html#MODIFICATION[MODIFICATION]` for a `update` sql request +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ChangeType.html#DELETION[DELETION]` for a `delete` sql request + +[[valuetype]] +=== Value Type + +The value can be a date, a boolean or a text for example. +All the possible types of value are contained in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html[ValueType] enumeration. + +The type of the value depends of class of the object given by `java.sql` when the data are got from database : + +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#BYTES[BYTES]` for a array of bytes (`byte[]`) +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#BOOLEAN[BOOLEAN]` for a `java.lang.Boolean` +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#TEXT[TEXT]` for a `java.lang.String` +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#DATE[DATE]` for a `java.sql.Date` +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#TIME[TIME]` for a `java.sql.Time` +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#DATE_TIME[DATE_TIME]` for a `java.sql.Timestamp` +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#UUID[UUID]` for a `java.util.UUID` [.small]#(since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0])# +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#NUMBER[NUMBER]` for a `java.lang.Byte`, + `java.lang.Short`, `java.lang.Integer`, `java.lang.Long`, `java.lang.Double`, `java.lang.Float` or `java.math.BigDecimal` +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#NOT_IDENTIFIED[NOT_IDENTIFIED]` for other cases (for example when the value is `null`) + +[[ordertype]] +=== Order Type + +Since xref:release-notes.adoc#v1-2-0-release-notes[1.2.0] + +The order can be a ascending or descending. +All the possible types of order are contained in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.Order.OrderType.html[Table.Order.OrderType] enumeration. + +The type of the order can be : + +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.Order.OrderType.html#ASC[ASC]` for an ascending order +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.Order.OrderType.html#DESC[DESC]` for a descending order + +[[navigation]] +== Navigation + +The navigation offers the ability to chain assertions at different levels and instructions to go inside the sub-elements and return to root element. + +There are examples of the navigation in {assertj-examples-github}/blob/main/assertions-examples/src/test/java/org/assertj/examples/db/NavigationExamples.java[NavigationExamples.java] + +[[tableorrequestasroot]] +=== With a Table or a Request as root + +The `assertThat(...)` static method of `Assertions` allows to create a root assertion on a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table]. + +[source,java] +---- +// From v3.0.2 +import static org.assertj.core.api.Assertions.assertThat; + +// For versions <= 3.0.1 : +// import static org.assertj.db.api.Assertions.assertThat; + +assertThat(table)... +---- + +or on a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.html[Request]. + +[source,java] +---- +// From v3.0.2 +import static org.assertj.core.api.Assertions.assertThat; + +// For versions <= 3.0.1 : +// import static org.assertj.db.api.Assertions.assertThat; + +assertThat(request)... +---- + +From these root assertions, it is possible to navigate to the sub elements and return to the root element as in the picture below. + +[ditaa, target="db-navigation-with-table-or-request", shadows=false, transparent=true] +.... + origin + instantiate+-----------+<-----------=+----------------------+ + +--------->|On a Column| instantiate |On a Value Of a Column| + | +-----+-----+=----------->+----------------------+ + : origin: ++----------------+------+<--------+ +|On a Table Or a Request| ++----------------+------+<--------+ + : origin: origin + | +-----+--+<-----------=+-------------------+ + +--------->|On a Row| instantiate |On a Value Of a Row| + instantiate+--------+=----------->+-------------------+ +.... + +More details on this concept in assertj-db-features-highlight.html#tableorrequestasroot[feature highlight]. + +[[changesasroot]] +=== With Changes as root + +The `assertThat(...)` static method of `Assertions` +allows to create a root assertion on https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Changes.html[Changes]. + +[source,java] +---- +// From v3.0.2 +import static org.assertj.core.api.Assertions.assertThat; + +// For versions <= 3.0.1 : +// import static org.assertj.db.api.Assertions.assertThat; + +assertThat(changes)... +---- + +From this root assertion, it is possible to navigate to the sub elements and return to the root element as in the picture below. + +[ditaa, target="db-navigation-with-changes", shadows=false, transparent=true] +.... + origin + instantiate+-----------+<-----------=+----------------------+ + +--------->|On a Column| instantiate |On a Value Of a Column| + | +-----+-----+=----------->+----------------------+ + origin : origin: ++-----------+<=-----------+-----+-----+<---------+ +|On Changes | instantiate |On a Change| ++-----------+=----------->+-----+-----+<---------+ + : origin: origin + | +-----+--+<-----------=+-------------------+ + +--------->|On a Row| instantiate |On a Value Of a Row| + instantiate+--------+=----------->+-------------------+ +.... + + +More details on this concept in xref:features.adoc#changesasroot[feature highlight]. + +[[datevaluetimevaluedatetimevalue]] +== DateValue, TimeValue and DateTimeValue + +Since 2.0.0, AssertJ-DB baseline is Java 8. The preferred way to compare values with date, time and date/time is to use java.time.LocalDate, java.time.LocalTime, java.time.LocalDateTime directly. + +But for the backward compatibility, it's always possible to use AssertJ-DB DateValue utilities. + +So The https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/DateValue.html[DateValue], + https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/TimeValue.html[TimeValue] and + https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/DateTimeValue.html[DateTimeValue] classes are simpler but contains this kind of informations. + +There is 4 kinds of static methods to instantiate these values : + +* `of` which receives the informations as `int` parameters + +[source,java] +---- +DateValue dateValue = DateValue.of(2007, 12, 23); + +// With hours and minutes only +TimeValue timeValue1 = TimeValue.of(9, 1); +// With seconds additional +TimeValue timeValue2 = TimeValue.of(9, 1, 6); +// With nanoseconds additional +TimeValue timeValue3 = TimeValue.of(9, 1, 6, 3); + +// With date only (so hour is midnight) +DateTimeValue dateTimeValue1 = DateTimeValue.of(dateValue); +// With date and time +DateTimeValue dateTimeValue2 = DateTimeValue.of(dateValue, timeValue1); +---- + +* `from` which receives the equivalent from `java.sql` package (`java.sql.Date`, `java.sql.Time` and `java.sql.Timestamp`) +or a `java.util.Calendar` [.small]#(since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0])# + +[source,java] +---- +Date date = Date.valueOf("2007-12-23"); +DateValue dateValue = DateValue.from(date); + +Time time = Time.valueOf("09:01:06"); +TimeValue timeValue = TimeValue.from(time); + +Timestamp timestamp = Timestamp.valueOf("2007-12-23 09:01:06.000000003"); +DateTimeValue dateTimeValue = DateTimeValue.from(timestamp); + +// Since 1.1.0 +Calendar calendar = Calendar.getInstance(); +DateValue dateValueFromCal = DateValue.from(calendar); +TimeValue timeValueFromCal = TimeValue.from(calendar); +DateTimeValue dateTimeValueFromCal = DateTimeValue.from(calendar); +---- + +* `parse` which receives a `String` to represent the value (this method can throw a `ParseException`) + +[source,java] +---- +DateValue dateValue = DateValue.parse("2007-12-23"); + +// With hours and minutes only +TimeValue timeValue1 = TimeValue.parse("09:01"); +// With seconds additional +TimeValue timeValue2 = TimeValue.parse("09:01:06"); +// With nanoseconds additional +TimeValue timeValue3 = TimeValue.parse("09:01:06.000000003"); + +// With date only (so hour is midnight) +DateTimeValue dateTimeValue1 = DateTimeValue.parse("2007-12-23"); +// With date and time (hours and minutes only) +DateTimeValue dateTimeValue2 = DateTimeValue.parse("2007-12-23T09:01"); +// With date and time (seconds additional) +DateTimeValue dateTimeValue2 = DateTimeValue.parse("2007-12-23T09:01:06"); +// With date and time (nanoseconds additional) +DateTimeValue dateTimeValue2 = DateTimeValue.parse("2007-12-23T09:01:06.000000003"); +---- + +* `now` [.small]#(since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0])# which create an instance corresponding to the current moment. + +[source,java] +---- +DateValue dateValue = DateValue.now(); // The current date +TimeValue timeValue = TimeValue.now(); // The current time +DateTimeValue dateTimeValue = DateTimeValue.now(); // The current date/time +---- + +All these static methods (except for `now` method) have equivalent constructors. + +[[description]] +== Default description + +In assertj, it is possible to add a description with the methods of the https://www.javadoc.io/doc/org.assertj/assertj-core/latest/org/assertj/core/api/Descriptable.html[Descriptable] interface. +This description is used in the error message if the assertion fails. + +Due to the navigation, it is more complicated in assertj-db to know on which element an error is thrown. +So to help the tester, there are default descriptions. + +For example : + +* `"members table"` for an assertion on a table +* `"'select * from actor' request"` for an assertion on a request +* `"'select id, name, firstname, bi...' request"` for an assertion on a request with more text +* `"Row at index 0 of members table"` for an assertion on a row of a table +* `"Column at index 0 (column name : ID) of 'select * from members' request"` for an assertion on a column of a request +* `"Value at index 0 of Column at index 0 (column name : ID) of 'select * from members' request"` for an assertion on a value of a column of a request +* `"Value at index 0 (column name : ID) of Row at index 0 of 'select * from members' request"` for an assertion on a value of a row of a request +* `"Value at index 0 (column name : ID) of Row at end point of Change at index 0 (on table : MEMBERS and with primary key : [4]) of Changes on tables of 'sa/jdbc:h2:mem:test' source"` +for an assertion on a value of the row at end point of a change on a table + +This default description can be replaced by the choice of the tester by using the methods of https://www.javadoc.io/doc/org.assertj/assertj-core/latest/org/assertj/core/api/Descriptable.html[Descriptable]. + +[[dblettercase]] +== Letter Case of the database + +Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] + +Databases have different letter cases for the name of the elements. +For example, the name of the table can be upper case either the name is inputted in upper case or not. So this concept (and feature too) is here to manage these shades. + +It is possible to declare a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] +with a <>. + +The concept of https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] is composed of https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversion.html[CaseConversion] and https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparison.html[CaseComparison]. + +[[caseconversion]] +=== CaseConversion + +The https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversion.html[CaseConversion] is used when getting a name with letter case from database : a table name, a column name or a primary key name. + +There are three conversions modes : https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversions.html#UPPER[UPPER] which converts to upper case (`"Name"` becomes `"NAME"`), https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversions.html#LOWER[LOWER] which converts to lower case (`"Name"` becomes `"name"`) and https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversions.html#NO[NO] which keeps the case (`"Name"` remains `"Name"`). + +Each name (table, column and primary key) got from the database is converted using a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversion.html[CaseConversion]. + +[[casecomparison]] +=== CaseComparison + +The https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparison.html[CaseComparison] is used when comparing something with letter case from database or with a parameter. + +There are two comparison modes : https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparisons.html#IGNORE[IGNORE] which compares `String`s by ignoring the case (`"Name"` is considered equal to `"NAME"`) and https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparisons.html#STRICT[STRICT] which compares `String`s strictly (`"Name"` is considered different from `"NAME"`). + +During navigation (e.g. from table to column) and assertion (e.g. on column name), the name are compared using a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparison.html[CaseComparison]. + +[[lettercase]] +=== LetterCase + +A https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] is created with the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html#getLetterCase-org.assertj.db.type.lettercase.CaseConversion-org.assertj.db.type.lettercase.CaseComparison-[getLetterCase] +static method which has a + https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversion.html[CaseConversion] and a + https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparison.html[CaseComparison] as parameters. + +[source,java] +---- +LetterCase letterCase = LetterCase.getLetterCase(CaseConversions.NO, CaseComparisons.IGNORE); +---- + +In AssertJ-DB, there are three different uses of a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] : +the table name, the column name and the primary key name. +That is the reason why the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/AssertDbConnection.html[AssertDbConnection] +have three https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] parameters. + +The https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] on the tables is used : + +* to convert the table name : when a name is got from the database like for the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table] +instantiation or for the table with changes found with https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Changes.html[Changes]. +* to compare the table name : for the instantiation when the table is search in the database for https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table], +for navigation (e.g. from changes to a change on a table) or for a assertion (like https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnDataType.html#isOnTable-java.lang.String-[isOnTable(String name)]). + +The https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] on the columns is used : + +* to convert the column name : when a column name is got from the database for a table or a request +* to compare the column name : for the navigation (e.g. from a table to a column) or for a assertion (like https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnName.html#hasColumnName-java.lang.String-[hasColumnName(String columnName)]). + +The https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] on the primary keys is used : + +* to convert the primary key name : when a primary key name is got from the database for a table +* to compare the primary key name : for a assertion (like https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnPrimaryKey.html#hasPksNames-java.lang.String...-[hasPksNames(String... names)]). + +The default settings for https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] in +https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/AssertDbConnection.html[AssertDbConnection] are : + +* https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversions.html#NO[NO] conversion +and https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparisons.html#IGNORE[IGNORE] comparison for table names +* https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversions.html#UPPER[UPPER] conversion +and https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparisons.html#IGNORE[IGNORE] comparison for the column and primary key name + +In this example, the two connections are equivalent : + +[source,java] +---- +AssertDbConnection jdbcConnection = AssertDbConnectionFactory.of("jdbc:h2:mem:test", "sa", "").create(); +Table table = jdbcConnection.table("members").build(); + +LetterCase tableLetterCase = LetterCase.getLetterCase(CaseConversions.NO, CaseComparisons.IGNORE); +LetterCase columnLetterCase = LetterCase.getLetterCase(CaseConversions.UPPER, CaseComparisons.IGNORE); +LetterCase pkLetterCase = LetterCase.getLetterCase(CaseConversions.UPPER, CaseComparisons.IGNORE); +AssertDbConnection connectionWithLC = AssertDbConnectionFactory.of("jdbc:h2:mem:test", "sa", "") + .letterCase(tableLetterCase, columnLetterCase, pkLetterCase) + .create(); +Table tableWithLC = connectionWithLC.table("members").build(); +---- + +Note that the letter case is extensible because the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html#getLetterCase-org.assertj.db.type.lettercase.CaseConversion-org.assertj.db.type.lettercase.CaseComparison-[getLetterCase] +static method's parameters are instances of the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversion.html[CaseConversion] +and the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparison.html[CaseComparison] interfaces. +So this is not limited to the implementations in the corresponding enumerations. + +[[output]] +== Output + +Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] + +It can be interesting to view the values on which an assertion is made (for example for debugging). The output allows that. + +This is a simple example : + +[source,java] +---- +import static org.assertj.db.output.Outputs.output; + +Table table = connection.table("members"); + +// Output the content of the table in the console +output(table).toConsole(); +---- + +These lines give the result below : + +[source,java] +---- +[MEMBERS table] +|-----------|---------|-----------|-----------|--------------|-----------|-----------|-----------| +| | | * | | | | | | +| | PRIMARY | ID | NAME | FIRSTNAME | SURNAME | BIRTHDATE | SIZE | +| | KEY | (NUMBER) | (TEXT) | (TEXT) | (TEXT) | (DATE) | (NUMBER) | +| | | Index : 0 | Index : 1 | Index : 2 | Index : 3 | Index : 4 | Index : 5 | +|-----------|---------|-----------|-----------|--------------|-----------|-----------|-----------| +| Index : 0 | 1 | 1 | Hewson | Paul David | Bono | 05-10-60 | 1.75 | +| Index : 1 | 2 | 2 | Evans | David Howell | The Edge | 08-08-61 | 1.77 | +| Index : 2 | 3 | 3 | Clayton | Adam | | 03-13-60 | 1.78 | +| Index : 4 | 4 | 4 | Mullen | Larry | | 10-31-61 | 1.70 | +|-----------|---------|-----------|-----------|--------------|-----------|-----------|-----------| +---- + +In the example above, the output is in plain text in the console. It is possible to change the type of the output and the destination. + +[[typeoutput]] +=== Type of output + +There are two outputs already implemented : + +* https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/output/impl/OutputType.html#PLAIN[PLAIN] : shown in the example above (the default output type) +* https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/output/impl/OutputType.html#HTML[HTML] : which represents the result as an HTML document + +[source,java] +---- +// Change the output of the table to be HTML +output(table).withType(OutputType.HTML).....; +---- + +Note that the type of output is extensible because the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/output/AbstractOutputter.html#withType-org.assertj.db.output.impl.Output-[withType(Output outputType)] method's parameter is an instance of the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/output/impl/Output.html[Output] interface. +So this is not limited to the implementations in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/output/impl/OutputType.html[OutputType] enum. + +[[destination]] +=== Destination + +The destination is the way to print the display. There are three destinations : + +* the console (with the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/output/AbstractOutputter.html#toConsole--[toConsole()] method) +* a file (with the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/output/AbstractOutputter.html#toFile-java.lang.String-[toFile(String fileName)] method) +* a stream (with the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/output/AbstractOutputter.html#toStream-java.io.OutputStream-[toStream(OutputStream outputStream)] method) + +Note that with this last method the possibilities of destination are really flexible. + +These three methods are fluent. In this short example, the output is a plain text representation in the console and a html output in a file : + +[source,java] +---- +// Display the content of the table with plain text in the console +// and with HTML output in the file +output(table).toConsole().withType(OutputType.HTML).toFile("test.html"); +---- diff --git a/docs/modules/ROOT/pages/features.adoc b/docs/modules/ROOT/pages/features.adoc new file mode 100644 index 00000000..682c6fad --- /dev/null +++ b/docs/modules/ROOT/pages/features.adoc @@ -0,0 +1,1762 @@ += Features highlight + +Before reading this page, it is recommended to be familiar with the xref:concepts.adoc[concepts of AssertJ-DB]. + +The purpose of this page is to show the different features of AssertJ-DB. + +[[navigation]] +== Navigation + +[[tableorrequestasroot]] +=== With a Table or a Request as root + +As shown in the xref:concepts.adoc#tableorrequestasroot[concepts] (to easily understand this chapter it is important to know the concepts of assertj-db), +the `assertThat(...)` static method is used +to begin an assertion +on a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table] +or on a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.html[Request]. + +The navigation from a table or from a request are similar, so in most of the examples below a table will be used : + +[source,java] +---- +assertThat(tableOrRequest)... +---- + +If there is a difference if will be specified. + +All the navigation methods work from an origin point. +That means that if the method is executed from another point, +it is like the execution is from the point of view of the origin. + +There are some recurring points in the different navigation methods : + +* a method without parameter which allows to navigate on the next element after the element reached on the last call +(if it is the first call, navigate to the first element) +* a method with an `int` parameter (an index) which allows to navigate on the element which is +at the corresponding index +* a method with an `String` parameter (a column name) which allows to navigate on the element corresponding +at the column name + +[[tableorrequesttorow]] +==== To a Row + +These methods are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/navigation/ToRow.html[ToRow] interface. + +The `row()` method allows to navigate to the next row after the row reached on the last call. + +[source,java] +---- +// If it is the first call, navigate to the first row +assertThat(tableOrRequest).row()... +// It is possible to chain the calls to navigate to the next row +// after the first row (so the second row) +assertThat(tableOrRequest).row().row()... +---- + +The `row(int index)` method with `index` as parameter +allows to navigate to the row corresponding to row at the index. + +[source,java] +---- +// Navigate to the row at index 2 +assertThat(tableOrRequest).row(2)... +// It is possible to chain the calls to navigate to another row. +// Here row at index 6 +assertThat(tableOrRequest).row(2).row(6)... +// It is possible to combine the calls to navigate to the next row +// after the row at index 2. Here row at index 3 +assertThat(tableOrRequest).row(2).row()... +---- + +This picture shows from where it is possible to navigate to a row. + +[ditaa, target="db-navigation-with-table-or-request-to-row", shadows=false, transparent=true] +.... + +-----------+<--------+----------------------+ + +--------->|On a Column| |On a Value Of a Column| + | +-----+-----+-------->+---------------------++ + | | : | ++----------------+------+<--------+ | | +|On a Table Or a Request| navigate to a row | ++----+-----------+------+<--------+ | | + : | | v | + | | +-----+-----+<--------+-------------------+ | + | +--------->| On a Row | |On a Value Of a Row| | + | +--+----+---+-------->+----------+--------+ | + | ^ ^ : ^ : | + | navigate to a row | | | | | | + +----------------------+ +----+ +--------------------+----------+ + navigate to a row navigate to a row +.... + +The origin point of the `row(...)` methods is the Table or the Request. +So if the method is executed from a row, from a column or from a value +it is like if the method was executed from the Table or the Request. + +When the position is on a row, it is possible to return to the origin. + +[source,java] +---- +// Return to the table from a row of a table +assertThat(table).row().returnToTable()... +// Return to the request from a row of a request +assertThat(request).row().returnToRequest()... +---- + +That also means that the two navigations below are equivalent. + +[source,java] +---- +// Navigate to the first row +// Return to the table from this row +// Navigate to the next row +assertThat(table).row().returnToTable().row()... +// The same thing is done but the return to the table is implicit +assertThat(table).row().row()... +---- + +[[tableorrequesttocolumn]] +==== To a Column + +These methods are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/navigation/ToColumn.html[ToColumn] interface. + +The `column()` method allows to navigate to the next column after the column reached on the last call. + +[source,java] +---- +// If it is the first call, navigate to the first column +assertThat(tableOrRequest).column()... +// It is possible to chain the calls to navigate to the next column +// after the first column (so the second column) +assertThat(tableOrRequest).column().column()... +---- + +The `column(int index)` method with `index` as parameter +allows to navigate to the column corresponding to column at the index. + +[source,java] +---- +// Navigate to the column at index 2 +assertThat(tableOrRequest).column(2)... +// It is possible to chain the calls to navigate to another column. +// Here column at index 6 +assertThat(tableOrRequest).column(2).column(6)... +// It is possible to combine the calls to navigate to the next column +// after the column at index 2. Here column at index 3 +assertThat(tableOrRequest).column(2).column()... +// It is possible to combine the calls with other navigation methods +// Here first column +assertThat(tableOrRequest).row(2).column()... +// Here column at index 3 +assertThat(tableOrRequest).row(2).column(3)... +// Here column at index 4 because the origin remember last navigation to a column +assertThat(tableOrRequest).column(3).row(2).column()... +---- + +The `column(String columnName)` method with `columnName` as parameter +allows to navigate to the column corresponding to the column with the column name. + +[source,java] +---- +// Navigate to the column with the name "SURNAME" +assertThat(tableOrRequest).column("surname")... +// Like for the other methods, it is possible to chain the calls +assertThat(tableOrRequest).column("surname").column().column(6).column("id")... +---- + +This picture shows from where it is possible to navigate to a column. + +[ditaa, target="db-navigation-with-table-or-request-to-column", shadows=false, transparent=true] +.... + navigate to a column navigate to a column navigate to a column + +----------------------+ +----+ +---------------------+-----------+ + | | | | | | | + | v v : v | | + | +--+----+---+<--------+-----------+----------+| + | +--------->|On a Column| |On a Value Of a Column|| + | | +-----+-----+-------->+---------------------++| + : | | ^ | ++----+-----------+------+<--------+ | | +|On a Table Or a Request| navigate to a column | ++----------------+------+<--------+ | | + | | : | + | +-----+-----+<--------+-------------------+ | + +--------->| On a Row | |On a Value Of a Row+-=-+ + +-----------+-------->+-------------------+ +.... + +The origin point of the `column(...)` methods is the Table or the Request. +So if the method is executed from a row, from a column or from a value +it is like if the method was executed from the Table or The Request. + +When the position is on a column, it is possible to return to the origin. + +[source,java] +---- +// Return to the table from a column of a table +assertThat(table).column().returnToTable()... +// Return to the request from a column of a request +assertThat(request).column().returnToRequest()... +---- + +That also means that the two navigations below are equivalent. + +[source,java] +---- +// Navigate to the first column +// Return to the table from this column +// Navigate to the next column +assertThat(table).column().returnToTable().column()... +// The same thing is done but the return to the table is implicit +assertThat(table).column().column()... +---- + +[[tableorrequesttovalue]] +==== To a Value + +These methods are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/navigation/ToValue.html[ToValue] +and the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/navigation/ToValueFromRow.html[ToValueFromRow] interfaces. + +The `value()` method allows to navigate to the next value after the value reached on the last call. + +[source,java] +---- +// If it is the first call, navigate to the first value +assertThat(tableOrRequest).row().value()... +// It is possible to chain the calls to navigate to the next value +// after the first value (so the second value) +assertThat(tableOrRequest).column().value().value()... +---- + +The `value(int index)` method with `index` as parameter +allows to navigate to the value corresponding to value at the index. + +[source,java] +---- +// Navigate to the value at index 2 +assertThat(tableOrRequest).column().value(2)... +// It is possible to chain the calls to navigate to another value. +// Here value at index 6 +assertThat(tableOrRequest).row(4).value(2).value(6)... +// It is possible to combine the calls to navigate to the next value +// after the value at index 2. Here value at index 3 +assertThat(tableOrRequest).column(4).value(2).value()... +// Here value at index 4 because the origin remember last navigation to a column +assertThat(tableOrRequest).column().value(3).row(2).column(0).value()... +---- + +The `value(String columnName)` method with `columnName` as parameter (only available from a row) +allows to navigate to the value of the column corresponding to the column with the column name. + +[source,java] +---- +// Navigate to the value of the column with the name "SURNAME" +assertThat(tableOrRequest).row().value("surname")... +// Like for the other methods, it is possible to chain the calls +assertThat(tableOrRequest).row().value("surname").value().value(6).value("id")... +---- + +This picture shows from where it is possible to navigate to a value. + +[ditaa, target="db-navigation-with-table-or-request-to-value", shadows=false, transparent=true] +.... + +--------------------+ + |navigate to a value | + : v + +-----+-----+<--+----------+-----------+=--+ + +-->|On a Column| |On a Value Of a Column| |navigate to a value + | +-----+-----+-->+----------------------+<--+ + | | ++----------------+------+<-+ +|On a Table Or a Request| ++----------------+------+<-+ + | | + | +-----+-----+<--+-------------------+=--+ + +-->| On a Row | |On a Value Of a Row| |navigate to a value + +-----+-----+-->+----------+--------+<--+ + : ^ + |navigate to a value | + +--------------------+ +.... + +The origin point of the `value(...)` methods is the Row or the Column. +So if the method is executed from a value +it is like if the method was executed from the Row or The Column. + +When the position is on a value, it is possible to return to the origin. + +[source,java] +---- +// Return to the column from a value +assertThat(table).column().value().returnToColumn()... +// Return to the row from a value +assertThat(request).row().value().returnToRow()... +---- + +That also means that the two navigations below are equivalent. + +[source,java] +---- +// Navigate to the first column +// Navigate to the first value +// Return to the column from this value +// Navigate to the next value +assertThat(table).column().value().returnToColumn().value()... +// The same thing is done but the return to the column is implicit +assertThat(table).column().value().value()... +---- + +[[changesasroot]] +=== With Changes as root + +[[changestochanges]] +==== To Changes + +These methods are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/navigation/ToChanges.html[ToChanges] interface. + +The `ofCreation()` method allows to navigate to the changes of creation. + +[source,java] +---- +// Navigate to the changes of creation +assertThat(changes).ofCreation()... +---- + +The `ofCreationOnTable()` method with `tableName` as parameter +allows to navigate to the changes of creation of a table. + +[source,java] +---- +// Navigate to the changes of creation on the "members" table +assertThat(changes).ofCreationOnTable("members")... +---- + +The `ofCreation()` method allows to navigate to the changes of modification. + +[source,java] +---- +// Navigate to the changes of modification +assertThat(changes).ofModification()... +---- + +The `ofModificationOnTable()` method with `tableName` as parameter +allows to navigate to the changes of modification of a table. + +[source,java] +---- +// Navigate to the changes of modification on the "members" table +assertThat(changes).ofModificationOnTable("members")... +---- + +The `ofCreation()` method allows to navigate to the changes of deletion. + +[source,java] +---- +// Navigate to the changes of deletion +assertThat(changes).ofDeletion()... +---- + +The `ofDeletionOnTable()` method with `tableName` as parameter +allows to navigate to the changes of deletion of a table. + +[source,java] +---- +// Navigate to the changes of deletion on the "members" table +assertThat(changes).ofDeletionOnTable("members")... +---- + +The `onTable(String tableName)` method with `tableName` as parameter +allows to navigate to the changes of a table. + +[source,java] +---- +// Navigate to all the changes on the "members" table +assertThat(changes).onTable("members")... +---- + +The `ofAll()` method allows to navigate to all the changes. + +[source,java] +---- +// Navigate to all the changes +assertThat(changes).ofAll()... +// The navigation can be chained +assertThat(changes).ofCreation().ofAll()... +---- + +This picture shows from where it is possible to navigate to changes. + +[ditaa, target="db-navigation-with-changes-to-changes", shadows=false, transparent=true] +.... + +--------------------------------+----------------------+ + | navigate to changes | : + | +-----+-----+<---+-----------+----------+ + |navigate to changes +-->|On a Column| |On a Value Of a Column| + +------------------+ | +-----+-----+--->+----------------------+ + | | | | + navigate to changes v : | | + +------------=+-----+-----+<-----+-----+---+-+<------+ + | |On Changes | |On a Change| + +------------>+-----+-----+----->+---------+-+<------+ + ^ | | + | | +-----+--+<---+-------------------+ + | +-->|On a Row| |On a Value Of a Row| + | +-----+--+--->+-----------+-------+ + | navigate to changes : | + +--------------------------------+-------------------+ +.... + +The origin point of these methods is the Changes. +So if the method is executed from a change, a column, a row or a value +it is like if the method was executed from the Changes. + +[[changestochange]] +==== To a Change + +These methods are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/navigation/ToChange.html[ToChange] interface. + +The `change()` method allows to navigate to the next change after the change reached on the last call. + +[source,java] +---- +// If it is the first call, navigate to the first change +assertThat(changes).change()... +// It is possible to chain the calls to navigate to the next change +// after the first change (so the second change) +assertThat(changes).change().change()... +---- + +The `change(int index)` method with `index` as parameter +allows to navigate to the change corresponding to change at the index. + +[source,java] +---- +// Navigate to the change at index 2 +assertThat(changes).change().change(2)... +// It is possible to chain the calls to navigate to another change. +// Here change at index 7 +assertThat(changes).change(6).change()... +---- + +The `changeOnTable(String tableName)` method with `tableName` as parameter +allows to navigate to the next change corresponding to the table name after the change corresponding to the table name reached on the last call. + +[source,java] +---- +// If it is the first call, navigate to the first change on "members" table +assertThat(changes).changeOnTable("members")... +// It is possible to chain the calls to navigate to the next change on the "members" table +// after the first change on the "members" table (so the second change) +assertThat(changes).changeOnTable("members").changeOnTable("members")... +---- + +The `changeOnTable(String tableName, int index)` method with `tableName` and `index` as parameters +allows to navigate to the change corresponding to change on the table name at the index. + +[source,java] +---- +// Navigate to the change at index 2 of "members" table +assertThat(changes).changeOnTable("members").changeOnTable("members", 2)... +// It is possible to chain the calls to navigate to another change. +// Here change at index 7 of "members" table +assertThat(changes).changeOnTable("members", 6).changeOnTable("members")... +---- + +There are 12 other methods which are derived from the 4 methods above : + +* `changeOfCreation()`, `changeOfModification()` and `changeOfDeletion()` +methods which allows to navigate to the next change of creation, modification and deletion like `change()` method + +[source,java] +---- +// If it is the first call, navigate to the first change of creation +assertThat(changes).changeOfCreation()... +// Navigate to the first change of creation +// and after the second change of creation +assertThat(changes).changeOfCreation().changeOfCreation()... +---- + +* `changeOfCreation(int index)`, `changeOfModification(int index)` and `changeOfDeletion(int index)` +methods with `index` as parameter which allows to navigate to the change of creation, modification and deletion corresponding to change of creation, modification and deletion at the index like `change(int index)` method + +[source,java] +---- +// Navigate to the change of modification at index 2 +assertThat(changes).changeOfModification() + .changeOfModification(2)... +// It is possible to chain the calls +// to navigate to another change of modification. +// Here change of modification at index 5 +assertThat(changes).changeOfModification(4) + .changeOfModification()... +---- + +* `changeOfCreationOnTable(String tableName)`, `changeOfModificationOnTable(String tableName)` and `changeOfDeletionOnTable(String tableName)` +methods with `tableName` as parameter which allows to navigate to the next change of creation, modification and deletion corresponding to the table name like `changeOnTable(String tableName)` method + +[source,java] +---- +// If it is the first call, navigate +// to the first change of creation on "members" table +assertThat(changes).changeOfCreationOnTable("members")... +// It is possible to chain the calls to navigate +// to the next change of creation on the "members" table +// after the first change of creation on the "members" table +// (so the second change of creation) +assertThat(changes).changeOfCreationOnTable("members") + .changeOfCreationOnTable("members")... +---- + +* `changeOfCreationOnTable(String tableName, int index)`, `changeOfModificationOnTable(String tableName, int index)` and `changeOfDeletionOnTable(String tableName, int index)` +methods with `tableName` and `index` as parameters which allows to navigate to the next change of creation, modification and deletion corresponding to the table name and index like `changeOnTable(String tableName, int index)` method + +[source,java] +---- +// Navigate to the change of deletion at index 2 of "members" table +assertThat(changes).changeOfDeletionOnTable("members") + .changeOfDeletionOnTable("members", 2)... +// It is possible to chain the calls +// to navigate to another change of deletion. +// Here change of deletion at index 7 of "members" table +assertThat(changes).changeOfDeletionOnTable("members", 6) + .changeOfDeletionOnTable("members")... +---- + +The `changeOnTableWithPks(String tableName, Object... pksValues)` method +allows to navigate to the change corresponding to the table and the primary keys. + +[source,java] +---- +// Navigate to the change with primary key 1 of "members" table +assertThat(changes).changeOnTableWithPks("members", 1)... +// It is possible to chain the calls to navigate to the next change +// after the change with primary key 1 of "members" table +assertThat(changes).changeOnTableWithPks("members", 1).change()... +---- + +This picture shows from where it is possible to navigate to a change. + +[ditaa, target="db-navigation-with-changes-to-change", shadows=false, transparent=true] +.... + navigate to change + +-------------+----------------------+ + | | : + navigate to change | +-----+-----+<---+-----------+----------+ + +------------------+ +-->|On a Column| |On a Value Of a Column| + | | | +-----+-----+--->+----------------------+ + : v | | ++-----+-----+<-----+-----+---+-+<------+ +|On Changes | |On a Change| ++-----------+----->+-----+---+-+<------+ + | ^ | | + | | | +-----+--+<---+-------------------+ + navigate to change| | +-->|On a Row| |On a Value Of a Row| + | | +-----+--+--->+-----------+-------+ + | | : | + +-----+-------------+-------------------+ + navigate to change +.... + +The origin point of the `change(...)` methods is the current Changes +and the origin point of other methods is the Changes of origin. +So if the method is executed from a change, a column, a row or a value +it is like if the method was executed from these origins. + +That means there is an important difference. + +[source,java] +---- +// Navigate to the changes of deletion +// Navigate to the first change of this changes of deletion +assertThat(changes).ofDeletion().change()... +// Navigate to the changes of deletion +// Navigate to the first change of this changes of creation +assertThat(changes).ofDeletion().changeOfCreation()... +// This is equivalent to +assertThat(changes).ofDeletion().ofAll().changeOfCreation()... +---- + +When the position is on a change, it is possible to return to the origin. + +[source,java] +---- +// Return to the change from a column +assertThat(changes).change().returnToChanges()... +---- + +That also means that the two navigations below are equivalent. + +[source,java] +---- +// Navigate to the first change +// Return to the changes +// Navigate to the next change +assertThat(changes).change().returnToChanges().change()... +// The same thing is done but the return to the changes is implicit +assertThat(changes).change().change()... +---- + +[[changestorow]] +==== To a Row + +These methods are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/navigation/ToRowFromChange.html[ToRowFromChange] interface. + +The `rowAtStartPoint()` and `rowAtEndPoint()` methods +allows to navigate to the row at the start point and at the end point. + +[source,java] +---- +// Navigate to the row at the start point +assertThat(changes).change().rowAtStartPoint()... +// Navigate to the row at the end point (note that the methods can be chained) +assertThat(changes).change().rowAtStartPoint().rowAtEndPoint()... +---- + +This picture shows from where it is possible to navigate to a row. + +[ditaa, target="db-navigation-with-changes-to-row", shadows=false, transparent=true] +.... + +-----------+<---+----------------------+ + +-->|On a Column| |On a Value Of a Column| + | +-----+--+--+--->+--------------------+-+ + | | : : ++-----------+<-----+-----+-----+<--+ | | +|On Changes | |On a Change| navigate to a row | ++-----------+----->+-+---+-----+<--+ | | + : | | v | + navigate to a row| | +-----+--+<---+-------------------+ | + | +-->|On a Row| |On a Value Of a Row| | + +------>++--+--+-+--->+-----------+-------+ | + : ^ ^ | | + | | | | | + +--+ +------------------+-----------+ + navigate to a row navigate to a row +.... + +The origin point of the `rowAtStartPoint()` and `rowAtEndPoint()` methods is the Change. +So if the method is executed from a row, from a column or from a value +it is like if the method was executed from the Change. + +When the position is on a row, it is possible to return to the origin. + +[source,java] +---- +// Return to the change from a row +assertThat(changes).change().rowAtStartPoint().returnToChange()... +---- + +That also means that the two navigations below are equivalent. + +[source,java] +---- +// Navigate to the first change +// Navigate to the row at start point +// Return to the change from this column +// Navigate to the row at end point +assertThat(changes).change().rowAtStartPoint().returnToChange().rowAtEndPoint()... +// The same thing is done but the return to the change is implicit +assertThat(changes).change().rowAtStartPoint().rowAtEndPoint()... +---- + +[[changestocolumn]] +==== To a Column + +These methods are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/navigation/ToColumn.html[ToColumn] +and https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/navigation/ToColumnFromChange.html[ToColumnFromChange] interfaces. + +The `column()` method allows to navigate to the next column after the column reached on the last call. + +[source,java] +---- +// If it is the first call, navigate to the first column +assertThat(changes).change().column()... +// It is possible to chain the calls to navigate to the next column +// after the first column (so the second column) +assertThat(changes).change().column().column()... +---- + +The `column(int index)` method with `index` as parameter +allows to navigate to the column corresponding to column at the index. + +[source,java] +---- +// Navigate to the column at index 2 +assertThat(changes).change().column(2)... +// It is possible to chain the calls to navigate to another column. +// Here column at index 6 +assertThat(changes).change().column(2).column(6)... +// It is possible to combine the calls to navigate to the next column +// after the column at index 2. Here column at index 3 +assertThat(changes).change().column(2).column()... +// It is possible to combine the calls with other navigation methods +// Here first column +assertThat(changes).change().rowAtStartPoint().column()... +// Here column at index 3 +assertThat(changes).change().rowAtEndPoint().column(3)... +// Here column at index 4 because the origin remember last navigation to a column +assertThat(changes).change().column(3).rowAtEndPoint().column()... +---- + +The `column(String columnName)` method with `columnName` as parameter +allows to navigate to the column corresponding to the column with the column name. + +[source,java] +---- +// Navigate to the column with the name "SURNAME" +assertThat(changes).change().column("surname")... +// Like for the other methods, it is possible to chain the calls +assertThat(changes).change().column("surname").column().column(6).column("id")... +---- + +The `columnAmongTheModifiedOnes()` method allows to navigate to the next column with modifications after the column reached on the last call. + +[source,java] +---- +// If it is the first call, navigate to the first column with modifications +assertThat(changes).change().columnAmongTheModifiedOnes()... +// It is possible to chain the calls to navigate to the next column +// after the first column (so the second column with modifications) +assertThat(changes).change().columnAmongTheModifiedOnes() + .columnAmongTheModifiedOnes()... +---- + +The `columnAmongTheModifiedOnes(int index)` method with `index` as parameter allows to navigate to the column with modifications corresponding to column at the index. + +[source,java] +---- +// Navigate to the column at index 2 (the third column with modifications) +assertThat(changes).change().columnAmongTheModifiedOnes(2)... +// It is possible to chain the calls to navigate to another column. +// Here column at index 0 (the first column with modifications) +assertThat(changes).change().columnAmongTheModifiedOnes(2) + .columnAmongTheModifiedOnes(0)... +---- + +The `columnAmongTheModifiedOnes(String columnName)` method with `columnName` as parameter +allows to navigate to the column with modifications corresponding to the column with the column name. + +[source,java] +---- +// Navigate to the column with modifications and the name "SURNAME" +assertThat(changes).change().columnAmongTheModifiedOnes("surname")... +// Like for the other methods, it is possible to chain the calls +assertThat(changes).change().column("surname").columnAmongTheModifiedOnes() + .column(6).columnAmongTheModifiedOnes("id")... +---- + +This picture shows from where it is possible to navigate to a column. + +[ditaa, target="db-navigation-with-changes-to-column", shadows=false, transparent=true] +.... + navigate to a column navigate to a column + +---+ +-----------------+-----------+ + | | | | | + : v v | | + +------>+-+---+-----+<---+-----------+----------+| + navigate to a column| +-->|On a Column| |On a Value Of a Column|| + | | +-----+-----+--->+----------------------+| + : | | ^ | ++-----------+<-----+-+---+-----+<--+ | | +|On Changes | |On a Change| navigate to a column | ++-----------+----->+-----+-----+<--+ | | + | | : | + | +-----+--+<---+-------------------+ | + +-->|On a Row| |On a Value Of a Row|=-----+ + +--------+--->+-------------------+ +.... + +The origin point of the `column(...)` methods is the Change. +So if the method is executed from a row, from a column or from a value +it is like if the method was executed from the Change. + +When the position is on a column, it is possible to return to the origin. + +[source,java] +---- +// Return to the change from a column +assertThat(changes).change().column().returnToChange()... +---- + +That also means that the two navigations below are equivalent. + +[source,java] +---- +// Navigate to the first change +// Navigate to the first column +// Return to the change from this column +// Navigate to the next column +assertThat(changes).change().column().returnToChange().column()... +// The same thing is done but the return to the change is implicit +assertThat(changes).change().column().column()... +---- + +[[changestovalue]] +==== To a Value + +These methods are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/navigation/ToValue.html[ToValue], + https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/navigation/ToValueFromColumn.html[ToValueFromColumn] +and https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/navigation/ToValueFromRow.html[ToValueFromRow] interfaces. + +This picture shows from where it is possible to navigate to a value. + +The `value()` method (only available from a row) allows to navigate to the next value after the value reached on the last call. + +[source,java] +---- +// If it is the first call, navigate to the first value +assertThat(changes).change().rowAtEndPoint().value()... +// It is possible to chain the calls to navigate to the next value +// after the first value (so the second value) +assertThat(changes).change().rowAtEndPoint().value().value()... +---- + +The `value(int index)` method with `index` as parameter (only available from a row) +allows to navigate to the value corresponding to value at the index. + +[source,java] +---- +// Navigate to the value at index 2 +assertThat(changes).change().rowAtEndPoint().value(2)... +// It is possible to chain the calls to navigate to another value. +// Here value at index 6 +assertThat(changes).change().rowAtEndPoint().value(2).value(6)... +// It is possible to combine the calls to navigate to the next value +// after the value at index 2. Here value at index 3 +assertThat(changes).change().rowAtEndPoint().value(2).value()... +// Here value at index 4 because the origin remember last navigation to the row +assertThat(changes).change().rowAtEndPoint().value(3).column(2).rowAtEndPoint().value()... +---- + +The `value(String columnName)` method with `columnName` as parameter (only available from a row) +allows to navigate to the value of the column corresponding to the column with the column name. + +[source,java] +---- +// Navigate to the value of the column with the name "SURNAME" +assertThat(changes).change().rowAtEndPoint().value("surname")... +// Like for the other methods, it is possible to chain the calls +assertThat(changes).change().rowAtEndPoint().value("surname").value().value(6).value("id")... +---- + +The `valueAtStartPoint()` and `valueAtEndPoint()` methods (only available from a column) +allows to navigate to the value at the start point and at the end point. + +[source,java] +---- +// Navigate to the value at the start point of the row +assertThat(changes).change().column().valueAtStartPoint()... +// Navigate to the value at the end point of the row (note that the methods can be chained) +assertThat(changes).change().column().valueAtStartPoint().valueAtEndPoint()... +---- + +This picture shows from where it is possible to navigate to a value. + +[ditaa, target="db-navigation-with-changes-to-value", shadows=false, transparent=true] +.... + +-------------------+ + |navigate to a value| + : v + +---+-------+<---+------+---------------+=-+ + +-->|On a Column| |On a Value Of a Column| |navigate to a value + | +-----+-----+--->+----------------------+<-+ + | | ++-----------+<-+-----+-----+<--+ +|On Changes | |On a Change| ++-----------+->+-----+-----+<--+ + | | + | +-----+--+<---+-------------------+=-+ + +-->|On a Row| |On a Value Of a Row| |navigate to a value + +---+----+--->+---------+---------+<-+ + : ^ + |navigate to a value| + +-------------------+ +.... + +The origin point of the `value(...)` methods is the Row or the Column. +So if the method is executed from a value +it is like if the method was executed from the Row or The Column. + +When the position is on a value, it is possible to return to the origin. + +[source,java] +---- +// Return to the column from a value +assertThat(changes).change().column().valueAtEndPoint().returnToColumn()... +// Return to the row from a value +assertThat(changes).change().rowAtEndPoint().value().returnToRow()... +---- + +That also means that the two navigations below are equivalent. + +[source,java] +---- +// Navigate to the first change +// Navigate to the row at end point +// Navigate to the first value +// Return to the column from this value +// Navigate to the next value +assertThat(changes).change().rowAtEndPoint().value().returnToRow().value()... +// The same thing is done but the return to the row is implicit +assertThat(changes).change().rowAtEndPoint().value().value()... +---- + +[[assertions]] +== Assertions + +[[onchangetype]] +=== On the type of change + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnChangeType.html[AssertOnChangeType] interface. + +These assertions allow to verify the type of a change (the concept of change of type is described xref:concepts.adoc#changetype[here]). + +[source,java] +---- +// Verify that the first change is a change of creation +assertThat(changes).change().isOfType(ChangeType.CREATION); +---- + +There are specific assertion methods for each type of change. For example, the assertion below is equivalent to the one above + +[source,java] +---- +assertThat(changes).change().isCreation(); +---- + +[[oncolumnequality]] +=== On the equality with the values of a column + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnEquality.html[AssertOnColumnEquality] +and the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnOfChangeEquality.html[AssertOnColumnOfChangeEquality] interfaces. + +These assertion allow to verify the values of a column (the column of a table, of a request or of a change). + +[[oncolumnequality-boolean]] +==== With Boolean + +[source,java] +---- +// Verify that the values of the column "live" of the request +// was equal to true, to false and after to true +assertThat(request).column("live").hasValues(true, false, true); +// Verify that the value of the first column of the first change +// was false at start point and is true at end point +assertThat(changes).change().column().hasValues(false, true); +// Verify that the value of the third column of the first change +// is not modified and is true +assertThat(changes).change().column(2).hasValues(true); +---- + +[[oncolumnequality-bytes]] +==== With Bytes + +[source,java] +---- +// Get bytes from a file and from a resource in the classpath +byte[] bytesFromFile = Assertions.bytesContentOf(file); +byte[] bytesFromClassPath = Assertions.bytesContentFromClassPathOf(resource); +// Verify that the values of the second column of the request +// was equal to the bytes from the file, to null and to bytes from the resource +assertThat(request).column(1).hasValues(bytesFromFile, null, bytesFromClassPath); +// Verify that the value of the first column of the first change +// was equal to bytes from the file at start point and to bytes from the resource at end point +assertThat(changes).change().column().hasValues(bytesFromFile, bytesFromClassPath); +---- + +[[oncolumnequality-number]] +==== With Number + +[source,java] +---- +// Verify that the values of the first column of the table +// was equal to 5.9, 4 and 15000 +assertThat(table).column().hasValues(5.9, 4, new BigInteger("15000")); +// Verify that the value of the first column of the first change +// is not modified and is equal to 5 +assertThat(changes).change().column().hasValues(5); +---- + +[[oncolumnequality-date]] +==== With Date + +[source,java] +---- +// Verify that the values of the first column of the table +// was equal to December 23rd 2007 and May 19th 1975 +assertThat(table).column() + .hasValues(LocalDate.of(2007, 12, 23), + LocalDate.of(1975, 5, 19)); +// Verify that the value of the first column of the first change +// was equal December 23rd 2007 at start point +// and is equal to May 19th 1975 at end point +assertThat(changes).change().column() + .hasValues(LocalDate.parse("2007-12-23"), + LocalDate.parse("1975-05-19")); +---- + +[[oncolumnequality-time]] +==== With Time + +[source,java] +---- +// Verify that the values of the first column of the table +// was equal to 09:01am and 05:30:50pm +assertThat(table).column() + .hasValues(LocalTime.of(9, 1), + LocalTime.of(17, 30, 50)); +// Verify that the value of the first column of the first change +// was equal to 09:01am at start point +// and is equal to 05:30:50pm at end point +assertThat(changes).change().column() + .hasValues(LocalTime.parse("09:01"), + LocalTime.parse("17:30:50")); +---- + +[[oncolumnequality-datetime]] +==== With Date/Time + +[source,java] +---- +// Verify that the values of the first column of the table +// was equal to December 23rd 2007 09:01am and May 19th 1975 +assertThat(table).column() + .hasValues(LocalDateTime.of(LocalDate.of(2007, 12, 23), + LocalTime.parse("09:01")), + LocalDateTime.of(LocalDate.of(1975, 5, 19), + LocalTime.MIDNIGHT)); +// Verify that the value of the first column of the first change +// was equal December 23rd 2007 09:01am at start point +// and is equal to May 19th 1975 at end point +assertThat(changes).change().column() + .hasValues(LocalDateTime.parse("2007-12-23T09:01"), + LocalDateTime.parse("1975-05-19T00:00")); +---- + +[[oncolumnequality-string]] +==== With String + +[source,java] +---- +// Verify that values are equal to texts +assertThat(table).column("name") + .hasValues("Hewson", + "Evans", + "Clayton", + "Mullen"); +// Verify that the value of the column "size" of the first change of modification +// is not modified and is equal to 1.75 by parsing +assertThat(changes).changeOfModification().column("size") + .hasValues("1.75"); +// Verify that values are equal to dates, times or dates/times by parsing +assertThat(table).column() + .hasValues("2007-12-23T09:01"), + "1975-05-19"); +---- + +[[oncolumnequality-uuid]] +==== With UUID + +Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] + +[source,java] +---- +// Verify that the values of the first column of the table +// was equal to 30B443AE-C0C9-4790-9BEC-CE1380808435, 0E2A1269-EFF0-4233-B87B-B53E8B6F164D +// and 2B0D1BDD-909E-4362-BA10-C930BA82718D +assertThat(table).column().hasValues(UUID.fromString("30B443AE-C0C9-4790-9BEC-CE1380808435"), + UUID.fromString("0E2A1269-EFF0-4233-B87B-B53E8B6F164D"), + UUID.fromString("2B0D1BDD-909E-4362-BA10-C930BA82718D")); +// Verify that the value of the first column of the first change +// is not modified and is equal to 399FFFCA-7874-4225-9903-E227C4E9DCC1 +assertThat(changes).change() + .column().hasValues(UUID.fromString("399FFFCA-7874-4225-9903-E227C4E9DCC1")); +---- + +[[oncolumnequality-character]] +==== With Character + +Since xref:release-notes.adoc#v1-2-0-release-notes[1.2.0] + +[source,java] +---- +// Verify that the values of the first column of the table +// was equal to 'T', 'e', 's' and 't' +assertThat(table).column().hasValues('T', 'e', 's', 't'); +// Verify that the value of the first column of the first change +// is not modified and is equal to 'T' +assertThat(changes).change().column().hasValues('T'); +---- + +[[oncolumnname]] +=== On the name of a column + +This assertion is described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnName.html[AssertOnColumnName] interface. + +This assertion allows to verify the name of a column (the column of a table, of a request or of a change). + +[source,java] +---- +// Verify that the fifth column of the table is called "firstname" +assertThat(table).column(4).hasColumnName("firstname"); +// Verify that the third value of the second row of the request is in a column called "name" +assertThat(request).row(1).value(2).hasColumnName("name"); +// Verify that the first column of the first change is called "id" +assertThat(changes).change().column().hasColumnName("id"); +---- + +[[oncolumnnullity]] +=== On the nullity of the values of a column + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnNullity.html[AssertOnColumnNullity] interface. + +These assertion allows to verify the nullity of the values of a column (the column of a table or of a request). + +[source,java] +---- +// Verify that the fifth column of the table has only null values +assertThat(table).column(4).hasOnlyNullValues(); +// Verify that the column "name" has only not null values +assertThat(request).column("name").hasOnlyNotNullValues(); +---- + +[[onrownullity]] +=== On the nullity of the values of a row + +Since xref:release-notes.adoc#v1-2-0-release-notes[1.2.0] + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnRowNullity.html[AssertOnRowNullity] interface. + +These assertion allows to verify the nullity of the values of a row (the row of a table or of a request). + +[source,java] +---- +// Verify that the fifth row of the table has only not null values +assertThat(table).row(4).hasOnlyNotNullValues(); +// Verify that the first column has only not null values +assertThat(request).row().hasOnlyNotNullValues(); +---- + +[[oncolumntype]] +=== On the type of column + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnType.html[AssertOnColumnType] interface. + +These assertions allow to verify the type of the values of a column (a column from a table, from a request or from a change). + +[source,java] +---- +// Verify that the values of the column called "firstname" +// of the table are a text (null values are considered as wrong) +assertThat(table).column("firstname").isOfType(ValueType.TEXT, false); +// The same verification (with the specific method) +// on the third column of the request +assertThat(request).column(2).isText(false); +// Now the same verification again but with a lenience with null values +// (the null values are not considered as wrong) +assertThat(request).column(2).isText(true); +// Verify that the values of the first column +// of the first change is either a date or a number +assertThat(changes).change().column() + .isOfAnyOfTypes(ValueType.DATE, ValueType.NUMBER); +---- + +[[oncolumnclass]] +=== On the class of column + +Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] + +This assertion is described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnClass.html[AssertOnColumnClass] interface. + +This assertion allows to verify the class of the values of a column (a column from a table, from a request or from a change). + +[source,java] +---- +// Verify that the values of the column called "firstname" +// of the table are a String (null values are considered as wrong) +assertThat(table).column("firstname").isOfClass(String.class, false); +// Verify that the values of the first column +// of the first change is a Locale (null values are considered as right) +assertThat(changes).change().column().isOfClass(Locale.class, true); +---- + +[[oncolumncontent]] +=== On the content of column + +Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnContent.html[AssertOnColumnContent] interface. + +These assertions allow to verify the content of a column (a column from a table or from a request). + +[source,java] +---- +// Verify that the content of the column called "name" +assertThat(table).column("name").containsValues("Hewson", + "Evans", + "Clayton", + "Mullen"); +// This second assertion is equivalent because the order of the values is not important +assertThat(table).column("name").containsValues("Evans", + "Clayton", + "Hewson", + "Mullen"); + +---- + +[[ondatatype]] +=== On the type of data + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnDataType.html[AssertOnDataType] interface. + +These assertions allow to verify the type of the date on which is a change. + +[source,java] +---- +// Verify that the change is on a table +assertThat(changes).change().isOnDataType(DataType.TABLE); +// The same verification (with the specific method) +assertThat(changes).change().isOnTable(); +// Verify that the change is on the "members" table +assertThat(changes).change().isOnTable("members"); +---- + +[[onmodifiedcolumns]] +=== On the modified columns in a change + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnModifiedColumn.html[AssertOnModifiedColumn] +and the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnModifiedColumns.html[AssertOnModifiedColumns] interfaces. + +These assertions allow to verify if a column of a change have been modified between the start point and the end point (see the xref:concepts.adoc#changes[concept of changes]). + +[source,java] +---- +// Verify that first column of the change is not modified +// and the second column is modified +assertThat(changes).change().column().isNotModified().column().isModified(); +// Verify that there are 2 modified columns in the change +assertThat(changes).change().hasNumberOfModifiedColumns(2); +// Verify that the modified column in change are at index 1 and 2 +assertThat(changes).change().hasModifiedColumns(1, 2); +// Verify that the modified column in change are "name" and "firstname" +assertThat(changes).change().hasModifiedColumns("name", "firstname"); +---- + +Since version xref:release-notes.adoc#v1-1-0-release-notes[1.1.0], there are new assertions which allow to compare the number of modified columns between the start point and the end point. + +[source,java] +---- +// Verify that the number of modified columns in the first change is more than 5 +assertThat(changes).change().hasNumberOfModifiedColumnsGreaterThan(5); +// Verify that the number of modified columns in the first change is at least 5 +assertThat(changes).change().hasNumberOfModifiedColumnsGreaterThanOrEqualTo(5); +// Verify that the number of modified columns in the first change is less than 6 +assertThat(changes).change().hasNumberOfModifiedColumnsLessThan(6); +// Verify that the number of modified columns in the first change is at most 6 +assertThat(changes).change().hasNumberOfModifiedColumnsLessThanOrEqualTo(6); +---- + +[[onnumberchanges]] +=== On the number of changes + +This assertion is described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnNumberOfChanges.html[AssertOnNumberOfChanges] interface. + +This assertion allows to verify the number of changes. + +[source,java] +---- +// Verify that there are 4 changes +assertThat(changes).hasNumberOfChanges(4); +---- + +Since version xref:release-notes.adoc#v1-1-0-release-notes[1.1.0], there are new assertions which allow to compare the number of changes between the start point and the end point. + +[source,java] +---- +// Verify that the number of changes is more than 5 +assertThat(changes).hasNumberOfChangesGreaterThan(5); +// Verify that the number of changes is at least 5 +assertThat(changes).hasNumberOfChangesGreaterThanOrEqualTo(5); +// Verify that the number of changes is less than 6 +assertThat(changes).hasNumberOfChangesLessThan(6); +// Verify that the number of changes is at most 6 +assertThat(changes).hasNumberOfChangesLessThanOrEqualTo(6); +---- + +[[onnumbercolumns]] +=== On the number of columns + +This assertion is described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnNumberOfColumns.html[AssertOnNumberOfColumns] interface. + +This assertion allows to verify the number of columns (columns from a table, from a request or from a change). + +[source,java] +---- +// Verify that there are 6 columns in the table +assertThat(table).hasNumberOfColumns(6); +// Verify that there are 4 columns in the change +assertThat(changes).change().hasNumberOfColumns(4); +---- + +Since version xref:release-notes.adoc#v1-1-0-release-notes[1.1.0], there are new assertions which allow to compare the number of columns. + +[source,java] +---- +// Verify that the number of columns is more than 5 +assertThat(table).hasNumberOfColumnsGreaterThan(5); +// Verify that the number of columns is at least 5 +assertThat(request).hasNumberOfColumnsGreaterThanOrEqualTo(5); +// Verify that the number of columns is less than 6 +assertThat(changes).hasNumberOfColumnsLessThan(6); +// Verify that the number of columns is at most 6 +assertThat(changes).hasNumberOfColumnsLessThanOrEqualTo(6); +---- + +[[onnumberrows]] +=== On the number of rows + +This assertion is described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnNumberOfRows.html[AssertOnNumberOfRows] interface. + +This assertion allows to verify the number of rows (rows from a table or from a request). + +[source,java] +---- +// Verify that there are 7 rows in the table +assertThat(table).hasNumberOfRows(7); +---- + +Since version xref:release-notes.adoc#v1-1-0-release-notes[1.1.0], there are new assertions which allow to compare the number of rows. + +[source,java] +---- +// Verify that the number of rows is more than 5 +assertThat(table).hasNumberOfRowsGreaterThan(5); +// Verify that the number of rows is at least 5 +assertThat(request).hasNumberOfRowsGreaterThanOrEqualTo(5); +// Verify that the number of rows is less than 6 +assertThat(changes).hasNumberOfRowsLessThan(6); +// Verify that the number of rows is at most 6 +assertThat(changes).hasNumberOfRowsLessThanOrEqualTo(6); +---- + +Since version xref:release-notes.adoc#v1-2-0-release-notes[1.2.0], there is a new assertion which allow to verify if rows are empty (equivalent to `hasNumberOfRows(0)`). + +[source,java] +---- +// Verify that the table are empty +assertThat(table).isEmpty(); +---- + +[[onprimarykeys]] +=== On the primary keys + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnPrimaryKey.html[AssertOnPrimaryKey] interface. + +These assertions allow to verify the names and the values of the columns which compose the primary keys of the rows from a change. + +[source,java] +---- +// Verify that the columns of the primary keys are "id" and "name" +assertThat(changes).change().hasPksNames("id", "name"); +// Verify that the values of the primary keys are 1 and "HEWSON" +assertThat(changes).change().hasPksValues(1, "HEWSON"); +---- + +[[onrowequality]] +=== On the equality with the values of a row + +This assertion is described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnRowEquality.html[AssertOnRowEquality] interface. + +This assertion allow to verify the values of a row (the row of a table, of a request or of a change). + +[source,java] +---- +// Verify the values of the row at index 1 +assertThat(table).row(1) + .hasValues(2, + "Evans", + "David Howell", + "The Edge", + DateValue.of(1961, 8, 8), + 1.77); +// Verify the values of the row at end point +assertThat(changes).change().rowAtEndPoint() + .hasValues(5, + "McGuiness", + "Paul", + null, + "1951-06-17", + null); +---- + +[[onrowexistence]] +=== On the existence of a row in a change + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnRowOfChangeExistence.html[AssertOnRowOfChangeExistence] interface. + +These assertions allow to verify that the row at start point or at end point of a change exists or not (for a creation, the row do not exist at start point and for a deletion it is the contrary : the row do not exist at end point). + +[source,java] +---- +// Verify that row at start point exists +assertThat(changes).change().rowAtStartPoint().exists(); +// Verify that the row at end point do not exist +assertThat(changes).change().rowAtEndPoint().doesNotExist(); +---- + +[[onvaluechronology]] +=== On the chronology of a value + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueChronology.html[AssertOnValueChronology] interface. + +These assertions allow to compare a value (the value of a table, of a request or of a change) to a date, a time or a date/time. + +[source,java] +---- +// Compare the value with a date +assertThat(table).row(1).value("birthdate") + .isAfter(DateValue.of(1950, 8, 8)); +// Verify the value is between two dates/times +assertThat(changes).change().column("release").valueAtEndPoint() + .isAfterOrEqualTo(DateTimeValue.parse("2014-09-08T23:30")) + .isBeforeOrEqualTo(DateTimeValue.parse("2014-09-09T05:30")); +---- + +[[onvaluecomparison]] +=== On the comparison with a value + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueComparison.html[AssertOnValueComparison] interface. + +These assertions allow to compare a value (the value of a table, of a request or of a change) to a number. + +[source,java] +---- +// Compare the value with a number +assertThat(table).row(1).value("size") + .isGreaterThan(1.5); +// Verify the value is between two numbers +assertThat(changes).change().column("size").valueAtEndPoint() + .isGreaterThanOrEqualTo(1.7) + .isLessThanOrEqualTo(1.8); +---- + +[[onvaluecloseness]] +=== On the closeness of a value + +Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueCloseness.html[AssertOnValueCloseness] interface. + +These assertions allow to verify if a value (the value of a table, of a request or of a change) is close to another. + +[source,java] +---- +// Verify if the value is close to 2 with a tolerance of 0.5 +// So the values between 1.5 and 2.5 are right +assertThat(table).row(1).value("size") + .isCloseTo(2, 0.5); +// Verify the value is close to 05-10-1960 with a tolerance of two days +assertThat(changes).change().column("birth").valueAtEndPoint() + .isCloseTo(DateValue(1960, 5, 10), + DateValue(0, 0, 2)); +---- + +[[onvaluequality]] +=== On the equality with a value + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueEquality.html[AssertOnValueEquality] interface. + +These assertion allow to verify that a value (the value of a table, of a request or of a change) is equal to another value (in parameter). + +[[onvaluequality-boolean]] +==== With Boolean + +[source,java] +---- +// Verify that the value is equal to true +assertThat(table).row(3).value("live").isEqualTo(true); +// Do the same thing with the specific method +assertThat(table).row(3).value("live").isTrue(); +---- + +[[onvaluequality-bytes]] +==== With Bytes + +[source,java] +---- +// Get bytes from a file +byte[] bytesFromFile = Assertions.bytesContentOf(file); +// Verify that the value at end point of the first column of the first change +// is equal to bytes from the file +assertThat(changes).change().column().valueAtStartPoint().isEqualTo(bytesFromFile); +---- + +[[onvaluequality-number]] +==== With Number + +[source,java] +---- +// Verify that the first value is equal to 1.77, +// the second is equal to 50 and the last is equal to zero +assertThat(request).column("size").value().isEqualTo(1.77) + .value().isEqualTo(50) + .value().isEqualTo(0).isZero(); +---- + +[[onvaluequality-date]] +==== With Date + +[source,java] +---- +// Verify that values are equal to dates +assertThat(changes).changeOfCreation() + .rowAtEndPoint() + .value("birthdate") + .isEqualTo(LocalDate.of(1951, 6, 17)) + .changeOfModification() + .column("birthdate") + .isEqualTo() + .isNotEqualTo(LocalDate.parse("1960-05-10")) + .valueAtEndPoint() + .isEqualTo(LocalDate.of(1960, 5, 10)); +---- + +[[onvaluequality-time]] +==== With Time + +[source,java] +---- +// Verify that the value is equal to a time +assertThat(table).row().value("duration").isEqualTo(LocalTime.of(9, 1)); +---- + +[[onvaluequality-datetime]] +==== With Date/Time + +[source,java] +---- +// Verify that the value is equal to a date/time +assertThat(request).column().value() + .isEqualTo(LocalDateTime.of(2007, 12, 23,9, 1, 0)) + .isEqualTo(LocalDateTime.parse("2007-12-23T09:01")); +---- + +[[onvaluequality-string]] +==== With String + +[source,java] +---- +// Verify that the values are equal to numbers, texts and dates +assertThat(table).row().value().isEqualTo("1") + .value().isEqualTo("Hewson") + .value().isEqualTo("Paul David") + .value().isEqualTo("Bono") + .value().isEqualTo("1960-05-10") + .value().isEqualTo("1.75"); +---- + +[[onvaluequality-uuid]] +==== With UUID + +Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] + +[source,java] +---- +// Verify that the values are equal to UUID +assertThat(table).column().value().isEqualTo(UUID.fromString("30B443AE-C0C9-4790-9BEC-CE1380808435")) + .value().isEqualTo(UUID.fromString("0E2A1269-EFF0-4233-B87B-B53E8B6F164D")) + .value().isEqualTo(UUID.fromString("2B0D1BDD-909E-4362-BA10-C930BA82718D")); +---- + +[[onvaluequality-character]] +==== With Character + +Since xref:release-notes.adoc#v1-2-0-release-notes[1.2.0] + +[source,java] +---- +// Verify that the values are equal to Character +assertThat(table).column().value().isEqualTo('T') + .value().isEqualTo('e') + .value().isEqualTo('s') + .value().isEqualTo('t'); +---- + +[[onvaluenonquality]] +=== On the non equality with a value + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueNonEquality.html[AssertOnValueNonEquality] interface. + +These assertion allow to verify that a value (the value of a table, of a request or of a change) is not equal to another value (in parameter). + +[[onvaluenonquality-boolean]] +==== With Boolean + +[source,java] +---- +// Verify that the values (values "live" in the row at index 3 and index 5) +// are not equal to false +assertThat(table).row(3).value("live").isNotEqualTo(false) + .row(5).value("live").isNotEqualTo(false); +---- + +[[onvaluenonquality-bytes]] +==== With Bytes + +[source,java] +---- +// Get bytes from a resource in the classpath +byte[] bytesFromClassPath = Assertions.bytesContentFromClassPathOf(resource); +// Verify that the value at end point of the first column of the first change +// is not equal to bytes from the resource +assertThat(changes).change().column().valueAtStartPoint().isNotEqualTo(bytesFromClassPath); +---- + +[[onvaluenonquality-number]] +==== With Number + +[source,java] +---- +// Verify that the first value is not equal to 1.78, +// the second is not equal to 55 and the last is not equal to 15 +assertThat(request).column("size").value().isNotEqualTo(1.78) + .value().isNotEqualTo(55) + .value().isNotEqualTo(15); +---- + +[[onvaluenonquality-date]] +==== With Date + +[source,java] +---- +// Verify that values are not equal to dates +assertThat(changes).changeOfCreation() + .rowAtEndPoint() + .value("birthdate") + .isNotEqualTo(LocalDate.of(1951, 6, 17)) + .changeOfModification() + .column("birthdate") + .valueAtStartPoint() + .isNotEqualTo(LocalDate.parse("1960-05-10")) + .valueAtEndPoint() + .isNotEqualTo(LocalDate.of(1960, 5, 10)); +---- + +[[onvaluenonquality-time]] +==== With Time + +[source,java] +---- +// Verify that the value is equal to a time +assertThat(table).row().value("duration").isNotEqualTo(LocalTime.of(9, 1)); +---- + +[[onvaluenonquality-datetime]] +==== With Date/Time + +[source,java] +---- +// Verify that the value is not equal to a date/time +assertThat(request).column().value() + .isNotEqualTo(LocalDateTime.of(2015, 5, 26,22, 46))) + .isNotEqualTo(LocalDateTime.parse("2015-05-26T22:46")); +---- + +[[onvaluenonquality-string]] +==== With String + +[source,java] +---- +// Verify that the values are not equal to numbers, texts and dates +assertThat(table).row().value().isNotEqualTo("5") + .value().isNotEqualTo("McGuiness") + .value().isNotEqualTo("Paul") + .value("birthdate").isNotEqualTo("1951-06-17"); +---- + +[[onvaluenonquality-uuid]] +==== With UUID + +Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] + +[source,java] +---- +// Verify that the values are not equal to UUID +assertThat(table).column() + .value().isNotEqualTo(UUID.fromString("30B443AE-C0C9-4790-9BEC-CE1380808435")) + .value().isNotEqualTo(UUID.fromString("0E2A1269-EFF0-4233-B87B-B53E8B6F164D")) + .value().isNotEqualTo(UUID.fromString("2B0D1BDD-909E-4362-BA10-C930BA82718D")); +---- + +[[onvaluenonquality-character]] +==== With Character + +Since xref:release-notes.adoc#v1-2-0-release-notes[1.2.0] + +[source,java] +---- +// Verify that the values are not equal to Character +assertThat(table).column() + .value().isNotEqualTo('T') + .value().isNotEqualTo('e') + .value().isNotEqualTo('s') + .value().isNotEqualTo('t'); +---- + +[[onvaluenullity]] +=== On the nullity of a value + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueNullity.html[AssertOnValueNullity] interface. + +These assertions allow to verify if a value (the value of a table, of a request or of a change) is null or not. + +[source,java] +---- +// Verify that the value at index 1 is null and the next value is not null +assertThat(table).column().value(1).isNull() + .value().isNotNull(); +// Verify the value is not null +assertThat(changes).change().rowAtStartPoint().value("live") + .isNotNull(); +---- + +[[onvaluetype]] +=== On the type of a value + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueType.html[AssertOnValueType] interface. + +This assertion allows to verify the type of a value (a value from a table, from a request or from changes). + +[source,java] +---- +// Verify that the value of the column called "firstname" +// of the fifth row of the table is a text +assertThat(table).row(4).value("firstname").isOfType(ValueType.TEXT); +// The same verification (with the specific method) +// on the third value of the second row of the request +assertThat(request).row(1).value(2).isText(); +// Verify that the value at start point of the first column +// of the first change is either a date or a number +assertThat(changes).change().column().valueAtStartPoint() + .isOfAnyOfTypes(ValueType.DATE, ValueType.NUMBER); +---- + +[[onvalueclass]] +=== On the class of a value + +Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] + +This assertion is described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueClass.html[AssertOnValueClass] interface. + +This assertion allows to verify the class of a value (a value from a table, from a request or from changes). + +[source,java] +---- +// Verify that the value of the column called "firstname" +// of the fifth row of the table is a String +assertThat(table).row(4).value("firstname").isOfClass(String.class); +// Verify that the value at start point of the first column +// of the first change is a Locale +assertThat(changes).change().column().valueAtStartPoint() + .isOfClass(Locale.class); +---- diff --git a/docs/modules/ROOT/pages/index.adoc b/docs/modules/ROOT/pages/index.adoc new file mode 100644 index 00000000..01717d6d --- /dev/null +++ b/docs/modules/ROOT/pages/index.adoc @@ -0,0 +1,38 @@ += AssertJ DB + +image::assertj-db_icon.png[] + +AssertJ-DB provides assertions to test data in a database. +It requires Java 8 or later and can be used with either JUnit or TestNG. + +If you need additional assertions, please create a ticket in the https://github.com/assertj/assertj-db/issues?labels=&milestone=&page=1&state=open[AssertJ-DB issue tracker]. + +AssertJ-DB is hosted on GitHub: https://github.com/assertj/assertj-db[https://github.com/assertj/assertj-db]. + +Big thanks to Joel Costigliola for his welcome, for his help and for having accepted to associate this project with a great project like AssertJ. + +_Régis Pouiller (AssertJ-DB creator)_ + +== Javadoc + +Latest Javadoc release: https://www.javadoc.io/doc/org.assertj/assertj-db/latest/index.html[AssertJ DB Javadoc]. + +== Examples + +Some implementations examples are visible at the {assertj-examples-github}/tree/main/assertions-examples/src/test/java/org/assertj/examples/db[assertj-db-examples tests]. +They show what is possible with AssertJ DB Assertions with running code. +You can clone the repository and run its tests ! + +== Mailing list + +If you have any questions, please use the https://groups.google.com/forum/?fromgroups=#!forum/assertj[AssertJ google group]. + +== Code and issue tracker + +AssertJ-DB is hosted on GitHub: https://github.com/assertj/assertj-db[https://github.com/assertj/assertj-db]. + +Please report bugs or missing features in the https://github.com/assertj/assertj-db/issues?labels=&milestone=&page=1&state=open[AssertJ-DB issue tracker]. + +== Contributing + +Thanks for your interest ! Please check our https://github.com/assertj/assertj-db/blob/main/CONTRIBUTING.md#contributing[contributor's guidelines]. diff --git a/docs/modules/ROOT/pages/quickstart.adoc b/docs/modules/ROOT/pages/quickstart.adoc new file mode 100644 index 00000000..cf1b26da --- /dev/null +++ b/docs/modules/ROOT/pages/quickstart.adoc @@ -0,0 +1,79 @@ += Quick start + +Suppose that the database contains this table *MEMBERS* : + +|==== +|ID |NAME |FIRSTNAME |SURNAME |BIRTHDATE |SIZE + +|1 |'Hewson' |'Paul David' |'Bono' |05-10-60 |1.75 +|2 |'Evans' |'David Howell' |'The Edge' |08-08-61 |1.77 +|3 |'Clayton' |'Adam' |  |03-13-60 |1.78 +|4 |'Mullen' |'Larry' |  |10-31-61 |1.70 +|==== + +To quickly start using DataBase assertions, follow the steps below. + +[[quickstart-dependency]] +== Add the assertj-db dependency to your project + +=== Maven + +[source,xml,subs=attributes+] +---- + + org.assertj + assertj-db + {assertj-db-version} + test + +---- + +=== Gradle + +For Gradle users (using the Maven Central Repository) + +[source,java,subs=attributes+] +---- +testImplementation("org.assertj:assertj-db:{assertj-db-version}") +---- + +=== Other dependency management tool + +Check this page to find the relevant https://search.maven.org/#artifactdetails|org.assertj|assertj-db|3.0.2|bundle[assertj db dependency declaration]. + +== Statically import Assertions.assertThat + +[NOTE] +==== +- From version 3.0.2 use org.assertj.**core**.api.Assertions.assertThat directly + - No more double import problem - see issue https://github.com/assertj/assertj-db/issues/329[329] +- For previous versions use org.assertj.**db**.api.Assertions.assertThat +==== + +\... and use your preferred IDE code completion after assertThat. + +Example from {assertj-examples-github}/blob/main/assertions-examples/src/test/java/org/assertj/examples/db/TableAssertionExamples.java[TableAssertionExamples.java] : + +[source,java] +---- +include::example$java/example/db/TableAssertionExamples.java[tags=user_guide] +---- + +In this simple example you can see many `[concepts of AssertJ-DB] (the concepts are simple but I advice you to take the time to get to know them well) : + +* xref:concepts.adoc#elements[the elements] : +** xref:concepts.adoc#table[Table] which represents a table in the database +** xref:concepts.adoc#column[Column] which represents a column of the table +** xref:concepts.adoc#row[Row] which represents a row of the table +** xref:concepts.adoc#value[Value] which represents a value in a column or in a row +* xref:concepts.adoc#tableorrequestasroot[the navigation] : +** The first check, navigates from the table to the column called "name" +(``column("name")`` moves the assertion to the column), +from this column to the first value (the first call of ``value()`` moves to the first value) +and after that to each value (each call of ``value()`` moves to the next value of the column). +** The second check, navigates from the table to the row with index 1 +(``row(1)`` moves the assertion to the row), +from this row to the first value +and after that to each value (``value()`` calls have similar behavior for rows and columns). +* xref:concepts.adoc#datevaluetimevaluedatetimevalue[DateValue] : Since 2.0.0, AssertJ-DB baseline is Java 8. The preferred way to compare values with date, time and date/time is to use java.time.LocalDate, java.time.LocalTime, java.time.LocalDateTime. +But for the backward compatibility, it's always possible to use AssertJ-DB DateValue utilities. diff --git a/docs/modules/ROOT/pages/release-notes.adoc b/docs/modules/ROOT/pages/release-notes.adoc new file mode 100644 index 00000000..98f52afe --- /dev/null +++ b/docs/modules/ROOT/pages/release-notes.adoc @@ -0,0 +1,239 @@ += Release Notes + +[[v3-0-2-release-notes]] +== AssertJ DB 3.0.2 + +Release date: 2026-02-21 + +[[v3-0-2-contributors]] +[.release-note-category]#icon:user[] Contributors# + +Thanks to https://github.com/fl0rian-p[@fl0rian-p] and https://github.com/jmaniquet[Jonathan Maniquet] for their contributions. + +[[v3.0.2-improvements]] +[.release-note-category]#icon:arrow-circle-up[] Improvements# + +- https://github.com/assertj/assertj-db/issues/329[issue #329:] Makes Core and DB assertions coexist with only one import by https://github.com/jmaniquet[Jonathan Maniquet] + +[[v3.0.2-fixed]] +[.release-note-category]#icon:wrench[] Fixed# + +- https://github.com/assertj/assertj-db/issues/328[issue #328:] Use Values#areEqual when looking for modified columns by https://github.com/fl0rian-p[@fl0rian-p] + +[[v3.0.2-chore]] +[.release-note-category]#icon:cog[] Chore# + +- https://github.com/assertj/assertj-db/issues/332[issue #332:] Replace Junit4 assertions by AssertJ ones by https://github.com/jmaniquet[Jonathan Maniquet] + +[[v3-0-1-release-notes]] +== AssertJ DB 3.0.1 + +Release date: 2025-12-21 + +[[v3-0-1-contributors]] +[.release-note-category]#icon:user[] Contributors# + +Thanks to https://github.com/fl0rian-p[@fl0rian-p] for his contribution. + +[[v3.0.1-fixed]] +[.release-note-category]#icon:wrench[] Fixed# + +- https://github.com/assertj/assertj-db/issues/325[issue #325] Support array comparison by https://github.com/fl0rian-p[@fl0rian-p] + +[[v3.0.1-chore]] +[.release-note-category]#icon:cog[] Chore# + +- Upgrade to AssertJ Parent POM 2.27.6 + +[[v3-0-0-release-notes]] +== AssertJ DB 3.0.0 + +Release date: 2024-11-20 + +[[v3.0.0-improvements]] +[.release-note-category]#icon:arrow-circle-up[] Improvements# + +- Fluent construction of AssertJ-DB connection to database +- Cacheable database schema metadata +- Fluent database element builder ( Table, Request, Changes ) + +[[v3.0.0-breaking-changes]] +[.release-note-category]#icon:exclamation-triangle[] Breaking changes# + +- Remove classes : Source, SourceWithLetterCase, DataSourceWithLetterCase +- Remove public constructor of classes : Table, Request, Changes + +[[v3.0.0-fixed]] +[.release-note-category]#icon:wrench[] Fixed# + +- https://github.com/assertj/assertj-db/issues/117[issue #117]: setStartPoint opens a lot of connections to the db + +[[v3.0.0-chore]] +[.release-note-category]#icon:cog[] Chore# + +- Upgrade GitHub actions +- Upgrade to AssertJ Core 3.21.0 + +[[v2-0-2-release-notes]] +== AssertJ DB 2.0.2 + +Release date: 2020-10-17 + +[[v2-0-2-contributors]] +[.release-note-category]#icon:user[] Contributors# + +Thanks to @soezen for his contribution. + +[[v2.0.2-fixed]] +[.release-note-category]#icon:wrench[] Fixed# + +- https://github.com/assertj/assertj-db/issues/107[issue #107]: Fix SoftAssertions on changes + +[[v2.0.2-chore]] +[.release-note-category]#icon:cog[] Chore# + +- Upgrade to AssertJ Core 3.17.2 +- Upgrade to AssertJ Parent POM 2.2.8 +- Upgrade to ByteBuddy 1.10.17 + +[[v2-0-1-release-notes]] +== AssertJ DB 2.0.1 + +Release date: 2020-10-07 + +[[v2-0-1-contributors]] +[.release-note-category]#icon:user[] Contributors# + +Thanks to Yosuke Nishikawa ( @sciencesakura ) for his contribution. + +[[v2.0.1-improvements]] +[.release-note-category]#icon:arrow-circle-up[] Improvements# + +- Implement isNotEqualTo, isBefore, isBeforeOrEqualTo, isAfter, isAfterOrEqualTo for JSR-310 types + +[[v2.0.1-fixed]] +[.release-note-category]#icon:wrench[] Fixed# + +- Fix isEqualTo for JSR-310 types + +[[v2-0-0-release-notes]] +== AssertJ DB 2.0.0 + +Release date: 2020-07-06 + +[[v2-0-0-contributors]] +[.release-note-category]#icon:user[] Contributors# + +Thanks to Yosuke Nishikawa ( @sciencesakura ), Pascal Schumacher and @sullis for their contributions. + +[[v2.0.0-improvements]] +[.release-note-category]#icon:arrow-circle-up[] Improvements# + +- Baseline upgrade to Java 8 +- Upgrade to AssertJ Core 3.16.1 +- Support JSR-310 types ( LocalDate, LocalTime, LocalDateTime ) +- Move from CGLIB to Bytebuddy for soft assertions + +[[v2.0.0-breaking-changes]] +[.release-note-category]#icon:exclamation-triangle[] Breaking changes# + +- Baseline upgrade to Java 8 +- Upgrade to AssertJ Core 3.16.1 + +[[v2.0.0-chore]] +[.release-note-category]#icon:cog[] Chore# + +- Replace Travis by GitHub actions +- Activate SonarCloud analysis + +[[v1-3-0-release-notes]] +== AssertJ DB 1.3.0 + +Release date: 2019-12-26 + +[[v1.3.0-improvements]] +[.release-note-category]#icon:arrow-circle-up[] Improvements# + +- https://github.com/assertj/assertj-db/issues/58[issue #58]: Implement SoftAssertions +- https://github.com/assertj/assertj-db/issues/57[issue #57]: Implement condition assertions +- https://github.com/assertj/assertj-db/issues/12[issue #12]: Implement assertions on table existence + +[[v1.3.0-fixed]] +[.release-note-category]#icon:wrench[] Fixed# + +- https://github.com/assertj/assertj-db/issues/62[issue #62]: Fix close-to when tolerance exceed 60 seconds + +[[v1-2-0-release-notes]] +== AssertJ DB 1.2.0 + +Release date: 2017-05-08 + +[[v1.2.0-improvements]] +[.release-note-category]#icon:arrow-circle-up[] Improvements# + +- https://github.com/assertj/assertj-db/issues/36[issue #36]: Add order on table (with ``Order``) +- https://github.com/assertj/assertj-db/issues/41[issue #41]: Add ``BDDAssertions`` so you can use ``then()`` instead of ``assertThat()`` (https://github.com/PascalSchumacher[Pascal Schumacher]) +- https://github.com/assertj/assertj-db/issues/43[issue #43]: Add ``isEqualTo(Character)`` and ``isNotEqualTo(Character)`` for values. Add ``hasValues(Character...)`` and ``containsValues(Character...)`` for columns. Add ``hasValues(Character)`` and ``hasValues(Character, Character)`` for columns of changes +- https://github.com/assertj/assertj-db/issues/45[issue #45]: Add support for testing that a row contains no Null values: ``hasOnlyNotNullValues()`` assertion method (https://github.com/fiery-phoenix[fiery-phoenix]) +- Add ``isEmpty()`` assertion method related to number of rows (https://github.com/fiery-phoenix[fiery-phoenix]) + +[[v1-2-0-fixed]] +[.release-note-category]#icon:wrench[] Fixed# + +- https://github.com/assertj/assertj-db/issues/39[issue #39]: Add start delimiter and end delimiter for table name and column name (used to generate the request) in ``Table`` +- https://github.com/assertj/assertj-db/issues/49[issue #49]: ``NullPointerException`` while asserting no changes +- https://github.com/assertj/assertj-db/issues/52[issue #52]: Fix about the outputs with column name and value with % + +[[v1-1-1-release-notes]] +== AssertJ DB 1.1.1 + +Release date: 2016-04-23 + +[[v1.1.1-fixed]] +[.release-note-category]#icon:wrench[] Fixed# + +- https://github.com/assertj/assertj-db/issues/37[issue #37]: assertj-db 1.1.0 does not work with java 7 + +[[v1-1-0-release-notes]] +== AssertJ DB 1.1.0 + +Release date: 2016-04-14 + +[[v1-1-0-improvements]] +[.release-note-category]#icon:arrow-circle-up[] Improvements# + +- Add ``from(Calendar)`` and ``now()`` methods to ``DateValue``, ``TimeValue`` and ``DateTimeValue`` +- https://github.com/assertj/assertj-db/issues/9[issue #9]: Provide a way to view the data of a ``Table``, of a ``Request`` or of ``Changes`` with ``Outputs`` +- https://github.com/assertj/assertj-db/issues/15[issue #15]: Add support for ``UUID`` type columns (Otoniel Isidoro) +- Add a ``isOfClass(Class)`` assertion method for value and column +- https://github.com/assertj/assertj-db/issues/18[issue #18]: Add ``isCloseTo(...)`` methods for ``Number``, ``DateValue``, ``TimeValue`` and ``DateTimeValue`` +- https://github.com/assertj/assertj-db/issues/19[issue #19]: Add support for BLOBs and CLOBs +- https://github.com/assertj/assertj-db/issues/22[issue #22]: Add ``isEqualTo(Object)`` for values. Add ``hasValues(Object...)`` for columns. Add ``hasValues(Object)`` and ``hasValues(Object, Object)`` for columns of changes +- https://github.com/assertj/assertj-db/issues/25[issue #25]: Add ``containsValues(...)`` methods for columns +- https://github.com/assertj/assertj-db/issues/29[issue #29]: Add ``hasNumberOfXXXGreaterThan(...)``, ``hasNumberOfXXXLessThan(...)``, ``hasNumberOfXXXGreaterThanOrEqualTo(...)`` and ``hasNumberOfXXXLessThanOrEqualTo(...)`` methods for the rows, columns, changes and modified columns +- https://github.com/assertj/assertj-db/issues/34[issue #34]: Enhance exception message when column does not exist + +[[v1.1.0-fixed]] +[.release-note-category]#icon:wrench[] Fixed# + +- https://github.com/assertj/assertj-db/issues/21[issue #21]: Add possibility to pass a reference containing a ``null`` value like parameter to ``isEqualTo()`` and ``isNotEqualTo()`` +- https://github.com/assertj/assertj-db/issues/23[issue #23]: Fix support of ``Number``s (bug when the mapping is a ``Double`` instance) +- https://github.com/assertj/assertj-db/issues/31[issue #31]: Fix detection of primary keys (caused by letter case) in some DBMS +- https://github.com/assertj/assertj-db/issues/32[issue #32]: Fix SQL requests for DBMS with letter case different from upper case in the name of the DB elements + +[[v1-0-1-release-notes]] +== AssertJ DB 1.0.1 + +Release date: 2015-08-09 + +[[v1.0.1-fixed]] +[.release-note-category]#icon:wrench[] Fixed# + +- https://github.com/assertj/assertj-db/issues/13[issue #13]: ``AbstractMethodError`` when creating a ``Table`` using a ``Datasource`` instead of a ``Source`` + +[[v1-0-0-release-notes]] +== AssertJ DB 1.0.0 + +Release date: 2015-07-12 + +First AssertJ DB release. diff --git a/docs/package.json b/docs/package.json new file mode 100644 index 00000000..223ea05e --- /dev/null +++ b/docs/package.json @@ -0,0 +1,7 @@ +{ + "private": true, + "devDependencies": { + "@antora/collector-extension": "1.0.3", + "antora": "3.2.2" + } +} diff --git a/docs/pom.xml b/docs/pom.xml new file mode 100644 index 00000000..bf2230e6 --- /dev/null +++ b/docs/pom.xml @@ -0,0 +1,104 @@ + + + 4.0.0 + + + org.assertj + assertj-parent + 3.27.6 + + + + assertj-db-docs + + 3.0.2 + + AssertJ DB Docs + + + true + true + true + + true + + true + + + + + org.assertj + assertj-db + ${project.version} + test + + + org.junit.jupiter + junit-jupiter + test + + + + + + + org.apache.maven.plugins + maven-jar-plugin + + true + + + + + io.spring.maven.antora + antora-component-version-maven-plugin + 0.0.4 + + + validate + + antora-component-version + + + + + + + maven-resources-plugin + + + antora-resources + process-resources + + copy-resources + + + ${project.build.directory}/antora + + + antora-resources + true + + + + + + + + org.antora + antora-maven-plugin + 1.0.0-alpha.5 + + true + + + v26 + + + + + + + + + diff --git a/docs/src/test/java/example/db/TableAssertionExamples.java b/docs/src/test/java/example/db/TableAssertionExamples.java new file mode 100644 index 00000000..c403e6a9 --- /dev/null +++ b/docs/src/test/java/example/db/TableAssertionExamples.java @@ -0,0 +1,49 @@ +package example.db; + +// tag::user_guide[] +// From v3.0.2 +import static org.assertj.core.api.Assertions.assertThat; + +// For versions <= 3.0.1 : +// import static org.assertj.db.api.Assertions.assertThat; + +import org.assertj.db.type.AssertDbConnection; +import org.assertj.db.type.AssertDbConnectionFactory; +import org.assertj.db.type.DateValue; +import org.assertj.db.type.Table; + +// end::user_guide[] + +import org.junit.jupiter.api.Test; + +public class TableAssertionExamples { +// tag::user_guide[] +private AssertDbConnection assertDbConnection = AssertDbConnectionFactory.of("jdbc:h2:mem:test", "sa", "").create(); + +// end::user_guide[] + /** + * This example shows a simple case of test. + */ + @Test + public void basic_table_assertion_examples() { +// tag::user_guide[] +Table table = assertDbConnection.table("members").build(); + +// Check column "name" values +assertThat(table).column("name") + .value().isEqualTo("Hewson") + .value().isEqualTo("Evans") + .value().isEqualTo("Clayton") + .value().isEqualTo("Mullen"); + +// Check row at index 1 (the second row) values +assertThat(table).row(1) + .value().isEqualTo(2) + .value().isEqualTo("Evans") + .value().isEqualTo("David Howell") + .value().isEqualTo("The Edge") + .value().isEqualTo(DateValue.of(1961, 8, 8)) + .value().isEqualTo(1.77); +// end::user_guide[] + } +} From 0b4e69d0357bde001a1ff9fd1384b0c909029963 Mon Sep 17 00:00:00 2001 From: Marc Philipp Date: Thu, 19 Nov 2026 15:18:09 +0100 Subject: [PATCH 02/13] Move Antora into main project --- .github/dependabot.yml | 6 +- .github/workflows/build.yml | 6 +- .gitignore | 4 +- docs/.gitignore | 2 - docs/antora.yml | 14 --- docs/pom.xml | 104 ------------------ docs/package.json => package.json | 0 pom.xml | 44 ++++++++ .../docs}/antora-resources/antora.yml | 0 {docs => src/docs/antora}/antora-playbook.yml | 6 +- src/docs/antora/antora.yml | 14 +++ .../modules/ROOT/images/assertj-db_icon.png | Bin .../ROOT/images/db-changes-concept.png | Bin .../docs/antora}/modules/ROOT/nav.adoc | 0 .../antora}/modules/ROOT/pages/concepts.adoc | 0 .../antora}/modules/ROOT/pages/features.adoc | 0 .../antora}/modules/ROOT/pages/index.adoc | 0 .../modules/ROOT/pages/quickstart.adoc | 0 .../modules/ROOT/pages/release-notes.adoc | 0 .../example/db/TableAssertionExamples.java | 14 ++- 20 files changed, 81 insertions(+), 133 deletions(-) delete mode 100644 docs/.gitignore delete mode 100644 docs/antora.yml delete mode 100644 docs/pom.xml rename docs/package.json => package.json (100%) rename {docs => src/docs}/antora-resources/antora.yml (100%) rename {docs => src/docs/antora}/antora-playbook.yml (72%) create mode 100644 src/docs/antora/antora.yml rename {docs => src/docs/antora}/modules/ROOT/images/assertj-db_icon.png (100%) rename {docs => src/docs/antora}/modules/ROOT/images/db-changes-concept.png (100%) rename {docs => src/docs/antora}/modules/ROOT/nav.adoc (100%) rename {docs => src/docs/antora}/modules/ROOT/pages/concepts.adoc (100%) rename {docs => src/docs/antora}/modules/ROOT/pages/features.adoc (100%) rename {docs => src/docs/antora}/modules/ROOT/pages/index.adoc (100%) rename {docs => src/docs/antora}/modules/ROOT/pages/quickstart.adoc (100%) rename {docs => src/docs/antora}/modules/ROOT/pages/release-notes.adoc (100%) rename {docs/src => src}/test/java/example/db/TableAssertionExamples.java (68%) diff --git a/.github/dependabot.yml b/.github/dependabot.yml index 12417830..dd3299a0 100644 --- a/.github/dependabot.yml +++ b/.github/dependabot.yml @@ -18,11 +18,7 @@ updates: github-actions: patterns: - "*" - - package-ecosystem: "maven" - directory: "/docs" - schedule: - interval: "weekly" - package-ecosystem: "npm" - directory: "/docs" + directory: "/" schedule: interval: "weekly" diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 18221a8a..487e9677 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -24,19 +24,19 @@ jobs: java-version: '21' cache: 'maven' - name: Build with Maven - run: ./mvnw -B install javadoc:javadoc + run: ./mvnw -B verify javadoc:javadoc - name: Set up Node.js uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0 with: node-version: '26' - name: Generate documentation - run: ./mvnw -B -f docs test-compile antora -Dnode.executable=node + run: ./mvnw -B antora -Dnode.executable=node - name: Upload documentation uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2 with: name: docs if-no-files-found: error - path: docs/target/site + path: target/site # - name: Sonar Analysis # if: ${{ github.event_name == 'push' || github.event.pull_request.head.repo.full_name == github.repository }} # run: ./mvnw -B sonar:sonar diff --git a/.gitignore b/.gitignore index d37ccf9c..20e014b7 100644 --- a/.gitignore +++ b/.gitignore @@ -16,4 +16,6 @@ out .java-version /bin/ .mvn/wrapper/maven-wrapper.jar -dependency-reduced-pom.xml \ No newline at end of file +dependency-reduced-pom.xml +#Node.js +/node_modules diff --git a/docs/.gitignore b/docs/.gitignore deleted file mode 100644 index 050c6035..00000000 --- a/docs/.gitignore +++ /dev/null @@ -1,2 +0,0 @@ -/node_modules -/target diff --git a/docs/antora.yml b/docs/antora.yml deleted file mode 100644 index a163db1f..00000000 --- a/docs/antora.yml +++ /dev/null @@ -1,14 +0,0 @@ -name: assertj-db -title: AssertJ DB -version: true -nav: - - modules/ROOT/nav.adoc -ext: - collector: - - run: - command: ./mvnw -q -f docs process-resources - local: true - scan: - - dir: docs/target/antora - - dir: docs/src/test/java - into: modules/ROOT/examples/java diff --git a/docs/pom.xml b/docs/pom.xml deleted file mode 100644 index bf2230e6..00000000 --- a/docs/pom.xml +++ /dev/null @@ -1,104 +0,0 @@ - - - 4.0.0 - - - org.assertj - assertj-parent - 3.27.6 - - - - assertj-db-docs - - 3.0.2 - - AssertJ DB Docs - - - true - true - true - - true - - true - - - - - org.assertj - assertj-db - ${project.version} - test - - - org.junit.jupiter - junit-jupiter - test - - - - - - - org.apache.maven.plugins - maven-jar-plugin - - true - - - - - io.spring.maven.antora - antora-component-version-maven-plugin - 0.0.4 - - - validate - - antora-component-version - - - - - - - maven-resources-plugin - - - antora-resources - process-resources - - copy-resources - - - ${project.build.directory}/antora - - - antora-resources - true - - - - - - - - org.antora - antora-maven-plugin - 1.0.0-alpha.5 - - true - - - v26 - - - - - - - - - diff --git a/docs/package.json b/package.json similarity index 100% rename from docs/package.json rename to package.json diff --git a/pom.xml b/pom.xml index 48e1dfcd..2186a9e3 100644 --- a/pom.xml +++ b/pom.xml @@ -205,6 +205,50 @@ + + + io.spring.maven.antora + antora-component-version-maven-plugin + 0.0.4 + + + org.antora + antora-maven-plugin + 1.0.0-alpha.5 + + true + + + v26 + src/docs/antora/antora-playbook.yml + + + + + + + org.apache.maven.plugins + maven-resources-plugin + + + + antora-resources + + copy-resources + + + ${project.build.directory}/antora + + + src/docs/antora-resources + true + + + + + + org.sonatype.central central-publishing-maven-plugin diff --git a/docs/antora-resources/antora.yml b/src/docs/antora-resources/antora.yml similarity index 100% rename from docs/antora-resources/antora.yml rename to src/docs/antora-resources/antora.yml diff --git a/docs/antora-playbook.yml b/src/docs/antora/antora-playbook.yml similarity index 72% rename from docs/antora-playbook.yml rename to src/docs/antora/antora-playbook.yml index c2dd461e..33cc71d5 100644 --- a/docs/antora-playbook.yml +++ b/src/docs/antora/antora-playbook.yml @@ -6,12 +6,12 @@ site: start_page: assertj-db::index.adoc content: sources: - - url: ./.. # the local repository, relative to this playbook + - url: ./../../.. # the local repository, relative to this playbook branches: HEAD # use the worktree so that uncommitted changes are included - start_path: docs + start_path: src/docs/antora ui: bundle: url: https://github.com/assertj/antora-ui/releases/latest/download/ui-bundle.zip snapshot: true output: - dir: ./target/site + dir: ./../../../target/site diff --git a/src/docs/antora/antora.yml b/src/docs/antora/antora.yml new file mode 100644 index 00000000..da176a6a --- /dev/null +++ b/src/docs/antora/antora.yml @@ -0,0 +1,14 @@ +name: assertj-db +title: AssertJ DB +version: true +nav: + - modules/ROOT/nav.adoc +ext: + collector: + - run: + command: ./mvnw -q io.spring.maven.antora:antora-component-version-maven-plugin:antora-component-version resources:copy-resources@antora-resources + local: true + scan: + - dir: target/antora + - dir: src/test/java/example + into: modules/ROOT/examples/java/example diff --git a/docs/modules/ROOT/images/assertj-db_icon.png b/src/docs/antora/modules/ROOT/images/assertj-db_icon.png similarity index 100% rename from docs/modules/ROOT/images/assertj-db_icon.png rename to src/docs/antora/modules/ROOT/images/assertj-db_icon.png diff --git a/docs/modules/ROOT/images/db-changes-concept.png b/src/docs/antora/modules/ROOT/images/db-changes-concept.png similarity index 100% rename from docs/modules/ROOT/images/db-changes-concept.png rename to src/docs/antora/modules/ROOT/images/db-changes-concept.png diff --git a/docs/modules/ROOT/nav.adoc b/src/docs/antora/modules/ROOT/nav.adoc similarity index 100% rename from docs/modules/ROOT/nav.adoc rename to src/docs/antora/modules/ROOT/nav.adoc diff --git a/docs/modules/ROOT/pages/concepts.adoc b/src/docs/antora/modules/ROOT/pages/concepts.adoc similarity index 100% rename from docs/modules/ROOT/pages/concepts.adoc rename to src/docs/antora/modules/ROOT/pages/concepts.adoc diff --git a/docs/modules/ROOT/pages/features.adoc b/src/docs/antora/modules/ROOT/pages/features.adoc similarity index 100% rename from docs/modules/ROOT/pages/features.adoc rename to src/docs/antora/modules/ROOT/pages/features.adoc diff --git a/docs/modules/ROOT/pages/index.adoc b/src/docs/antora/modules/ROOT/pages/index.adoc similarity index 100% rename from docs/modules/ROOT/pages/index.adoc rename to src/docs/antora/modules/ROOT/pages/index.adoc diff --git a/docs/modules/ROOT/pages/quickstart.adoc b/src/docs/antora/modules/ROOT/pages/quickstart.adoc similarity index 100% rename from docs/modules/ROOT/pages/quickstart.adoc rename to src/docs/antora/modules/ROOT/pages/quickstart.adoc diff --git a/docs/modules/ROOT/pages/release-notes.adoc b/src/docs/antora/modules/ROOT/pages/release-notes.adoc similarity index 100% rename from docs/modules/ROOT/pages/release-notes.adoc rename to src/docs/antora/modules/ROOT/pages/release-notes.adoc diff --git a/docs/src/test/java/example/db/TableAssertionExamples.java b/src/test/java/example/db/TableAssertionExamples.java similarity index 68% rename from docs/src/test/java/example/db/TableAssertionExamples.java rename to src/test/java/example/db/TableAssertionExamples.java index c403e6a9..fda43cf8 100644 --- a/docs/src/test/java/example/db/TableAssertionExamples.java +++ b/src/test/java/example/db/TableAssertionExamples.java @@ -1,3 +1,15 @@ +/* + * 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-2025 the original author or authors. + */ package example.db; // tag::user_guide[] @@ -14,7 +26,7 @@ // end::user_guide[] -import org.junit.jupiter.api.Test; +import org.junit.Test; public class TableAssertionExamples { // tag::user_guide[] From ec38197102c6fb32ffad90a4c2a111f9cd837cf3 Mon Sep 17 00:00:00 2001 From: Marc Philipp Date: Thu, 19 Nov 2026 15:29:50 +0100 Subject: [PATCH 03/13] Add "Documentation" section to contributing guidelines --- CONTRIBUTING.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index d96c76d6..6d7f9f46 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -12,3 +12,24 @@ We appreciate your effort and to make sure that your pull request is easy to rev * Failing assertion unit test method name must start with : `should_fail_...`. * If possible, add a (fun) code example in [assertj-examples](https://github.com/joel-costigliola/assertj-examples) and use it in the javadoc. + +Documentation +------------- + +The user guide is written in AsciiDoc and built with [Antora](https://antora.org). +Its pages are in `src/docs/antora/modules/ROOT/pages`, and the code examples they include are in `src/test/java/example`. + +The code examples are compiled with the test sources, so an API change that breaks them fails the build. +They are not executed as tests, because they need a database that does not exist. +Pages include them by tag, e.g. `include::example$java/example/db/TableAssertionExamples.java[tags=user_guide]`. + +To preview your changes, generate the site: + +```shell +./mvnw antora +``` + +Then open `target/site/index.html` in a browser (the build prints the full `file://` URL at the end). +The preview only contains the AssertJ DB guide; the complete site is assembled from all AssertJ repositories by [docs.assertj.dev](https://github.com/assertj/docs.assertj.dev). +No Node.js installation is required: the first run downloads Node.js into `target/node` and the Antora packages into `node_modules`. +To use a Node.js installation from your `PATH` instead, add `-Dnode.executable=node`. From 43a753eeae279bf0644171e5e9f3f271de2fe048 Mon Sep 17 00:00:00 2001 From: Marc Philipp Date: Thu, 19 Nov 2026 15:53:52 +0100 Subject: [PATCH 04/13] Split concepts and features into separate pages Break the two long pages of the user guide into one page per section, `concepts/*.adoc` and `features/*.adoc`, and nest them in the navigation. Cross-references now point at the new pages. --- src/docs/antora/modules/ROOT/nav.adoc | 14 +- .../antora/modules/ROOT/pages/concepts.adoc | 1081 ----------------- .../ROOT/pages/concepts/connection.adoc | 73 ++ .../modules/ROOT/pages/concepts/datetime.adoc | 85 ++ .../ROOT/pages/concepts/description.adoc | 21 + .../modules/ROOT/pages/concepts/elements.adoc | 529 ++++++++ .../modules/ROOT/pages/concepts/index.adoc | 42 + .../ROOT/pages/concepts/letter-case.adoc | 93 ++ .../ROOT/pages/concepts/navigation.adoc | 92 ++ .../modules/ROOT/pages/concepts/output.adoc | 74 ++ .../modules/ROOT/pages/concepts/types.adoc | 56 + .../ROOT/pages/features/assertions.adoc | 858 +++++++++++++ .../modules/ROOT/pages/features/index.adoc | 5 + .../navigation.adoc} | 891 +------------- .../antora/modules/ROOT/pages/quickstart.adoc | 14 +- 15 files changed, 1959 insertions(+), 1969 deletions(-) delete mode 100644 src/docs/antora/modules/ROOT/pages/concepts.adoc create mode 100644 src/docs/antora/modules/ROOT/pages/concepts/connection.adoc create mode 100644 src/docs/antora/modules/ROOT/pages/concepts/datetime.adoc create mode 100644 src/docs/antora/modules/ROOT/pages/concepts/description.adoc create mode 100644 src/docs/antora/modules/ROOT/pages/concepts/elements.adoc create mode 100644 src/docs/antora/modules/ROOT/pages/concepts/index.adoc create mode 100644 src/docs/antora/modules/ROOT/pages/concepts/letter-case.adoc create mode 100644 src/docs/antora/modules/ROOT/pages/concepts/navigation.adoc create mode 100644 src/docs/antora/modules/ROOT/pages/concepts/output.adoc create mode 100644 src/docs/antora/modules/ROOT/pages/concepts/types.adoc create mode 100644 src/docs/antora/modules/ROOT/pages/features/assertions.adoc create mode 100644 src/docs/antora/modules/ROOT/pages/features/index.adoc rename src/docs/antora/modules/ROOT/pages/{features.adoc => features/navigation.adoc} (52%) diff --git a/src/docs/antora/modules/ROOT/nav.adoc b/src/docs/antora/modules/ROOT/nav.adoc index 00281f97..bce3a719 100644 --- a/src/docs/antora/modules/ROOT/nav.adoc +++ b/src/docs/antora/modules/ROOT/nav.adoc @@ -1,5 +1,15 @@ * xref:index.adoc[Overview] * xref:quickstart.adoc[] -* xref:concepts.adoc[] -* xref:features.adoc[] +* xref:concepts/index.adoc[] +** xref:concepts/connection.adoc[] +** xref:concepts/elements.adoc[] +** xref:concepts/types.adoc[] +** xref:concepts/navigation.adoc[] +** xref:concepts/datetime.adoc[] +** xref:concepts/description.adoc[] +** xref:concepts/letter-case.adoc[] +** xref:concepts/output.adoc[] +* xref:features/index.adoc[] +** xref:features/navigation.adoc[] +** xref:features/assertions.adoc[] * xref:release-notes.adoc[] diff --git a/src/docs/antora/modules/ROOT/pages/concepts.adoc b/src/docs/antora/modules/ROOT/pages/concepts.adoc deleted file mode 100644 index afb4a087..00000000 --- a/src/docs/antora/modules/ROOT/pages/concepts.adoc +++ /dev/null @@ -1,1081 +0,0 @@ -= Concepts - -For the examples below, suppose that the database contains these three tables : - -.MEMBERS -|==== -|ID |NAME |FIRSTNAME |SURNAME |BIRTHDATE |SIZE - -|1 |'Hewson' |'Paul David' |'Bono' |05-10-60 |1.75 -|2 |'Evans' |'David Howell' |'The Edge' |08-08-61 |1.77 -|3 |'Clayton' |'Adam' | |03-13-60 |1.78 -|4 |'Mullen' |'Larry' | |10-31-61 |1.70 -|==== - -.ALBUMS -|==== -|ID |RELEASE |TITLE |NUMBEROFSONGS |DURATION |LIVE - -|1 |10-20-80 |'Boy' |12 |42:17 | -|2 |10-12-81 |'October' |11 |41:08 | -|3 |02-28-83 |'War' |10 |42:07 | -|4 |11-07-83 |'Under a Blood Red Sky' |8 |33:25 |true -|5 |10-01-84 |'The Unforgettable Fire' |10 |42:42 | -|6 |06-10-85 |'Wide Awake in America' |4 |20:30 |true -|7 |03-09-87 |'The Joshua Tree' |11 |50:11 | -|8 |10-10-88 |'Rattle and Hum' |17 |72:27 | -|9 |11-18-91 |'Achtung Baby' |12 |55:23 | -|10 |07-06-93 |'Zooropa' |10 |51:15 | -|11 |03-03-97 |'Pop' |12 |60:08 | -|12 |10-30-00 |'All That You Can't Leave Behind' |11 |49:23 | -|13 |11-22-04 |'How to Dismantle an Atomic Bomb' |11 |49:08 | -|14 |03-02-09 |'No Line on the Horizon' |11 |53:44 | -|15 |09-09-14 |'Songs of Innocence' |11 |48:11 | -|==== - -.GROUP -|==== -|ID |NAME - -|1 |'U2' -|2 |'Coldplay' -|==== - -[[connection]] -== Connection to the database - -To make assertions on a database, it is necessary to connect. The concept of `AssertDbConnection` represent how -AssertJ-DB can retrieve data and schema information from database. - -It's also with a `AssertDbConnection` that you can instantiate the following element : `Table`, `Request`, `Changes`. - -[[assertdbconnection]] -=== AssertDbConnection - -A https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/AssertDbConnection.html[AssertDbConnection] -is created with the factory https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/AssertDbConnectionFactory.html[AssertDbConnectionFactory]. - -There are 2 way to begin the AssertDbConnectionFactory, with a https://docs.oracle.com/javase/6/docs/api/javax/sql/DataSource.html[DataSource] ( the classic Java way -to get a https://docs.oracle.com/javase/6/docs/api/java/sql/Connection.html[Connection] to a database ) or with JDBC connection information. - -Below is an example of using a DataSource to connect to H2 in memory database : - -[source,java] ----- -AssertDbConnection connection = AssertDbConnectionFactory.of("jdbc:h2:mem:test", "sa", "").create(); ----- - -And using a DataSource to connect : - -[source,java] ----- -AssertDbConnection connection = AssertDbConnectionFactory.of(dataSource).create(); ----- - -[[assertdbconnectionlettercase]] -=== LetterCase setup - -https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/AssertDbConnectionFactory.html[AssertDbConnectionFactory] -provide the capacity to indicate the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] -to use for the tables, columns and primary keys. - -[source,java] ----- -AssertDbConnection connection = AssertDbConnectionFactory - .of(dataSource) - .letterCase(tableLetterCase, columnLetterCase, pkLetterCase) - .create(); ----- - -For more information, see the <>. - -[[assertdbconnectionmetadata]] -=== Schema retrieval mode - -Since xref:release-notes.adoc#v1-1-0-release-notes[3.0.0] - -For many assertions, AssertJ-DB require to discover database schema metadata ( list of tables, columns, ... ). -When the schema contains many tables this operation can slow down the tests executions. - -To avoid that and when the database schema is not updated during the test session, you can use the option -https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/SchemaMetaDataMode.html[SchemaMetaDataMode] of -https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/AssertDbConnectionFactory.html[AssertDbConnectionFactory] -to keep in memory the schema. - -Available mode are : - - - DYNAMIC ( default ): Retrieve schema metadata each time is required. - - STATIC : Retrieve schema metadata only once and keep in memory for all duration of connection. - -Below is an example of using the STATIC mode for a connection : - -[source,java] ----- -AssertDbConnection connection = AssertDbConnectionFactory.of(dataSource) - .schemaMetaDataMode(SchemaMetaDataMode.STATIC) - .create(); ----- - -[[elements]] -== Elements of the database - -Here the elements on which it is possible to make assertions. - -Note that, there are only 3 root elements : https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table], - https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.html[Request] -and https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Changes.html[Changes]. - -That means that the other elements are components or sub components of a root element. - -A root element is an element on which the assertion start (in practice, the parameter of a `assertThat(...)` method). - -[[table]] -=== Table - -A https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table] represents -a table in the database. - -A https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table] can be constructed with the builder method `table(String name)` from -https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/AssertDbConnection.html[AssertDbConnection]. - -[source,java] ----- -// Prepare the connection -AssertDbConnection connection = ... -// Declare the "members" table by using a AssertDbConnection table builder -Table table1 = connection.table("members").build(); ----- - -For more information about table construction, see the -https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.Builder.html[Table.Builder] javadoc. - -.Representation of "table1" -|==== -|ID |NAME |FIRSTNAME |SURNAME |BIRTHDATE |SIZE - -|1 |'Hewson' |'Paul David' |'Bono' |05-10-60 |1.75 -|2 |'Evans' |'David Howell' |'The Edge' |08-08-61 |1.77 -|3 |'Clayton' |'Adam' | |03-13-60 |1.78 -|4 |'Mullen' |'Larry' | |10-31-61 |1.70 -|==== - -For a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table], -it is possible to choose the columns to include and to exclude in the assertions. - -[source,java] ----- -// Get the data of the "id" and "name" columns of the "members" table -Table table2 = connection.table("members").columnsToCheck(new String[] { "id", "name" }).build(); -// Get the data of the "members" table but not of the "birthdate" column -Table table3 = connection.table("members").columnsToExclude(new String[] { "birthdate" }).build(); -// Get the data of the "name" column of the "members" table (because "id" is included and excluded) -Table table4 = connection.table("members").columnsToCheck(new String[] { "id", "name" }).columnsToExclude(new String[] { "id" }).build(); ----- - -.Representation of "table2" -|==== -|ID |NAME - -|1 |'Hewson' -|2 |'Evans' -|3 |'Clayton' -|4 |'Mullen' -|==== - -.Representation of "table3" -|==== -|ID |NAME |FIRSTNAME |SURNAME |SIZE - -|1 |'Hewson' |'Paul David' |'Bono' |1.75 -|2 |'Evans' |'David Howell' |'The Edge' |1.77 -|3 |'Clayton' |'Adam' | |1.78 -|4 |'Mullen' |'Larry' | |1.70 -|==== - -.Representation of "table4" -|==== -|NAME - -|'Hewson' -|'Evans' -|'Clayton' -|'Mullen' -|==== - -Since version xref:release-notes.adoc#v1-2-0-release-notes[1.2.0], there are the possibility to indicate delimiters (start delimiter and end delimiter) and `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.Order.html[Order]`. - -The delimiters are useful when the table name or column name is a reserved word or contains special characters (like space or '%'). - `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.Order.html[Order]` allows to choose the order of the `Row`. - -[source,java] ----- -// The line code below throws SQLException because "group" is SQL reserved word -Table table5 = connection.table("group").build(); -// Get the data of the "group" table by using "`" delimiter -// That generates a request -Table table6 = connection.table("group").delimiters('`', '`').build(); - -// Get the data from "members" table and order on "name" column in ascending order -Table table7 = connection.table("members").columnsToOrder(new Order[] { Order.asc("name") }).build(); ----- - -.Representation of "table6" -|==== -|ID |NAME - -|1 |'U2' -|2 |'Colplay' -|==== - -.Representation of "table7" -|==== -|ID |NAME |FIRSTNAME |SURNAME |BIRTHDATE |SIZE - -|3 |'Clayton' |'Adam' | |03-13-60 |1.78 -|2 |'Evans' |'David Howell' |'The Edge' |08-08-61 |1.77 -|1 |'Hewson' |'Paul David' |'Bono' |05-10-60 |1.75 -|4 |'Mullen' |'Larry' | |10-31-61 |1.70 -|==== - -[[request]] -=== Request - -A https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.html[Request] represents -a SQL request on the database. - -Like a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table], -a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.html[Request] -can be constructed with the builder method `request(String sql)` from -https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/AssertDbConnection.html[AssertDbConnection]. - -[source,java] ----- -// Prepare the connection -AssertDbConnection connection = ... -// Declare a request which gets the name and the firstname of the corresponding members -Request request1 = connection.request("select name, firstname from members where id = 2 or id = 3").build(); ----- - -For more information about request construction, see the -https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.Builder.html[Request.Builder] javadoc. - -.Representation of "request1" -|==== -|NAME |FIRSTNAME |SURNAME - -|'Evans' |'David Howell' |'The Edge' -|'Clayton' |'Adam' | -|==== - -For a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.html[Request], -it is possible to use a simple SQL request or a SQL request with one or many parameters. - -[source,java] ----- -// Declare a request which gets the name and the firstname of the members -// and use "%e%" as a parameter -Request request2 = connection.request( - "select name, firstname from members " + - "where name like ?;") - .parameters("%e%") - .build(); -// Declare a request which gets the name and the firstname of the members -// and use "%e%" and "%Paul%" as parameters -Request request3 = connection.request( - "select name, firstname from members " + - "where name like ? and firstname like ?;") - .parameters("%e%", "%Paul%") - .build(); ----- - -.Representation of "request2" -|==== -|NAME |FIRSTNAME |SURNAME - -|'Hewson' |'Paul David' |'Bono' -|'Evans' |'David Howell' |'The Edge' -|'Mullen' |'Larry' | -|==== - -.Representation of "request3" -|==== -|NAME |FIRSTNAME |SURNAME - -|'Hewson' |'Paul David' |'Bono' -|==== - -[[changes]] -=== Changes - -The https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Changes.html[Changes] -are the differences of states in database between a `start point` and a `end point`. - -image::db-changes-concept.png[] - -Assume that there are these SQL statements between the start point and the end point. - -[source,java] ----- -DELETE FROM ALBUMS WHERE ID = 15; -INSERT INTO MEMBERS(ID, NAME, FIRSTNAME) VALUES(5, 'McGuiness', 'Paul'); -UPDATE MEMBERS SET SURNAME = 'Bono Vox' WHERE ID = 1; -UPDATE ALBUMS SET NAME = 'Rattle & Hum', LIVE = true WHERE ID = 8; - ----- - -[source,java] ----- -// Prepare the connection -AssertDbConnection connection = ... -// The changes can be on a DataSource or on a Source -Changes changes1 = connection.changes().build(); -// The changes can also be on a Table or on a Request -Changes changes2 = connection.changes().table(table3).build(); -Changes changes3 = connection.changes().request(request2).build(); -// The names of the columns used for the primary key are found in the metadata for a table -// but for a request it can be important to set the primary key -Changes changes4 = connection.changes().request("select name, firstname from members", r -> r.pksName("name")).build(); ----- - -For more information about changes construction, see the -https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Changes.Builder.html[Changes.Builder] javadoc. - -The changes are ordered : - -* First by the type of the change : creation, modification and after deletion -* After if it is a change on a table by the name of the table -* To finish by the values of the primary key and if there are no primary key by the values of the row (for a modification) - -As indicated above, the primary key is used to order the changes. -But more important, the primary key is used to determinate which rows at the same with modifications. - -In Representation of "changes3" the modification of first row of the table become a creation and deletion. - -.Representation of "changes1" -[cols="1,2,3,4a"] -|==== -|Creation |"MEMBERS" table |`5` as PK | -!==== -!!ID !NAME !FIRSTNAME !SURNAME !BIRTHDATE !SIZE - -!At start point !!!!!! -!At end point !5 !'McGuiness' !'Paul' !!! -!==== -|Modification |"ALBUMS" table |`8` as PK | -!==== -!!ID !RELEASE !TITLE !NUMBEROFSONGS !DURATION !LIVE - -!At start point !8 !10-10-88 !'Rattle and Hum' !17 !72:27 ! -!At end point !8 !10-10-88 !'Rattle & Hum' !17 !72:27 !true -!==== -|Modification |"MEMBERS" table |`1` as PK | -!==== -!!ID !NAME !FIRSTNAME !SURNAME !BIRTHDATE !SIZE - -!At start point !1 !'Hewson' !'Paul David' !'Bono' !05-10-60 !1.75 -!At end point !1 !'Hewson' !'Paul David' !'Bono Vox' !05-10-60 !1.75 -!==== -|Deletion |"ALBUMS" table |`15` as PK | -!==== -!!ID !RELEASE !TITLE !NUMBEROFSONGS !DURATION !LIVE - -!At start point !15 !09-09-14 !'Songs of Innocence' !11 !48:11! -!At end point !!!!!! -!==== -|==== - -.Representation of "changes2" -[cols="1,2,3,4a"] -|==== -|Creation |"MEMBERS" table |`5` as PK | -!==== -!!ID !NAME !FIRSTNAME !SURNAME !SIZE - -!At start point !!!!! -!At end point !5 !'McGuiness' !'Paul' ! ! -!==== -|Modification |"MEMBERS" table |`1` as PK | -!==== -!!ID !NAME !FIRSTNAME !SURNAME !SIZE - -!At start point !1 !'Hewson' !'Paul David' !'Bono' !1.75 -!At end point !1 !'Hewson' !'Paul David' !'Bono Vox' !1.75 -!==== -|==== - -.Representation of "changes3" -[cols="1,2,3,4a"] -|==== -|Creation | |No PK | -!==== -!!NAME !FIRSTNAME !SURNAME - -!At start point !!! -!At end point !'Hewson' !'Paul David' !'Bono Vox' -!==== -|Creation | |No PK | -!==== -!!NAME !FIRSTNAME !SURNAME - -!At start point !!! -!At end point !'McGuiness' !'Paul' ! -!==== -|Deletion | |No PK | -!==== -!!NAME !FIRSTNAME !SURNAME - -!At start point !!! -!At end point !'Hewson' !'Paul David' !'Bono Vox' -!==== -|==== - -.Representation of "changes4" -[cols="1,2,3,4a"] -|==== -|Creation | |`'McGuiness'` as PK | -!==== -!!NAME !FIRSTNAME !SURNAME - -!At start point !!! -!At end point !'McGuiness' !'Paul' ! -!==== -|Modification | |`'Hewson'` as PK | -!==== -!!NAME !FIRSTNAME !SURNAME - -!At start point !'Hewson' !'Paul David' !'Bono' -!At end point !'Hewson' !'Paul David' !'Bono Vox' -!==== -|==== - -[[change]] -=== Change - -A https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Change.html[Change] -is an element of the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Changes.html[Changes]. - -Below framed in red the first https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Change.html[Change] -of "changes2". - -.Representation of "changes2" -[cols="1,2,3,4a"] -|==== -|Creation |"MEMBERS" table |`5` as PK | -!==== -!!ID !NAME !FIRSTNAME !SURNAME !SIZE - -!At start point !!!!! -!At end point !5 !'McGuiness' !'Paul' ! ! -!==== -|Modification |"MEMBERS" table |`1` as PK | -!==== -!!ID !NAME !FIRSTNAME !SURNAME !SIZE - -!At start point !1 !'Hewson' !'Paul David' !'Bono' !1.75 -!At end point !1 !'Hewson' !'Paul David' !'Bono Vox' !1.75 -!==== -|==== - -[[row]] -=== Row - -A https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Row.html[Row] -can represent a row of a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table] -, of a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.html[Request] or -of a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Change.html[Change]. - -Below framed in red the third https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Row.html[Row] of "table3". - -.Representation of "table3" -|==== -|ID |NAME |FIRSTNAME |SURNAME |SIZE - -|1 |'Hewson' |'Paul David' |'Bono' |1.75 -|2 |'Evans' |'David Howell' |'The Edge' |1.77 -|3 |'Clayton' |'Adam' | |1.78 -|4 |'Mullen' |'Larry' | |1.70 -|==== - -Below framed in red the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Row.html[Row] of "request2". - -.Representation of "request2" -|==== -|NAME |FIRSTNAME |SURNAME - -|'Hewson' |'Paul David' |'Bono' -|'Evans' |'David Howell' |'The Edge' -|'Mullen' |'Larry' | -|==== - -Below framed in red the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Row.html[Row] at end point of -the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Change.html[Change] -of "changes3". - -.Representation of "changes2" -[cols="1,2,3,4a"] -|==== -|Creation |"MEMBERS" table |`5` as PK | -!==== -!!ID !NAME !FIRSTNAME !SURNAME !SIZE - -!At start point !!!!! -!At end point !5 !'McGuiness' !'Paul' ! ! -!==== -|Modification |"MEMBERS" table |`1` as PK | -!==== -!!ID !NAME !FIRSTNAME !SURNAME !SIZE - -!At start point !1 !'Hewson' !'Paul David' !'Bono' !1.75 -!At end point !1 !'Hewson' !'Paul David' !'Bono Vox' !1.75 -!==== -|==== - -[[column]] -=== Column - -A https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Column.html[Column] -can represent a column of a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table] -, of a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.html[Request] or -of a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Change.html[Change]. - -Below framed in red the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Column.html[Column] of "table3". - -.Representation of "table3" -|==== -|ID |NAME |FIRSTNAME |SURNAME |SIZE - -|1 |'Hewson' |'Paul David' |'Bono' |1.75 -|2 |'Evans' |'David Howell' |'The Edge' |1.77 -|3 |'Clayton' |'Adam' | |1.78 -|4 |'Mullen' |'Larry' | |1.70 -|==== - -Below framed in red the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Column.html[Column] of "request2". - -.Representation of "request2" -|==== -|NAME |FIRSTNAME |SURNAME - -|'Hewson' |'Paul David' |'Bono' -|'Evans' |'David Howell' |'The Edge' -|'Mullen' |'Larry' | -|==== - -Below framed in red the fourth https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Column.html[Column] of -the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Change.html[Change] -of "changes3". - -.Representation of "changes2" -[cols="1,2,3,4a"] -|==== -|Creation |"MEMBERS" table |`5` as PK | -!==== -!!ID !NAME !FIRSTNAME !SURNAME !SIZE - -!At start point !!!!! -!At end point !5 !'McGuiness' !'Paul' ! ! -!==== -|Modification |"MEMBERS" table |`1` as PK | -!==== -!!ID !NAME !FIRSTNAME !SURNAME !SIZE - -!At start point !1 !'Hewson' !'Paul David' !'Bono' !1.75 -!At end point !1 !'Hewson' !'Paul David' !'Bono Vox' !1.75 -!==== -|==== - -[[value]] -=== Value - -A value can be in a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Row.html[Row] -or in a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Column.html[Column]. - -Below framed in red (depending of the path) : - -* the second value of the third https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Row.html[Row] of "table3" -* the third value of the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Column.html[Column] of "table3" - -.Representation of "table3" -|==== -|ID |NAME |FIRSTNAME |SURNAME |SIZE - -|1 |'Hewson' |'Paul David' |'Bono' |1.75 -|2 |'Evans' |'David Howell' |'The Edge' |1.77 -|3 |'Clayton' |'Adam' | |1.78 -|4 |'Mullen' |'Larry' | |1.70 -|==== - -Below framed in red (depending of the path) : - -* the second value of the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Row.html[Row] of "request2" -* the second value of the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Column.html[Column] of "request2" - -.Representation of "request2" -|==== -|NAME |FIRSTNAME |SURNAME - -|'Hewson' |'Paul David' |'Bono' -|'Evans' |'David Howell' |'The Edge' -|'Mullen' |'Larry' | -|==== - -Below framed in red (depending of the path) : - -* the fourth value of the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Row.html[Row] at end point of -the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Change.html[Change] -of "changes2" -* the value at end point of the fourth https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Column.html[Column] of -the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Change.html[Change] -of "changes2" - -.Representation of "changes2" -[cols="1,2,3,4a"] -|==== -|Creation |"MEMBERS" table |`5` as PK | -!==== -!!ID !NAME !FIRSTNAME !SURNAME !SIZE - -!At start point !!!!! -!At end point !5 !'McGuiness' !'Paul' ! ! -!==== -|Modification |"MEMBERS" table |`1` as PK | -!==== -!!ID !NAME !FIRSTNAME !SURNAME !SIZE - -!At start point !1 !'Hewson' !'Paul David' !'Bono' !1.75 -!At end point !1 !'Hewson' !'Paul David' !'Bono Vox' !1.75 -!==== -|==== - -[[type]] -== Type - -[[datatype]] -=== Data Type - -As see above there are three root elements of database, but only https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table] and https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.html[Request] are data elements. -All the possible types of data are contained in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/DataType.html[DataType] enumeration. - -The type of the data can be : - -* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/DataType.html#TABLE[TABLE]` -* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/DataType.html#REQUEST[REQUEST]` - -[[changetype]] -=== Change Type - -The change can be a creation, a modification or a deletion. -All the possible types of change are contained in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ChangeType.html[ChangeType] enumeration. - -The type of the change depends of operation on database : - -* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ChangeType.html#CREATION[CREATION]` for a `insert` sql request -* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ChangeType.html#MODIFICATION[MODIFICATION]` for a `update` sql request -* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ChangeType.html#DELETION[DELETION]` for a `delete` sql request - -[[valuetype]] -=== Value Type - -The value can be a date, a boolean or a text for example. -All the possible types of value are contained in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html[ValueType] enumeration. - -The type of the value depends of class of the object given by `java.sql` when the data are got from database : - -* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#BYTES[BYTES]` for a array of bytes (`byte[]`) -* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#BOOLEAN[BOOLEAN]` for a `java.lang.Boolean` -* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#TEXT[TEXT]` for a `java.lang.String` -* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#DATE[DATE]` for a `java.sql.Date` -* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#TIME[TIME]` for a `java.sql.Time` -* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#DATE_TIME[DATE_TIME]` for a `java.sql.Timestamp` -* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#UUID[UUID]` for a `java.util.UUID` [.small]#(since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0])# -* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#NUMBER[NUMBER]` for a `java.lang.Byte`, - `java.lang.Short`, `java.lang.Integer`, `java.lang.Long`, `java.lang.Double`, `java.lang.Float` or `java.math.BigDecimal` -* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#NOT_IDENTIFIED[NOT_IDENTIFIED]` for other cases (for example when the value is `null`) - -[[ordertype]] -=== Order Type - -Since xref:release-notes.adoc#v1-2-0-release-notes[1.2.0] - -The order can be a ascending or descending. -All the possible types of order are contained in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.Order.OrderType.html[Table.Order.OrderType] enumeration. - -The type of the order can be : - -* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.Order.OrderType.html#ASC[ASC]` for an ascending order -* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.Order.OrderType.html#DESC[DESC]` for a descending order - -[[navigation]] -== Navigation - -The navigation offers the ability to chain assertions at different levels and instructions to go inside the sub-elements and return to root element. - -There are examples of the navigation in {assertj-examples-github}/blob/main/assertions-examples/src/test/java/org/assertj/examples/db/NavigationExamples.java[NavigationExamples.java] - -[[tableorrequestasroot]] -=== With a Table or a Request as root - -The `assertThat(...)` static method of `Assertions` allows to create a root assertion on a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table]. - -[source,java] ----- -// From v3.0.2 -import static org.assertj.core.api.Assertions.assertThat; - -// For versions <= 3.0.1 : -// import static org.assertj.db.api.Assertions.assertThat; - -assertThat(table)... ----- - -or on a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.html[Request]. - -[source,java] ----- -// From v3.0.2 -import static org.assertj.core.api.Assertions.assertThat; - -// For versions <= 3.0.1 : -// import static org.assertj.db.api.Assertions.assertThat; - -assertThat(request)... ----- - -From these root assertions, it is possible to navigate to the sub elements and return to the root element as in the picture below. - -[ditaa, target="db-navigation-with-table-or-request", shadows=false, transparent=true] -.... - origin - instantiate+-----------+<-----------=+----------------------+ - +--------->|On a Column| instantiate |On a Value Of a Column| - | +-----+-----+=----------->+----------------------+ - : origin: -+----------------+------+<--------+ -|On a Table Or a Request| -+----------------+------+<--------+ - : origin: origin - | +-----+--+<-----------=+-------------------+ - +--------->|On a Row| instantiate |On a Value Of a Row| - instantiate+--------+=----------->+-------------------+ -.... - -More details on this concept in assertj-db-features-highlight.html#tableorrequestasroot[feature highlight]. - -[[changesasroot]] -=== With Changes as root - -The `assertThat(...)` static method of `Assertions` -allows to create a root assertion on https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Changes.html[Changes]. - -[source,java] ----- -// From v3.0.2 -import static org.assertj.core.api.Assertions.assertThat; - -// For versions <= 3.0.1 : -// import static org.assertj.db.api.Assertions.assertThat; - -assertThat(changes)... ----- - -From this root assertion, it is possible to navigate to the sub elements and return to the root element as in the picture below. - -[ditaa, target="db-navigation-with-changes", shadows=false, transparent=true] -.... - origin - instantiate+-----------+<-----------=+----------------------+ - +--------->|On a Column| instantiate |On a Value Of a Column| - | +-----+-----+=----------->+----------------------+ - origin : origin: -+-----------+<=-----------+-----+-----+<---------+ -|On Changes | instantiate |On a Change| -+-----------+=----------->+-----+-----+<---------+ - : origin: origin - | +-----+--+<-----------=+-------------------+ - +--------->|On a Row| instantiate |On a Value Of a Row| - instantiate+--------+=----------->+-------------------+ -.... - - -More details on this concept in xref:features.adoc#changesasroot[feature highlight]. - -[[datevaluetimevaluedatetimevalue]] -== DateValue, TimeValue and DateTimeValue - -Since 2.0.0, AssertJ-DB baseline is Java 8. The preferred way to compare values with date, time and date/time is to use java.time.LocalDate, java.time.LocalTime, java.time.LocalDateTime directly. - -But for the backward compatibility, it's always possible to use AssertJ-DB DateValue utilities. - -So The https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/DateValue.html[DateValue], - https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/TimeValue.html[TimeValue] and - https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/DateTimeValue.html[DateTimeValue] classes are simpler but contains this kind of informations. - -There is 4 kinds of static methods to instantiate these values : - -* `of` which receives the informations as `int` parameters - -[source,java] ----- -DateValue dateValue = DateValue.of(2007, 12, 23); - -// With hours and minutes only -TimeValue timeValue1 = TimeValue.of(9, 1); -// With seconds additional -TimeValue timeValue2 = TimeValue.of(9, 1, 6); -// With nanoseconds additional -TimeValue timeValue3 = TimeValue.of(9, 1, 6, 3); - -// With date only (so hour is midnight) -DateTimeValue dateTimeValue1 = DateTimeValue.of(dateValue); -// With date and time -DateTimeValue dateTimeValue2 = DateTimeValue.of(dateValue, timeValue1); ----- - -* `from` which receives the equivalent from `java.sql` package (`java.sql.Date`, `java.sql.Time` and `java.sql.Timestamp`) -or a `java.util.Calendar` [.small]#(since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0])# - -[source,java] ----- -Date date = Date.valueOf("2007-12-23"); -DateValue dateValue = DateValue.from(date); - -Time time = Time.valueOf("09:01:06"); -TimeValue timeValue = TimeValue.from(time); - -Timestamp timestamp = Timestamp.valueOf("2007-12-23 09:01:06.000000003"); -DateTimeValue dateTimeValue = DateTimeValue.from(timestamp); - -// Since 1.1.0 -Calendar calendar = Calendar.getInstance(); -DateValue dateValueFromCal = DateValue.from(calendar); -TimeValue timeValueFromCal = TimeValue.from(calendar); -DateTimeValue dateTimeValueFromCal = DateTimeValue.from(calendar); ----- - -* `parse` which receives a `String` to represent the value (this method can throw a `ParseException`) - -[source,java] ----- -DateValue dateValue = DateValue.parse("2007-12-23"); - -// With hours and minutes only -TimeValue timeValue1 = TimeValue.parse("09:01"); -// With seconds additional -TimeValue timeValue2 = TimeValue.parse("09:01:06"); -// With nanoseconds additional -TimeValue timeValue3 = TimeValue.parse("09:01:06.000000003"); - -// With date only (so hour is midnight) -DateTimeValue dateTimeValue1 = DateTimeValue.parse("2007-12-23"); -// With date and time (hours and minutes only) -DateTimeValue dateTimeValue2 = DateTimeValue.parse("2007-12-23T09:01"); -// With date and time (seconds additional) -DateTimeValue dateTimeValue2 = DateTimeValue.parse("2007-12-23T09:01:06"); -// With date and time (nanoseconds additional) -DateTimeValue dateTimeValue2 = DateTimeValue.parse("2007-12-23T09:01:06.000000003"); ----- - -* `now` [.small]#(since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0])# which create an instance corresponding to the current moment. - -[source,java] ----- -DateValue dateValue = DateValue.now(); // The current date -TimeValue timeValue = TimeValue.now(); // The current time -DateTimeValue dateTimeValue = DateTimeValue.now(); // The current date/time ----- - -All these static methods (except for `now` method) have equivalent constructors. - -[[description]] -== Default description - -In assertj, it is possible to add a description with the methods of the https://www.javadoc.io/doc/org.assertj/assertj-core/latest/org/assertj/core/api/Descriptable.html[Descriptable] interface. -This description is used in the error message if the assertion fails. - -Due to the navigation, it is more complicated in assertj-db to know on which element an error is thrown. -So to help the tester, there are default descriptions. - -For example : - -* `"members table"` for an assertion on a table -* `"'select * from actor' request"` for an assertion on a request -* `"'select id, name, firstname, bi...' request"` for an assertion on a request with more text -* `"Row at index 0 of members table"` for an assertion on a row of a table -* `"Column at index 0 (column name : ID) of 'select * from members' request"` for an assertion on a column of a request -* `"Value at index 0 of Column at index 0 (column name : ID) of 'select * from members' request"` for an assertion on a value of a column of a request -* `"Value at index 0 (column name : ID) of Row at index 0 of 'select * from members' request"` for an assertion on a value of a row of a request -* `"Value at index 0 (column name : ID) of Row at end point of Change at index 0 (on table : MEMBERS and with primary key : [4]) of Changes on tables of 'sa/jdbc:h2:mem:test' source"` -for an assertion on a value of the row at end point of a change on a table - -This default description can be replaced by the choice of the tester by using the methods of https://www.javadoc.io/doc/org.assertj/assertj-core/latest/org/assertj/core/api/Descriptable.html[Descriptable]. - -[[dblettercase]] -== Letter Case of the database - -Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] - -Databases have different letter cases for the name of the elements. -For example, the name of the table can be upper case either the name is inputted in upper case or not. So this concept (and feature too) is here to manage these shades. - -It is possible to declare a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] -with a <>. - -The concept of https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] is composed of https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversion.html[CaseConversion] and https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparison.html[CaseComparison]. - -[[caseconversion]] -=== CaseConversion - -The https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversion.html[CaseConversion] is used when getting a name with letter case from database : a table name, a column name or a primary key name. - -There are three conversions modes : https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversions.html#UPPER[UPPER] which converts to upper case (`"Name"` becomes `"NAME"`), https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversions.html#LOWER[LOWER] which converts to lower case (`"Name"` becomes `"name"`) and https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversions.html#NO[NO] which keeps the case (`"Name"` remains `"Name"`). - -Each name (table, column and primary key) got from the database is converted using a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversion.html[CaseConversion]. - -[[casecomparison]] -=== CaseComparison - -The https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparison.html[CaseComparison] is used when comparing something with letter case from database or with a parameter. - -There are two comparison modes : https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparisons.html#IGNORE[IGNORE] which compares `String`s by ignoring the case (`"Name"` is considered equal to `"NAME"`) and https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparisons.html#STRICT[STRICT] which compares `String`s strictly (`"Name"` is considered different from `"NAME"`). - -During navigation (e.g. from table to column) and assertion (e.g. on column name), the name are compared using a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparison.html[CaseComparison]. - -[[lettercase]] -=== LetterCase - -A https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] is created with the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html#getLetterCase-org.assertj.db.type.lettercase.CaseConversion-org.assertj.db.type.lettercase.CaseComparison-[getLetterCase] -static method which has a - https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversion.html[CaseConversion] and a - https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparison.html[CaseComparison] as parameters. - -[source,java] ----- -LetterCase letterCase = LetterCase.getLetterCase(CaseConversions.NO, CaseComparisons.IGNORE); ----- - -In AssertJ-DB, there are three different uses of a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] : -the table name, the column name and the primary key name. -That is the reason why the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/AssertDbConnection.html[AssertDbConnection] -have three https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] parameters. - -The https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] on the tables is used : - -* to convert the table name : when a name is got from the database like for the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table] -instantiation or for the table with changes found with https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Changes.html[Changes]. -* to compare the table name : for the instantiation when the table is search in the database for https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table], -for navigation (e.g. from changes to a change on a table) or for a assertion (like https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnDataType.html#isOnTable-java.lang.String-[isOnTable(String name)]). - -The https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] on the columns is used : - -* to convert the column name : when a column name is got from the database for a table or a request -* to compare the column name : for the navigation (e.g. from a table to a column) or for a assertion (like https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnName.html#hasColumnName-java.lang.String-[hasColumnName(String columnName)]). - -The https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] on the primary keys is used : - -* to convert the primary key name : when a primary key name is got from the database for a table -* to compare the primary key name : for a assertion (like https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnPrimaryKey.html#hasPksNames-java.lang.String...-[hasPksNames(String... names)]). - -The default settings for https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] in -https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/AssertDbConnection.html[AssertDbConnection] are : - -* https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversions.html#NO[NO] conversion -and https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparisons.html#IGNORE[IGNORE] comparison for table names -* https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversions.html#UPPER[UPPER] conversion -and https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparisons.html#IGNORE[IGNORE] comparison for the column and primary key name - -In this example, the two connections are equivalent : - -[source,java] ----- -AssertDbConnection jdbcConnection = AssertDbConnectionFactory.of("jdbc:h2:mem:test", "sa", "").create(); -Table table = jdbcConnection.table("members").build(); - -LetterCase tableLetterCase = LetterCase.getLetterCase(CaseConversions.NO, CaseComparisons.IGNORE); -LetterCase columnLetterCase = LetterCase.getLetterCase(CaseConversions.UPPER, CaseComparisons.IGNORE); -LetterCase pkLetterCase = LetterCase.getLetterCase(CaseConversions.UPPER, CaseComparisons.IGNORE); -AssertDbConnection connectionWithLC = AssertDbConnectionFactory.of("jdbc:h2:mem:test", "sa", "") - .letterCase(tableLetterCase, columnLetterCase, pkLetterCase) - .create(); -Table tableWithLC = connectionWithLC.table("members").build(); ----- - -Note that the letter case is extensible because the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html#getLetterCase-org.assertj.db.type.lettercase.CaseConversion-org.assertj.db.type.lettercase.CaseComparison-[getLetterCase] -static method's parameters are instances of the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversion.html[CaseConversion] -and the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparison.html[CaseComparison] interfaces. -So this is not limited to the implementations in the corresponding enumerations. - -[[output]] -== Output - -Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] - -It can be interesting to view the values on which an assertion is made (for example for debugging). The output allows that. - -This is a simple example : - -[source,java] ----- -import static org.assertj.db.output.Outputs.output; - -Table table = connection.table("members"); - -// Output the content of the table in the console -output(table).toConsole(); ----- - -These lines give the result below : - -[source,java] ----- -[MEMBERS table] -|-----------|---------|-----------|-----------|--------------|-----------|-----------|-----------| -| | | * | | | | | | -| | PRIMARY | ID | NAME | FIRSTNAME | SURNAME | BIRTHDATE | SIZE | -| | KEY | (NUMBER) | (TEXT) | (TEXT) | (TEXT) | (DATE) | (NUMBER) | -| | | Index : 0 | Index : 1 | Index : 2 | Index : 3 | Index : 4 | Index : 5 | -|-----------|---------|-----------|-----------|--------------|-----------|-----------|-----------| -| Index : 0 | 1 | 1 | Hewson | Paul David | Bono | 05-10-60 | 1.75 | -| Index : 1 | 2 | 2 | Evans | David Howell | The Edge | 08-08-61 | 1.77 | -| Index : 2 | 3 | 3 | Clayton | Adam | | 03-13-60 | 1.78 | -| Index : 4 | 4 | 4 | Mullen | Larry | | 10-31-61 | 1.70 | -|-----------|---------|-----------|-----------|--------------|-----------|-----------|-----------| ----- - -In the example above, the output is in plain text in the console. It is possible to change the type of the output and the destination. - -[[typeoutput]] -=== Type of output - -There are two outputs already implemented : - -* https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/output/impl/OutputType.html#PLAIN[PLAIN] : shown in the example above (the default output type) -* https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/output/impl/OutputType.html#HTML[HTML] : which represents the result as an HTML document - -[source,java] ----- -// Change the output of the table to be HTML -output(table).withType(OutputType.HTML).....; ----- - -Note that the type of output is extensible because the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/output/AbstractOutputter.html#withType-org.assertj.db.output.impl.Output-[withType(Output outputType)] method's parameter is an instance of the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/output/impl/Output.html[Output] interface. -So this is not limited to the implementations in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/output/impl/OutputType.html[OutputType] enum. - -[[destination]] -=== Destination - -The destination is the way to print the display. There are three destinations : - -* the console (with the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/output/AbstractOutputter.html#toConsole--[toConsole()] method) -* a file (with the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/output/AbstractOutputter.html#toFile-java.lang.String-[toFile(String fileName)] method) -* a stream (with the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/output/AbstractOutputter.html#toStream-java.io.OutputStream-[toStream(OutputStream outputStream)] method) - -Note that with this last method the possibilities of destination are really flexible. - -These three methods are fluent. In this short example, the output is a plain text representation in the console and a html output in a file : - -[source,java] ----- -// Display the content of the table with plain text in the console -// and with HTML output in the file -output(table).toConsole().withType(OutputType.HTML).toFile("test.html"); ----- diff --git a/src/docs/antora/modules/ROOT/pages/concepts/connection.adoc b/src/docs/antora/modules/ROOT/pages/concepts/connection.adoc new file mode 100644 index 00000000..9e5d0dc9 --- /dev/null +++ b/src/docs/antora/modules/ROOT/pages/concepts/connection.adoc @@ -0,0 +1,73 @@ += Connection to the database + +To make assertions on a database, it is necessary to connect. The concept of `AssertDbConnection` represent how +AssertJ-DB can retrieve data and schema information from database. + +It's also with a `AssertDbConnection` that you can instantiate the following element : `Table`, `Request`, `Changes`. + +[[assertdbconnection]] +== AssertDbConnection + +A https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/AssertDbConnection.html[AssertDbConnection] +is created with the factory https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/AssertDbConnectionFactory.html[AssertDbConnectionFactory]. + +There are 2 way to begin the AssertDbConnectionFactory, with a https://docs.oracle.com/javase/6/docs/api/javax/sql/DataSource.html[DataSource] ( the classic Java way +to get a https://docs.oracle.com/javase/6/docs/api/java/sql/Connection.html[Connection] to a database ) or with JDBC connection information. + +Below is an example of using a DataSource to connect to H2 in memory database : + +[source,java] +---- +AssertDbConnection connection = AssertDbConnectionFactory.of("jdbc:h2:mem:test", "sa", "").create(); +---- + +And using a DataSource to connect : + +[source,java] +---- +AssertDbConnection connection = AssertDbConnectionFactory.of(dataSource).create(); +---- + +[[assertdbconnectionlettercase]] +== LetterCase setup + +https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/AssertDbConnectionFactory.html[AssertDbConnectionFactory] +provide the capacity to indicate the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] +to use for the tables, columns and primary keys. + +[source,java] +---- +AssertDbConnection connection = AssertDbConnectionFactory + .of(dataSource) + .letterCase(tableLetterCase, columnLetterCase, pkLetterCase) + .create(); +---- + +For more information, see the xref:concepts/letter-case.adoc[paragraph on LetterCase]. + +[[assertdbconnectionmetadata]] +== Schema retrieval mode + +Since xref:release-notes.adoc#v1-1-0-release-notes[3.0.0] + +For many assertions, AssertJ-DB require to discover database schema metadata ( list of tables, columns, ... ). +When the schema contains many tables this operation can slow down the tests executions. + +To avoid that and when the database schema is not updated during the test session, you can use the option +https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/SchemaMetaDataMode.html[SchemaMetaDataMode] of +https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/AssertDbConnectionFactory.html[AssertDbConnectionFactory] +to keep in memory the schema. + +Available mode are : + + - DYNAMIC ( default ): Retrieve schema metadata each time is required. + - STATIC : Retrieve schema metadata only once and keep in memory for all duration of connection. + +Below is an example of using the STATIC mode for a connection : + +[source,java] +---- +AssertDbConnection connection = AssertDbConnectionFactory.of(dataSource) + .schemaMetaDataMode(SchemaMetaDataMode.STATIC) + .create(); +---- diff --git a/src/docs/antora/modules/ROOT/pages/concepts/datetime.adoc b/src/docs/antora/modules/ROOT/pages/concepts/datetime.adoc new file mode 100644 index 00000000..1e371e63 --- /dev/null +++ b/src/docs/antora/modules/ROOT/pages/concepts/datetime.adoc @@ -0,0 +1,85 @@ += DateValue, TimeValue and DateTimeValue + +Since 2.0.0, AssertJ-DB baseline is Java 8. The preferred way to compare values with date, time and date/time is to use java.time.LocalDate, java.time.LocalTime, java.time.LocalDateTime directly. + +But for the backward compatibility, it's always possible to use AssertJ-DB DateValue utilities. + +So The https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/DateValue.html[DateValue], + https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/TimeValue.html[TimeValue] and + https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/DateTimeValue.html[DateTimeValue] classes are simpler but contains this kind of informations. + +There is 4 kinds of static methods to instantiate these values : + +* `of` which receives the informations as `int` parameters + +[source,java] +---- +DateValue dateValue = DateValue.of(2007, 12, 23); + +// With hours and minutes only +TimeValue timeValue1 = TimeValue.of(9, 1); +// With seconds additional +TimeValue timeValue2 = TimeValue.of(9, 1, 6); +// With nanoseconds additional +TimeValue timeValue3 = TimeValue.of(9, 1, 6, 3); + +// With date only (so hour is midnight) +DateTimeValue dateTimeValue1 = DateTimeValue.of(dateValue); +// With date and time +DateTimeValue dateTimeValue2 = DateTimeValue.of(dateValue, timeValue1); +---- + +* `from` which receives the equivalent from `java.sql` package (`java.sql.Date`, `java.sql.Time` and `java.sql.Timestamp`) +or a `java.util.Calendar` [.small]#(since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0])# + +[source,java] +---- +Date date = Date.valueOf("2007-12-23"); +DateValue dateValue = DateValue.from(date); + +Time time = Time.valueOf("09:01:06"); +TimeValue timeValue = TimeValue.from(time); + +Timestamp timestamp = Timestamp.valueOf("2007-12-23 09:01:06.000000003"); +DateTimeValue dateTimeValue = DateTimeValue.from(timestamp); + +// Since 1.1.0 +Calendar calendar = Calendar.getInstance(); +DateValue dateValueFromCal = DateValue.from(calendar); +TimeValue timeValueFromCal = TimeValue.from(calendar); +DateTimeValue dateTimeValueFromCal = DateTimeValue.from(calendar); +---- + +* `parse` which receives a `String` to represent the value (this method can throw a `ParseException`) + +[source,java] +---- +DateValue dateValue = DateValue.parse("2007-12-23"); + +// With hours and minutes only +TimeValue timeValue1 = TimeValue.parse("09:01"); +// With seconds additional +TimeValue timeValue2 = TimeValue.parse("09:01:06"); +// With nanoseconds additional +TimeValue timeValue3 = TimeValue.parse("09:01:06.000000003"); + +// With date only (so hour is midnight) +DateTimeValue dateTimeValue1 = DateTimeValue.parse("2007-12-23"); +// With date and time (hours and minutes only) +DateTimeValue dateTimeValue2 = DateTimeValue.parse("2007-12-23T09:01"); +// With date and time (seconds additional) +DateTimeValue dateTimeValue2 = DateTimeValue.parse("2007-12-23T09:01:06"); +// With date and time (nanoseconds additional) +DateTimeValue dateTimeValue2 = DateTimeValue.parse("2007-12-23T09:01:06.000000003"); +---- + +* `now` [.small]#(since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0])# which create an instance corresponding to the current moment. + +[source,java] +---- +DateValue dateValue = DateValue.now(); // The current date +TimeValue timeValue = TimeValue.now(); // The current time +DateTimeValue dateTimeValue = DateTimeValue.now(); // The current date/time +---- + +All these static methods (except for `now` method) have equivalent constructors. diff --git a/src/docs/antora/modules/ROOT/pages/concepts/description.adoc b/src/docs/antora/modules/ROOT/pages/concepts/description.adoc new file mode 100644 index 00000000..06b3f10a --- /dev/null +++ b/src/docs/antora/modules/ROOT/pages/concepts/description.adoc @@ -0,0 +1,21 @@ += Default description + +In assertj, it is possible to add a description with the methods of the https://www.javadoc.io/doc/org.assertj/assertj-core/latest/org/assertj/core/api/Descriptable.html[Descriptable] interface. +This description is used in the error message if the assertion fails. + +Due to the navigation, it is more complicated in assertj-db to know on which element an error is thrown. +So to help the tester, there are default descriptions. + +For example : + +* `"members table"` for an assertion on a table +* `"'select * from actor' request"` for an assertion on a request +* `"'select id, name, firstname, bi...' request"` for an assertion on a request with more text +* `"Row at index 0 of members table"` for an assertion on a row of a table +* `"Column at index 0 (column name : ID) of 'select * from members' request"` for an assertion on a column of a request +* `"Value at index 0 of Column at index 0 (column name : ID) of 'select * from members' request"` for an assertion on a value of a column of a request +* `"Value at index 0 (column name : ID) of Row at index 0 of 'select * from members' request"` for an assertion on a value of a row of a request +* `"Value at index 0 (column name : ID) of Row at end point of Change at index 0 (on table : MEMBERS and with primary key : [4]) of Changes on tables of 'sa/jdbc:h2:mem:test' source"` +for an assertion on a value of the row at end point of a change on a table + +This default description can be replaced by the choice of the tester by using the methods of https://www.javadoc.io/doc/org.assertj/assertj-core/latest/org/assertj/core/api/Descriptable.html[Descriptable]. diff --git a/src/docs/antora/modules/ROOT/pages/concepts/elements.adoc b/src/docs/antora/modules/ROOT/pages/concepts/elements.adoc new file mode 100644 index 00000000..b433039e --- /dev/null +++ b/src/docs/antora/modules/ROOT/pages/concepts/elements.adoc @@ -0,0 +1,529 @@ += Elements of the database + +Here the elements on which it is possible to make assertions. + +Note that, there are only 3 root elements : https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table], + https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.html[Request] +and https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Changes.html[Changes]. + +That means that the other elements are components or sub components of a root element. + +A root element is an element on which the assertion start (in practice, the parameter of a `assertThat(...)` method). + +[[table]] +== Table + +A https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table] represents +a table in the database. + +A https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table] can be constructed with the builder method `table(String name)` from +https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/AssertDbConnection.html[AssertDbConnection]. + +[source,java] +---- +// Prepare the connection +AssertDbConnection connection = ... +// Declare the "members" table by using a AssertDbConnection table builder +Table table1 = connection.table("members").build(); +---- + +For more information about table construction, see the +https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.Builder.html[Table.Builder] javadoc. + +.Representation of "table1" +|==== +|ID |NAME |FIRSTNAME |SURNAME |BIRTHDATE |SIZE + +|1 |'Hewson' |'Paul David' |'Bono' |05-10-60 |1.75 +|2 |'Evans' |'David Howell' |'The Edge' |08-08-61 |1.77 +|3 |'Clayton' |'Adam' | |03-13-60 |1.78 +|4 |'Mullen' |'Larry' | |10-31-61 |1.70 +|==== + +For a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table], +it is possible to choose the columns to include and to exclude in the assertions. + +[source,java] +---- +// Get the data of the "id" and "name" columns of the "members" table +Table table2 = connection.table("members").columnsToCheck(new String[] { "id", "name" }).build(); +// Get the data of the "members" table but not of the "birthdate" column +Table table3 = connection.table("members").columnsToExclude(new String[] { "birthdate" }).build(); +// Get the data of the "name" column of the "members" table (because "id" is included and excluded) +Table table4 = connection.table("members").columnsToCheck(new String[] { "id", "name" }).columnsToExclude(new String[] { "id" }).build(); +---- + +.Representation of "table2" +|==== +|ID |NAME + +|1 |'Hewson' +|2 |'Evans' +|3 |'Clayton' +|4 |'Mullen' +|==== + +.Representation of "table3" +|==== +|ID |NAME |FIRSTNAME |SURNAME |SIZE + +|1 |'Hewson' |'Paul David' |'Bono' |1.75 +|2 |'Evans' |'David Howell' |'The Edge' |1.77 +|3 |'Clayton' |'Adam' | |1.78 +|4 |'Mullen' |'Larry' | |1.70 +|==== + +.Representation of "table4" +|==== +|NAME + +|'Hewson' +|'Evans' +|'Clayton' +|'Mullen' +|==== + +Since version xref:release-notes.adoc#v1-2-0-release-notes[1.2.0], there are the possibility to indicate delimiters (start delimiter and end delimiter) and `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.Order.html[Order]`. + +The delimiters are useful when the table name or column name is a reserved word or contains special characters (like space or '%'). + `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.Order.html[Order]` allows to choose the order of the `Row`. + +[source,java] +---- +// The line code below throws SQLException because "group" is SQL reserved word +Table table5 = connection.table("group").build(); +// Get the data of the "group" table by using "`" delimiter +// That generates a request +Table table6 = connection.table("group").delimiters('`', '`').build(); + +// Get the data from "members" table and order on "name" column in ascending order +Table table7 = connection.table("members").columnsToOrder(new Order[] { Order.asc("name") }).build(); +---- + +.Representation of "table6" +|==== +|ID |NAME + +|1 |'U2' +|2 |'Colplay' +|==== + +.Representation of "table7" +|==== +|ID |NAME |FIRSTNAME |SURNAME |BIRTHDATE |SIZE + +|3 |'Clayton' |'Adam' | |03-13-60 |1.78 +|2 |'Evans' |'David Howell' |'The Edge' |08-08-61 |1.77 +|1 |'Hewson' |'Paul David' |'Bono' |05-10-60 |1.75 +|4 |'Mullen' |'Larry' | |10-31-61 |1.70 +|==== + +[[request]] +== Request + +A https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.html[Request] represents +a SQL request on the database. + +Like a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table], +a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.html[Request] +can be constructed with the builder method `request(String sql)` from +https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/AssertDbConnection.html[AssertDbConnection]. + +[source,java] +---- +// Prepare the connection +AssertDbConnection connection = ... +// Declare a request which gets the name and the firstname of the corresponding members +Request request1 = connection.request("select name, firstname from members where id = 2 or id = 3").build(); +---- + +For more information about request construction, see the +https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.Builder.html[Request.Builder] javadoc. + +.Representation of "request1" +|==== +|NAME |FIRSTNAME |SURNAME + +|'Evans' |'David Howell' |'The Edge' +|'Clayton' |'Adam' | +|==== + +For a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.html[Request], +it is possible to use a simple SQL request or a SQL request with one or many parameters. + +[source,java] +---- +// Declare a request which gets the name and the firstname of the members +// and use "%e%" as a parameter +Request request2 = connection.request( + "select name, firstname from members " + + "where name like ?;") + .parameters("%e%") + .build(); +// Declare a request which gets the name and the firstname of the members +// and use "%e%" and "%Paul%" as parameters +Request request3 = connection.request( + "select name, firstname from members " + + "where name like ? and firstname like ?;") + .parameters("%e%", "%Paul%") + .build(); +---- + +.Representation of "request2" +|==== +|NAME |FIRSTNAME |SURNAME + +|'Hewson' |'Paul David' |'Bono' +|'Evans' |'David Howell' |'The Edge' +|'Mullen' |'Larry' | +|==== + +.Representation of "request3" +|==== +|NAME |FIRSTNAME |SURNAME + +|'Hewson' |'Paul David' |'Bono' +|==== + +[[changes]] +== Changes + +The https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Changes.html[Changes] +are the differences of states in database between a `start point` and a `end point`. + +image::db-changes-concept.png[] + +Assume that there are these SQL statements between the start point and the end point. + +[source,java] +---- +DELETE FROM ALBUMS WHERE ID = 15; +INSERT INTO MEMBERS(ID, NAME, FIRSTNAME) VALUES(5, 'McGuiness', 'Paul'); +UPDATE MEMBERS SET SURNAME = 'Bono Vox' WHERE ID = 1; +UPDATE ALBUMS SET NAME = 'Rattle & Hum', LIVE = true WHERE ID = 8; + +---- + +[source,java] +---- +// Prepare the connection +AssertDbConnection connection = ... +// The changes can be on a DataSource or on a Source +Changes changes1 = connection.changes().build(); +// The changes can also be on a Table or on a Request +Changes changes2 = connection.changes().table(table3).build(); +Changes changes3 = connection.changes().request(request2).build(); +// The names of the columns used for the primary key are found in the metadata for a table +// but for a request it can be important to set the primary key +Changes changes4 = connection.changes().request("select name, firstname from members", r -> r.pksName("name")).build(); +---- + +For more information about changes construction, see the +https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Changes.Builder.html[Changes.Builder] javadoc. + +The changes are ordered : + +* First by the type of the change : creation, modification and after deletion +* After if it is a change on a table by the name of the table +* To finish by the values of the primary key and if there are no primary key by the values of the row (for a modification) + +As indicated above, the primary key is used to order the changes. +But more important, the primary key is used to determinate which rows at the same with modifications. + +In Representation of "changes3" the modification of first row of the table become a creation and deletion. + +.Representation of "changes1" +[cols="1,2,3,4a"] +|==== +|Creation |"MEMBERS" table |`5` as PK | +!==== +!!ID !NAME !FIRSTNAME !SURNAME !BIRTHDATE !SIZE + +!At start point !!!!!! +!At end point !5 !'McGuiness' !'Paul' !!! +!==== +|Modification |"ALBUMS" table |`8` as PK | +!==== +!!ID !RELEASE !TITLE !NUMBEROFSONGS !DURATION !LIVE + +!At start point !8 !10-10-88 !'Rattle and Hum' !17 !72:27 ! +!At end point !8 !10-10-88 !'Rattle & Hum' !17 !72:27 !true +!==== +|Modification |"MEMBERS" table |`1` as PK | +!==== +!!ID !NAME !FIRSTNAME !SURNAME !BIRTHDATE !SIZE + +!At start point !1 !'Hewson' !'Paul David' !'Bono' !05-10-60 !1.75 +!At end point !1 !'Hewson' !'Paul David' !'Bono Vox' !05-10-60 !1.75 +!==== +|Deletion |"ALBUMS" table |`15` as PK | +!==== +!!ID !RELEASE !TITLE !NUMBEROFSONGS !DURATION !LIVE + +!At start point !15 !09-09-14 !'Songs of Innocence' !11 !48:11! +!At end point !!!!!! +!==== +|==== + +.Representation of "changes2" +[cols="1,2,3,4a"] +|==== +|Creation |"MEMBERS" table |`5` as PK | +!==== +!!ID !NAME !FIRSTNAME !SURNAME !SIZE + +!At start point !!!!! +!At end point !5 !'McGuiness' !'Paul' ! ! +!==== +|Modification |"MEMBERS" table |`1` as PK | +!==== +!!ID !NAME !FIRSTNAME !SURNAME !SIZE + +!At start point !1 !'Hewson' !'Paul David' !'Bono' !1.75 +!At end point !1 !'Hewson' !'Paul David' !'Bono Vox' !1.75 +!==== +|==== + +.Representation of "changes3" +[cols="1,2,3,4a"] +|==== +|Creation | |No PK | +!==== +!!NAME !FIRSTNAME !SURNAME + +!At start point !!! +!At end point !'Hewson' !'Paul David' !'Bono Vox' +!==== +|Creation | |No PK | +!==== +!!NAME !FIRSTNAME !SURNAME + +!At start point !!! +!At end point !'McGuiness' !'Paul' ! +!==== +|Deletion | |No PK | +!==== +!!NAME !FIRSTNAME !SURNAME + +!At start point !!! +!At end point !'Hewson' !'Paul David' !'Bono Vox' +!==== +|==== + +.Representation of "changes4" +[cols="1,2,3,4a"] +|==== +|Creation | |`'McGuiness'` as PK | +!==== +!!NAME !FIRSTNAME !SURNAME + +!At start point !!! +!At end point !'McGuiness' !'Paul' ! +!==== +|Modification | |`'Hewson'` as PK | +!==== +!!NAME !FIRSTNAME !SURNAME + +!At start point !'Hewson' !'Paul David' !'Bono' +!At end point !'Hewson' !'Paul David' !'Bono Vox' +!==== +|==== + +[[change]] +== Change + +A https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Change.html[Change] +is an element of the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Changes.html[Changes]. + +Below framed in red the first https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Change.html[Change] +of "changes2". + +.Representation of "changes2" +[cols="1,2,3,4a"] +|==== +|Creation |"MEMBERS" table |`5` as PK | +!==== +!!ID !NAME !FIRSTNAME !SURNAME !SIZE + +!At start point !!!!! +!At end point !5 !'McGuiness' !'Paul' ! ! +!==== +|Modification |"MEMBERS" table |`1` as PK | +!==== +!!ID !NAME !FIRSTNAME !SURNAME !SIZE + +!At start point !1 !'Hewson' !'Paul David' !'Bono' !1.75 +!At end point !1 !'Hewson' !'Paul David' !'Bono Vox' !1.75 +!==== +|==== + +[[row]] +== Row + +A https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Row.html[Row] +can represent a row of a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table] +, of a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.html[Request] or +of a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Change.html[Change]. + +Below framed in red the third https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Row.html[Row] of "table3". + +.Representation of "table3" +|==== +|ID |NAME |FIRSTNAME |SURNAME |SIZE + +|1 |'Hewson' |'Paul David' |'Bono' |1.75 +|2 |'Evans' |'David Howell' |'The Edge' |1.77 +|3 |'Clayton' |'Adam' | |1.78 +|4 |'Mullen' |'Larry' | |1.70 +|==== + +Below framed in red the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Row.html[Row] of "request2". + +.Representation of "request2" +|==== +|NAME |FIRSTNAME |SURNAME + +|'Hewson' |'Paul David' |'Bono' +|'Evans' |'David Howell' |'The Edge' +|'Mullen' |'Larry' | +|==== + +Below framed in red the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Row.html[Row] at end point of +the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Change.html[Change] +of "changes3". + +.Representation of "changes2" +[cols="1,2,3,4a"] +|==== +|Creation |"MEMBERS" table |`5` as PK | +!==== +!!ID !NAME !FIRSTNAME !SURNAME !SIZE + +!At start point !!!!! +!At end point !5 !'McGuiness' !'Paul' ! ! +!==== +|Modification |"MEMBERS" table |`1` as PK | +!==== +!!ID !NAME !FIRSTNAME !SURNAME !SIZE + +!At start point !1 !'Hewson' !'Paul David' !'Bono' !1.75 +!At end point !1 !'Hewson' !'Paul David' !'Bono Vox' !1.75 +!==== +|==== + +[[column]] +== Column + +A https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Column.html[Column] +can represent a column of a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table] +, of a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.html[Request] or +of a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Change.html[Change]. + +Below framed in red the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Column.html[Column] of "table3". + +.Representation of "table3" +|==== +|ID |NAME |FIRSTNAME |SURNAME |SIZE + +|1 |'Hewson' |'Paul David' |'Bono' |1.75 +|2 |'Evans' |'David Howell' |'The Edge' |1.77 +|3 |'Clayton' |'Adam' | |1.78 +|4 |'Mullen' |'Larry' | |1.70 +|==== + +Below framed in red the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Column.html[Column] of "request2". + +.Representation of "request2" +|==== +|NAME |FIRSTNAME |SURNAME + +|'Hewson' |'Paul David' |'Bono' +|'Evans' |'David Howell' |'The Edge' +|'Mullen' |'Larry' | +|==== + +Below framed in red the fourth https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Column.html[Column] of +the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Change.html[Change] +of "changes3". + +.Representation of "changes2" +[cols="1,2,3,4a"] +|==== +|Creation |"MEMBERS" table |`5` as PK | +!==== +!!ID !NAME !FIRSTNAME !SURNAME !SIZE + +!At start point !!!!! +!At end point !5 !'McGuiness' !'Paul' ! ! +!==== +|Modification |"MEMBERS" table |`1` as PK | +!==== +!!ID !NAME !FIRSTNAME !SURNAME !SIZE + +!At start point !1 !'Hewson' !'Paul David' !'Bono' !1.75 +!At end point !1 !'Hewson' !'Paul David' !'Bono Vox' !1.75 +!==== +|==== + +[[value]] +== Value + +A value can be in a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Row.html[Row] +or in a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Column.html[Column]. + +Below framed in red (depending of the path) : + +* the second value of the third https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Row.html[Row] of "table3" +* the third value of the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Column.html[Column] of "table3" + +.Representation of "table3" +|==== +|ID |NAME |FIRSTNAME |SURNAME |SIZE + +|1 |'Hewson' |'Paul David' |'Bono' |1.75 +|2 |'Evans' |'David Howell' |'The Edge' |1.77 +|3 |'Clayton' |'Adam' | |1.78 +|4 |'Mullen' |'Larry' | |1.70 +|==== + +Below framed in red (depending of the path) : + +* the second value of the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Row.html[Row] of "request2" +* the second value of the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Column.html[Column] of "request2" + +.Representation of "request2" +|==== +|NAME |FIRSTNAME |SURNAME + +|'Hewson' |'Paul David' |'Bono' +|'Evans' |'David Howell' |'The Edge' +|'Mullen' |'Larry' | +|==== + +Below framed in red (depending of the path) : + +* the fourth value of the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Row.html[Row] at end point of +the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Change.html[Change] +of "changes2" +* the value at end point of the fourth https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Column.html[Column] of +the second https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Change.html[Change] +of "changes2" + +.Representation of "changes2" +[cols="1,2,3,4a"] +|==== +|Creation |"MEMBERS" table |`5` as PK | +!==== +!!ID !NAME !FIRSTNAME !SURNAME !SIZE + +!At start point !!!!! +!At end point !5 !'McGuiness' !'Paul' ! ! +!==== +|Modification |"MEMBERS" table |`1` as PK | +!==== +!!ID !NAME !FIRSTNAME !SURNAME !SIZE + +!At start point !1 !'Hewson' !'Paul David' !'Bono' !1.75 +!At end point !1 !'Hewson' !'Paul David' !'Bono Vox' !1.75 +!==== +|==== diff --git a/src/docs/antora/modules/ROOT/pages/concepts/index.adoc b/src/docs/antora/modules/ROOT/pages/concepts/index.adoc new file mode 100644 index 00000000..bf0e69c5 --- /dev/null +++ b/src/docs/antora/modules/ROOT/pages/concepts/index.adoc @@ -0,0 +1,42 @@ += Concepts + +For the examples below, suppose that the database contains these three tables : + +.MEMBERS +|==== +|ID |NAME |FIRSTNAME |SURNAME |BIRTHDATE |SIZE + +|1 |'Hewson' |'Paul David' |'Bono' |05-10-60 |1.75 +|2 |'Evans' |'David Howell' |'The Edge' |08-08-61 |1.77 +|3 |'Clayton' |'Adam' | |03-13-60 |1.78 +|4 |'Mullen' |'Larry' | |10-31-61 |1.70 +|==== + +.ALBUMS +|==== +|ID |RELEASE |TITLE |NUMBEROFSONGS |DURATION |LIVE + +|1 |10-20-80 |'Boy' |12 |42:17 | +|2 |10-12-81 |'October' |11 |41:08 | +|3 |02-28-83 |'War' |10 |42:07 | +|4 |11-07-83 |'Under a Blood Red Sky' |8 |33:25 |true +|5 |10-01-84 |'The Unforgettable Fire' |10 |42:42 | +|6 |06-10-85 |'Wide Awake in America' |4 |20:30 |true +|7 |03-09-87 |'The Joshua Tree' |11 |50:11 | +|8 |10-10-88 |'Rattle and Hum' |17 |72:27 | +|9 |11-18-91 |'Achtung Baby' |12 |55:23 | +|10 |07-06-93 |'Zooropa' |10 |51:15 | +|11 |03-03-97 |'Pop' |12 |60:08 | +|12 |10-30-00 |'All That You Can't Leave Behind' |11 |49:23 | +|13 |11-22-04 |'How to Dismantle an Atomic Bomb' |11 |49:08 | +|14 |03-02-09 |'No Line on the Horizon' |11 |53:44 | +|15 |09-09-14 |'Songs of Innocence' |11 |48:11 | +|==== + +.GROUP +|==== +|ID |NAME + +|1 |'U2' +|2 |'Coldplay' +|==== diff --git a/src/docs/antora/modules/ROOT/pages/concepts/letter-case.adoc b/src/docs/antora/modules/ROOT/pages/concepts/letter-case.adoc new file mode 100644 index 00000000..5705389d --- /dev/null +++ b/src/docs/antora/modules/ROOT/pages/concepts/letter-case.adoc @@ -0,0 +1,93 @@ += Letter Case of the database + +Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] + +Databases have different letter cases for the name of the elements. +For example, the name of the table can be upper case either the name is inputted in upper case or not. So this concept (and feature too) is here to manage these shades. + +It is possible to declare a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] +with a xref:concepts/connection.adoc#assertdbconnectionlettercase[AssertDbConnection with LetterCase]. + +The concept of https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] is composed of https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversion.html[CaseConversion] and https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparison.html[CaseComparison]. + +[[caseconversion]] +== CaseConversion + +The https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversion.html[CaseConversion] is used when getting a name with letter case from database : a table name, a column name or a primary key name. + +There are three conversions modes : https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversions.html#UPPER[UPPER] which converts to upper case (`"Name"` becomes `"NAME"`), https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversions.html#LOWER[LOWER] which converts to lower case (`"Name"` becomes `"name"`) and https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversions.html#NO[NO] which keeps the case (`"Name"` remains `"Name"`). + +Each name (table, column and primary key) got from the database is converted using a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversion.html[CaseConversion]. + +[[casecomparison]] +== CaseComparison + +The https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparison.html[CaseComparison] is used when comparing something with letter case from database or with a parameter. + +There are two comparison modes : https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparisons.html#IGNORE[IGNORE] which compares `String`s by ignoring the case (`"Name"` is considered equal to `"NAME"`) and https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparisons.html#STRICT[STRICT] which compares `String`s strictly (`"Name"` is considered different from `"NAME"`). + +During navigation (e.g. from table to column) and assertion (e.g. on column name), the name are compared using a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparison.html[CaseComparison]. + +[[lettercase]] +== LetterCase + +A https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] is created with the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html#getLetterCase-org.assertj.db.type.lettercase.CaseConversion-org.assertj.db.type.lettercase.CaseComparison-[getLetterCase] +static method which has a + https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversion.html[CaseConversion] and a + https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparison.html[CaseComparison] as parameters. + +[source,java] +---- +LetterCase letterCase = LetterCase.getLetterCase(CaseConversions.NO, CaseComparisons.IGNORE); +---- + +In AssertJ-DB, there are three different uses of a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] : +the table name, the column name and the primary key name. +That is the reason why the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/AssertDbConnection.html[AssertDbConnection] +have three https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] parameters. + +The https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] on the tables is used : + +* to convert the table name : when a name is got from the database like for the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table] +instantiation or for the table with changes found with https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Changes.html[Changes]. +* to compare the table name : for the instantiation when the table is search in the database for https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table], +for navigation (e.g. from changes to a change on a table) or for a assertion (like https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnDataType.html#isOnTable-java.lang.String-[isOnTable(String name)]). + +The https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] on the columns is used : + +* to convert the column name : when a column name is got from the database for a table or a request +* to compare the column name : for the navigation (e.g. from a table to a column) or for a assertion (like https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnName.html#hasColumnName-java.lang.String-[hasColumnName(String columnName)]). + +The https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] on the primary keys is used : + +* to convert the primary key name : when a primary key name is got from the database for a table +* to compare the primary key name : for a assertion (like https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnPrimaryKey.html#hasPksNames-java.lang.String...-[hasPksNames(String... names)]). + +The default settings for https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html[LetterCase] in +https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/AssertDbConnection.html[AssertDbConnection] are : + +* https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversions.html#NO[NO] conversion +and https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparisons.html#IGNORE[IGNORE] comparison for table names +* https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversions.html#UPPER[UPPER] conversion +and https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparisons.html#IGNORE[IGNORE] comparison for the column and primary key name + +In this example, the two connections are equivalent : + +[source,java] +---- +AssertDbConnection jdbcConnection = AssertDbConnectionFactory.of("jdbc:h2:mem:test", "sa", "").create(); +Table table = jdbcConnection.table("members").build(); + +LetterCase tableLetterCase = LetterCase.getLetterCase(CaseConversions.NO, CaseComparisons.IGNORE); +LetterCase columnLetterCase = LetterCase.getLetterCase(CaseConversions.UPPER, CaseComparisons.IGNORE); +LetterCase pkLetterCase = LetterCase.getLetterCase(CaseConversions.UPPER, CaseComparisons.IGNORE); +AssertDbConnection connectionWithLC = AssertDbConnectionFactory.of("jdbc:h2:mem:test", "sa", "") + .letterCase(tableLetterCase, columnLetterCase, pkLetterCase) + .create(); +Table tableWithLC = connectionWithLC.table("members").build(); +---- + +Note that the letter case is extensible because the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/LetterCase.html#getLetterCase-org.assertj.db.type.lettercase.CaseConversion-org.assertj.db.type.lettercase.CaseComparison-[getLetterCase] +static method's parameters are instances of the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseConversion.html[CaseConversion] +and the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/lettercase/CaseComparison.html[CaseComparison] interfaces. +So this is not limited to the implementations in the corresponding enumerations. diff --git a/src/docs/antora/modules/ROOT/pages/concepts/navigation.adoc b/src/docs/antora/modules/ROOT/pages/concepts/navigation.adoc new file mode 100644 index 00000000..7088c1a2 --- /dev/null +++ b/src/docs/antora/modules/ROOT/pages/concepts/navigation.adoc @@ -0,0 +1,92 @@ += Navigation + +The navigation offers the ability to chain assertions at different levels and instructions to go inside the sub-elements and return to root element. + +There are examples of the navigation in {assertj-examples-github}/blob/main/assertions-examples/src/test/java/org/assertj/examples/db/NavigationExamples.java[NavigationExamples.java] + +[[tableorrequestasroot]] +== With a Table or a Request as root + +The `assertThat(...)` static method of `Assertions` allows to create a root assertion on a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table]. + +[source,java] +---- +// From v3.0.2 +import static org.assertj.core.api.Assertions.assertThat; + +// For versions <= 3.0.1 : +// import static org.assertj.db.api.Assertions.assertThat; + +assertThat(table)... +---- + +or on a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.html[Request]. + +[source,java] +---- +// From v3.0.2 +import static org.assertj.core.api.Assertions.assertThat; + +// For versions <= 3.0.1 : +// import static org.assertj.db.api.Assertions.assertThat; + +assertThat(request)... +---- + +From these root assertions, it is possible to navigate to the sub elements and return to the root element as in the picture below. + +[ditaa, target="db-navigation-with-table-or-request", shadows=false, transparent=true] +.... + origin + instantiate+-----------+<-----------=+----------------------+ + +--------->|On a Column| instantiate |On a Value Of a Column| + | +-----+-----+=----------->+----------------------+ + : origin: ++----------------+------+<--------+ +|On a Table Or a Request| ++----------------+------+<--------+ + : origin: origin + | +-----+--+<-----------=+-------------------+ + +--------->|On a Row| instantiate |On a Value Of a Row| + instantiate+--------+=----------->+-------------------+ +.... + +More details on this concept in assertj-db-features-highlight.html#tableorrequestasroot[feature highlight]. + +[[changesasroot]] +== With Changes as root + +The `assertThat(...)` static method of `Assertions` +allows to create a root assertion on https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Changes.html[Changes]. + +[source,java] +---- +// From v3.0.2 +import static org.assertj.core.api.Assertions.assertThat; + +// For versions <= 3.0.1 : +// import static org.assertj.db.api.Assertions.assertThat; + +assertThat(changes)... +---- + +From this root assertion, it is possible to navigate to the sub elements and return to the root element as in the picture below. + +[ditaa, target="db-navigation-with-changes", shadows=false, transparent=true] +.... + origin + instantiate+-----------+<-----------=+----------------------+ + +--------->|On a Column| instantiate |On a Value Of a Column| + | +-----+-----+=----------->+----------------------+ + origin : origin: ++-----------+<=-----------+-----+-----+<---------+ +|On Changes | instantiate |On a Change| ++-----------+=----------->+-----+-----+<---------+ + : origin: origin + | +-----+--+<-----------=+-------------------+ + +--------->|On a Row| instantiate |On a Value Of a Row| + instantiate+--------+=----------->+-------------------+ +.... + + +More details on this concept in xref:features/navigation.adoc#changesasroot[feature highlight]. diff --git a/src/docs/antora/modules/ROOT/pages/concepts/output.adoc b/src/docs/antora/modules/ROOT/pages/concepts/output.adoc new file mode 100644 index 00000000..09d2184c --- /dev/null +++ b/src/docs/antora/modules/ROOT/pages/concepts/output.adoc @@ -0,0 +1,74 @@ += Output + +Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] + +It can be interesting to view the values on which an assertion is made (for example for debugging). The output allows that. + +This is a simple example : + +[source,java] +---- +import static org.assertj.db.output.Outputs.output; + +Table table = connection.table("members"); + +// Output the content of the table in the console +output(table).toConsole(); +---- + +These lines give the result below : + +[source,java] +---- +[MEMBERS table] +|-----------|---------|-----------|-----------|--------------|-----------|-----------|-----------| +| | | * | | | | | | +| | PRIMARY | ID | NAME | FIRSTNAME | SURNAME | BIRTHDATE | SIZE | +| | KEY | (NUMBER) | (TEXT) | (TEXT) | (TEXT) | (DATE) | (NUMBER) | +| | | Index : 0 | Index : 1 | Index : 2 | Index : 3 | Index : 4 | Index : 5 | +|-----------|---------|-----------|-----------|--------------|-----------|-----------|-----------| +| Index : 0 | 1 | 1 | Hewson | Paul David | Bono | 05-10-60 | 1.75 | +| Index : 1 | 2 | 2 | Evans | David Howell | The Edge | 08-08-61 | 1.77 | +| Index : 2 | 3 | 3 | Clayton | Adam | | 03-13-60 | 1.78 | +| Index : 4 | 4 | 4 | Mullen | Larry | | 10-31-61 | 1.70 | +|-----------|---------|-----------|-----------|--------------|-----------|-----------|-----------| +---- + +In the example above, the output is in plain text in the console. It is possible to change the type of the output and the destination. + +[[typeoutput]] +== Type of output + +There are two outputs already implemented : + +* https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/output/impl/OutputType.html#PLAIN[PLAIN] : shown in the example above (the default output type) +* https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/output/impl/OutputType.html#HTML[HTML] : which represents the result as an HTML document + +[source,java] +---- +// Change the output of the table to be HTML +output(table).withType(OutputType.HTML).....; +---- + +Note that the type of output is extensible because the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/output/AbstractOutputter.html#withType-org.assertj.db.output.impl.Output-[withType(Output outputType)] method's parameter is an instance of the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/output/impl/Output.html[Output] interface. +So this is not limited to the implementations in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/output/impl/OutputType.html[OutputType] enum. + +[[destination]] +== Destination + +The destination is the way to print the display. There are three destinations : + +* the console (with the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/output/AbstractOutputter.html#toConsole--[toConsole()] method) +* a file (with the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/output/AbstractOutputter.html#toFile-java.lang.String-[toFile(String fileName)] method) +* a stream (with the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/output/AbstractOutputter.html#toStream-java.io.OutputStream-[toStream(OutputStream outputStream)] method) + +Note that with this last method the possibilities of destination are really flexible. + +These three methods are fluent. In this short example, the output is a plain text representation in the console and a html output in a file : + +[source,java] +---- +// Display the content of the table with plain text in the console +// and with HTML output in the file +output(table).toConsole().withType(OutputType.HTML).toFile("test.html"); +---- diff --git a/src/docs/antora/modules/ROOT/pages/concepts/types.adoc b/src/docs/antora/modules/ROOT/pages/concepts/types.adoc new file mode 100644 index 00000000..669b06df --- /dev/null +++ b/src/docs/antora/modules/ROOT/pages/concepts/types.adoc @@ -0,0 +1,56 @@ += Type + +[[datatype]] +== Data Type + +As see above there are three root elements of database, but only https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table] and https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Request.html[Request] are data elements. +All the possible types of data are contained in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/DataType.html[DataType] enumeration. + +The type of the data can be : + +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/DataType.html#TABLE[TABLE]` +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/DataType.html#REQUEST[REQUEST]` + +[[changetype]] +== Change Type + +The change can be a creation, a modification or a deletion. +All the possible types of change are contained in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ChangeType.html[ChangeType] enumeration. + +The type of the change depends of operation on database : + +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ChangeType.html#CREATION[CREATION]` for a `insert` sql request +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ChangeType.html#MODIFICATION[MODIFICATION]` for a `update` sql request +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ChangeType.html#DELETION[DELETION]` for a `delete` sql request + +[[valuetype]] +== Value Type + +The value can be a date, a boolean or a text for example. +All the possible types of value are contained in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html[ValueType] enumeration. + +The type of the value depends of class of the object given by `java.sql` when the data are got from database : + +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#BYTES[BYTES]` for a array of bytes (`byte[]`) +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#BOOLEAN[BOOLEAN]` for a `java.lang.Boolean` +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#TEXT[TEXT]` for a `java.lang.String` +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#DATE[DATE]` for a `java.sql.Date` +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#TIME[TIME]` for a `java.sql.Time` +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#DATE_TIME[DATE_TIME]` for a `java.sql.Timestamp` +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#UUID[UUID]` for a `java.util.UUID` [.small]#(since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0])# +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#NUMBER[NUMBER]` for a `java.lang.Byte`, + `java.lang.Short`, `java.lang.Integer`, `java.lang.Long`, `java.lang.Double`, `java.lang.Float` or `java.math.BigDecimal` +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#NOT_IDENTIFIED[NOT_IDENTIFIED]` for other cases (for example when the value is `null`) + +[[ordertype]] +== Order Type + +Since xref:release-notes.adoc#v1-2-0-release-notes[1.2.0] + +The order can be a ascending or descending. +All the possible types of order are contained in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.Order.OrderType.html[Table.Order.OrderType] enumeration. + +The type of the order can be : + +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.Order.OrderType.html#ASC[ASC]` for an ascending order +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.Order.OrderType.html#DESC[DESC]` for a descending order diff --git a/src/docs/antora/modules/ROOT/pages/features/assertions.adoc b/src/docs/antora/modules/ROOT/pages/features/assertions.adoc new file mode 100644 index 00000000..92d5f152 --- /dev/null +++ b/src/docs/antora/modules/ROOT/pages/features/assertions.adoc @@ -0,0 +1,858 @@ += Assertions + +[[onchangetype]] +== On the type of change + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnChangeType.html[AssertOnChangeType] interface. + +These assertions allow to verify the type of a change (the concept of change of type is described xref:concepts/types.adoc#changetype[here]). + +[source,java] +---- +// Verify that the first change is a change of creation +assertThat(changes).change().isOfType(ChangeType.CREATION); +---- + +There are specific assertion methods for each type of change. For example, the assertion below is equivalent to the one above + +[source,java] +---- +assertThat(changes).change().isCreation(); +---- + +[[oncolumnequality]] +== On the equality with the values of a column + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnEquality.html[AssertOnColumnEquality] +and the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnOfChangeEquality.html[AssertOnColumnOfChangeEquality] interfaces. + +These assertion allow to verify the values of a column (the column of a table, of a request or of a change). + +[[oncolumnequality-boolean]] +=== With Boolean + +[source,java] +---- +// Verify that the values of the column "live" of the request +// was equal to true, to false and after to true +assertThat(request).column("live").hasValues(true, false, true); +// Verify that the value of the first column of the first change +// was false at start point and is true at end point +assertThat(changes).change().column().hasValues(false, true); +// Verify that the value of the third column of the first change +// is not modified and is true +assertThat(changes).change().column(2).hasValues(true); +---- + +[[oncolumnequality-bytes]] +=== With Bytes + +[source,java] +---- +// Get bytes from a file and from a resource in the classpath +byte[] bytesFromFile = Assertions.bytesContentOf(file); +byte[] bytesFromClassPath = Assertions.bytesContentFromClassPathOf(resource); +// Verify that the values of the second column of the request +// was equal to the bytes from the file, to null and to bytes from the resource +assertThat(request).column(1).hasValues(bytesFromFile, null, bytesFromClassPath); +// Verify that the value of the first column of the first change +// was equal to bytes from the file at start point and to bytes from the resource at end point +assertThat(changes).change().column().hasValues(bytesFromFile, bytesFromClassPath); +---- + +[[oncolumnequality-number]] +=== With Number + +[source,java] +---- +// Verify that the values of the first column of the table +// was equal to 5.9, 4 and 15000 +assertThat(table).column().hasValues(5.9, 4, new BigInteger("15000")); +// Verify that the value of the first column of the first change +// is not modified and is equal to 5 +assertThat(changes).change().column().hasValues(5); +---- + +[[oncolumnequality-date]] +=== With Date + +[source,java] +---- +// Verify that the values of the first column of the table +// was equal to December 23rd 2007 and May 19th 1975 +assertThat(table).column() + .hasValues(LocalDate.of(2007, 12, 23), + LocalDate.of(1975, 5, 19)); +// Verify that the value of the first column of the first change +// was equal December 23rd 2007 at start point +// and is equal to May 19th 1975 at end point +assertThat(changes).change().column() + .hasValues(LocalDate.parse("2007-12-23"), + LocalDate.parse("1975-05-19")); +---- + +[[oncolumnequality-time]] +=== With Time + +[source,java] +---- +// Verify that the values of the first column of the table +// was equal to 09:01am and 05:30:50pm +assertThat(table).column() + .hasValues(LocalTime.of(9, 1), + LocalTime.of(17, 30, 50)); +// Verify that the value of the first column of the first change +// was equal to 09:01am at start point +// and is equal to 05:30:50pm at end point +assertThat(changes).change().column() + .hasValues(LocalTime.parse("09:01"), + LocalTime.parse("17:30:50")); +---- + +[[oncolumnequality-datetime]] +=== With Date/Time + +[source,java] +---- +// Verify that the values of the first column of the table +// was equal to December 23rd 2007 09:01am and May 19th 1975 +assertThat(table).column() + .hasValues(LocalDateTime.of(LocalDate.of(2007, 12, 23), + LocalTime.parse("09:01")), + LocalDateTime.of(LocalDate.of(1975, 5, 19), + LocalTime.MIDNIGHT)); +// Verify that the value of the first column of the first change +// was equal December 23rd 2007 09:01am at start point +// and is equal to May 19th 1975 at end point +assertThat(changes).change().column() + .hasValues(LocalDateTime.parse("2007-12-23T09:01"), + LocalDateTime.parse("1975-05-19T00:00")); +---- + +[[oncolumnequality-string]] +=== With String + +[source,java] +---- +// Verify that values are equal to texts +assertThat(table).column("name") + .hasValues("Hewson", + "Evans", + "Clayton", + "Mullen"); +// Verify that the value of the column "size" of the first change of modification +// is not modified and is equal to 1.75 by parsing +assertThat(changes).changeOfModification().column("size") + .hasValues("1.75"); +// Verify that values are equal to dates, times or dates/times by parsing +assertThat(table).column() + .hasValues("2007-12-23T09:01"), + "1975-05-19"); +---- + +[[oncolumnequality-uuid]] +=== With UUID + +Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] + +[source,java] +---- +// Verify that the values of the first column of the table +// was equal to 30B443AE-C0C9-4790-9BEC-CE1380808435, 0E2A1269-EFF0-4233-B87B-B53E8B6F164D +// and 2B0D1BDD-909E-4362-BA10-C930BA82718D +assertThat(table).column().hasValues(UUID.fromString("30B443AE-C0C9-4790-9BEC-CE1380808435"), + UUID.fromString("0E2A1269-EFF0-4233-B87B-B53E8B6F164D"), + UUID.fromString("2B0D1BDD-909E-4362-BA10-C930BA82718D")); +// Verify that the value of the first column of the first change +// is not modified and is equal to 399FFFCA-7874-4225-9903-E227C4E9DCC1 +assertThat(changes).change() + .column().hasValues(UUID.fromString("399FFFCA-7874-4225-9903-E227C4E9DCC1")); +---- + +[[oncolumnequality-character]] +=== With Character + +Since xref:release-notes.adoc#v1-2-0-release-notes[1.2.0] + +[source,java] +---- +// Verify that the values of the first column of the table +// was equal to 'T', 'e', 's' and 't' +assertThat(table).column().hasValues('T', 'e', 's', 't'); +// Verify that the value of the first column of the first change +// is not modified and is equal to 'T' +assertThat(changes).change().column().hasValues('T'); +---- + +[[oncolumnname]] +== On the name of a column + +This assertion is described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnName.html[AssertOnColumnName] interface. + +This assertion allows to verify the name of a column (the column of a table, of a request or of a change). + +[source,java] +---- +// Verify that the fifth column of the table is called "firstname" +assertThat(table).column(4).hasColumnName("firstname"); +// Verify that the third value of the second row of the request is in a column called "name" +assertThat(request).row(1).value(2).hasColumnName("name"); +// Verify that the first column of the first change is called "id" +assertThat(changes).change().column().hasColumnName("id"); +---- + +[[oncolumnnullity]] +== On the nullity of the values of a column + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnNullity.html[AssertOnColumnNullity] interface. + +These assertion allows to verify the nullity of the values of a column (the column of a table or of a request). + +[source,java] +---- +// Verify that the fifth column of the table has only null values +assertThat(table).column(4).hasOnlyNullValues(); +// Verify that the column "name" has only not null values +assertThat(request).column("name").hasOnlyNotNullValues(); +---- + +[[onrownullity]] +== On the nullity of the values of a row + +Since xref:release-notes.adoc#v1-2-0-release-notes[1.2.0] + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnRowNullity.html[AssertOnRowNullity] interface. + +These assertion allows to verify the nullity of the values of a row (the row of a table or of a request). + +[source,java] +---- +// Verify that the fifth row of the table has only not null values +assertThat(table).row(4).hasOnlyNotNullValues(); +// Verify that the first column has only not null values +assertThat(request).row().hasOnlyNotNullValues(); +---- + +[[oncolumntype]] +== On the type of column + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnType.html[AssertOnColumnType] interface. + +These assertions allow to verify the type of the values of a column (a column from a table, from a request or from a change). + +[source,java] +---- +// Verify that the values of the column called "firstname" +// of the table are a text (null values are considered as wrong) +assertThat(table).column("firstname").isOfType(ValueType.TEXT, false); +// The same verification (with the specific method) +// on the third column of the request +assertThat(request).column(2).isText(false); +// Now the same verification again but with a lenience with null values +// (the null values are not considered as wrong) +assertThat(request).column(2).isText(true); +// Verify that the values of the first column +// of the first change is either a date or a number +assertThat(changes).change().column() + .isOfAnyOfTypes(ValueType.DATE, ValueType.NUMBER); +---- + +[[oncolumnclass]] +== On the class of column + +Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] + +This assertion is described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnClass.html[AssertOnColumnClass] interface. + +This assertion allows to verify the class of the values of a column (a column from a table, from a request or from a change). + +[source,java] +---- +// Verify that the values of the column called "firstname" +// of the table are a String (null values are considered as wrong) +assertThat(table).column("firstname").isOfClass(String.class, false); +// Verify that the values of the first column +// of the first change is a Locale (null values are considered as right) +assertThat(changes).change().column().isOfClass(Locale.class, true); +---- + +[[oncolumncontent]] +== On the content of column + +Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnContent.html[AssertOnColumnContent] interface. + +These assertions allow to verify the content of a column (a column from a table or from a request). + +[source,java] +---- +// Verify that the content of the column called "name" +assertThat(table).column("name").containsValues("Hewson", + "Evans", + "Clayton", + "Mullen"); +// This second assertion is equivalent because the order of the values is not important +assertThat(table).column("name").containsValues("Evans", + "Clayton", + "Hewson", + "Mullen"); + +---- + +[[ondatatype]] +== On the type of data + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnDataType.html[AssertOnDataType] interface. + +These assertions allow to verify the type of the date on which is a change. + +[source,java] +---- +// Verify that the change is on a table +assertThat(changes).change().isOnDataType(DataType.TABLE); +// The same verification (with the specific method) +assertThat(changes).change().isOnTable(); +// Verify that the change is on the "members" table +assertThat(changes).change().isOnTable("members"); +---- + +[[onmodifiedcolumns]] +== On the modified columns in a change + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnModifiedColumn.html[AssertOnModifiedColumn] +and the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnModifiedColumns.html[AssertOnModifiedColumns] interfaces. + +These assertions allow to verify if a column of a change have been modified between the start point and the end point (see the xref:concepts/elements.adoc#changes[concept of changes]). + +[source,java] +---- +// Verify that first column of the change is not modified +// and the second column is modified +assertThat(changes).change().column().isNotModified().column().isModified(); +// Verify that there are 2 modified columns in the change +assertThat(changes).change().hasNumberOfModifiedColumns(2); +// Verify that the modified column in change are at index 1 and 2 +assertThat(changes).change().hasModifiedColumns(1, 2); +// Verify that the modified column in change are "name" and "firstname" +assertThat(changes).change().hasModifiedColumns("name", "firstname"); +---- + +Since version xref:release-notes.adoc#v1-1-0-release-notes[1.1.0], there are new assertions which allow to compare the number of modified columns between the start point and the end point. + +[source,java] +---- +// Verify that the number of modified columns in the first change is more than 5 +assertThat(changes).change().hasNumberOfModifiedColumnsGreaterThan(5); +// Verify that the number of modified columns in the first change is at least 5 +assertThat(changes).change().hasNumberOfModifiedColumnsGreaterThanOrEqualTo(5); +// Verify that the number of modified columns in the first change is less than 6 +assertThat(changes).change().hasNumberOfModifiedColumnsLessThan(6); +// Verify that the number of modified columns in the first change is at most 6 +assertThat(changes).change().hasNumberOfModifiedColumnsLessThanOrEqualTo(6); +---- + +[[onnumberchanges]] +== On the number of changes + +This assertion is described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnNumberOfChanges.html[AssertOnNumberOfChanges] interface. + +This assertion allows to verify the number of changes. + +[source,java] +---- +// Verify that there are 4 changes +assertThat(changes).hasNumberOfChanges(4); +---- + +Since version xref:release-notes.adoc#v1-1-0-release-notes[1.1.0], there are new assertions which allow to compare the number of changes between the start point and the end point. + +[source,java] +---- +// Verify that the number of changes is more than 5 +assertThat(changes).hasNumberOfChangesGreaterThan(5); +// Verify that the number of changes is at least 5 +assertThat(changes).hasNumberOfChangesGreaterThanOrEqualTo(5); +// Verify that the number of changes is less than 6 +assertThat(changes).hasNumberOfChangesLessThan(6); +// Verify that the number of changes is at most 6 +assertThat(changes).hasNumberOfChangesLessThanOrEqualTo(6); +---- + +[[onnumbercolumns]] +== On the number of columns + +This assertion is described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnNumberOfColumns.html[AssertOnNumberOfColumns] interface. + +This assertion allows to verify the number of columns (columns from a table, from a request or from a change). + +[source,java] +---- +// Verify that there are 6 columns in the table +assertThat(table).hasNumberOfColumns(6); +// Verify that there are 4 columns in the change +assertThat(changes).change().hasNumberOfColumns(4); +---- + +Since version xref:release-notes.adoc#v1-1-0-release-notes[1.1.0], there are new assertions which allow to compare the number of columns. + +[source,java] +---- +// Verify that the number of columns is more than 5 +assertThat(table).hasNumberOfColumnsGreaterThan(5); +// Verify that the number of columns is at least 5 +assertThat(request).hasNumberOfColumnsGreaterThanOrEqualTo(5); +// Verify that the number of columns is less than 6 +assertThat(changes).hasNumberOfColumnsLessThan(6); +// Verify that the number of columns is at most 6 +assertThat(changes).hasNumberOfColumnsLessThanOrEqualTo(6); +---- + +[[onnumberrows]] +== On the number of rows + +This assertion is described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnNumberOfRows.html[AssertOnNumberOfRows] interface. + +This assertion allows to verify the number of rows (rows from a table or from a request). + +[source,java] +---- +// Verify that there are 7 rows in the table +assertThat(table).hasNumberOfRows(7); +---- + +Since version xref:release-notes.adoc#v1-1-0-release-notes[1.1.0], there are new assertions which allow to compare the number of rows. + +[source,java] +---- +// Verify that the number of rows is more than 5 +assertThat(table).hasNumberOfRowsGreaterThan(5); +// Verify that the number of rows is at least 5 +assertThat(request).hasNumberOfRowsGreaterThanOrEqualTo(5); +// Verify that the number of rows is less than 6 +assertThat(changes).hasNumberOfRowsLessThan(6); +// Verify that the number of rows is at most 6 +assertThat(changes).hasNumberOfRowsLessThanOrEqualTo(6); +---- + +Since version xref:release-notes.adoc#v1-2-0-release-notes[1.2.0], there is a new assertion which allow to verify if rows are empty (equivalent to `hasNumberOfRows(0)`). + +[source,java] +---- +// Verify that the table are empty +assertThat(table).isEmpty(); +---- + +[[onprimarykeys]] +== On the primary keys + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnPrimaryKey.html[AssertOnPrimaryKey] interface. + +These assertions allow to verify the names and the values of the columns which compose the primary keys of the rows from a change. + +[source,java] +---- +// Verify that the columns of the primary keys are "id" and "name" +assertThat(changes).change().hasPksNames("id", "name"); +// Verify that the values of the primary keys are 1 and "HEWSON" +assertThat(changes).change().hasPksValues(1, "HEWSON"); +---- + +[[onrowequality]] +== On the equality with the values of a row + +This assertion is described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnRowEquality.html[AssertOnRowEquality] interface. + +This assertion allow to verify the values of a row (the row of a table, of a request or of a change). + +[source,java] +---- +// Verify the values of the row at index 1 +assertThat(table).row(1) + .hasValues(2, + "Evans", + "David Howell", + "The Edge", + DateValue.of(1961, 8, 8), + 1.77); +// Verify the values of the row at end point +assertThat(changes).change().rowAtEndPoint() + .hasValues(5, + "McGuiness", + "Paul", + null, + "1951-06-17", + null); +---- + +[[onrowexistence]] +== On the existence of a row in a change + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnRowOfChangeExistence.html[AssertOnRowOfChangeExistence] interface. + +These assertions allow to verify that the row at start point or at end point of a change exists or not (for a creation, the row do not exist at start point and for a deletion it is the contrary : the row do not exist at end point). + +[source,java] +---- +// Verify that row at start point exists +assertThat(changes).change().rowAtStartPoint().exists(); +// Verify that the row at end point do not exist +assertThat(changes).change().rowAtEndPoint().doesNotExist(); +---- + +[[onvaluechronology]] +== On the chronology of a value + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueChronology.html[AssertOnValueChronology] interface. + +These assertions allow to compare a value (the value of a table, of a request or of a change) to a date, a time or a date/time. + +[source,java] +---- +// Compare the value with a date +assertThat(table).row(1).value("birthdate") + .isAfter(DateValue.of(1950, 8, 8)); +// Verify the value is between two dates/times +assertThat(changes).change().column("release").valueAtEndPoint() + .isAfterOrEqualTo(DateTimeValue.parse("2014-09-08T23:30")) + .isBeforeOrEqualTo(DateTimeValue.parse("2014-09-09T05:30")); +---- + +[[onvaluecomparison]] +== On the comparison with a value + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueComparison.html[AssertOnValueComparison] interface. + +These assertions allow to compare a value (the value of a table, of a request or of a change) to a number. + +[source,java] +---- +// Compare the value with a number +assertThat(table).row(1).value("size") + .isGreaterThan(1.5); +// Verify the value is between two numbers +assertThat(changes).change().column("size").valueAtEndPoint() + .isGreaterThanOrEqualTo(1.7) + .isLessThanOrEqualTo(1.8); +---- + +[[onvaluecloseness]] +== On the closeness of a value + +Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueCloseness.html[AssertOnValueCloseness] interface. + +These assertions allow to verify if a value (the value of a table, of a request or of a change) is close to another. + +[source,java] +---- +// Verify if the value is close to 2 with a tolerance of 0.5 +// So the values between 1.5 and 2.5 are right +assertThat(table).row(1).value("size") + .isCloseTo(2, 0.5); +// Verify the value is close to 05-10-1960 with a tolerance of two days +assertThat(changes).change().column("birth").valueAtEndPoint() + .isCloseTo(DateValue(1960, 5, 10), + DateValue(0, 0, 2)); +---- + +[[onvaluequality]] +== On the equality with a value + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueEquality.html[AssertOnValueEquality] interface. + +These assertion allow to verify that a value (the value of a table, of a request or of a change) is equal to another value (in parameter). + +[[onvaluequality-boolean]] +=== With Boolean + +[source,java] +---- +// Verify that the value is equal to true +assertThat(table).row(3).value("live").isEqualTo(true); +// Do the same thing with the specific method +assertThat(table).row(3).value("live").isTrue(); +---- + +[[onvaluequality-bytes]] +=== With Bytes + +[source,java] +---- +// Get bytes from a file +byte[] bytesFromFile = Assertions.bytesContentOf(file); +// Verify that the value at end point of the first column of the first change +// is equal to bytes from the file +assertThat(changes).change().column().valueAtStartPoint().isEqualTo(bytesFromFile); +---- + +[[onvaluequality-number]] +=== With Number + +[source,java] +---- +// Verify that the first value is equal to 1.77, +// the second is equal to 50 and the last is equal to zero +assertThat(request).column("size").value().isEqualTo(1.77) + .value().isEqualTo(50) + .value().isEqualTo(0).isZero(); +---- + +[[onvaluequality-date]] +=== With Date + +[source,java] +---- +// Verify that values are equal to dates +assertThat(changes).changeOfCreation() + .rowAtEndPoint() + .value("birthdate") + .isEqualTo(LocalDate.of(1951, 6, 17)) + .changeOfModification() + .column("birthdate") + .isEqualTo() + .isNotEqualTo(LocalDate.parse("1960-05-10")) + .valueAtEndPoint() + .isEqualTo(LocalDate.of(1960, 5, 10)); +---- + +[[onvaluequality-time]] +=== With Time + +[source,java] +---- +// Verify that the value is equal to a time +assertThat(table).row().value("duration").isEqualTo(LocalTime.of(9, 1)); +---- + +[[onvaluequality-datetime]] +=== With Date/Time + +[source,java] +---- +// Verify that the value is equal to a date/time +assertThat(request).column().value() + .isEqualTo(LocalDateTime.of(2007, 12, 23,9, 1, 0)) + .isEqualTo(LocalDateTime.parse("2007-12-23T09:01")); +---- + +[[onvaluequality-string]] +=== With String + +[source,java] +---- +// Verify that the values are equal to numbers, texts and dates +assertThat(table).row().value().isEqualTo("1") + .value().isEqualTo("Hewson") + .value().isEqualTo("Paul David") + .value().isEqualTo("Bono") + .value().isEqualTo("1960-05-10") + .value().isEqualTo("1.75"); +---- + +[[onvaluequality-uuid]] +=== With UUID + +Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] + +[source,java] +---- +// Verify that the values are equal to UUID +assertThat(table).column().value().isEqualTo(UUID.fromString("30B443AE-C0C9-4790-9BEC-CE1380808435")) + .value().isEqualTo(UUID.fromString("0E2A1269-EFF0-4233-B87B-B53E8B6F164D")) + .value().isEqualTo(UUID.fromString("2B0D1BDD-909E-4362-BA10-C930BA82718D")); +---- + +[[onvaluequality-character]] +=== With Character + +Since xref:release-notes.adoc#v1-2-0-release-notes[1.2.0] + +[source,java] +---- +// Verify that the values are equal to Character +assertThat(table).column().value().isEqualTo('T') + .value().isEqualTo('e') + .value().isEqualTo('s') + .value().isEqualTo('t'); +---- + +[[onvaluenonquality]] +== On the non equality with a value + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueNonEquality.html[AssertOnValueNonEquality] interface. + +These assertion allow to verify that a value (the value of a table, of a request or of a change) is not equal to another value (in parameter). + +[[onvaluenonquality-boolean]] +=== With Boolean + +[source,java] +---- +// Verify that the values (values "live" in the row at index 3 and index 5) +// are not equal to false +assertThat(table).row(3).value("live").isNotEqualTo(false) + .row(5).value("live").isNotEqualTo(false); +---- + +[[onvaluenonquality-bytes]] +=== With Bytes + +[source,java] +---- +// Get bytes from a resource in the classpath +byte[] bytesFromClassPath = Assertions.bytesContentFromClassPathOf(resource); +// Verify that the value at end point of the first column of the first change +// is not equal to bytes from the resource +assertThat(changes).change().column().valueAtStartPoint().isNotEqualTo(bytesFromClassPath); +---- + +[[onvaluenonquality-number]] +=== With Number + +[source,java] +---- +// Verify that the first value is not equal to 1.78, +// the second is not equal to 55 and the last is not equal to 15 +assertThat(request).column("size").value().isNotEqualTo(1.78) + .value().isNotEqualTo(55) + .value().isNotEqualTo(15); +---- + +[[onvaluenonquality-date]] +=== With Date + +[source,java] +---- +// Verify that values are not equal to dates +assertThat(changes).changeOfCreation() + .rowAtEndPoint() + .value("birthdate") + .isNotEqualTo(LocalDate.of(1951, 6, 17)) + .changeOfModification() + .column("birthdate") + .valueAtStartPoint() + .isNotEqualTo(LocalDate.parse("1960-05-10")) + .valueAtEndPoint() + .isNotEqualTo(LocalDate.of(1960, 5, 10)); +---- + +[[onvaluenonquality-time]] +=== With Time + +[source,java] +---- +// Verify that the value is equal to a time +assertThat(table).row().value("duration").isNotEqualTo(LocalTime.of(9, 1)); +---- + +[[onvaluenonquality-datetime]] +=== With Date/Time + +[source,java] +---- +// Verify that the value is not equal to a date/time +assertThat(request).column().value() + .isNotEqualTo(LocalDateTime.of(2015, 5, 26,22, 46))) + .isNotEqualTo(LocalDateTime.parse("2015-05-26T22:46")); +---- + +[[onvaluenonquality-string]] +=== With String + +[source,java] +---- +// Verify that the values are not equal to numbers, texts and dates +assertThat(table).row().value().isNotEqualTo("5") + .value().isNotEqualTo("McGuiness") + .value().isNotEqualTo("Paul") + .value("birthdate").isNotEqualTo("1951-06-17"); +---- + +[[onvaluenonquality-uuid]] +=== With UUID + +Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] + +[source,java] +---- +// Verify that the values are not equal to UUID +assertThat(table).column() + .value().isNotEqualTo(UUID.fromString("30B443AE-C0C9-4790-9BEC-CE1380808435")) + .value().isNotEqualTo(UUID.fromString("0E2A1269-EFF0-4233-B87B-B53E8B6F164D")) + .value().isNotEqualTo(UUID.fromString("2B0D1BDD-909E-4362-BA10-C930BA82718D")); +---- + +[[onvaluenonquality-character]] +=== With Character + +Since xref:release-notes.adoc#v1-2-0-release-notes[1.2.0] + +[source,java] +---- +// Verify that the values are not equal to Character +assertThat(table).column() + .value().isNotEqualTo('T') + .value().isNotEqualTo('e') + .value().isNotEqualTo('s') + .value().isNotEqualTo('t'); +---- + +[[onvaluenullity]] +== On the nullity of a value + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueNullity.html[AssertOnValueNullity] interface. + +These assertions allow to verify if a value (the value of a table, of a request or of a change) is null or not. + +[source,java] +---- +// Verify that the value at index 1 is null and the next value is not null +assertThat(table).column().value(1).isNull() + .value().isNotNull(); +// Verify the value is not null +assertThat(changes).change().rowAtStartPoint().value("live") + .isNotNull(); +---- + +[[onvaluetype]] +== On the type of a value + +These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueType.html[AssertOnValueType] interface. + +This assertion allows to verify the type of a value (a value from a table, from a request or from changes). + +[source,java] +---- +// Verify that the value of the column called "firstname" +// of the fifth row of the table is a text +assertThat(table).row(4).value("firstname").isOfType(ValueType.TEXT); +// The same verification (with the specific method) +// on the third value of the second row of the request +assertThat(request).row(1).value(2).isText(); +// Verify that the value at start point of the first column +// of the first change is either a date or a number +assertThat(changes).change().column().valueAtStartPoint() + .isOfAnyOfTypes(ValueType.DATE, ValueType.NUMBER); +---- + +[[onvalueclass]] +== On the class of a value + +Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] + +This assertion is described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueClass.html[AssertOnValueClass] interface. + +This assertion allows to verify the class of a value (a value from a table, from a request or from changes). + +[source,java] +---- +// Verify that the value of the column called "firstname" +// of the fifth row of the table is a String +assertThat(table).row(4).value("firstname").isOfClass(String.class); +// Verify that the value at start point of the first column +// of the first change is a Locale +assertThat(changes).change().column().valueAtStartPoint() + .isOfClass(Locale.class); +---- diff --git a/src/docs/antora/modules/ROOT/pages/features/index.adoc b/src/docs/antora/modules/ROOT/pages/features/index.adoc new file mode 100644 index 00000000..604efb45 --- /dev/null +++ b/src/docs/antora/modules/ROOT/pages/features/index.adoc @@ -0,0 +1,5 @@ += Features highlight + +Before reading this page, it is recommended to be familiar with the xref:concepts/index.adoc[concepts of AssertJ-DB]. + +The purpose of this page is to show the different features of AssertJ-DB. diff --git a/src/docs/antora/modules/ROOT/pages/features.adoc b/src/docs/antora/modules/ROOT/pages/features/navigation.adoc similarity index 52% rename from src/docs/antora/modules/ROOT/pages/features.adoc rename to src/docs/antora/modules/ROOT/pages/features/navigation.adoc index 682c6fad..f1694c0a 100644 --- a/src/docs/antora/modules/ROOT/pages/features.adoc +++ b/src/docs/antora/modules/ROOT/pages/features/navigation.adoc @@ -1,16 +1,9 @@ -= Features highlight - -Before reading this page, it is recommended to be familiar with the xref:concepts.adoc[concepts of AssertJ-DB]. - -The purpose of this page is to show the different features of AssertJ-DB. - -[[navigation]] -== Navigation += Navigation [[tableorrequestasroot]] -=== With a Table or a Request as root +== With a Table or a Request as root -As shown in the xref:concepts.adoc#tableorrequestasroot[concepts] (to easily understand this chapter it is important to know the concepts of assertj-db), +As shown in the xref:concepts/navigation.adoc#tableorrequestasroot[concepts] (to easily understand this chapter it is important to know the concepts of assertj-db), the `assertThat(...)` static method is used to begin an assertion on a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table] @@ -39,7 +32,7 @@ at the corresponding index at the column name [[tableorrequesttorow]] -==== To a Row +=== To a Row These methods are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/navigation/ToRow.html[ToRow] interface. @@ -117,7 +110,7 @@ assertThat(table).row().row()... ---- [[tableorrequesttocolumn]] -==== To a Column +=== To a Column These methods are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/navigation/ToColumn.html[ToColumn] interface. @@ -213,7 +206,7 @@ assertThat(table).column().column()... ---- [[tableorrequesttovalue]] -==== To a Value +=== To a Value These methods are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/navigation/ToValue.html[ToValue] and the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/navigation/ToValueFromRow.html[ToValueFromRow] interfaces. @@ -308,10 +301,10 @@ assertThat(table).column().value().value()... ---- [[changesasroot]] -=== With Changes as root +== With Changes as root [[changestochanges]] -==== To Changes +=== To Changes These methods are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/navigation/ToChanges.html[ToChanges] interface. @@ -412,7 +405,7 @@ So if the method is executed from a change, a column, a row or a value it is like if the method was executed from the Changes. [[changestochange]] -==== To a Change +=== To a Change These methods are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/navigation/ToChange.html[ToChange] interface. @@ -598,7 +591,7 @@ assertThat(changes).change().change()... ---- [[changestorow]] -==== To a Row +=== To a Row These methods are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/navigation/ToRowFromChange.html[ToRowFromChange] interface. @@ -660,7 +653,7 @@ assertThat(changes).change().rowAtStartPoint().rowAtEndPoint()... ---- [[changestocolumn]] -==== To a Column +=== To a Column These methods are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/navigation/ToColumn.html[ToColumn] and https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/navigation/ToColumnFromChange.html[ToColumnFromChange] interfaces. @@ -792,7 +785,7 @@ assertThat(changes).change().column().column()... ---- [[changestovalue]] -==== To a Value +=== To a Value These methods are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/navigation/ToValue.html[ToValue], https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/navigation/ToValueFromColumn.html[ToValueFromColumn] @@ -900,863 +893,3 @@ assertThat(changes).change().rowAtEndPoint().value().returnToRow().value()... // The same thing is done but the return to the row is implicit assertThat(changes).change().rowAtEndPoint().value().value()... ---- - -[[assertions]] -== Assertions - -[[onchangetype]] -=== On the type of change - -These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnChangeType.html[AssertOnChangeType] interface. - -These assertions allow to verify the type of a change (the concept of change of type is described xref:concepts.adoc#changetype[here]). - -[source,java] ----- -// Verify that the first change is a change of creation -assertThat(changes).change().isOfType(ChangeType.CREATION); ----- - -There are specific assertion methods for each type of change. For example, the assertion below is equivalent to the one above - -[source,java] ----- -assertThat(changes).change().isCreation(); ----- - -[[oncolumnequality]] -=== On the equality with the values of a column - -These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnEquality.html[AssertOnColumnEquality] -and the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnOfChangeEquality.html[AssertOnColumnOfChangeEquality] interfaces. - -These assertion allow to verify the values of a column (the column of a table, of a request or of a change). - -[[oncolumnequality-boolean]] -==== With Boolean - -[source,java] ----- -// Verify that the values of the column "live" of the request -// was equal to true, to false and after to true -assertThat(request).column("live").hasValues(true, false, true); -// Verify that the value of the first column of the first change -// was false at start point and is true at end point -assertThat(changes).change().column().hasValues(false, true); -// Verify that the value of the third column of the first change -// is not modified and is true -assertThat(changes).change().column(2).hasValues(true); ----- - -[[oncolumnequality-bytes]] -==== With Bytes - -[source,java] ----- -// Get bytes from a file and from a resource in the classpath -byte[] bytesFromFile = Assertions.bytesContentOf(file); -byte[] bytesFromClassPath = Assertions.bytesContentFromClassPathOf(resource); -// Verify that the values of the second column of the request -// was equal to the bytes from the file, to null and to bytes from the resource -assertThat(request).column(1).hasValues(bytesFromFile, null, bytesFromClassPath); -// Verify that the value of the first column of the first change -// was equal to bytes from the file at start point and to bytes from the resource at end point -assertThat(changes).change().column().hasValues(bytesFromFile, bytesFromClassPath); ----- - -[[oncolumnequality-number]] -==== With Number - -[source,java] ----- -// Verify that the values of the first column of the table -// was equal to 5.9, 4 and 15000 -assertThat(table).column().hasValues(5.9, 4, new BigInteger("15000")); -// Verify that the value of the first column of the first change -// is not modified and is equal to 5 -assertThat(changes).change().column().hasValues(5); ----- - -[[oncolumnequality-date]] -==== With Date - -[source,java] ----- -// Verify that the values of the first column of the table -// was equal to December 23rd 2007 and May 19th 1975 -assertThat(table).column() - .hasValues(LocalDate.of(2007, 12, 23), - LocalDate.of(1975, 5, 19)); -// Verify that the value of the first column of the first change -// was equal December 23rd 2007 at start point -// and is equal to May 19th 1975 at end point -assertThat(changes).change().column() - .hasValues(LocalDate.parse("2007-12-23"), - LocalDate.parse("1975-05-19")); ----- - -[[oncolumnequality-time]] -==== With Time - -[source,java] ----- -// Verify that the values of the first column of the table -// was equal to 09:01am and 05:30:50pm -assertThat(table).column() - .hasValues(LocalTime.of(9, 1), - LocalTime.of(17, 30, 50)); -// Verify that the value of the first column of the first change -// was equal to 09:01am at start point -// and is equal to 05:30:50pm at end point -assertThat(changes).change().column() - .hasValues(LocalTime.parse("09:01"), - LocalTime.parse("17:30:50")); ----- - -[[oncolumnequality-datetime]] -==== With Date/Time - -[source,java] ----- -// Verify that the values of the first column of the table -// was equal to December 23rd 2007 09:01am and May 19th 1975 -assertThat(table).column() - .hasValues(LocalDateTime.of(LocalDate.of(2007, 12, 23), - LocalTime.parse("09:01")), - LocalDateTime.of(LocalDate.of(1975, 5, 19), - LocalTime.MIDNIGHT)); -// Verify that the value of the first column of the first change -// was equal December 23rd 2007 09:01am at start point -// and is equal to May 19th 1975 at end point -assertThat(changes).change().column() - .hasValues(LocalDateTime.parse("2007-12-23T09:01"), - LocalDateTime.parse("1975-05-19T00:00")); ----- - -[[oncolumnequality-string]] -==== With String - -[source,java] ----- -// Verify that values are equal to texts -assertThat(table).column("name") - .hasValues("Hewson", - "Evans", - "Clayton", - "Mullen"); -// Verify that the value of the column "size" of the first change of modification -// is not modified and is equal to 1.75 by parsing -assertThat(changes).changeOfModification().column("size") - .hasValues("1.75"); -// Verify that values are equal to dates, times or dates/times by parsing -assertThat(table).column() - .hasValues("2007-12-23T09:01"), - "1975-05-19"); ----- - -[[oncolumnequality-uuid]] -==== With UUID - -Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] - -[source,java] ----- -// Verify that the values of the first column of the table -// was equal to 30B443AE-C0C9-4790-9BEC-CE1380808435, 0E2A1269-EFF0-4233-B87B-B53E8B6F164D -// and 2B0D1BDD-909E-4362-BA10-C930BA82718D -assertThat(table).column().hasValues(UUID.fromString("30B443AE-C0C9-4790-9BEC-CE1380808435"), - UUID.fromString("0E2A1269-EFF0-4233-B87B-B53E8B6F164D"), - UUID.fromString("2B0D1BDD-909E-4362-BA10-C930BA82718D")); -// Verify that the value of the first column of the first change -// is not modified and is equal to 399FFFCA-7874-4225-9903-E227C4E9DCC1 -assertThat(changes).change() - .column().hasValues(UUID.fromString("399FFFCA-7874-4225-9903-E227C4E9DCC1")); ----- - -[[oncolumnequality-character]] -==== With Character - -Since xref:release-notes.adoc#v1-2-0-release-notes[1.2.0] - -[source,java] ----- -// Verify that the values of the first column of the table -// was equal to 'T', 'e', 's' and 't' -assertThat(table).column().hasValues('T', 'e', 's', 't'); -// Verify that the value of the first column of the first change -// is not modified and is equal to 'T' -assertThat(changes).change().column().hasValues('T'); ----- - -[[oncolumnname]] -=== On the name of a column - -This assertion is described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnName.html[AssertOnColumnName] interface. - -This assertion allows to verify the name of a column (the column of a table, of a request or of a change). - -[source,java] ----- -// Verify that the fifth column of the table is called "firstname" -assertThat(table).column(4).hasColumnName("firstname"); -// Verify that the third value of the second row of the request is in a column called "name" -assertThat(request).row(1).value(2).hasColumnName("name"); -// Verify that the first column of the first change is called "id" -assertThat(changes).change().column().hasColumnName("id"); ----- - -[[oncolumnnullity]] -=== On the nullity of the values of a column - -These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnNullity.html[AssertOnColumnNullity] interface. - -These assertion allows to verify the nullity of the values of a column (the column of a table or of a request). - -[source,java] ----- -// Verify that the fifth column of the table has only null values -assertThat(table).column(4).hasOnlyNullValues(); -// Verify that the column "name" has only not null values -assertThat(request).column("name").hasOnlyNotNullValues(); ----- - -[[onrownullity]] -=== On the nullity of the values of a row - -Since xref:release-notes.adoc#v1-2-0-release-notes[1.2.0] - -These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnRowNullity.html[AssertOnRowNullity] interface. - -These assertion allows to verify the nullity of the values of a row (the row of a table or of a request). - -[source,java] ----- -// Verify that the fifth row of the table has only not null values -assertThat(table).row(4).hasOnlyNotNullValues(); -// Verify that the first column has only not null values -assertThat(request).row().hasOnlyNotNullValues(); ----- - -[[oncolumntype]] -=== On the type of column - -These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnType.html[AssertOnColumnType] interface. - -These assertions allow to verify the type of the values of a column (a column from a table, from a request or from a change). - -[source,java] ----- -// Verify that the values of the column called "firstname" -// of the table are a text (null values are considered as wrong) -assertThat(table).column("firstname").isOfType(ValueType.TEXT, false); -// The same verification (with the specific method) -// on the third column of the request -assertThat(request).column(2).isText(false); -// Now the same verification again but with a lenience with null values -// (the null values are not considered as wrong) -assertThat(request).column(2).isText(true); -// Verify that the values of the first column -// of the first change is either a date or a number -assertThat(changes).change().column() - .isOfAnyOfTypes(ValueType.DATE, ValueType.NUMBER); ----- - -[[oncolumnclass]] -=== On the class of column - -Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] - -This assertion is described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnClass.html[AssertOnColumnClass] interface. - -This assertion allows to verify the class of the values of a column (a column from a table, from a request or from a change). - -[source,java] ----- -// Verify that the values of the column called "firstname" -// of the table are a String (null values are considered as wrong) -assertThat(table).column("firstname").isOfClass(String.class, false); -// Verify that the values of the first column -// of the first change is a Locale (null values are considered as right) -assertThat(changes).change().column().isOfClass(Locale.class, true); ----- - -[[oncolumncontent]] -=== On the content of column - -Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] - -These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnContent.html[AssertOnColumnContent] interface. - -These assertions allow to verify the content of a column (a column from a table or from a request). - -[source,java] ----- -// Verify that the content of the column called "name" -assertThat(table).column("name").containsValues("Hewson", - "Evans", - "Clayton", - "Mullen"); -// This second assertion is equivalent because the order of the values is not important -assertThat(table).column("name").containsValues("Evans", - "Clayton", - "Hewson", - "Mullen"); - ----- - -[[ondatatype]] -=== On the type of data - -These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnDataType.html[AssertOnDataType] interface. - -These assertions allow to verify the type of the date on which is a change. - -[source,java] ----- -// Verify that the change is on a table -assertThat(changes).change().isOnDataType(DataType.TABLE); -// The same verification (with the specific method) -assertThat(changes).change().isOnTable(); -// Verify that the change is on the "members" table -assertThat(changes).change().isOnTable("members"); ----- - -[[onmodifiedcolumns]] -=== On the modified columns in a change - -These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnModifiedColumn.html[AssertOnModifiedColumn] -and the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnModifiedColumns.html[AssertOnModifiedColumns] interfaces. - -These assertions allow to verify if a column of a change have been modified between the start point and the end point (see the xref:concepts.adoc#changes[concept of changes]). - -[source,java] ----- -// Verify that first column of the change is not modified -// and the second column is modified -assertThat(changes).change().column().isNotModified().column().isModified(); -// Verify that there are 2 modified columns in the change -assertThat(changes).change().hasNumberOfModifiedColumns(2); -// Verify that the modified column in change are at index 1 and 2 -assertThat(changes).change().hasModifiedColumns(1, 2); -// Verify that the modified column in change are "name" and "firstname" -assertThat(changes).change().hasModifiedColumns("name", "firstname"); ----- - -Since version xref:release-notes.adoc#v1-1-0-release-notes[1.1.0], there are new assertions which allow to compare the number of modified columns between the start point and the end point. - -[source,java] ----- -// Verify that the number of modified columns in the first change is more than 5 -assertThat(changes).change().hasNumberOfModifiedColumnsGreaterThan(5); -// Verify that the number of modified columns in the first change is at least 5 -assertThat(changes).change().hasNumberOfModifiedColumnsGreaterThanOrEqualTo(5); -// Verify that the number of modified columns in the first change is less than 6 -assertThat(changes).change().hasNumberOfModifiedColumnsLessThan(6); -// Verify that the number of modified columns in the first change is at most 6 -assertThat(changes).change().hasNumberOfModifiedColumnsLessThanOrEqualTo(6); ----- - -[[onnumberchanges]] -=== On the number of changes - -This assertion is described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnNumberOfChanges.html[AssertOnNumberOfChanges] interface. - -This assertion allows to verify the number of changes. - -[source,java] ----- -// Verify that there are 4 changes -assertThat(changes).hasNumberOfChanges(4); ----- - -Since version xref:release-notes.adoc#v1-1-0-release-notes[1.1.0], there are new assertions which allow to compare the number of changes between the start point and the end point. - -[source,java] ----- -// Verify that the number of changes is more than 5 -assertThat(changes).hasNumberOfChangesGreaterThan(5); -// Verify that the number of changes is at least 5 -assertThat(changes).hasNumberOfChangesGreaterThanOrEqualTo(5); -// Verify that the number of changes is less than 6 -assertThat(changes).hasNumberOfChangesLessThan(6); -// Verify that the number of changes is at most 6 -assertThat(changes).hasNumberOfChangesLessThanOrEqualTo(6); ----- - -[[onnumbercolumns]] -=== On the number of columns - -This assertion is described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnNumberOfColumns.html[AssertOnNumberOfColumns] interface. - -This assertion allows to verify the number of columns (columns from a table, from a request or from a change). - -[source,java] ----- -// Verify that there are 6 columns in the table -assertThat(table).hasNumberOfColumns(6); -// Verify that there are 4 columns in the change -assertThat(changes).change().hasNumberOfColumns(4); ----- - -Since version xref:release-notes.adoc#v1-1-0-release-notes[1.1.0], there are new assertions which allow to compare the number of columns. - -[source,java] ----- -// Verify that the number of columns is more than 5 -assertThat(table).hasNumberOfColumnsGreaterThan(5); -// Verify that the number of columns is at least 5 -assertThat(request).hasNumberOfColumnsGreaterThanOrEqualTo(5); -// Verify that the number of columns is less than 6 -assertThat(changes).hasNumberOfColumnsLessThan(6); -// Verify that the number of columns is at most 6 -assertThat(changes).hasNumberOfColumnsLessThanOrEqualTo(6); ----- - -[[onnumberrows]] -=== On the number of rows - -This assertion is described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnNumberOfRows.html[AssertOnNumberOfRows] interface. - -This assertion allows to verify the number of rows (rows from a table or from a request). - -[source,java] ----- -// Verify that there are 7 rows in the table -assertThat(table).hasNumberOfRows(7); ----- - -Since version xref:release-notes.adoc#v1-1-0-release-notes[1.1.0], there are new assertions which allow to compare the number of rows. - -[source,java] ----- -// Verify that the number of rows is more than 5 -assertThat(table).hasNumberOfRowsGreaterThan(5); -// Verify that the number of rows is at least 5 -assertThat(request).hasNumberOfRowsGreaterThanOrEqualTo(5); -// Verify that the number of rows is less than 6 -assertThat(changes).hasNumberOfRowsLessThan(6); -// Verify that the number of rows is at most 6 -assertThat(changes).hasNumberOfRowsLessThanOrEqualTo(6); ----- - -Since version xref:release-notes.adoc#v1-2-0-release-notes[1.2.0], there is a new assertion which allow to verify if rows are empty (equivalent to `hasNumberOfRows(0)`). - -[source,java] ----- -// Verify that the table are empty -assertThat(table).isEmpty(); ----- - -[[onprimarykeys]] -=== On the primary keys - -These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnPrimaryKey.html[AssertOnPrimaryKey] interface. - -These assertions allow to verify the names and the values of the columns which compose the primary keys of the rows from a change. - -[source,java] ----- -// Verify that the columns of the primary keys are "id" and "name" -assertThat(changes).change().hasPksNames("id", "name"); -// Verify that the values of the primary keys are 1 and "HEWSON" -assertThat(changes).change().hasPksValues(1, "HEWSON"); ----- - -[[onrowequality]] -=== On the equality with the values of a row - -This assertion is described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnRowEquality.html[AssertOnRowEquality] interface. - -This assertion allow to verify the values of a row (the row of a table, of a request or of a change). - -[source,java] ----- -// Verify the values of the row at index 1 -assertThat(table).row(1) - .hasValues(2, - "Evans", - "David Howell", - "The Edge", - DateValue.of(1961, 8, 8), - 1.77); -// Verify the values of the row at end point -assertThat(changes).change().rowAtEndPoint() - .hasValues(5, - "McGuiness", - "Paul", - null, - "1951-06-17", - null); ----- - -[[onrowexistence]] -=== On the existence of a row in a change - -These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnRowOfChangeExistence.html[AssertOnRowOfChangeExistence] interface. - -These assertions allow to verify that the row at start point or at end point of a change exists or not (for a creation, the row do not exist at start point and for a deletion it is the contrary : the row do not exist at end point). - -[source,java] ----- -// Verify that row at start point exists -assertThat(changes).change().rowAtStartPoint().exists(); -// Verify that the row at end point do not exist -assertThat(changes).change().rowAtEndPoint().doesNotExist(); ----- - -[[onvaluechronology]] -=== On the chronology of a value - -These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueChronology.html[AssertOnValueChronology] interface. - -These assertions allow to compare a value (the value of a table, of a request or of a change) to a date, a time or a date/time. - -[source,java] ----- -// Compare the value with a date -assertThat(table).row(1).value("birthdate") - .isAfter(DateValue.of(1950, 8, 8)); -// Verify the value is between two dates/times -assertThat(changes).change().column("release").valueAtEndPoint() - .isAfterOrEqualTo(DateTimeValue.parse("2014-09-08T23:30")) - .isBeforeOrEqualTo(DateTimeValue.parse("2014-09-09T05:30")); ----- - -[[onvaluecomparison]] -=== On the comparison with a value - -These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueComparison.html[AssertOnValueComparison] interface. - -These assertions allow to compare a value (the value of a table, of a request or of a change) to a number. - -[source,java] ----- -// Compare the value with a number -assertThat(table).row(1).value("size") - .isGreaterThan(1.5); -// Verify the value is between two numbers -assertThat(changes).change().column("size").valueAtEndPoint() - .isGreaterThanOrEqualTo(1.7) - .isLessThanOrEqualTo(1.8); ----- - -[[onvaluecloseness]] -=== On the closeness of a value - -Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] - -These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueCloseness.html[AssertOnValueCloseness] interface. - -These assertions allow to verify if a value (the value of a table, of a request or of a change) is close to another. - -[source,java] ----- -// Verify if the value is close to 2 with a tolerance of 0.5 -// So the values between 1.5 and 2.5 are right -assertThat(table).row(1).value("size") - .isCloseTo(2, 0.5); -// Verify the value is close to 05-10-1960 with a tolerance of two days -assertThat(changes).change().column("birth").valueAtEndPoint() - .isCloseTo(DateValue(1960, 5, 10), - DateValue(0, 0, 2)); ----- - -[[onvaluequality]] -=== On the equality with a value - -These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueEquality.html[AssertOnValueEquality] interface. - -These assertion allow to verify that a value (the value of a table, of a request or of a change) is equal to another value (in parameter). - -[[onvaluequality-boolean]] -==== With Boolean - -[source,java] ----- -// Verify that the value is equal to true -assertThat(table).row(3).value("live").isEqualTo(true); -// Do the same thing with the specific method -assertThat(table).row(3).value("live").isTrue(); ----- - -[[onvaluequality-bytes]] -==== With Bytes - -[source,java] ----- -// Get bytes from a file -byte[] bytesFromFile = Assertions.bytesContentOf(file); -// Verify that the value at end point of the first column of the first change -// is equal to bytes from the file -assertThat(changes).change().column().valueAtStartPoint().isEqualTo(bytesFromFile); ----- - -[[onvaluequality-number]] -==== With Number - -[source,java] ----- -// Verify that the first value is equal to 1.77, -// the second is equal to 50 and the last is equal to zero -assertThat(request).column("size").value().isEqualTo(1.77) - .value().isEqualTo(50) - .value().isEqualTo(0).isZero(); ----- - -[[onvaluequality-date]] -==== With Date - -[source,java] ----- -// Verify that values are equal to dates -assertThat(changes).changeOfCreation() - .rowAtEndPoint() - .value("birthdate") - .isEqualTo(LocalDate.of(1951, 6, 17)) - .changeOfModification() - .column("birthdate") - .isEqualTo() - .isNotEqualTo(LocalDate.parse("1960-05-10")) - .valueAtEndPoint() - .isEqualTo(LocalDate.of(1960, 5, 10)); ----- - -[[onvaluequality-time]] -==== With Time - -[source,java] ----- -// Verify that the value is equal to a time -assertThat(table).row().value("duration").isEqualTo(LocalTime.of(9, 1)); ----- - -[[onvaluequality-datetime]] -==== With Date/Time - -[source,java] ----- -// Verify that the value is equal to a date/time -assertThat(request).column().value() - .isEqualTo(LocalDateTime.of(2007, 12, 23,9, 1, 0)) - .isEqualTo(LocalDateTime.parse("2007-12-23T09:01")); ----- - -[[onvaluequality-string]] -==== With String - -[source,java] ----- -// Verify that the values are equal to numbers, texts and dates -assertThat(table).row().value().isEqualTo("1") - .value().isEqualTo("Hewson") - .value().isEqualTo("Paul David") - .value().isEqualTo("Bono") - .value().isEqualTo("1960-05-10") - .value().isEqualTo("1.75"); ----- - -[[onvaluequality-uuid]] -==== With UUID - -Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] - -[source,java] ----- -// Verify that the values are equal to UUID -assertThat(table).column().value().isEqualTo(UUID.fromString("30B443AE-C0C9-4790-9BEC-CE1380808435")) - .value().isEqualTo(UUID.fromString("0E2A1269-EFF0-4233-B87B-B53E8B6F164D")) - .value().isEqualTo(UUID.fromString("2B0D1BDD-909E-4362-BA10-C930BA82718D")); ----- - -[[onvaluequality-character]] -==== With Character - -Since xref:release-notes.adoc#v1-2-0-release-notes[1.2.0] - -[source,java] ----- -// Verify that the values are equal to Character -assertThat(table).column().value().isEqualTo('T') - .value().isEqualTo('e') - .value().isEqualTo('s') - .value().isEqualTo('t'); ----- - -[[onvaluenonquality]] -=== On the non equality with a value - -These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueNonEquality.html[AssertOnValueNonEquality] interface. - -These assertion allow to verify that a value (the value of a table, of a request or of a change) is not equal to another value (in parameter). - -[[onvaluenonquality-boolean]] -==== With Boolean - -[source,java] ----- -// Verify that the values (values "live" in the row at index 3 and index 5) -// are not equal to false -assertThat(table).row(3).value("live").isNotEqualTo(false) - .row(5).value("live").isNotEqualTo(false); ----- - -[[onvaluenonquality-bytes]] -==== With Bytes - -[source,java] ----- -// Get bytes from a resource in the classpath -byte[] bytesFromClassPath = Assertions.bytesContentFromClassPathOf(resource); -// Verify that the value at end point of the first column of the first change -// is not equal to bytes from the resource -assertThat(changes).change().column().valueAtStartPoint().isNotEqualTo(bytesFromClassPath); ----- - -[[onvaluenonquality-number]] -==== With Number - -[source,java] ----- -// Verify that the first value is not equal to 1.78, -// the second is not equal to 55 and the last is not equal to 15 -assertThat(request).column("size").value().isNotEqualTo(1.78) - .value().isNotEqualTo(55) - .value().isNotEqualTo(15); ----- - -[[onvaluenonquality-date]] -==== With Date - -[source,java] ----- -// Verify that values are not equal to dates -assertThat(changes).changeOfCreation() - .rowAtEndPoint() - .value("birthdate") - .isNotEqualTo(LocalDate.of(1951, 6, 17)) - .changeOfModification() - .column("birthdate") - .valueAtStartPoint() - .isNotEqualTo(LocalDate.parse("1960-05-10")) - .valueAtEndPoint() - .isNotEqualTo(LocalDate.of(1960, 5, 10)); ----- - -[[onvaluenonquality-time]] -==== With Time - -[source,java] ----- -// Verify that the value is equal to a time -assertThat(table).row().value("duration").isNotEqualTo(LocalTime.of(9, 1)); ----- - -[[onvaluenonquality-datetime]] -==== With Date/Time - -[source,java] ----- -// Verify that the value is not equal to a date/time -assertThat(request).column().value() - .isNotEqualTo(LocalDateTime.of(2015, 5, 26,22, 46))) - .isNotEqualTo(LocalDateTime.parse("2015-05-26T22:46")); ----- - -[[onvaluenonquality-string]] -==== With String - -[source,java] ----- -// Verify that the values are not equal to numbers, texts and dates -assertThat(table).row().value().isNotEqualTo("5") - .value().isNotEqualTo("McGuiness") - .value().isNotEqualTo("Paul") - .value("birthdate").isNotEqualTo("1951-06-17"); ----- - -[[onvaluenonquality-uuid]] -==== With UUID - -Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] - -[source,java] ----- -// Verify that the values are not equal to UUID -assertThat(table).column() - .value().isNotEqualTo(UUID.fromString("30B443AE-C0C9-4790-9BEC-CE1380808435")) - .value().isNotEqualTo(UUID.fromString("0E2A1269-EFF0-4233-B87B-B53E8B6F164D")) - .value().isNotEqualTo(UUID.fromString("2B0D1BDD-909E-4362-BA10-C930BA82718D")); ----- - -[[onvaluenonquality-character]] -==== With Character - -Since xref:release-notes.adoc#v1-2-0-release-notes[1.2.0] - -[source,java] ----- -// Verify that the values are not equal to Character -assertThat(table).column() - .value().isNotEqualTo('T') - .value().isNotEqualTo('e') - .value().isNotEqualTo('s') - .value().isNotEqualTo('t'); ----- - -[[onvaluenullity]] -=== On the nullity of a value - -These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueNullity.html[AssertOnValueNullity] interface. - -These assertions allow to verify if a value (the value of a table, of a request or of a change) is null or not. - -[source,java] ----- -// Verify that the value at index 1 is null and the next value is not null -assertThat(table).column().value(1).isNull() - .value().isNotNull(); -// Verify the value is not null -assertThat(changes).change().rowAtStartPoint().value("live") - .isNotNull(); ----- - -[[onvaluetype]] -=== On the type of a value - -These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueType.html[AssertOnValueType] interface. - -This assertion allows to verify the type of a value (a value from a table, from a request or from changes). - -[source,java] ----- -// Verify that the value of the column called "firstname" -// of the fifth row of the table is a text -assertThat(table).row(4).value("firstname").isOfType(ValueType.TEXT); -// The same verification (with the specific method) -// on the third value of the second row of the request -assertThat(request).row(1).value(2).isText(); -// Verify that the value at start point of the first column -// of the first change is either a date or a number -assertThat(changes).change().column().valueAtStartPoint() - .isOfAnyOfTypes(ValueType.DATE, ValueType.NUMBER); ----- - -[[onvalueclass]] -=== On the class of a value - -Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] - -This assertion is described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueClass.html[AssertOnValueClass] interface. - -This assertion allows to verify the class of a value (a value from a table, from a request or from changes). - -[source,java] ----- -// Verify that the value of the column called "firstname" -// of the fifth row of the table is a String -assertThat(table).row(4).value("firstname").isOfClass(String.class); -// Verify that the value at start point of the first column -// of the first change is a Locale -assertThat(changes).change().column().valueAtStartPoint() - .isOfClass(Locale.class); ----- diff --git a/src/docs/antora/modules/ROOT/pages/quickstart.adoc b/src/docs/antora/modules/ROOT/pages/quickstart.adoc index cf1b26da..3c2cf5ec 100644 --- a/src/docs/antora/modules/ROOT/pages/quickstart.adoc +++ b/src/docs/antora/modules/ROOT/pages/quickstart.adoc @@ -61,12 +61,12 @@ include::example$java/example/db/TableAssertionExamples.java[tags=user_guide] In this simple example you can see many `[concepts of AssertJ-DB] (the concepts are simple but I advice you to take the time to get to know them well) : -* xref:concepts.adoc#elements[the elements] : -** xref:concepts.adoc#table[Table] which represents a table in the database -** xref:concepts.adoc#column[Column] which represents a column of the table -** xref:concepts.adoc#row[Row] which represents a row of the table -** xref:concepts.adoc#value[Value] which represents a value in a column or in a row -* xref:concepts.adoc#tableorrequestasroot[the navigation] : +* xref:concepts/elements.adoc[the elements] : +** xref:concepts/elements.adoc#table[Table] which represents a table in the database +** xref:concepts/elements.adoc#column[Column] which represents a column of the table +** xref:concepts/elements.adoc#row[Row] which represents a row of the table +** xref:concepts/elements.adoc#value[Value] which represents a value in a column or in a row +* xref:concepts/navigation.adoc#tableorrequestasroot[the navigation] : ** The first check, navigates from the table to the column called "name" (``column("name")`` moves the assertion to the column), from this column to the first value (the first call of ``value()`` moves to the first value) @@ -75,5 +75,5 @@ and after that to each value (each call of ``value()`` moves to the next value o (``row(1)`` moves the assertion to the row), from this row to the first value and after that to each value (``value()`` calls have similar behavior for rows and columns). -* xref:concepts.adoc#datevaluetimevaluedatetimevalue[DateValue] : Since 2.0.0, AssertJ-DB baseline is Java 8. The preferred way to compare values with date, time and date/time is to use java.time.LocalDate, java.time.LocalTime, java.time.LocalDateTime. +* xref:concepts/datetime.adoc[DateValue] : Since 2.0.0, AssertJ-DB baseline is Java 8. The preferred way to compare values with date, time and date/time is to use java.time.LocalDate, java.time.LocalTime, java.time.LocalDateTime. But for the backward compatibility, it's always possible to use AssertJ-DB DateValue utilities. From 90bf4fd94467b1b86f460c30593b8296ee415821 Mon Sep 17 00:00:00 2001 From: Marc Philipp Date: Thu, 19 Nov 2026 15:54:46 +0100 Subject: [PATCH 05/13] Fix typos and broken concepts link in user guide --- src/docs/antora/modules/ROOT/pages/concepts/datetime.adoc | 4 ++-- src/docs/antora/modules/ROOT/pages/quickstart.adoc | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/src/docs/antora/modules/ROOT/pages/concepts/datetime.adoc b/src/docs/antora/modules/ROOT/pages/concepts/datetime.adoc index 1e371e63..73112d53 100644 --- a/src/docs/antora/modules/ROOT/pages/concepts/datetime.adoc +++ b/src/docs/antora/modules/ROOT/pages/concepts/datetime.adoc @@ -6,11 +6,11 @@ But for the backward compatibility, it's always possible to use AssertJ-DB DateV So The https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/DateValue.html[DateValue], https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/TimeValue.html[TimeValue] and - https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/DateTimeValue.html[DateTimeValue] classes are simpler but contains this kind of informations. + https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/DateTimeValue.html[DateTimeValue] classes are simpler but contain this kind of information. There is 4 kinds of static methods to instantiate these values : -* `of` which receives the informations as `int` parameters +* `of` which receives the information as `int` parameters [source,java] ---- diff --git a/src/docs/antora/modules/ROOT/pages/quickstart.adoc b/src/docs/antora/modules/ROOT/pages/quickstart.adoc index 3c2cf5ec..ac84067c 100644 --- a/src/docs/antora/modules/ROOT/pages/quickstart.adoc +++ b/src/docs/antora/modules/ROOT/pages/quickstart.adoc @@ -59,7 +59,7 @@ Example from {assertj-examples-github}/blob/main/assertions-examples/src/test/ja include::example$java/example/db/TableAssertionExamples.java[tags=user_guide] ---- -In this simple example you can see many `[concepts of AssertJ-DB] (the concepts are simple but I advice you to take the time to get to know them well) : +In this simple example you can see many xref:concepts/index.adoc[concepts of AssertJ-DB] (the concepts are simple, but I advise you to take the time to get to know them well) : * xref:concepts/elements.adoc[the elements] : ** xref:concepts/elements.adoc#table[Table] which represents a table in the database From 333f5c9e3bfc1c182ce56c2761b8a367f69c219e Mon Sep 17 00:00:00 2001 From: Marc Philipp Date: Thu, 19 Nov 2026 15:55:27 +0100 Subject: [PATCH 06/13] Move images into Antora component --- README.md | 2 +- img/assertj-db_icon.png | Bin 114573 -> 0 bytes .../modules/ROOT/images}/assertj-db_icon.xcf | Bin .../ROOT/images}/assertj-db_icon_small.png | Bin .../ROOT/images}/old_assertj-db_icon.png | Bin .../ROOT/images}/old_assertj-db_icon.xcf | Bin .../ROOT/images}/old_assertj-db_icon_small.png | Bin 7 files changed, 1 insertion(+), 1 deletion(-) delete mode 100644 img/assertj-db_icon.png rename {img => src/docs/antora/modules/ROOT/images}/assertj-db_icon.xcf (100%) rename {img => src/docs/antora/modules/ROOT/images}/assertj-db_icon_small.png (100%) rename {img => src/docs/antora/modules/ROOT/images}/old_assertj-db_icon.png (100%) rename {img => src/docs/antora/modules/ROOT/images}/old_assertj-db_icon.xcf (100%) rename {img => src/docs/antora/modules/ROOT/images}/old_assertj-db_icon_small.png (100%) diff --git a/README.md b/README.md index b00f3f8d..81f98e9a 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -![alt tag](img/assertj-db_icon.png) +![alt tag](src/docs/antora/modules/ROOT/images/assertj-db_icon.png) AssertJ-DB - Assertions for database ========== diff --git a/img/assertj-db_icon.png b/img/assertj-db_icon.png deleted file mode 100644 index ace471498e5bde229c2b152c1af6eefd1d8b5b8b..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 114573 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 diff --git a/img/assertj-db_icon.xcf b/src/docs/antora/modules/ROOT/images/assertj-db_icon.xcf similarity index 100% rename from img/assertj-db_icon.xcf rename to src/docs/antora/modules/ROOT/images/assertj-db_icon.xcf diff --git a/img/assertj-db_icon_small.png b/src/docs/antora/modules/ROOT/images/assertj-db_icon_small.png similarity index 100% rename from img/assertj-db_icon_small.png rename to src/docs/antora/modules/ROOT/images/assertj-db_icon_small.png diff --git a/img/old_assertj-db_icon.png b/src/docs/antora/modules/ROOT/images/old_assertj-db_icon.png similarity index 100% rename from img/old_assertj-db_icon.png rename to src/docs/antora/modules/ROOT/images/old_assertj-db_icon.png diff --git a/img/old_assertj-db_icon.xcf b/src/docs/antora/modules/ROOT/images/old_assertj-db_icon.xcf similarity index 100% rename from img/old_assertj-db_icon.xcf rename to src/docs/antora/modules/ROOT/images/old_assertj-db_icon.xcf diff --git a/img/old_assertj-db_icon_small.png b/src/docs/antora/modules/ROOT/images/old_assertj-db_icon_small.png similarity index 100% rename from img/old_assertj-db_icon_small.png rename to src/docs/antora/modules/ROOT/images/old_assertj-db_icon_small.png From a5f4fea4642343e1592829cddba63e37550587a8 Mon Sep 17 00:00:00 2001 From: Marc Philipp Date: Thu, 19 Nov 2026 15:59:54 +0100 Subject: [PATCH 07/13] Shorten navigation labels of concept pages --- src/docs/antora/modules/ROOT/nav.adoc | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/src/docs/antora/modules/ROOT/nav.adoc b/src/docs/antora/modules/ROOT/nav.adoc index bce3a719..ae755278 100644 --- a/src/docs/antora/modules/ROOT/nav.adoc +++ b/src/docs/antora/modules/ROOT/nav.adoc @@ -1,13 +1,13 @@ * xref:index.adoc[Overview] * xref:quickstart.adoc[] * xref:concepts/index.adoc[] -** xref:concepts/connection.adoc[] -** xref:concepts/elements.adoc[] +** xref:concepts/connection.adoc[Connection] +** xref:concepts/elements.adoc[Elements] ** xref:concepts/types.adoc[] ** xref:concepts/navigation.adoc[] -** xref:concepts/datetime.adoc[] -** xref:concepts/description.adoc[] -** xref:concepts/letter-case.adoc[] +** xref:concepts/datetime.adoc[Date Time] +** xref:concepts/description.adoc[Description] +** xref:concepts/letter-case.adoc[Letter Case] ** xref:concepts/output.adoc[] * xref:features/index.adoc[] ** xref:features/navigation.adoc[] From b2528d5aa464a49c77cc551ca75da4517e748e45 Mon Sep 17 00:00:00 2001 From: Marc Philipp Date: Fri, 20 Nov 2026 10:27:50 +0100 Subject: [PATCH 08/13] Remove unused AsciiDoc attributes --- src/docs/antora-resources/antora.yml | 9 --------- 1 file changed, 9 deletions(-) diff --git a/src/docs/antora-resources/antora.yml b/src/docs/antora-resources/antora.yml index 86f57c2a..0a5fc799 100644 --- a/src/docs/antora-resources/antora.yml +++ b/src/docs/antora-resources/antora.yml @@ -7,13 +7,4 @@ asciidoc: tabsize: '3' source-indent: '0' assertj-db-version: '${project.version}' - assertj-core-github: 'https://github.com/assertj/assertj' - assertj-doc-github: 'https://github.com/assertj/doc' assertj-examples-github: 'https://github.com/assertj/assertj-examples' - assertj-examples-base-package: 'https://github.com/assertj/assertj-examples/blob/main/assertions-examples/src/test/java/org/assertj/examples' - assertj-guava-github: 'https://github.com/assertj/assertj' - assertj-swing-github: 'https://github.com/assertj/assertj-swing' - release-branch: 'main' - current-branch: 'https://github.com/assertj/assertj/tree/main' - AssertJ: 'https://assertj.github.io/doc/[AssertJ]' - StackOverflow: 'https://stackoverflow.com/questions/tagged/assertj[Stack Overflow]' From 31798061573635b080ed567b236b7c8576c8fb65 Mon Sep 17 00:00:00 2001 From: Marc Philipp Date: Fri, 20 Nov 2026 10:32:25 +0100 Subject: [PATCH 09/13] Remove release notes page --- src/docs/antora/modules/ROOT/nav.adoc | 2 +- .../ROOT/pages/concepts/connection.adoc | 2 +- .../modules/ROOT/pages/concepts/datetime.adoc | 4 +- .../modules/ROOT/pages/concepts/elements.adoc | 2 +- .../ROOT/pages/concepts/letter-case.adoc | 2 +- .../modules/ROOT/pages/concepts/output.adoc | 2 +- .../modules/ROOT/pages/concepts/types.adoc | 4 +- .../ROOT/pages/features/assertions.adoc | 32 +-- .../modules/ROOT/pages/release-notes.adoc | 239 ------------------ 9 files changed, 25 insertions(+), 264 deletions(-) delete mode 100644 src/docs/antora/modules/ROOT/pages/release-notes.adoc diff --git a/src/docs/antora/modules/ROOT/nav.adoc b/src/docs/antora/modules/ROOT/nav.adoc index ae755278..984fc7cd 100644 --- a/src/docs/antora/modules/ROOT/nav.adoc +++ b/src/docs/antora/modules/ROOT/nav.adoc @@ -12,4 +12,4 @@ * xref:features/index.adoc[] ** xref:features/navigation.adoc[] ** xref:features/assertions.adoc[] -* xref:release-notes.adoc[] +* https://github.com/assertj/assertj-db/releases[Release Notes] diff --git a/src/docs/antora/modules/ROOT/pages/concepts/connection.adoc b/src/docs/antora/modules/ROOT/pages/concepts/connection.adoc index 9e5d0dc9..3636602d 100644 --- a/src/docs/antora/modules/ROOT/pages/concepts/connection.adoc +++ b/src/docs/antora/modules/ROOT/pages/concepts/connection.adoc @@ -48,7 +48,7 @@ For more information, see the xref:concepts/letter-case.adoc[paragraph on Letter [[assertdbconnectionmetadata]] == Schema retrieval mode -Since xref:release-notes.adoc#v1-1-0-release-notes[3.0.0] +Since 3.0.0 For many assertions, AssertJ-DB require to discover database schema metadata ( list of tables, columns, ... ). When the schema contains many tables this operation can slow down the tests executions. diff --git a/src/docs/antora/modules/ROOT/pages/concepts/datetime.adoc b/src/docs/antora/modules/ROOT/pages/concepts/datetime.adoc index 73112d53..c27b2842 100644 --- a/src/docs/antora/modules/ROOT/pages/concepts/datetime.adoc +++ b/src/docs/antora/modules/ROOT/pages/concepts/datetime.adoc @@ -30,7 +30,7 @@ DateTimeValue dateTimeValue2 = DateTimeValue.of(dateValue, timeValue1); ---- * `from` which receives the equivalent from `java.sql` package (`java.sql.Date`, `java.sql.Time` and `java.sql.Timestamp`) -or a `java.util.Calendar` [.small]#(since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0])# +or a `java.util.Calendar` [.small]#(since 1.1.0)# [source,java] ---- @@ -73,7 +73,7 @@ DateTimeValue dateTimeValue2 = DateTimeValue.parse("2007-12-23T09:01:06"); DateTimeValue dateTimeValue2 = DateTimeValue.parse("2007-12-23T09:01:06.000000003"); ---- -* `now` [.small]#(since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0])# which create an instance corresponding to the current moment. +* `now` [.small]#(since 1.1.0)# which create an instance corresponding to the current moment. [source,java] ---- diff --git a/src/docs/antora/modules/ROOT/pages/concepts/elements.adoc b/src/docs/antora/modules/ROOT/pages/concepts/elements.adoc index b433039e..a7ba6dc4 100644 --- a/src/docs/antora/modules/ROOT/pages/concepts/elements.adoc +++ b/src/docs/antora/modules/ROOT/pages/concepts/elements.adoc @@ -83,7 +83,7 @@ Table table4 = connection.table("members").columnsToCheck(new String[] { "id", " |'Mullen' |==== -Since version xref:release-notes.adoc#v1-2-0-release-notes[1.2.0], there are the possibility to indicate delimiters (start delimiter and end delimiter) and `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.Order.html[Order]`. +Since version 1.2.0, there are the possibility to indicate delimiters (start delimiter and end delimiter) and `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.Order.html[Order]`. The delimiters are useful when the table name or column name is a reserved word or contains special characters (like space or '%'). `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.Order.html[Order]` allows to choose the order of the `Row`. diff --git a/src/docs/antora/modules/ROOT/pages/concepts/letter-case.adoc b/src/docs/antora/modules/ROOT/pages/concepts/letter-case.adoc index 5705389d..dac2fe67 100644 --- a/src/docs/antora/modules/ROOT/pages/concepts/letter-case.adoc +++ b/src/docs/antora/modules/ROOT/pages/concepts/letter-case.adoc @@ -1,6 +1,6 @@ = Letter Case of the database -Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] +Since 1.1.0 Databases have different letter cases for the name of the elements. For example, the name of the table can be upper case either the name is inputted in upper case or not. So this concept (and feature too) is here to manage these shades. diff --git a/src/docs/antora/modules/ROOT/pages/concepts/output.adoc b/src/docs/antora/modules/ROOT/pages/concepts/output.adoc index 09d2184c..02df4ed7 100644 --- a/src/docs/antora/modules/ROOT/pages/concepts/output.adoc +++ b/src/docs/antora/modules/ROOT/pages/concepts/output.adoc @@ -1,6 +1,6 @@ = Output -Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] +Since 1.1.0 It can be interesting to view the values on which an assertion is made (for example for debugging). The output allows that. diff --git a/src/docs/antora/modules/ROOT/pages/concepts/types.adoc b/src/docs/antora/modules/ROOT/pages/concepts/types.adoc index 669b06df..3f3baead 100644 --- a/src/docs/antora/modules/ROOT/pages/concepts/types.adoc +++ b/src/docs/antora/modules/ROOT/pages/concepts/types.adoc @@ -37,7 +37,7 @@ The type of the value depends of class of the object given by `java.sql` when th * `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#DATE[DATE]` for a `java.sql.Date` * `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#TIME[TIME]` for a `java.sql.Time` * `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#DATE_TIME[DATE_TIME]` for a `java.sql.Timestamp` -* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#UUID[UUID]` for a `java.util.UUID` [.small]#(since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0])# +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#UUID[UUID]` for a `java.util.UUID` [.small]#(since 1.1.0)# * `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#NUMBER[NUMBER]` for a `java.lang.Byte`, `java.lang.Short`, `java.lang.Integer`, `java.lang.Long`, `java.lang.Double`, `java.lang.Float` or `java.math.BigDecimal` * `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#NOT_IDENTIFIED[NOT_IDENTIFIED]` for other cases (for example when the value is `null`) @@ -45,7 +45,7 @@ The type of the value depends of class of the object given by `java.sql` when th [[ordertype]] == Order Type -Since xref:release-notes.adoc#v1-2-0-release-notes[1.2.0] +Since 1.2.0 The order can be a ascending or descending. All the possible types of order are contained in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.Order.OrderType.html[Table.Order.OrderType] enumeration. diff --git a/src/docs/antora/modules/ROOT/pages/features/assertions.adoc b/src/docs/antora/modules/ROOT/pages/features/assertions.adoc index 92d5f152..f6f6d2ea 100644 --- a/src/docs/antora/modules/ROOT/pages/features/assertions.adoc +++ b/src/docs/antora/modules/ROOT/pages/features/assertions.adoc @@ -153,7 +153,7 @@ assertThat(table).column() [[oncolumnequality-uuid]] === With UUID -Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] +Since 1.1.0 [source,java] ---- @@ -172,7 +172,7 @@ assertThat(changes).change() [[oncolumnequality-character]] === With Character -Since xref:release-notes.adoc#v1-2-0-release-notes[1.2.0] +Since 1.2.0 [source,java] ---- @@ -219,7 +219,7 @@ assertThat(request).column("name").hasOnlyNotNullValues(); [[onrownullity]] == On the nullity of the values of a row -Since xref:release-notes.adoc#v1-2-0-release-notes[1.2.0] +Since 1.2.0 These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnRowNullity.html[AssertOnRowNullity] interface. @@ -260,7 +260,7 @@ assertThat(changes).change().column() [[oncolumnclass]] == On the class of column -Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] +Since 1.1.0 This assertion is described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnClass.html[AssertOnColumnClass] interface. @@ -279,7 +279,7 @@ assertThat(changes).change().column().isOfClass(Locale.class, true); [[oncolumncontent]] == On the content of column -Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] +Since 1.1.0 These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnContent.html[AssertOnColumnContent] interface. @@ -338,7 +338,7 @@ assertThat(changes).change().hasModifiedColumns(1, 2); assertThat(changes).change().hasModifiedColumns("name", "firstname"); ---- -Since version xref:release-notes.adoc#v1-1-0-release-notes[1.1.0], there are new assertions which allow to compare the number of modified columns between the start point and the end point. +Since version 1.1.0, there are new assertions which allow to compare the number of modified columns between the start point and the end point. [source,java] ---- @@ -365,7 +365,7 @@ This assertion allows to verify the number of changes. assertThat(changes).hasNumberOfChanges(4); ---- -Since version xref:release-notes.adoc#v1-1-0-release-notes[1.1.0], there are new assertions which allow to compare the number of changes between the start point and the end point. +Since version 1.1.0, there are new assertions which allow to compare the number of changes between the start point and the end point. [source,java] ---- @@ -394,7 +394,7 @@ assertThat(table).hasNumberOfColumns(6); assertThat(changes).change().hasNumberOfColumns(4); ---- -Since version xref:release-notes.adoc#v1-1-0-release-notes[1.1.0], there are new assertions which allow to compare the number of columns. +Since version 1.1.0, there are new assertions which allow to compare the number of columns. [source,java] ---- @@ -421,7 +421,7 @@ This assertion allows to verify the number of rows (rows from a table or from a assertThat(table).hasNumberOfRows(7); ---- -Since version xref:release-notes.adoc#v1-1-0-release-notes[1.1.0], there are new assertions which allow to compare the number of rows. +Since version 1.1.0, there are new assertions which allow to compare the number of rows. [source,java] ---- @@ -435,7 +435,7 @@ assertThat(changes).hasNumberOfRowsLessThan(6); assertThat(changes).hasNumberOfRowsLessThanOrEqualTo(6); ---- -Since version xref:release-notes.adoc#v1-2-0-release-notes[1.2.0], there is a new assertion which allow to verify if rows are empty (equivalent to `hasNumberOfRows(0)`). +Since version 1.2.0, there is a new assertion which allow to verify if rows are empty (equivalent to `hasNumberOfRows(0)`). [source,java] ---- @@ -539,7 +539,7 @@ assertThat(changes).change().column("size").valueAtEndPoint() [[onvaluecloseness]] == On the closeness of a value -Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] +Since 1.1.0 These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueCloseness.html[AssertOnValueCloseness] interface. @@ -654,7 +654,7 @@ assertThat(table).row().value().isEqualTo("1") [[onvaluequality-uuid]] === With UUID -Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] +Since 1.1.0 [source,java] ---- @@ -667,7 +667,7 @@ assertThat(table).column().value().isEqualTo(UUID.fromString("30B443AE-C0C9-4790 [[onvaluequality-character]] === With Character -Since xref:release-notes.adoc#v1-2-0-release-notes[1.2.0] +Since 1.2.0 [source,java] ---- @@ -773,7 +773,7 @@ assertThat(table).row().value().isNotEqualTo("5") [[onvaluenonquality-uuid]] === With UUID -Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] +Since 1.1.0 [source,java] ---- @@ -787,7 +787,7 @@ assertThat(table).column() [[onvaluenonquality-character]] === With Character -Since xref:release-notes.adoc#v1-2-0-release-notes[1.2.0] +Since 1.2.0 [source,java] ---- @@ -840,7 +840,7 @@ assertThat(changes).change().column().valueAtStartPoint() [[onvalueclass]] == On the class of a value -Since xref:release-notes.adoc#v1-1-0-release-notes[1.1.0] +Since 1.1.0 This assertion is described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueClass.html[AssertOnValueClass] interface. diff --git a/src/docs/antora/modules/ROOT/pages/release-notes.adoc b/src/docs/antora/modules/ROOT/pages/release-notes.adoc deleted file mode 100644 index 98f52afe..00000000 --- a/src/docs/antora/modules/ROOT/pages/release-notes.adoc +++ /dev/null @@ -1,239 +0,0 @@ -= Release Notes - -[[v3-0-2-release-notes]] -== AssertJ DB 3.0.2 - -Release date: 2026-02-21 - -[[v3-0-2-contributors]] -[.release-note-category]#icon:user[] Contributors# - -Thanks to https://github.com/fl0rian-p[@fl0rian-p] and https://github.com/jmaniquet[Jonathan Maniquet] for their contributions. - -[[v3.0.2-improvements]] -[.release-note-category]#icon:arrow-circle-up[] Improvements# - -- https://github.com/assertj/assertj-db/issues/329[issue #329:] Makes Core and DB assertions coexist with only one import by https://github.com/jmaniquet[Jonathan Maniquet] - -[[v3.0.2-fixed]] -[.release-note-category]#icon:wrench[] Fixed# - -- https://github.com/assertj/assertj-db/issues/328[issue #328:] Use Values#areEqual when looking for modified columns by https://github.com/fl0rian-p[@fl0rian-p] - -[[v3.0.2-chore]] -[.release-note-category]#icon:cog[] Chore# - -- https://github.com/assertj/assertj-db/issues/332[issue #332:] Replace Junit4 assertions by AssertJ ones by https://github.com/jmaniquet[Jonathan Maniquet] - -[[v3-0-1-release-notes]] -== AssertJ DB 3.0.1 - -Release date: 2025-12-21 - -[[v3-0-1-contributors]] -[.release-note-category]#icon:user[] Contributors# - -Thanks to https://github.com/fl0rian-p[@fl0rian-p] for his contribution. - -[[v3.0.1-fixed]] -[.release-note-category]#icon:wrench[] Fixed# - -- https://github.com/assertj/assertj-db/issues/325[issue #325] Support array comparison by https://github.com/fl0rian-p[@fl0rian-p] - -[[v3.0.1-chore]] -[.release-note-category]#icon:cog[] Chore# - -- Upgrade to AssertJ Parent POM 2.27.6 - -[[v3-0-0-release-notes]] -== AssertJ DB 3.0.0 - -Release date: 2024-11-20 - -[[v3.0.0-improvements]] -[.release-note-category]#icon:arrow-circle-up[] Improvements# - -- Fluent construction of AssertJ-DB connection to database -- Cacheable database schema metadata -- Fluent database element builder ( Table, Request, Changes ) - -[[v3.0.0-breaking-changes]] -[.release-note-category]#icon:exclamation-triangle[] Breaking changes# - -- Remove classes : Source, SourceWithLetterCase, DataSourceWithLetterCase -- Remove public constructor of classes : Table, Request, Changes - -[[v3.0.0-fixed]] -[.release-note-category]#icon:wrench[] Fixed# - -- https://github.com/assertj/assertj-db/issues/117[issue #117]: setStartPoint opens a lot of connections to the db - -[[v3.0.0-chore]] -[.release-note-category]#icon:cog[] Chore# - -- Upgrade GitHub actions -- Upgrade to AssertJ Core 3.21.0 - -[[v2-0-2-release-notes]] -== AssertJ DB 2.0.2 - -Release date: 2020-10-17 - -[[v2-0-2-contributors]] -[.release-note-category]#icon:user[] Contributors# - -Thanks to @soezen for his contribution. - -[[v2.0.2-fixed]] -[.release-note-category]#icon:wrench[] Fixed# - -- https://github.com/assertj/assertj-db/issues/107[issue #107]: Fix SoftAssertions on changes - -[[v2.0.2-chore]] -[.release-note-category]#icon:cog[] Chore# - -- Upgrade to AssertJ Core 3.17.2 -- Upgrade to AssertJ Parent POM 2.2.8 -- Upgrade to ByteBuddy 1.10.17 - -[[v2-0-1-release-notes]] -== AssertJ DB 2.0.1 - -Release date: 2020-10-07 - -[[v2-0-1-contributors]] -[.release-note-category]#icon:user[] Contributors# - -Thanks to Yosuke Nishikawa ( @sciencesakura ) for his contribution. - -[[v2.0.1-improvements]] -[.release-note-category]#icon:arrow-circle-up[] Improvements# - -- Implement isNotEqualTo, isBefore, isBeforeOrEqualTo, isAfter, isAfterOrEqualTo for JSR-310 types - -[[v2.0.1-fixed]] -[.release-note-category]#icon:wrench[] Fixed# - -- Fix isEqualTo for JSR-310 types - -[[v2-0-0-release-notes]] -== AssertJ DB 2.0.0 - -Release date: 2020-07-06 - -[[v2-0-0-contributors]] -[.release-note-category]#icon:user[] Contributors# - -Thanks to Yosuke Nishikawa ( @sciencesakura ), Pascal Schumacher and @sullis for their contributions. - -[[v2.0.0-improvements]] -[.release-note-category]#icon:arrow-circle-up[] Improvements# - -- Baseline upgrade to Java 8 -- Upgrade to AssertJ Core 3.16.1 -- Support JSR-310 types ( LocalDate, LocalTime, LocalDateTime ) -- Move from CGLIB to Bytebuddy for soft assertions - -[[v2.0.0-breaking-changes]] -[.release-note-category]#icon:exclamation-triangle[] Breaking changes# - -- Baseline upgrade to Java 8 -- Upgrade to AssertJ Core 3.16.1 - -[[v2.0.0-chore]] -[.release-note-category]#icon:cog[] Chore# - -- Replace Travis by GitHub actions -- Activate SonarCloud analysis - -[[v1-3-0-release-notes]] -== AssertJ DB 1.3.0 - -Release date: 2019-12-26 - -[[v1.3.0-improvements]] -[.release-note-category]#icon:arrow-circle-up[] Improvements# - -- https://github.com/assertj/assertj-db/issues/58[issue #58]: Implement SoftAssertions -- https://github.com/assertj/assertj-db/issues/57[issue #57]: Implement condition assertions -- https://github.com/assertj/assertj-db/issues/12[issue #12]: Implement assertions on table existence - -[[v1.3.0-fixed]] -[.release-note-category]#icon:wrench[] Fixed# - -- https://github.com/assertj/assertj-db/issues/62[issue #62]: Fix close-to when tolerance exceed 60 seconds - -[[v1-2-0-release-notes]] -== AssertJ DB 1.2.0 - -Release date: 2017-05-08 - -[[v1.2.0-improvements]] -[.release-note-category]#icon:arrow-circle-up[] Improvements# - -- https://github.com/assertj/assertj-db/issues/36[issue #36]: Add order on table (with ``Order``) -- https://github.com/assertj/assertj-db/issues/41[issue #41]: Add ``BDDAssertions`` so you can use ``then()`` instead of ``assertThat()`` (https://github.com/PascalSchumacher[Pascal Schumacher]) -- https://github.com/assertj/assertj-db/issues/43[issue #43]: Add ``isEqualTo(Character)`` and ``isNotEqualTo(Character)`` for values. Add ``hasValues(Character...)`` and ``containsValues(Character...)`` for columns. Add ``hasValues(Character)`` and ``hasValues(Character, Character)`` for columns of changes -- https://github.com/assertj/assertj-db/issues/45[issue #45]: Add support for testing that a row contains no Null values: ``hasOnlyNotNullValues()`` assertion method (https://github.com/fiery-phoenix[fiery-phoenix]) -- Add ``isEmpty()`` assertion method related to number of rows (https://github.com/fiery-phoenix[fiery-phoenix]) - -[[v1-2-0-fixed]] -[.release-note-category]#icon:wrench[] Fixed# - -- https://github.com/assertj/assertj-db/issues/39[issue #39]: Add start delimiter and end delimiter for table name and column name (used to generate the request) in ``Table`` -- https://github.com/assertj/assertj-db/issues/49[issue #49]: ``NullPointerException`` while asserting no changes -- https://github.com/assertj/assertj-db/issues/52[issue #52]: Fix about the outputs with column name and value with % - -[[v1-1-1-release-notes]] -== AssertJ DB 1.1.1 - -Release date: 2016-04-23 - -[[v1.1.1-fixed]] -[.release-note-category]#icon:wrench[] Fixed# - -- https://github.com/assertj/assertj-db/issues/37[issue #37]: assertj-db 1.1.0 does not work with java 7 - -[[v1-1-0-release-notes]] -== AssertJ DB 1.1.0 - -Release date: 2016-04-14 - -[[v1-1-0-improvements]] -[.release-note-category]#icon:arrow-circle-up[] Improvements# - -- Add ``from(Calendar)`` and ``now()`` methods to ``DateValue``, ``TimeValue`` and ``DateTimeValue`` -- https://github.com/assertj/assertj-db/issues/9[issue #9]: Provide a way to view the data of a ``Table``, of a ``Request`` or of ``Changes`` with ``Outputs`` -- https://github.com/assertj/assertj-db/issues/15[issue #15]: Add support for ``UUID`` type columns (Otoniel Isidoro) -- Add a ``isOfClass(Class)`` assertion method for value and column -- https://github.com/assertj/assertj-db/issues/18[issue #18]: Add ``isCloseTo(...)`` methods for ``Number``, ``DateValue``, ``TimeValue`` and ``DateTimeValue`` -- https://github.com/assertj/assertj-db/issues/19[issue #19]: Add support for BLOBs and CLOBs -- https://github.com/assertj/assertj-db/issues/22[issue #22]: Add ``isEqualTo(Object)`` for values. Add ``hasValues(Object...)`` for columns. Add ``hasValues(Object)`` and ``hasValues(Object, Object)`` for columns of changes -- https://github.com/assertj/assertj-db/issues/25[issue #25]: Add ``containsValues(...)`` methods for columns -- https://github.com/assertj/assertj-db/issues/29[issue #29]: Add ``hasNumberOfXXXGreaterThan(...)``, ``hasNumberOfXXXLessThan(...)``, ``hasNumberOfXXXGreaterThanOrEqualTo(...)`` and ``hasNumberOfXXXLessThanOrEqualTo(...)`` methods for the rows, columns, changes and modified columns -- https://github.com/assertj/assertj-db/issues/34[issue #34]: Enhance exception message when column does not exist - -[[v1.1.0-fixed]] -[.release-note-category]#icon:wrench[] Fixed# - -- https://github.com/assertj/assertj-db/issues/21[issue #21]: Add possibility to pass a reference containing a ``null`` value like parameter to ``isEqualTo()`` and ``isNotEqualTo()`` -- https://github.com/assertj/assertj-db/issues/23[issue #23]: Fix support of ``Number``s (bug when the mapping is a ``Double`` instance) -- https://github.com/assertj/assertj-db/issues/31[issue #31]: Fix detection of primary keys (caused by letter case) in some DBMS -- https://github.com/assertj/assertj-db/issues/32[issue #32]: Fix SQL requests for DBMS with letter case different from upper case in the name of the DB elements - -[[v1-0-1-release-notes]] -== AssertJ DB 1.0.1 - -Release date: 2015-08-09 - -[[v1.0.1-fixed]] -[.release-note-category]#icon:wrench[] Fixed# - -- https://github.com/assertj/assertj-db/issues/13[issue #13]: ``AbstractMethodError`` when creating a ``Table`` using a ``Datasource`` instead of a ``Source`` - -[[v1-0-0-release-notes]] -== AssertJ DB 1.0.0 - -Release date: 2015-07-12 - -First AssertJ DB release. From 10da3e5628ec1263dbabca550be26c9beef76ec3 Mon Sep 17 00:00:00 2001 From: Marc Philipp Date: Fri, 20 Nov 2026 10:42:56 +0100 Subject: [PATCH 10/13] Remove version-specific mentions from documentation The documentation is published per release, so "Since x.y.z" markers and notes about imports for versions before 3.0.2 are no longer needed. --- .../ROOT/pages/concepts/connection.adoc | 2 -- .../modules/ROOT/pages/concepts/datetime.adoc | 7 ++-- .../modules/ROOT/pages/concepts/elements.adoc | 2 +- .../ROOT/pages/concepts/letter-case.adoc | 2 -- .../ROOT/pages/concepts/navigation.adoc | 12 ------- .../modules/ROOT/pages/concepts/output.adoc | 2 -- .../modules/ROOT/pages/concepts/types.adoc | 4 +-- .../ROOT/pages/features/assertions.adoc | 32 +++---------------- .../antora/modules/ROOT/pages/quickstart.adoc | 12 +++---- .../example/db/TableAssertionExamples.java | 4 --- 10 files changed, 15 insertions(+), 64 deletions(-) diff --git a/src/docs/antora/modules/ROOT/pages/concepts/connection.adoc b/src/docs/antora/modules/ROOT/pages/concepts/connection.adoc index 3636602d..3ecaf3cb 100644 --- a/src/docs/antora/modules/ROOT/pages/concepts/connection.adoc +++ b/src/docs/antora/modules/ROOT/pages/concepts/connection.adoc @@ -48,8 +48,6 @@ For more information, see the xref:concepts/letter-case.adoc[paragraph on Letter [[assertdbconnectionmetadata]] == Schema retrieval mode -Since 3.0.0 - For many assertions, AssertJ-DB require to discover database schema metadata ( list of tables, columns, ... ). When the schema contains many tables this operation can slow down the tests executions. diff --git a/src/docs/antora/modules/ROOT/pages/concepts/datetime.adoc b/src/docs/antora/modules/ROOT/pages/concepts/datetime.adoc index c27b2842..ca61ce38 100644 --- a/src/docs/antora/modules/ROOT/pages/concepts/datetime.adoc +++ b/src/docs/antora/modules/ROOT/pages/concepts/datetime.adoc @@ -1,6 +1,6 @@ = DateValue, TimeValue and DateTimeValue -Since 2.0.0, AssertJ-DB baseline is Java 8. The preferred way to compare values with date, time and date/time is to use java.time.LocalDate, java.time.LocalTime, java.time.LocalDateTime directly. +AssertJ-DB baseline is Java 8. The preferred way to compare values with date, time and date/time is to use java.time.LocalDate, java.time.LocalTime, java.time.LocalDateTime directly. But for the backward compatibility, it's always possible to use AssertJ-DB DateValue utilities. @@ -30,7 +30,7 @@ DateTimeValue dateTimeValue2 = DateTimeValue.of(dateValue, timeValue1); ---- * `from` which receives the equivalent from `java.sql` package (`java.sql.Date`, `java.sql.Time` and `java.sql.Timestamp`) -or a `java.util.Calendar` [.small]#(since 1.1.0)# +or a `java.util.Calendar` [source,java] ---- @@ -43,7 +43,6 @@ TimeValue timeValue = TimeValue.from(time); Timestamp timestamp = Timestamp.valueOf("2007-12-23 09:01:06.000000003"); DateTimeValue dateTimeValue = DateTimeValue.from(timestamp); -// Since 1.1.0 Calendar calendar = Calendar.getInstance(); DateValue dateValueFromCal = DateValue.from(calendar); TimeValue timeValueFromCal = TimeValue.from(calendar); @@ -73,7 +72,7 @@ DateTimeValue dateTimeValue2 = DateTimeValue.parse("2007-12-23T09:01:06"); DateTimeValue dateTimeValue2 = DateTimeValue.parse("2007-12-23T09:01:06.000000003"); ---- -* `now` [.small]#(since 1.1.0)# which create an instance corresponding to the current moment. +* `now` which create an instance corresponding to the current moment. [source,java] ---- diff --git a/src/docs/antora/modules/ROOT/pages/concepts/elements.adoc b/src/docs/antora/modules/ROOT/pages/concepts/elements.adoc index a7ba6dc4..956b1315 100644 --- a/src/docs/antora/modules/ROOT/pages/concepts/elements.adoc +++ b/src/docs/antora/modules/ROOT/pages/concepts/elements.adoc @@ -83,7 +83,7 @@ Table table4 = connection.table("members").columnsToCheck(new String[] { "id", " |'Mullen' |==== -Since version 1.2.0, there are the possibility to indicate delimiters (start delimiter and end delimiter) and `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.Order.html[Order]`. +It is also possible to indicate delimiters (start delimiter and end delimiter) and `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.Order.html[Order]`. The delimiters are useful when the table name or column name is a reserved word or contains special characters (like space or '%'). `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.Order.html[Order]` allows to choose the order of the `Row`. diff --git a/src/docs/antora/modules/ROOT/pages/concepts/letter-case.adoc b/src/docs/antora/modules/ROOT/pages/concepts/letter-case.adoc index dac2fe67..c92e03a6 100644 --- a/src/docs/antora/modules/ROOT/pages/concepts/letter-case.adoc +++ b/src/docs/antora/modules/ROOT/pages/concepts/letter-case.adoc @@ -1,7 +1,5 @@ = Letter Case of the database -Since 1.1.0 - Databases have different letter cases for the name of the elements. For example, the name of the table can be upper case either the name is inputted in upper case or not. So this concept (and feature too) is here to manage these shades. diff --git a/src/docs/antora/modules/ROOT/pages/concepts/navigation.adoc b/src/docs/antora/modules/ROOT/pages/concepts/navigation.adoc index 7088c1a2..4be6bb15 100644 --- a/src/docs/antora/modules/ROOT/pages/concepts/navigation.adoc +++ b/src/docs/antora/modules/ROOT/pages/concepts/navigation.adoc @@ -11,12 +11,8 @@ The `assertThat(...)` static method of `Assertions` allows to create a root asse [source,java] ---- -// From v3.0.2 import static org.assertj.core.api.Assertions.assertThat; -// For versions <= 3.0.1 : -// import static org.assertj.db.api.Assertions.assertThat; - assertThat(table)... ---- @@ -24,12 +20,8 @@ or on a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/ [source,java] ---- -// From v3.0.2 import static org.assertj.core.api.Assertions.assertThat; -// For versions <= 3.0.1 : -// import static org.assertj.db.api.Assertions.assertThat; - assertThat(request)... ---- @@ -61,12 +53,8 @@ allows to create a root assertion on https://www.javadoc.io/doc/org.assertj/asse [source,java] ---- -// From v3.0.2 import static org.assertj.core.api.Assertions.assertThat; -// For versions <= 3.0.1 : -// import static org.assertj.db.api.Assertions.assertThat; - assertThat(changes)... ---- diff --git a/src/docs/antora/modules/ROOT/pages/concepts/output.adoc b/src/docs/antora/modules/ROOT/pages/concepts/output.adoc index 02df4ed7..793b8d28 100644 --- a/src/docs/antora/modules/ROOT/pages/concepts/output.adoc +++ b/src/docs/antora/modules/ROOT/pages/concepts/output.adoc @@ -1,7 +1,5 @@ = Output -Since 1.1.0 - It can be interesting to view the values on which an assertion is made (for example for debugging). The output allows that. This is a simple example : diff --git a/src/docs/antora/modules/ROOT/pages/concepts/types.adoc b/src/docs/antora/modules/ROOT/pages/concepts/types.adoc index 3f3baead..fc33e8a7 100644 --- a/src/docs/antora/modules/ROOT/pages/concepts/types.adoc +++ b/src/docs/antora/modules/ROOT/pages/concepts/types.adoc @@ -37,7 +37,7 @@ The type of the value depends of class of the object given by `java.sql` when th * `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#DATE[DATE]` for a `java.sql.Date` * `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#TIME[TIME]` for a `java.sql.Time` * `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#DATE_TIME[DATE_TIME]` for a `java.sql.Timestamp` -* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#UUID[UUID]` for a `java.util.UUID` [.small]#(since 1.1.0)# +* `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#UUID[UUID]` for a `java.util.UUID` * `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#NUMBER[NUMBER]` for a `java.lang.Byte`, `java.lang.Short`, `java.lang.Integer`, `java.lang.Long`, `java.lang.Double`, `java.lang.Float` or `java.math.BigDecimal` * `https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/ValueType.html#NOT_IDENTIFIED[NOT_IDENTIFIED]` for other cases (for example when the value is `null`) @@ -45,8 +45,6 @@ The type of the value depends of class of the object given by `java.sql` when th [[ordertype]] == Order Type -Since 1.2.0 - The order can be a ascending or descending. All the possible types of order are contained in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.Order.OrderType.html[Table.Order.OrderType] enumeration. diff --git a/src/docs/antora/modules/ROOT/pages/features/assertions.adoc b/src/docs/antora/modules/ROOT/pages/features/assertions.adoc index f6f6d2ea..23090773 100644 --- a/src/docs/antora/modules/ROOT/pages/features/assertions.adoc +++ b/src/docs/antora/modules/ROOT/pages/features/assertions.adoc @@ -153,8 +153,6 @@ assertThat(table).column() [[oncolumnequality-uuid]] === With UUID -Since 1.1.0 - [source,java] ---- // Verify that the values of the first column of the table @@ -172,8 +170,6 @@ assertThat(changes).change() [[oncolumnequality-character]] === With Character -Since 1.2.0 - [source,java] ---- // Verify that the values of the first column of the table @@ -219,8 +215,6 @@ assertThat(request).column("name").hasOnlyNotNullValues(); [[onrownullity]] == On the nullity of the values of a row -Since 1.2.0 - These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnRowNullity.html[AssertOnRowNullity] interface. These assertion allows to verify the nullity of the values of a row (the row of a table or of a request). @@ -260,8 +254,6 @@ assertThat(changes).change().column() [[oncolumnclass]] == On the class of column -Since 1.1.0 - This assertion is described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnClass.html[AssertOnColumnClass] interface. This assertion allows to verify the class of the values of a column (a column from a table, from a request or from a change). @@ -279,8 +271,6 @@ assertThat(changes).change().column().isOfClass(Locale.class, true); [[oncolumncontent]] == On the content of column -Since 1.1.0 - These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnColumnContent.html[AssertOnColumnContent] interface. These assertions allow to verify the content of a column (a column from a table or from a request). @@ -338,7 +328,7 @@ assertThat(changes).change().hasModifiedColumns(1, 2); assertThat(changes).change().hasModifiedColumns("name", "firstname"); ---- -Since version 1.1.0, there are new assertions which allow to compare the number of modified columns between the start point and the end point. +There are also assertions which allow to compare the number of modified columns between the start point and the end point. [source,java] ---- @@ -365,7 +355,7 @@ This assertion allows to verify the number of changes. assertThat(changes).hasNumberOfChanges(4); ---- -Since version 1.1.0, there are new assertions which allow to compare the number of changes between the start point and the end point. +There are also assertions which allow to compare the number of changes between the start point and the end point. [source,java] ---- @@ -394,7 +384,7 @@ assertThat(table).hasNumberOfColumns(6); assertThat(changes).change().hasNumberOfColumns(4); ---- -Since version 1.1.0, there are new assertions which allow to compare the number of columns. +There are also assertions which allow to compare the number of columns. [source,java] ---- @@ -421,7 +411,7 @@ This assertion allows to verify the number of rows (rows from a table or from a assertThat(table).hasNumberOfRows(7); ---- -Since version 1.1.0, there are new assertions which allow to compare the number of rows. +There are also assertions which allow to compare the number of rows. [source,java] ---- @@ -435,7 +425,7 @@ assertThat(changes).hasNumberOfRowsLessThan(6); assertThat(changes).hasNumberOfRowsLessThanOrEqualTo(6); ---- -Since version 1.2.0, there is a new assertion which allow to verify if rows are empty (equivalent to `hasNumberOfRows(0)`). +There is also an assertion which allows to verify if rows are empty (equivalent to `hasNumberOfRows(0)`). [source,java] ---- @@ -539,8 +529,6 @@ assertThat(changes).change().column("size").valueAtEndPoint() [[onvaluecloseness]] == On the closeness of a value -Since 1.1.0 - These assertions are described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueCloseness.html[AssertOnValueCloseness] interface. These assertions allow to verify if a value (the value of a table, of a request or of a change) is close to another. @@ -654,8 +642,6 @@ assertThat(table).row().value().isEqualTo("1") [[onvaluequality-uuid]] === With UUID -Since 1.1.0 - [source,java] ---- // Verify that the values are equal to UUID @@ -667,8 +653,6 @@ assertThat(table).column().value().isEqualTo(UUID.fromString("30B443AE-C0C9-4790 [[onvaluequality-character]] === With Character -Since 1.2.0 - [source,java] ---- // Verify that the values are equal to Character @@ -773,8 +757,6 @@ assertThat(table).row().value().isNotEqualTo("5") [[onvaluenonquality-uuid]] === With UUID -Since 1.1.0 - [source,java] ---- // Verify that the values are not equal to UUID @@ -787,8 +769,6 @@ assertThat(table).column() [[onvaluenonquality-character]] === With Character -Since 1.2.0 - [source,java] ---- // Verify that the values are not equal to Character @@ -840,8 +820,6 @@ assertThat(changes).change().column().valueAtStartPoint() [[onvalueclass]] == On the class of a value -Since 1.1.0 - This assertion is described in the https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/api/assertions/AssertOnValueClass.html[AssertOnValueClass] interface. This assertion allows to verify the class of a value (a value from a table, from a request or from changes). diff --git a/src/docs/antora/modules/ROOT/pages/quickstart.adoc b/src/docs/antora/modules/ROOT/pages/quickstart.adoc index ac84067c..00d6e1a8 100644 --- a/src/docs/antora/modules/ROOT/pages/quickstart.adoc +++ b/src/docs/antora/modules/ROOT/pages/quickstart.adoc @@ -43,12 +43,10 @@ Check this page to find the relevant https://search.maven.org/#artifactdetails|o == Statically import Assertions.assertThat -[NOTE] -==== -- From version 3.0.2 use org.assertj.**core**.api.Assertions.assertThat directly - - No more double import problem - see issue https://github.com/assertj/assertj-db/issues/329[329] -- For previous versions use org.assertj.**db**.api.Assertions.assertThat -==== +[source,java] +---- +import static org.assertj.core.api.Assertions.assertThat; +---- \... and use your preferred IDE code completion after assertThat. @@ -75,5 +73,5 @@ and after that to each value (each call of ``value()`` moves to the next value o (``row(1)`` moves the assertion to the row), from this row to the first value and after that to each value (``value()`` calls have similar behavior for rows and columns). -* xref:concepts/datetime.adoc[DateValue] : Since 2.0.0, AssertJ-DB baseline is Java 8. The preferred way to compare values with date, time and date/time is to use java.time.LocalDate, java.time.LocalTime, java.time.LocalDateTime. +* xref:concepts/datetime.adoc[DateValue] : AssertJ-DB baseline is Java 8. The preferred way to compare values with date, time and date/time is to use java.time.LocalDate, java.time.LocalTime, java.time.LocalDateTime. But for the backward compatibility, it's always possible to use AssertJ-DB DateValue utilities. diff --git a/src/test/java/example/db/TableAssertionExamples.java b/src/test/java/example/db/TableAssertionExamples.java index fda43cf8..c2aef91f 100644 --- a/src/test/java/example/db/TableAssertionExamples.java +++ b/src/test/java/example/db/TableAssertionExamples.java @@ -13,12 +13,8 @@ package example.db; // tag::user_guide[] -// From v3.0.2 import static org.assertj.core.api.Assertions.assertThat; -// For versions <= 3.0.1 : -// import static org.assertj.db.api.Assertions.assertThat; - import org.assertj.db.type.AssertDbConnection; import org.assertj.db.type.AssertDbConnectionFactory; import org.assertj.db.type.DateValue; From 555dac23648df43f74cc67e74235a3a558c0db9f Mon Sep 17 00:00:00 2001 From: Marc Philipp Date: Fri, 20 Nov 2026 10:44:10 +0100 Subject: [PATCH 11/13] Use version attribute in Maven Central link --- src/docs/antora/modules/ROOT/pages/quickstart.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/docs/antora/modules/ROOT/pages/quickstart.adoc b/src/docs/antora/modules/ROOT/pages/quickstart.adoc index 00d6e1a8..d414d844 100644 --- a/src/docs/antora/modules/ROOT/pages/quickstart.adoc +++ b/src/docs/antora/modules/ROOT/pages/quickstart.adoc @@ -39,7 +39,7 @@ testImplementation("org.assertj:assertj-db:{assertj-db-version}") === Other dependency management tool -Check this page to find the relevant https://search.maven.org/#artifactdetails|org.assertj|assertj-db|3.0.2|bundle[assertj db dependency declaration]. +Check this page to find the relevant https://search.maven.org/#artifactdetails|org.assertj|assertj-db|{assertj-db-version}|bundle[assertj db dependency declaration]. == Statically import Assertions.assertThat From 8c04d675ca86d83590fbb1b1093165a3494c9809 Mon Sep 17 00:00:00 2001 From: Marc Philipp Date: Fri, 20 Nov 2026 10:44:36 +0100 Subject: [PATCH 12/13] Remove obsolete Dia diagram sources --- .../diagramOfPartOnChangesWithAssertions.dia | Bin 15839 -> 0 bytes doc/changes/diagramOfPartOnChanges.dia | Bin 7049 -> 0 bytes .../diagramOfPartOnChangesWithNavigation.dia | Bin 12948 -> 0 bytes .../diagramOnNavigationWithChanges.dia | Bin 2111 -> 0 bytes .../diagramOnNavigationWithChanges_ToChange.dia | Bin 2476 -> 0 bytes ...diagramOnNavigationWithChanges_ToChanges.dia | Bin 2465 -> 0 bytes .../diagramOnNavigationWithChanges_ToColumn.dia | Bin 2424 -> 0 bytes .../diagramOnNavigationWithChanges_ToRow.dia | Bin 2434 -> 0 bytes .../diagramOnNavigationWithChanges_ToValue.dia | Bin 2278 -> 0 bytes ...NavigationWithChanges_ToValue_FromColumn.dia | Bin 2280 -> 0 bytes ...mOnNavigationWithChanges_ToValue_FromRow.dia | Bin 2278 -> 0 bytes ...ramOfPartOnOutputOnChangesWithNavigation.dia | Bin 16679 -> 0 bytes ...tOnOutputOnTableAndRequestWithNavigation.dia | Bin 14230 -> 0 bytes ...ramOfPartOnTableAndRequestWithAssertions.dia | Bin 15631 -> 0 bytes .../diagramOfPartOnTableAndRequest.dia | Bin 8925 -> 0 bytes ...ramOfPartOnTableAndRequestWithNavigation.dia | Bin 11143 -> 0 bytes .../diagramOnNavigationWithTableOrRequest.dia | Bin 1928 -> 0 bytes ...mOnNavigationWithTableOrRequest_ToColumn.dia | Bin 2224 -> 0 bytes ...gramOnNavigationWithTableOrRequest_ToRow.dia | Bin 2239 -> 0 bytes ...amOnNavigationWithTableOrRequest_ToValue.dia | Bin 2219 -> 0 bytes ...gationWithTableOrRequest_ToValue_FromRow.dia | Bin 2090 -> 0 bytes doc/type/diagramOfTypeClasses.dia | Bin 9135 -> 0 bytes 22 files changed, 0 insertions(+), 0 deletions(-) delete mode 100644 doc/changes/assertions/diagramOfPartOnChangesWithAssertions.dia delete mode 100644 doc/changes/diagramOfPartOnChanges.dia delete mode 100644 doc/changes/navigation/diagramOfPartOnChangesWithNavigation.dia delete mode 100644 doc/changes/navigation/diagramOnNavigationWithChanges.dia delete mode 100644 doc/changes/navigation/diagramOnNavigationWithChanges_ToChange.dia delete mode 100644 doc/changes/navigation/diagramOnNavigationWithChanges_ToChanges.dia delete mode 100644 doc/changes/navigation/diagramOnNavigationWithChanges_ToColumn.dia delete mode 100644 doc/changes/navigation/diagramOnNavigationWithChanges_ToRow.dia delete mode 100644 doc/changes/navigation/diagramOnNavigationWithChanges_ToValue.dia delete mode 100644 doc/changes/navigation/diagramOnNavigationWithChanges_ToValue_FromColumn.dia delete mode 100644 doc/changes/navigation/diagramOnNavigationWithChanges_ToValue_FromRow.dia delete mode 100644 doc/output/diagramOfPartOnOutputOnChangesWithNavigation.dia delete mode 100644 doc/output/diagramOfPartOnOutputOnTableAndRequestWithNavigation.dia delete mode 100644 doc/table_and_request/assertions/diagramOfPartOnTableAndRequestWithAssertions.dia delete mode 100644 doc/table_and_request/diagramOfPartOnTableAndRequest.dia delete mode 100644 doc/table_and_request/navigation/diagramOfPartOnTableAndRequestWithNavigation.dia delete mode 100644 doc/table_and_request/navigation/diagramOnNavigationWithTableOrRequest.dia delete mode 100644 doc/table_and_request/navigation/diagramOnNavigationWithTableOrRequest_ToColumn.dia delete mode 100644 doc/table_and_request/navigation/diagramOnNavigationWithTableOrRequest_ToRow.dia delete mode 100644 doc/table_and_request/navigation/diagramOnNavigationWithTableOrRequest_ToValue.dia delete mode 100644 doc/table_and_request/navigation/diagramOnNavigationWithTableOrRequest_ToValue_FromRow.dia delete mode 100644 doc/type/diagramOfTypeClasses.dia diff --git a/doc/changes/assertions/diagramOfPartOnChangesWithAssertions.dia b/doc/changes/assertions/diagramOfPartOnChangesWithAssertions.dia deleted file mode 100644 index 964aa7818abf8ae3c95bd6734267754a7444cd58..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 15839 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 diff --git a/doc/changes/navigation/diagramOfPartOnChangesWithNavigation.dia b/doc/changes/navigation/diagramOfPartOnChangesWithNavigation.dia deleted file mode 100644 index 5b7d2531886bc02873ae5493e7a95d88d44fd13c..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 12948 zcmaKy1yo$kmbL@ICAho0L!)WjT^kMV?ykW#1PBhn3GOZd8n@umcyM=u58uq4JOAAK z&ELINt*76vQ`LReIaTl8XOqPsy!-0~jeOz{aUmK`Ice_>5$z87(P0QTlk;WH-j{M< z=0l^MFsDe3OfPD_)w^V7;jAjR$#Bhc2n{HbQnVx~B=lMc2MnZKgFT5@N{1HB5+_PQU(mzIvuT1Z)> zHydxt3wB(9tv>p+mi1HqmwoqhR!>JKLjG9>xz!c(9>3i(CMLV$i-ogZZ)qR-Uu#~{ z(1>!?FPG2?Alo)Mu>mYER)>LEwwF_A!+wvZXJpg;;7sOj;o~%HKczpfOqq>yy+q>< zfp?IE%jWXxhJekT`pYh>yri9Hs{q0DlZT7i^eX6{sGY1wBYH~`p6QyBv{_Hjx$1W7 z?$h1pwoGPLvgvylUGPpMafg{`^$Ufeec+DqoDy`jzu*5Z}MQZnP2 zkL~Hqsn)Yhm!w^aRjHosO0@MmBT%+C2cE;*w+>5}zd>xmrqTw)ZQ06IqsCT!`5WqW zdDA@qzOGV7h$iaTVNvBQl`98{zw+);!Yf~{^2_>bHXRtS_THflWPHW2-^xQ!@l&e{6KF*n z(D5afo#YcbIIXxV$=W55Uumy?mAdrmXw1+4^D{0OpR(2W*;Mz>a_~zwib%_NuEj*t zbl>>)`N-?AaJlfO=l$HP6^YvT@_x>AI%}_%7~&?6&4@F9PCco|rzrtS$OpNv(YhEu zeqL#GG5tGN!pw3XS7VD~nyS>g!|_=@Hc7bNaQA3-l6%Yvvu?>0_kg)rQtI1~izX-^s0-u#xONNg<@FWd6NoFPnUEF-zTSxY8~aHnfnHRbZx(nJ-Hbb@GmrdJHZ=T2t{kUVf*2DI%z}>sZgY6C6fc~I7yvz zXO%cT39vh7Um4}6B$`{Rtn1Qjw&vHv2i3Z>y_XI2`ma)U7LpFk?mtc%aQb!_3I|pn z3Eix2Gw(5)$Hw*INuBMOWbF#m#;xwmSK8n@f5OElyQOx$Lkqa3sjWLInKZQ1LI;`G zTDWu0OJ*zRIKZ!@qTUrI-W4(VIESXC330|TQ z!+Y`n4kEPhne=M%xWlIxty2bG(#D=773f|kShqFfVk>RU^8Mo!FzNox0Hg^TrHUhK zZ9yv|n_<`Gi1+%F}p-&ZLUR_REzu;yoL+9vM? z*l`uWjfH72Gs?k(e0HLBc2zSN5~lN#5bnA&AF5;oJzcUjtt@eU>fC<9fC{sD4fu)j zY==z}$LdRP$GFn=W=wJ*g3uQzTLfUPNK5od@*Gj2&t7mBD>+^-Dk)5mNflwDX3J9P zC4v3X)lxw*UeAx%2{R`N1ZNRKr%7mMNu@bsr(f^Q_%q^?M)Q4dF(uX}mW0WY?(a;C z*O4EeC!ZaKf8u(txqRQcN7cKX+ceobxU&7RWM4<`hj6D4$`0=M{isg8?p>C8*jM#q z;VF-F{j54^$vtsKj2LoMA;N*FXYLaESmyQ!?a2ob&Fl%IRKmw;{CQ%K-pFJ-dmh3; zY2X!X9(LLSd&*jMwSlzaBB;)LvFuWfv`X(%z{2YR${UKK zIc$Pt- dR<5Yk8JmN(lHoPoCu!8uvE$VG+9gxW+liWy%Wfk;z(ZWH%OX8)=8<#@ zuy`Te-zm4gtT=f&W9>90HYPTf_T%_ry?j=QEx}m?&w5;%s46?YAy=)>ac1L1L7f+S z2&EocJ5*>vx1bX?>n1@zCt6vE`Qu0AVPS^KNyTRF6X+5j@e@`Dt(W3?#s*K1ZO8&l z^*@DuLY=FY&AJ=xGV|{MQTvc(m`3l6KJ!iWW9Mne_xmC}&okeBc9iU9Vu6K%o&D5+ zh{=T2b})J`x({1#1{sG9IYJQm_etFQrbbQ?ZIe)QTaPs&y0KOM^sF zkl8}T?OS8yMcv+37X1!Nz9Pctq{l z9dM#2lrh=&YPz~{%&LFmf>-s>f(+s~>(#7iS1DRzqEg6&LK6!Z%|G2Y0drukth;A!j(1Q@SP^=v(5je#Mg2 zgugbTVf}hjLvrZ)fU1`#A{r6`1B-}+iA_x}qw?iDx#<5E;5~+jk_?jj8)lYhsckEx z^l`adPUN)fzwRIXgjJ!GP+y-LH94uSm(x-BGb#L|Zn4De!An@&93_QAV?c%A{{w;w z&RrpV!exB9qFHFpK=A!V|9w`v!h0oOl|9>nPjma?t1IUlkc{FkG|8M?vVOm*k63RT zjk!)Buet*fJv!Mqi5~rR-Y+)Q{ZU9UHCL}GVQ=R>GdMGPTkq*%jtjPQC8Zc*$}B zM?|UUyMuSd)K*i61y&)!+38>!1XVRmGYgVU$XfTdn90?*j8wB$)t6nybbkwoG6e;g z52A|P!|vcE8>$3|{@*}Sd^s8t1%ri1i>a`!%9Xf+G1vPIYB z-$rH_UJJDvgDY6U%otnVj-N{F^0`T@)u$;KT6Om%q3#%Isz<_ORH99*Q)fI=wwoA} zm0Dk><%<)EdvBu}W5w5;#e4+WSW~tPgtLtFjfedd!!XgY`kPe8qEbse$@`SXmGE=q z11;}1&95A9zbR&BeuPbUK5HyAJ!HBxW@KZylKOk}1CM!AB|TAc^uWp8TtAN%hQGB~ zqo3ku;>V~JrYXFM?eIUyTWpctL+NC$r?sw#nj(+j_IybobEtl{i>Hc zHGBhiqEc#@GHFgfcQruNfF}N=iQO-xr-<*`)Wxz&^)h0G-fD{sz_c^7w4*M$SR5it ziZJuY9vfIU+|fH`Sl>Efkd=!?^oJ+e3>hxfwu~$iMJarw8$x(ts>)Qza&=SHd*<`_!PN`4< zgTq?K+}~bD5cPu-)75J;a(>#pDnTzr4IeC|C#sJdCeV~|j>-sl6_iQ0M201uWqB^u zqpc4kJ0FdbZky3)ofRldc5GBKErsmKQqmanxlRF=%Y^e>IA2#V1(`e~Zz-7=ENGLGQVE&%ZX}RMbdx)ebT9h14 zi5)ica7omRRFH4rD0^N)ftNB1Q0fjIg-JzZ#nPv3QE*D%;OsFE`KK`Uuv2@vgMDab zWF}%Mh7?r$9)M*>yQqMYn)>)rx%&oS0`%NR7NUhi^%}z@ooU$NfTfwh=lUg~%c3tq z%H_4iq}=OED5uo2MSGqmwqGh_L5HUkHh8_z+bV!_dg%z|FKQI>6DAlD8ViONK>4hra>=TM1=lvon9;iCi36Qo^h17qs~H*lO-@8QjM`_q-z zr!T16qe02Ef%)7g_YfY+uD8v{z?F%l?o*6&t9-WsZh#-i(;QpOH+`_KQ(vU7GUbZ< z3*QuF;47bj5-F`|0u@GQN6=hV(h7gqEz87%+*yDZh?lP&8PvHFRt`Mv)f{Vg!Z~7{ z<)1b{Cwi3el+MDXZOLESgwMiA&AxDm1e~TR3)9D%fdRKz$ zww13+_j2O!(4@o^&^#B_ognp8^*qJ=jh%LJBSe0SSyOe=;-brKS0010^zx4c{^Tbk zFhW`W?bg|@9Fui-vh?Z)uU9z%cF{kyQT^=;!T$Pety(+t-OArQg(vBnlXU*5FQw~$ z33EpTtAvT-z-i)Z82<|_T9@`_RMq?hitRurYIo70kfV_Qx^t|-)A@DvL57Q|lz_dr zQG=Dyde>kng=yCSl?|UNdb&nBt#+WRoD?0>@2<6)V5f8tw3r`@7-of?uNo;uLHIYY zuk|KQstAeSv^v}n6u=e02`1HY5eO!&PdUl9hrM)ip-L&z6@;741}%(vjSJIq1!Bw$ zcQ<>|*3*R~HLiP_BDfL^%a~$ijfEKi1X^^lvN8~4>jOrWcvcg=(A%Mr3$#s$n#9Un z;+mw8+FCnR7nTTHJFDwP zI};y!GCZN@wK98Psb&dDy%VT$m_Q2nUC>A8&{QFaMe)QHu5S~_N6m`KY9cP#5?H#B zovzWCbvKW1oMG19;O@?g9ox59wuukDaCpmDEDYN{eMGC0^lj0SklTaX^xTdo>Ip-x zqMp)Pt|>4;lsDg}>v={VL|KqjT`^@UWI1aQ%^Ig{uz%Eg7u)fNTGfM7?@wM^R_r&~ zM+c*;skRgq=_?z$6WO%Vl+f}@&nr@aWP~N$aemY}y3^OLDk>ql7u|BhT1;6#;h$vSReTFG7cs>qipaoP{* zd}dpJ2hC?7HOpbxY)o*?moI0wMj;qs7_d9*6!fneo;Sz8t^{m8W=4Id&}m-yaAS7{ z34?B?&0ul{Z<{%z%iDD_m}{gig-0%-*Ag~m(9iIt{dx)hE#!BSyJGf1lVw?TaONci zS=LRjv{(X>0d%;wD;LHnqZrlDlSIS#?&=rDX$5-vUV&C3c6iO=tl=YV&S{43*5|Fh zdQ%@0Ow9f3@8kzsqWMTYEl^))fH2g>EYb3k+*qF#3W`mNA!~`#Ow!S1dBxzCbC8_d zN`ZY_OKer13=3Xy0I}H*&R`Arn@(>QhItbZIJW3hY;R@T@FV1DX9yfttd+@lrL`rtfLol7s4EOn>(i2j zbBN?#OQM-pI|>iM7>*-gmn$tg^-^tP59OzH5)H+w%3-M2O}O!Yh6wceFiKv*F-k5yfK79E38e4I8|cjS!C4<<}4b*Y;I4Gjr*F_dpm!(}Vo`A}L7gxt|MJkbX9@DysHG8mMSk=XwN z{ROxTTKcM@B+wi<+fg)B2&V9+@FR=}7!(qIo_#dFe}JrkI`O-s-Jy(uj=$+3$|0gK z&RfGM`MDMg_+t2CzwStzyP7q)Y4ym6SP?as51iV*M?n%NeDiIUmwLiqcKlX_*d}V)N)Q~cJ8xApWxIsgY1Tl z-HBK#kHzI6FHerS1#$`nm3Kr0)!8VS!Tr^lLuqdqiizZC<@9i8U{cn| z<*OuV9F-o3xG&seBF83x*`jBv-Nj;O#APBJPXQ~Z^Lr%LZscS%Q@lxfgU)^yz?7|TRs>)YibRZmLT_0hg5pwTeklLmjnqQ!B)Spu6E+wb z8V`mQK_C4uVZVC1p?jpu9LI{{mzY&u2tX2F)T%K=i|MV|{0gCg?xgrd1Pz^ob%L4) zQOjK7{}6m*I~VdDsgXcvIE79s1s_RP`+TgvvtN3JDF5y9FAhhrIn>EOzq_jGY!B#E+}!35F;s&V<*lX7_$En z9w6Q6xsY^!m_N}@n)Bb0E02)$UyiFsn?JTAq%_DvaL`M6%1>P7P;bj;9d&Oe(=l4(8b7gx7%G z0;_ITuG=*!V^6C~5-AS=tLk%lMKaNpl48-J*oX|%93?U#n3f6<;IXC}wM8WN$OrDk zJdzg`c9WJnJH+2|#Lm$g_`SsG(aOjS^*0KwO9;wJTjr5ljDy(y^k%w5>GQacbT;O? z0-tgpKBnV}7l$bzr{i)~7ECmJB7{qCF-UBooVTQ&G)N4k=2TzN%};pHZtX?iO>@aF z+~QF@0j4{nn^#lX{>~ABzc_a;(S_(TOznajN!3~6HIRScs<9O6N{>G>2p_1gxnxxJ zKMwC<`K6%bBz&A>MA@wRK{bM4Zkx_XS*{ieDW?-!QkF zP=GuUrOCbfjp|H}zs+T*MNNF?i5<`6OZJGB#%w)ad+UUaG@DxAPI-hv?b$$hyz;W~A<~EUHN|t-EZmxSVH%D@P2@fElwd*b19p_TcU;?6`0`#r=^CIms5{bp2 z>iI%xn#Rz_vCDr26@L4HX8ya0o$oh_WfqB-ItGpIvGeMwOz$K8&nDnjEOM`+72jZ# z3gxa&@*0*a;}tm0TwD}!FT^qy%dzcyxt9OQHf1@EVI@a(D&%k|rn+2ftF$ZsA^MQ1 ztorXjsk8nhfUjda+F{&;bF`26GVw zVhi!5JK}qRVcmz{13&HplizOhCJivVy?*PD6s<^sVu5}8Fv(#YnguMD)(imZX!Ekw zG*GUpiiOXRy_cAm5fW7`IV;t(hPPmGGOBVEzSNo}M1R1;G18V+v=Cp_Aa|3Z)4O!! z7B5-RRd%vHEsJb+h5=SK*R{q)b_t=PPC%w_EZZT*|GF z&7J&*)Muyw10igJv(!X%xlut3>1fnW`pAx%Lx+ z{{Bwo9sRrH=%BB^S>Oe7)@#fSNq{b1QAgW`VF?>KlWiKI2H1+RZF| zwPQFf8(|9FfMG@TOX^HAHYIOJx!%?YfgJ|l#RcEx@S4PSH6e?ACvAM0%xSH`L${KG zKTiwT>avWIP96*Y5U)yE2vD6QI@%UM``mR@3xSRlLiZ-W6xj|QdY=eSi6%k%-$LFX zv=4L8==;=#0|)lxb=3grdlGEYpYJ!I&VM$kUMv0d_^SzxKt#hLr4_oC{Rxf$B0ADE zY*mJ7#j_9F?`v+vMtKj!-AOcFS{5aa? zH6xB-#+VP<=4DzW7yLVnwB>eDTn;F6JrVio11p$f}AS>=Lu|7r%rIX}Reaz>~9-?60Ue^9wzL0{6*A#9^NBdNc`(b!rj)x6JQttRXhaH|WDD|>%Ci}J+`|K^b1 zmO>Si=I^+lSQl&{gw2HqqWO{j5jywYxca#lJo)}Vg*Apt@7$N!^@H)HWh6+q$U*S5 zp5s1!72rE`0+JBp`NqXN(syV<@PLH;ReC@i>1pv4DP2ddBk+F5lL8d}15KT*7`Qzi zgz*!>2!?>0)5`4E(D&xzuK&ELhw*2~iiH&dhw`Clf-pr8Ijzm6hYAyA7cyP~6p9gx zfeQX<4__qTOTD8C!uadJL{X~GReU$&U9nZgDjX(jeH{_rj;|ffC|1E(?Cj6R4}I4W z2WbB_Xxht2vG6R-xfvyg?YFdN|GJLH(Q4#v%c03HxfH_U0pU95Em!pshImV@gfYC{ zB7qZaPncrov6SjZepF=9)-v;7DkyZs>%ybZu_$Q86hhMwI512o!4e2sh!vP>4dM{i zIBryH!fEb8Ynd5#0uxTKS>!N!5(TZeLUKjc-Qs*Ke3>%LRcDLB(M4^coYsLH zkA!5Fm#=<490UfoWYbRO#9A;Z>n~F9N*r!1p_@vGPXZabx`|7!mf$EQTZhKxnul*L z9qz=WXBw%LlGRv%udL}SYb-G&PQ3>MXpXyf$Z5R1BjbOiY!>~ymMiZfynS97vVm)R zo{^Qm0iLzBal^w;7Tij@kIVhwXKn4hE7!UUgBI-xGNSzct&2_LoIiFq_hh)WK?h5k z7pm6=ts`3IGldZ`K9{rWJe6cE|EwCgcTM#sSpB2w#otAA^8JvjSZ?|FYC*LvOUYt* zhdX`sbn5`wA=3l+tw1lqthv@f#sksU0!A*)EmN2!D{jWR%~ie*5409QR2-U_X+i2h zJ97|#HXz{Xy2}0jVWDoB=U2G$0(16yLUAhZ0qc3h!i0m=UDClF*~Hn5PMg>H%-H>s z$-RGu8N=Km6|gAbDoU9S*pQCBc1k2vICFM)@U-c`8PLv_IH%J~b{81dKP0}C*lh|=@2;s7-D zeXdg?JJ3G;B;0}{_M_QCVD+5R@M|C1&e24w*?wOw>&a`{pT;9Af&05?HXoheZyv16 zx_tmIL}gG?+gg3<`o5}R0L|8?cs0mYtZ`QSEPXh|(l*nlOZi*D)yFKz4VVp_VX)xm z?U@c+u8QEP*h)3eXE3UP)u@^}#4%n*ZGCxA!BSMK|0;E zB#%=4DqY#_;q0F>QXR{FCy;7Nryc#5yCT7L*Pb<2jgb5s0EB=?8Vyzr5k#rgU5pTT zb!#Gz9>-D&(wRnJh(0+<;`2CcM5-y&q?JFt?Y1KV>zJ%9cDbV@8v?KDO{=ECI6$pG z+MA|f34a3tcT9fbde!GVwJV6cEkV5yrX;*)-zOo5PG2sUvMo>vtN|C7AMrYN={MS&kuZujmnzp8G27Sm8) zHizFoUuL?bTLj>h9`?~I*YBv*e4NT?mb8_RotOH+O6@#7k|wE(X5NdK-RiP7_X}g3 zb3IGNqE+xy3v0YdROO(NO&Dwa4Mn}q(BYy5&3W;ZkPCR=)8gH`MK>%LcajdkHOqx= z!$eizCnbm3jSy>-Fei=~+XU*%rBob;p-2p6eAkso1I$5AQ|VHZSB0?f%Nef{kKI%lOne{_Lg{- zb3!lwWqyF5O2MNoMC_Us1A zz-=WUt|uvC2g(&J!xTP^t_X{40Jo!hXUmLY9RGuYv3>Wjm_mQz8*X<|!uJs_$!;m5 zYlb`9ihhO>7Acq1fP~PgO5a0ZIb7DHnJKUP&}>yYQ&oNOhb$}W?Vx)*UH$-Y|3UBD zUwbGoCbFl#vhxpJVH9(>Be5q`ESw2C{2XDk5Tdkgay8ySSJ;$2e9f9hp>^@e%_r~d z1C9nNTiQ)}sWJ@LS@IRum%|gdy0J9*UKWi#-CoO!GEZ7N;qI%OtClBO8 zNo77r+xQZed9uCa?z}{p4qDZ>kqvnmLvbaI;spf$tdv_X(I&p={$t*$_xwPRn znMDOFPq2sqem}9EJPN2$LHuW^y05m#K)n_@r0J}5V8tVsKj;Bp(!E0KK+KMeVHQuL zdCg=flxzz?9zjl7_kCh-cA!kCbT_^CG%~M^J(@>hwG>VR@8BRFrcCdQ%`DHw z+8<~Y8Qa(f%zD#lDn zY{g=oXTuPqO(REL*j6m*7ftt|3XS1kuEDBRTkp%2jc`B&HEQ0NEg3{zl-iY6@Y=8y zq{0=^@5AQmOhk^xJ&dDR4bXxPNp$vdFmBA`px#2kA21rck~Hs9f|B0PQfL*TT|Wu zN{V!Ovi2EZ9XiEX^?K#<^_Y#BqJxW60bWRwp%l#lEWmR%7n=Ci!Y@Rf(1N)qnQ`Ug zIJl2D!K*y|T6~3F(y0&20KNDdz2dGa{}=>GF}jgp8cL5CgtKVmv%}t!4mA`uZVuY4 z`2%&6wZ$7_w@7*=5?CZn{-+v8IDCh6f4Tg#ZvS zO_uJw!xxa;=VxdGSm^+kv%F=tgGROYwQ|u3+O2x%-Nf>eS$X;4Mdv@xyN;J563Yza zjkwt#3h$Ul0n7&7_^U7A&JqP?BgI)bEZT}aE@_2yiX^aZC7ck%#tBSrfc+CwKIepi zp<4UTc_ey{y}AZ-Q1xJZb)(!*2x?3_ctLs7Y8g}`muu8`GvA1Ou&|itLoWUS2TQAy zDnYO(5wj0@Gg58Mp3n71`hr=;%40;psb$X4LaO(&D}5(r^vH*a!b!gqL0morYCwS3 z-RFnB`)v=-BV(&ay_7LWso#Z-)i+ZkQ$~jeh5IsC|K)y|aZ{^5*v2Pc3Ag*Wueef! z4C!Kq=eQ3x^K*o5JQa`NSu=7SucpN3My+2~%s)x-24H`RKa&zPdazjswPQ`zGn;3O zIe0o><3P>-RWW&_dIUIxTlmN&I$yKo&WF%4<_AiEq^FA&$t@!G3>iUv)753$P zd1-tu%m*o#oWC(ip5;WxTRgS;rsy=$>{14e6tw+&Ah_Gxkwpkcr)U%Xjh)|+ISM| z`euatD>ABqulK%gI?VQgL6JBUKtTKy<6a}TmdL_tv4C}JoF5j>xh%F^ZhK@4IMha zir1TXtY9I6b(_`?YkM}@+Q^ofO#_Y^jqfxftxR}Gj`_;>4WCQtdcYgo+!AC55sP_O z`q86w&VHg~AJ4}9u^|n9mg~J}+P4u&#TXin9?f$GfRa7(9u==g0Dii&D*lxn%~VtI zNg1N^&ef{d@zv@VlJ|A%F7VFfRAKtyZ*5@@wYQcO^77ogHck}O7is7qF^i}?zmw5R z7025jIU{Yp^0{QLI3T(C;UX>7q_A-`j2lyjOlYpvghRFiy4T2c+87{>ndL!T;LO6X z{kKdJ6*y6ynDe>Wq()B|eu8Z?M;5vy2kN3220B-6S>muP6c^5+VRE|9Z%~)!QumRj zW$^K!{(=c&bCjJ8+fyR^{I#8y{{E$3eRbEza$&*7{U*uq?EanS?)-Y>KgwJ6-^yFf z7ynV-DhgHGm6>&;UzAm=`lt6#r+)0r(_mq3dx`FhPZl@hE;cKNOZa-d^W$dfnqQWZ zps$6?=!Xl^sWsvoZrlgrHUIeb;bYeHH*34Z*UH>x$tJpelJ$JWksc^)!Ob9dD&_hL zL96MPiV`C8@#&3M24XN&5JHQ*BY%hfPKF@piN7;v<&Pvl1cn?M9V(I=I*}~N8u}en z(7U%TmESmoC;y5t5uIT8po#fOiH9$~ea4@3T&$~(Clpj(=ltIP>eJUd=rox!M=&C| z7C0Q>c`A@FUJ5+T@EIpNx_EvONH@UaXMw5foIon6f1vIqVg_@dnh=7yBdyVA$cuYC z0jR)~uk5fUNMP(p26T1u;-7asuqIo5;D{(REHYZ4f*(BR1zg^G`Q{I*nJh%Qf5V8H>1ZoUaWABYjJ;jj>D(YJPLjQu(lB zqPLbk>3bwR^*k(u)DF!-2hFyiN3Ka48iCK#?>^M(_3)W&FQ>jGIRtx)Oy7%x6Prod z;!QmV@|Ko>rqT`Nw#3U37dD3ZdNWRs+1<}P3aFbA>$=Zh)*||1ICwk&Jcj`PH666^ zDg2@nUpOL@M%?#AAAAy)*%#62besy0+1UQ@0;`3aR3eWkcLchHYArvN*s&Ojp`v5VTQ4Hx99sjn}i%$L{4+S3+5}wF$-L zQRH#&SeajkB{=PEI?>C<@-vd#X*vKFjtqVuM7k`-r9+7k%X76A)nZtQX>wAIn$2Kn zEc+pcg>}Y&p{4x;P9frfg@}_f%|hVHKJx(x17>@3-YoSJ^m`-rDPPnUIB#kjqe%d< zrs{}a+W6J#0r1F<*|3vt_NAYm{RJL!#scp$=M0|$o3Eyx&jPMqp)!QogF{bX-~9)4 C-+!p`^lk%1^(~g5oZ1j`n%rAgh96Qxt%9n?Y4P^`M%Cm#J9lu zyXC7p(lVOKfmX@hei^Brb}alw=cUBhWP!tqecIe)Kb;RJs5PlAzkpMzQ5+6j;uOYR z!R(A^#K~-v_-nLhk`{GlEJh)98b-#52btO&-0|f13A&wxpp>lVL?c4MnXEm2Ss6&W zQcBS~_T#;mlC%4XFXb78qG;B9(*3pLn)g#m3Xc_PgRg4dwGOlhXa$fZPRHaTpB=jy z0dtbLh;DN|iBUbXJ!@O%QspH*s*xUAymmf!1N&`lY94p<=O#b&m1jte*V+RaP^<`+ z;d`Eb*iy>;aK;jo2|j2Gn$BzQ<7$yEV^7=cs7FXB<{AW|FV3cs8=l6f~T9 zTFxf`XaoC^7GXvqw!+Uo4xq&*n@%i33uS}vr0_yr=E1< z8gf*5ni?E=)Gw-l(AM#2v{cU!NssGVK}K3J9aDnk#|$cnC6&WM7`nVXb92H9N>Cq$ z$9j{42n~1DGUGtq>$|Ap&~n#>FRD=fK(XG8D?5Es$)n1)LuNdCAoX5v=@__-NWA^k z$)mh&Bk#8A_QYlAR?8;J`PAE%EOB#S|64JVuD^?&dF@0+UbNTtbD!J#!+TW!<^Idc5#EHzo>EH-JhPf$tx59bc_xRI2C9O!|I zy+#VK^E96e^o)bBDKpBATG(!&gC{lQrWMfp#msn3^)HR%l}#JIB3qjRTmRnUV+;I1 z7HIdg?vI?s$EF$>$Gk=?D>VQz`y+2Dj4>{_3=eZ|ZVug=Rq>9@Dgjjgd)8lT14>}bqNg^k@TyECVPfRjyddPf&lRELdggW_*Tks+-g58=ZN|pR(t4a#n>xV zTMz|$RFj_I)AW7eRii{UU@S2m7Qmq9EHVDqjl{7;%-U?<5`I-J@ zF3P*_jt*E7B=a!-P3O*(SyjZwSO5wI?cZ#u=PIO;Wl71j=1Fn&$5@tY0UDzd@dTM- zt$QZIF2JWG{=HMlt&3}%pQ0{u*K#d~H!r=Ar2vkOaT@j4;lJ~VEEcSBw3BTOb7S14 zusr(MM$ta$DXrH#uPXLe%&9JZ_Ke@k%&AnYbU?Tjco{zv4|4H-b?l7X@B2kGnjRYC z^=X5j`^@4^Vwx8BQ@>^Sn$A*}vLkr`n@{p1Ahofh#>-9fOWxLs91{+FEOzXEzL10~ zKifH|p@vI7ARnSe=$gdf&x?iB3_t^Nh&_(cmbG19hj`g~f@PG2x$3ELJ$Go_4;O;>U(JBut9l1yleBn@2@}fm86!$$(q6#{GzKYoT~?0f^x1H4W9AZKX}rM` z&KlBRYe($YvDyUHIi?&+DN8CzLU!w0OHdcZE|3n)?pab>aFRCo0$0vXvXo+k%Tg&b zknh#no23prhfl6!uWbV_h(wG3UI=R_(W;2|QXU+qfI{Zw^DzvLQooG{9ZY>%YoxsU ziE^J>71VeNbP>BykHmu_5?Tr;P=^KqgNfx+y+_yU?-u)$htAy$@cO`E@=U`$K-_Rr z!_b>;N|Tmp_@LY^u2}`ObOAz(B6t*qjqs2jqJnI|@6DOup0|qmhs!>mmM)R<%mR39S8aauR zFhd{$Qq_6c@7e#@A6pwpB?L$Shg4H@BUP)DTzv42IlkxGTz>rN+s4gZNuTY@>-If>^$L9IcaN`@?wr^74ZGeawcFY0u1m9DQ7-uhBSfW?X3JLfc!m;6iG zHSNfMPi%6lSQrJXr;nelkJ%~Z9~|4NI?-B?WW%DB7nE^?Z~V*=2BL;x2xkzNy1HXI z_~4WFaI^cu`S*p3?hEI|(`^_f5%ZEVBu!)oU(czk7;6>Vx-TIXitYhFLMYwDQnqqE66 zh49&)M|ty~qsaT;e$6~_<-c)GIvSfN-t*zziCeyR>ZM971S9EY4cp-drl5VP4iLL@rCf|bvY zC=$dV6T=oX?~n&MQ$$h?=&ci4uM+&#>S_+erO1XOnLa~uyD7C-l-fErH0~kn7 zi6<|k8`xRMR0x>91{%}8ti=z;DhxR#+d6bA@tc)ct(+v-jIw0lt z*-RWOuF`XWOA~M_U+uQrh{y5t^^3T7s8EF0OnSdJsKZRwf2R&e_v=$W;(Eh*iP*Mj zcZ!i~YZSH=SL$@WW+e`NWl&4+)_(4#sR)hv)aSvf%%I1Z#!3!!q;B&$K1mc>exz zvFGYs#CT(|`9 z2U{FtS8?%8hjd?XrvtZvD{Z&&s&>G`=$NY=p{Acwdpgq5Zg+*T}?r zH}#H{)w_!fmpl+;(>~R^K(SI3b7B%ignD<7Yxb($RXf&HyBEgt`_S>BzuN?$<3Y!R zjt3nNIv#X9=y=fapyNTugN_Fs4?4aF9dFz~$J;_-V-pdxUm;K26vm=b$r}%tAcyuW zSNH-l9%MYoc#!cR<3YxQj0YJHG9F|+$as+PAme+G@usSb zw=lBuh4LO%yg)J2wQ)ix#6Y%V$n|*ItBhCfSrZkHF~ZLK*i8Qi^LJePx`g$35b_}8 zLCAxU2O$qa9)vsyc@Xj-2A9z=aVqMoRV zdYbM;cRO!*ZzSnyy2D<8m=kOvLen~Tz1}LX+O1~$>nSbluYU((KC5>ZgN6qU4;mgc zJZN~(@Sx#A!-Iwg4G$U~G(2c{1r7fT-|}F=gZchM$m3kd+p0od3TyKLW90U!uKtt)_$unBS#kC8XoL6`Gs0KhvRqn!gspDIk8<5M&Yi{OE8ZucfAFduOWDU5SJ1$UJ#3mF7X7< z+#wUA46%sV%alb?_;MqqIuC=_I z#bX8Lckagg#xN>mngr>BszijZlZk{()6qm9FzHu1u7b=RLFP@3F3SNT=S-DHivrmL z*#p_9gl#G$b?{q-`O4*xa|-D>t0PdXG^v9#vX>Q=C~}5O_LYvSFtd?vw=ugoE95gw z(F_P52p^VhZrkWOV)S+WHHyK4f=*@T*8$SJ;w&zwD0kUAUGAL0x%MQP0VILzj_$wt_1#sU*YD}A_)zM%M z=r{-1L%1auE8mkVX_-2`7gdxnW}4$Cc`1g0Z`-W)TfH4crqQ6tLPN8@_ilc_6F~P0 za=`z<|1C-~sBGua@5cZ1Hrw_U_J}kV04AbzBH`?JvS+;>g`N~8-(-Ctp2|24_P0e|NHFg z90dIv`ps_N>UodPY35&s!*ZJ^b~?{F-_^ZaSNHE646jz($&&gF&Hlc*f6xFh3EXAB z&mdC&2EI*s9ubk#e(UoX$jD%fEc0&{qTONE<~jFTW!W9v*o+|aW=3v5CMSz diff --git a/doc/changes/navigation/diagramOnNavigationWithChanges_ToChanges.dia b/doc/changes/navigation/diagramOnNavigationWithChanges_ToChanges.dia deleted file mode 100644 index 16af90cfba7c9c820e242bdf37c2f7f8dc025bc3..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2465 zcmV;S310ReiwFP!000023+-Lqj-xmhzVD|%>Dy`t1LkKkRioZsjpkxUEvuVbIN8SW{-^2m<>du=$B4#3 zh&=azA~yXm^*lP|M$^gD2SvFoU`1mpj%7z_9Ea}W5HrQ6JN7tP(B+?-FgWLP-qCR5`b8Y>8!vT)hHOpKxHE`jJE~<^ z_~euJaEoE#ykX(OVd30pz7N7Uq;6biI&vkP3%^+Bxw6z#o`(v?&l+1x#Okg(_dR{D!g8$f*rZ6tj>8qU~0peU2g)#=IFzWAVpy$NaboNV?Z#XX@-8ZdH zK5}i1Lf8CBoiDevz@e`UYN*}H&%89}p)s3#%-<9l^c>Szau_k)Z1NHKU2jNIg_=G< zML1875HQl-1@o};X z{2r(WUhu3#T{$6XNax9;-oE@CM{Qt{vVONc0^ zvJ<-f3jZ7Po>}ZJ>8HO1-b(UjbiJJ7)yVPD+n`@O6SWbgitH=8GVaq1heOUig2Tb) z+gL3wzH5{23+}SvHgKis1};^4u+;R9nX%d?3ncx37pE0@_CI^tanrI zSX#Y1NOQ;oL8jfOdgmxcf}+oKf(Tdd7IO4nwYzM^nrio4TYeupKJX4ZA9OtEc+l~n z<3Y!Rjt3nNIv#X9=y=fapyNTu_n_moJLq_mD{QPIqW3H0iIcz>wovlg1189_dlvGN zHEW{e2_mYIYtHXM$^SEW0T~Z69%MYoc#!cR<3YxQj0YJHG9F|+$as+PJ;-=nR>m6` z8QDO2k1C#{=*iePv1dd>rlpDTc)M2_FI}@HDjs8mt@kmR{@>I)Fy-qS#^XWAgOCRy z4?-S8Q2QtCHtWP&yv3b15&{0GIMua?*Rf zmY1$v6EW}b+E|xk^7cE^^)NaQq8>y&h^X=&!v-RDvd>+wOXX#&)ogyfZRh6KzXLI!?spe~h6fD~8Xhz} zXn4@@py5HogN6qU4;mgcJZN|c4gYtxXa0)$%j1QR$C;2fWre&D*7^g+$mvtba}>iC zC}M;6nTCauw>$6kzGE?+)V!l%<#OfKtwLeEohKe@?Y9y$f>hGR?9wMy+wfo8wXR*j zJMLmf!~DZ8dr%A4aQ+S7_)V3#CVGg2FgW!22xhV6p|{}jH3aVu;#MNY^&|e!#V+TW z0WvYt5UY^B%xM?~FLzR^%fRnZ^vZeki3!dU2NrfusUmqt{p?Q~_i?egp z{JEs~>XWMrx)bYL(tD)n$TW3Zj!7ErlEQ%!6phSu6{$`#Crh=*OZ-)?E4L)g?Tp-d zuEZK8OOT`d2p%8vAuDR9iWKfb?a)9uG@Cy{oZ|lbOf$KYRz1oKBuQEg0P+X6tUqq{G z$iNc&*ffjpIhSe4>uYR%rW?q?g6y?1$MZwXXe+&u}7v(kjklwNBAn43CJWJP1F&SeyQV1$lT&&-qh%}93Z04lzF)* zkUfw+kbOefxxnIBf?=V2&oxKG1#-nVnX&Z@d-llaXwisvF1>Yq2cO`yA0prkCp@=KXTN zl_qUet%Vt>>mIP&_zSQ;WOsn@%Sc<5n3O+Uc1L<0uE9f4M=UGqIhils3#Dg+xSaF} zvJHW1qcLam%YApl&_d?zd79iiw(wG8Lx}~{O}M`yzu!7Iao(vjbdj-EVdg+Hdb`fHMv@6o$)<%0A)Ta;cA2%+0^dV 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 A1^@s6 diff --git a/doc/changes/navigation/diagramOnNavigationWithChanges_ToValue.dia b/doc/changes/navigation/diagramOnNavigationWithChanges_ToValue.dia deleted file mode 100644 index 23681dbb64295698cf50497ca21eea2de330d293..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2278 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 Aj{pDw diff --git a/doc/changes/navigation/diagramOnNavigationWithChanges_ToValue_FromColumn.dia b/doc/changes/navigation/diagramOnNavigationWithChanges_ToValue_FromColumn.dia deleted file mode 100644 index ca6c9e561bbe79bb8d3ac918ad3a34053e130b42..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2280 zcmVDy`t8_dsSszyCMTJ6QGT3T(-ZR8|Q z!VZDRkgCqjJkPwxyx7`=R6>9Ra7ayRPo!#f$iW{z*q_gLY|M{8eP4yfGZ#q^M~?%H z%z?q9X*>&}#pB@HfBx~w8~pV2;m29Pevp3)!B&PmBTCe_$H6j9*FOx0FE1}B+$JoI z1qy==O8D>(7KUsnjfR7#4~B7Ez>K9#9m|ihG!?;QlX4?sEB-i`u<7p$5pSZ|U}u%v zP2(^Y#xn~a2OsCzXE4l*85YVpQ}&uI_(X8_dwtQS{P=#CqSsuU7Q0%PSp-WE>W7A{D}>sX|M1!);_62~ED(GE2g8{Qo!nX*tev2)eZsKq=;)A+*m z&smr>sle{=Yj11Ya~C3*o$t5>i<(kif?2v8fA7g%yVAEkmHr$g!6f8WS06;_)r#L< zr})#mld<>Vbj{YVE3I~Tn0cIX+J1OgY=Rk2E;O^EO-)J5+-!Ks>!)^29kV-hGFWF2 zA=`417yns^;IBUg|FjNSG%)geoRf~hrfKlJ|90e-c=BI9P4oJG``53=C*w=Vl4Nj* zL1Y9H%pM0{&7!kTt0zm6JXrG9I(}_Z#6*-n_{eqXsT0Z+QU@`aoFWKW0TwMnen3$m zgpP`pM#N;7gji<4Q%8|k~tCqoJq*AWlo=_Y_h*tSa9xRq=Jpe&!NId$G zZeS-NQz2mb8X3&^vXnQBS4K{4aFUb@9;>!nhxR#1xJYF)*2a?Ebj72z4oJIvHj(Gb zUU~{}ZUAoOtIc{Xc#@1?e@J?Vie-4sl=pjs+K*)YS89)RyE^49t~Z<)!PZTyQ;b|& zqp-Q`spILAl{oa3L2a{J`MHOis&HWpFcB_N zw23vqim_FV_%=JrtH(taX8bw8C@@@d^LJ}^fu^6ed1z7X(I20uI%eH!`mSjy5Q|#i*4*8 zF1~7$?hEd?;Wluk;}<_p$4VZ8!{K>-c?gDv7Y3e{RM{!-D-zh3pA_>NJF(tPy<=_l z?jz#U2Z|i8PxUTQ>!b3z)oQlB-t!9U>)(Nx-|csofQAPR4;mgcJZN~( z@Sx#A!-Iwg4G$U~G(2c{4GsSbU-M|jqv`fY$m3kdJGw$%32W;CW90X#Q*6RJG?c^ z>XVZTx)STV+Iyr}$Z;%Bk4YNsk|KdJ6hcRqiA+CRlVy7MOZ;`NtG1-g?d-zyVD-Dd z*xjFq1MUaz2kt*`{|SFPZMdHl&$VvF{ob{>zxVf4NgOP39AsG|NnUO?v*reA+vz^l3ak&T53FCy`nV12<2Pb`|32PLD1%c|(W9BAc}x}i%YW`V z(NpQTiVTh%=9*ibPX=YFB_9YM2){(Z^0qF52)Mo@*PCs){vN>N(a7cB zj_vUk*xvHp8|-+V6F$a>s&u}MJgh(+^UgWH%6rv=LsP5EIscsaVJa7xADCaC`H4nO z$E=+J?wR??ee98GQDjQ0k`ca1M+!1aM^p2TNx#x@6=d#8GH+^hUJg(-X6n3L6v!UP z9>_i;Y)d1lgWoF5*WM60r;whrIugask~(-t_G(Wh54rbD_LYvSFmsUUv@tt7D&!+f z(F_P52p^_xuan$qwNTS~qlKE-z5?sxY|W(GbBK@C%0k~7I-ZJ!E!T(Z2mwv`_D3(^Shwu6h>BmAo$z{cL%;b;rD4?YGLL zjY(RV(M!Vv)|-C;)`#p45PlVDn;MJqZM9NK?C>WBi7Ue(t=U*uMMLK@G`%KJT6Ebs)}>eZ-!F1yk)m zHkiWNK&am}!-F+4JoskJul+2pdhH+~z0cxG80?b#Rfi6i?C+|~KDlG|ul8JposCSl zh25px{vP-LHn|TY0E_^)nAs&7BS8CQJiG59+j8;rVfRJ;Ed*OVefS?^)cE1It^feY CCyO}% diff --git a/doc/changes/navigation/diagramOnNavigationWithChanges_ToValue_FromRow.dia b/doc/changes/navigation/diagramOnNavigationWithChanges_ToValue_FromRow.dia deleted file mode 100644 index 23681dbb64295698cf50497ca21eea2de330d293..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2278 zcmVed_@ECRq)+EN65{7yer!VHnI~xwM~@?n z%#p#PdAtas)#K>bfBxl*H~Qu2)6a{5{UrWY3ELRrj3|}g9!Kje+x|2jzr4JlaG$a) zPEZ)^P|C;uW?{(2!e~5t`eYby3s|s>$z$bFmSssW+hyE{*oHrjW^DfZDv5W|VpLd_ zcJnxl6XThMkE74a{4*Mt#f&TEoGE+DR(zIl_IrELrug{&kfOIdIW2axjnhDwWczK+ zq@^7B?;D%aDiuc2>gn@W`*U$g<$+^aO&8hp}VX_pEVhhKYJ-=4clg2nlcTd`;<*)_o?kY;(YbyOYNP}6(o31{Hva1!p zzfSR|cPD4>(Xp|$?K-1hQWpO;NrM0WC*fbVA&W*vd5=rdG1xo{o)6#NxFw$bi_f#NzQ6wcZ^jqnTgcLM zbc{hn1QIMBN8in=vrelgN)kL+^VT+gZBoQUls@>#b?K=S>J-ujF`JztB%%T=T7~?G zB0&h95J%9wOCK;nCK-syL%x~L<0Ps_3fHV!4wI8gy?O^iaS$O&<*#|LT4(J51j!-s z&4&yFI|-R80n_)$V8*w#xM938a_WPVW<24sY`bk}U(=K)nP|q!SfZP5c$BpPDVNV? z;#|>7PXW#iz`cC6+inw{rqkCSQteQ&2(Ov+zBZ`CNT$D12c+B8scdoDa9$F&?OL5` zTo5RX4y)+e}F`tG!TGbi!7}L0F7#UlwsuB2AZ%AH+3uAzZ zaFwD>tN>Pxty;vlIq=RbgD|{|P|Y0lL&*4#Om7{cScu7Rx{T}0FOL~Zwh6-h<7g8{ zak^!55ox8_UWQ#FYATBO7VnaPC&Ta$qr&@L!8Q)}n>g97gZcYi#9W4?^1qiaA!UNf z4(Q%1{9k$a%(Gz5zWgZ;7m7Dy=;hR}Mvaf&2mMW-xEN8I$UC7c`#R0=cF2`3cstl? z8@q^$uiB(_!M$y`9bD=7)sHih1d|qE3gQ4+-foCIBcE)u@0*CU`YF?ud>%-JL zR#xvmB0hbf$nkWlcY$K(DAvTHhzj-YBHz-g-Bl~rRl8T(^2gBeak$$=pyNTugN_Fs z4>}%nJm`4P@u1^D$AgXs9S=HQgN`Rx(D9B?*w{kU(ktYtpTpRmRPy8jQ{;M@g}h?T zx+r;ysA*T4^G8tf|A=2e#)FIp84ofZWIV`tkntenLB@lO2N@4C9%Q@*8E>h|cpD?T zoG90*;suJ8&y7=WLJ4wQBIn~htukJ@W?fV~#t6F~V=?`2EZlM9`x55kLCAxU2O$qa z9)vsyc@Xj-y&h%oqFJrJ&(K!-Iwg4G$U~ zG(2c{(D0z)LBoTF2MrGzUO~hEnQwWt;L&{lM#$q*$UCY+UJ7gL0b}IrRPqAF_9Tkj z;C(`{RPx^7z1}xGW1|c2XjlY7c@3*jlC7t?hkE<1!Hgo4_Az_wleTU6PwjfwE*1lK zeW2mdZc}#D+BF=1!)Jao6|RZxvN(x%I=f&QTkf<4m#-nXK8SOPm>^0;r^^DtGdIY@ zC_^j~_A+Hj62DwYsm|jl61*enzUKYIFUFchi!yl1;ye{<9DjWrxwYoqa4s&-HLK^+ z`m0Y)F6c_E?<((+Vj;(|JT)fiv`dNr%25cNSSB+4d`*_=-7oRCxvtrgcDJ)D&x5t^ z{$dY*A`ZA8xF5Lx$o(h$?eyV(Qa#tY7597B;(qP#sS-F?;5f*#CW5@&d}hrf^!~a3 z#C45^ZbvJpGTGR=d$%)usufrtSRYuwmGyBS*2nL}`u=^qn@|L&rldzRPxF{E_80%$ zb)u)yaSa(9G0b(hI-d;6Q%gP&J`jG5g2ioJ1rc!lK(06YaQ#VUh}??nvGR*(ErM*U zu#Zi*_+D@s$zNaNSrf}fK9*!p?m511@>`=7?PhdY0f?|(m?(|Q!1loQ!1hhixucNF zza87-E3m!gyEoYJyd->#5tZqD8+llQI_8~oev|i_2Zyd!mvjCl@xxRuFh4NAI`b2S zoQ~N#1FV_($$jjRX;EYfsuB^tNhcCAPe)Vpj!D1KaSded3Nr6%bY2cnIcBQ7TolM2 z$R5Z(Cu~b0se|7u%vatJxug)ySsj65=Sdx0kiFbf$wTfvlYOJ(8q6GII(^K}jtb=n zQ#Av^2f~MG+v_BEdM(tn-f5vGwy(hYIA1gAY7X(STv_N_lX6FV>zlHcho`0wyCfv|906O<>zqaj@35N&-eld`{Z?>Y#&jX+ZWOP zJwKDx;=Be!f=s`c;iZWG75e`+G&^$1ZTNH?bW=Z245Hi+t+?EathG&^Z{om4UB8P>7QJ!Z95U zH4g+G$^P7VFc82%aK|YiM`0jvdJhD}_mJ&*^7N_rBK}qh+dO^xAIJz)oz1QQ0G6YL Aj{pDw diff --git a/doc/output/diagramOfPartOnOutputOnChangesWithNavigation.dia b/doc/output/diagramOfPartOnOutputOnChangesWithNavigation.dia deleted file mode 100644 index 531c39540a55c7d6b151be605362875293f5a7e9..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 16679 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 diff --git a/doc/output/diagramOfPartOnOutputOnTableAndRequestWithNavigation.dia b/doc/output/diagramOfPartOnOutputOnTableAndRequestWithNavigation.dia deleted file mode 100644 index 2bf557813a04f7c8fb59afbe9751e68c4adfc65f..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 14230 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 diff --git a/doc/table_and_request/assertions/diagramOfPartOnTableAndRequestWithAssertions.dia b/doc/table_and_request/assertions/diagramOfPartOnTableAndRequestWithAssertions.dia deleted file mode 100644 index 450e1b9e2f57ebb18ce4085c0a1395ff07bf5862..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 15631 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 diff --git a/doc/table_and_request/diagramOfPartOnTableAndRequest.dia b/doc/table_and_request/diagramOfPartOnTableAndRequest.dia deleted file mode 100644 index cea1ccffeac653bdc5170c66082db3f954c75756..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 8925 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 diff --git a/doc/table_and_request/navigation/diagramOfPartOnTableAndRequestWithNavigation.dia b/doc/table_and_request/navigation/diagramOfPartOnTableAndRequestWithNavigation.dia deleted file mode 100644 index 10fce8dd2f1828e967881c6dcd1df43bac353526..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 11143 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

LB;QCeYB56Y@Pqbr3T9;o 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 OboVbRP?fhph5!Homeb_` diff --git a/doc/table_and_request/navigation/diagramOnNavigationWithTableOrRequest_ToColumn.dia b/doc/table_and_request/navigation/diagramOnNavigationWithTableOrRequest_ToColumn.dia deleted file mode 100644 index 422f32e7a90c2231f830bc7e7e42455d95dda037..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2224 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 yF7?dc%`;D%%i0OGehWul@(in$@KaqyPYliE|DB diff --git a/doc/table_and_request/navigation/diagramOnNavigationWithTableOrRequest_ToRow.dia b/doc/table_and_request/navigation/diagramOnNavigationWithTableOrRequest_ToRow.dia deleted file mode 100644 index ac801fbdfd186466c893676b895e8a9a07920f58..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2239 zcmV;w2tfBAiwFP!000023+-LqlG-*DzRy#5$So0;|DDZlCQYZ)i*_=TNqWl&5a7nx zR2IA8rq9#&=!;dd&F&fuHWp$7JLGSLBVLUHjLO7A1m7fyMSu|R4Y9wSqZ+jy${x)OjDw*^OtI}?q#wj!I zNqpOTJ1$1;-$z+AifP^1M+rY!@$1tRzkPLb z_I^5Cu{9K>?d={W0d=W+eD^S0MH8AeG_$JBo|5LJ*`Uem+jeaoQ+%}5S?3TjSyNUP z|ADdS-+vf=vy4g7Gsa6YRiIM~l?s#jNJ~pWUd5+r;k?p(NPS~Z8eGsG3HUbkBAjvGI8x%LpQ7rey zG7l(d z?}8?LACPkSWF(Fix9>K1w^wdvyYS89WFzB-jH zP8-exBg?kcsfM&iqmZe%Q-|X@+2PhlW_8SN<(FO>ikO)WW17r%ne{2y@zpRmna!%9 z`AIKGUWJCfLG*N0x;C)_ST*R{qsq;WS7sW;aWg_SrEnYqr{B5WIwYx3nelL%?lQmp z%$Slz6t8c4i!@2IB^iqlEaPh#kBM-qDB@$fVi9HC@Hf4}%bme8jn|8mE$7kr#?e=w=lwC-$h=aQPoQjM}pWlmX932@1xMxDd<&e)ke>I$g(Q!*u4fl z|1phMiv%=0Xn4@@py5HogN6qU4;mgcJZN~(@Sx#A!)ws+)(JGc8}_j!^tE0Q?>Z92 z4Wx?4j@!o$3IfeKUae+rguIJf)2X!PYY_6E(+5!TpyENrgNg?g4=Ns1Jg9h3@u1>C z#e<3m6|X_X+o~$w7GgRdv(_o%C5Rk}7aHF25XQdS_cd#H)q1s@TaSJJDhA;HAn}SC zpQbPt4=Ns1Jg9h3@u1>C#e<3m6%Q&NR6MA7Q1LodyrZn*Z4~CCoKD_5r{Sti8Jt>edOJh`GH}F}LoWOE<*r zA=ADQ^yE1L(&@Ty>5oL)Tb|o*=pjF7AZ;9OSpjDQX9H)q=4^ZnXX6**Y+rdnt1p;S zVPa~#^{l>NEdhc}_r`XS?eqiWn-|R2bzZBnDz?~eZ+0*aFDCa^txitq<^f87S-Mw} zy1@6q_d9&Q#o7Kbd~a8eb(p_~lTeFF$!eqerJ{%6c@DKNkDLd+j3Gru5V)72g7;}CiBNis4{y^)ZvU^o+5 zmzw#vG1(*bcVT9`FO{nM)>Zaph)F0({*uQa>u2zLnLn&c)Z*JOyDp@}XRs zcN^PKwxH=ij)Tfzy@U-eo3v}Zcfhc5$aF*8N+Z+2+`!!b+ejNLFt>j;=EfJXzl7zX z(C<4aED|iC)Ax{j$@!H!uho!nm}gDen;nkX^F+SFGdUo&0$dMVUzZa%6~<4`7o}U5 zu?kU;y?k!2h&*$;7nu2!yvyeMI?wG-lOJJcH&DJAs;MdgHF*n`OJ1OSM(=pSjcD7c5IKaTw8|fW^nb>9dj#eBF}9Tf48;M9H+M= z_d~~BY@80v52LBa&3<{YkX?CMsU09ckn0^C&E)TGLRUMu5ukxBL49OhaH6K(bq5SR zWVhn>wst>8fDe5D^a0nIwozH1dcJX45h1!0 zD;E(#C0f4N37L&a{f(iI+!o3Ic2=Mupa*~+K;O(x@2uko#rv47DZ6`Byb(V$MizIk N{sSeMv#uJX006-IY?A;0 diff --git a/doc/table_and_request/navigation/diagramOnNavigationWithTableOrRequest_ToValue.dia b/doc/table_and_request/navigation/diagramOnNavigationWithTableOrRequest_ToValue.dia deleted file mode 100644 index 70836852bd67a47b19ecf8cbcf5b48b719319c7c..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2219 zcmV;c2vqkUiwFP!000023+-LqlA|^jzMrR{JhvVh0pcf4cWQQ0sazyARa42{x@23n z*(CM-PjmxWYO!HLskD6AM~Mv_;kJ_A%6Vn>pC)?7*E3_ei&e6 z4h$C0l6e>}9|nK^@yiE)@YCbFALk+cLHsN^T^r(vIF+9s2CFRF{4g3lKR=^rm(ncZ zC$^bK5`v043O=SV<((a$T^7V^caDQ3eb2Nu{{b2 zaukbeF#942R#)A}741tZ7xoZw|sz*@0zxysIi zSxEMeuQsb2*irmciJm^k1~vYmqMaI_x%l@B`}dZmS#3yl4Q84#&Jx+E&mn(IQ^qsV zzLl}W{kvvyb`D6nd^#1!ire=Xps8oR%2(UXhO;!C9KJ}kLnR{arqcV`p!Qvy{z~nU z`m0mf;b_@yaa1C~8NjrWCG2$k^9RZyn-9sLW`x zNKTnw?lTs29Y(u{!8(bPbVFw%1WU7>jK@ScRTS|l+47L_Zut9N;qA^~lSI39!Z)jM z_I4*Rld-D&xBV1SDyVFa?jPWPWziGM!WsSWk0hEaUW~4%b9y#veDpTxukMM~=+Z>~ z5nVaAX@>nFS8l=nV5@Dc6&K&MN$Y}p-Ec2(r5jW?w__z=g2Pd>@O%k|MlBuBTFCE= z>52sQ<)_tzN1@`o$$G3R>n)6MFeJ$JHL7|E;z$sCYh8_xRoq}GqR+s2`7g<)N z9g}ZC&womy?K%bx4;mgcJZN~(@Sx#A!-Iwg4G$U~G(2c{(C`{GymbQ&Pl6$~gud1* z;)x?sh%Z$``?(ThjDpO^q}ZL(SxD~MGuM|6g?<d0Ng&Jjav-?|o`pbp1t4Z#rF3xMPw2@~w8I}(QRL!nF^F;K_r#%Uax9hrPG^^j4 z3b=HeB|O=-+(+HD$00u4Y6}n#VYEJormRXBr{b>3LctY1WK)zO=A1rHDCf!Zjjs4C ziDN+=lCn>{zyHQq(Rf}4Kv|Nn0cyN_`!H}%T6fK{xIEUX9&4X2gnD#BH)3x0R?Mw? z<zTB)a4lgG6R;_MM>1G3^ zzb)M>NnPN3;QJH4KjLif8osxy$CAGI-oF9gn?bRhfUTGD&0^JpobyH08VoVHd(y9Q zT`iy6SK2l959MT#?h8Nw^8@n(^S@$#OM&^FH)8%knfV0?n?!f0j|1e&H_6C2bu1x? zU^o+5_ne)n_1syr)*Oy}*$%eUUho6ynR_N}apjg_41C=&Qokyjew5X*`r>PB-h!|l z`BE;;tBvg`ThO#G$3bPVUc&nKP1-fyYcOmbGTjrm(#SM0H!$~i8);(&=JtAHZhRN( zOIR)nyrF}FBEb?kLl=>I&ac#Yt%ihyJZo~fS#!*uC-N2E$pNVq;CkTtx}3PFFn-!! zly2R}Q;34><$H5QPcLAcRO_{8yi?_xWmm+>!T^`_(Q zHKVgwXeWFXh$h01=~K9*@(xH0DzUaOklHmdj}@lS;NIBZxmjXf_aqv@|3QHxdH_2> zmMtIH@hWt8w|V*2=`njl7un4dBYoug(lHksYMx319RYL%-*=whRhUuZ_SO+7KdS18 zXx#OP?o7WU%Evhj@yA52Jtb(-N7fzp0`;D&vGWkYSJ<^pqTl0wx6|mM2Y?=+kLH6{A{{Sq_D1kGc000n;WeWfR diff --git a/doc/table_and_request/navigation/diagramOnNavigationWithTableOrRequest_ToValue_FromRow.dia b/doc/table_and_request/navigation/diagramOnNavigationWithTableOrRequest_ToValue_FromRow.dia deleted file mode 100644 index 3fdd2c7a175459b33534076e62616529ca005f73..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2090 zcmV+_2-Wu=iwFP!000023+-Lovf4Hjea}~T$SX(qehJ}Z(sVj~Xy?pilD;wm1h_F4 zmBk^v^n3ar{jo~6xfl!v3vkk*H#)iltDBamYEXxc)JYl5+}>9p1FI zOIz-Qg`?9Aw_tI^%Q77CY5#je;mW+P8uI=eCgC6=Wmg}@{A%u3*KxmpcT)D=o~~FM zGH*w_hmlVl;#}T6OcvpYBo)=HXmiBVG&k#1MSb7y+`wdq_B!hnBEl=ea`zt@3;+Fx zk%xJN}*}?XufHfuIWXg|&nMn4JJ1?^y*k1lr z$ex~J4QpSpsHfT!6aRiDe=SJDOH-;#FcVG~p|VmRL;jc~gmF>7m9a$oospOy15);n z2jX1OeD?uP^~@K=YB8TPk|h1j2T9{lROH=QM!zwrbr;usq1H&ZD^p(M8pByKJU_QM z#gz796g(C!wLhHV18&_gtF71bpGT=La%R$xNIW@Y)@`!msbO$DnG{p=tKN{b2o-&U z=;?}dts4qp#iZ+qD%We?nQ<6J)d5p z8q;Kshav?__)6wuBAv=ye4+~$5>^j?-7CD@70hY0no%~NhQpV;h@s3?<-gUJkYGV& zYjl4D|0{`}2@i+(;U^l66mLe|%Q?InH9mS7^qn?QnO*A0-=i!0I@R!Y$b}|&JJ@0! ztHd>~TBVzU+pV}~gwhR)FSlkPx5;7WwD8;}L!F9_XC~w~CrxDnYyU}cz#~)f^<=%F zD(g)H8A01YuHT@lmmszTvAU**Y_IL1z-m&^tCs2DTcS9=RPl!Gv<(~i ze#1Imtz_p2c?UVVU8v2kLCAlmOHlEk;z7lOiU$=BDjrlksCZEEpyENrgNg?g-++p@ zR8_ns#B@4m-K2<@AaW*NXn5O2hT%DFuVD?ZTCOwK)*GJpDkk9nz|n$ePh*&i2Ne%0 z9#lN2cu?`6;z7lOiU$=BDjrlksQ4yTysfO_Efl1)@y#x( zS1#H)N2k z^@_y!w4a8lPVi1xTFA3b8RlOMD4Jb-{hdl|27qhZ$G>f0<3b=T|DWi*uc2r+` zZ1TfJV+rCWjcyL&)Tl}rC!*ExP;kW!MpKj_Mhq|em@&G%(j6btI2ObqDf=M$>rb>P zjz@U{#A&(*sJ8vI*K!YPcgeX%ey&+O*E-w?b?<_%#N6(+n7iqnOV`BhBHii=dU9<6 zY1iGi^#4TLdyzYC=pxUrAZ;VqvjWZr&IZmto3o8eINNw3&i0hQ(CP{1R9KjL-uGEO z!CC^u(4DU3Aj@w1$kXqbugjuVVwG*NeZJYrJUm<6TeP}5rRygs{blK1N$LXM1K%I; z{T^p~m+-w+JlDAu-}_hKdp*du6R?_Pd_CK>Amx0KwFYg&xqH$t30*0lTNm1$>>u*Q zAoVwZ0Okkg2j<^lep7+@?H6MHK$-ak3F}VNslE{)S3XHb=BZr?=?I3?k$KOfGo_I` zYF0UhBOkV7m}(FBf#I2ZCT(%&CSeSGT{Ba^Xf%CqRL8s(UmN;02-}tqBb=+J*vidpBcl<1Y4>FkKXQZ5svI z083!EUF6*J_)1ySN=P_JM@`N*JDszq1NjQi2-$E2* zFQ1z$GS8Im1!lS=@4orIEON(($uF?8DkxtM)KnFaK9D|;e%WxiuCUPYcBF4zZD^+H zX;d4TL55>nT`NGQC6{b_$aoDSGnEshYeN@Vr$jORNRVsn#9oaTVrN-J5j;%6pK=9YHM5X*~ZIIEJ6&SY5{y znZG1Pr@(jj))5>DUWuWDbpIm5sx>tm=pS}f4Ri$15!^x%m0K*0HN{}Q2+n{ diff --git a/doc/type/diagramOfTypeClasses.dia b/doc/type/diagramOfTypeClasses.dia deleted file mode 100644 index 14d1eed0e8c4b96767cd3f4026b608bfa06272ef..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 9135 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 From c16138dbb7653559bda6299aecfdabd10b8529d5 Mon Sep 17 00:00:00 2001 From: Marc Philipp Date: Fri, 20 Nov 2026 10:46:20 +0100 Subject: [PATCH 13/13] Replace Google group link with GitHub Discussions --- src/docs/antora/modules/ROOT/pages/index.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/docs/antora/modules/ROOT/pages/index.adoc b/src/docs/antora/modules/ROOT/pages/index.adoc index 01717d6d..0030ffd0 100644 --- a/src/docs/antora/modules/ROOT/pages/index.adoc +++ b/src/docs/antora/modules/ROOT/pages/index.adoc @@ -23,9 +23,9 @@ Some implementations examples are visible at the {assertj-examples-github}/tree/ They show what is possible with AssertJ DB Assertions with running code. You can clone the repository and run its tests ! -== Mailing list +== Discussions -If you have any questions, please use the https://groups.google.com/forum/?fromgroups=#!forum/assertj[AssertJ google group]. +If you have any questions, please use https://github.com/orgs/assertj/discussions[GitHub Discussions]. == Code and issue tracker