Document "data snapshot" aspect/intent of AbstractDbData and subclasses more explicitly
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 2/5
- Tempo stimato
- 1-3 ore
- Idoneità per principianti
- 42/100
- Tipo di issue
- Documentazione
- Chiarezza
- Abbastanza chiara
- Stato di attività
- Ferma
- Stack tecnologico
- java
- Ambito
- documentation
Direzione di ricerca
Inizia con la documentazione Concepts / Elements of the Database e il JavaDoc di AbstractDbData e delle sue sottoclassi. Rendi espliciti lo scopo dello snapshot dei dati e l’indicazione di creare una nuova Table dopo gli aggiornamenti del database; il lavoro è completato quando è improbabile che i lettori interpretino Table come un oggetto dati ricaricabile.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
Dear AssertJ-DB team, Dear Joel,
I found one of my friends wrapping Table to allow for a "data reload feature". As I understand the JavaDoc of that class, the intended purpose of this class and the sibling AbstractDbData subclasses is to hold a snapshot of DB data and provide a fluent assertion API for this data snapshot.
The web site http://joel-costigliola.github.io/assertj/assertj-db-concepts.html states for e. g. Table and Request, that these objects represent a "Table in" or a "Request on" the database.
This probably misled my friend (who has a decent background in RDBMS) into thinking that a Table object could / should also be used in more complex query/update scenarios, whereas its original purpose is "only" to contain the data snapshot used for upcoming fluent assertions.
Would it be possible to make this intention of holding a data snapshot from different sources (Table, Request) more explicit in the "Concepts" / "Elements of the Database" page, maybe a "Caution" paragraph elaborating a bit on this? In particular, I consider a hint like "If you need to re-load data after DB update operations, please create a new Table instance" very useful.
Looking forward to your feedback. Thanks in advance & keep up the good work. Very much appreciated.
- Lingua principale
- Java
- Stelle
- 130
- Fork
- 21
- Metriche di merge delle PR
- Nessuna PR unita negli ultimi 30g
Guida per i contributori
Apri la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di assertj/assertj-db
-
Add toString() and equals() implementations for core domain types (Table, Row, Value, Column) Aperta
assertj/assertj-db#324 · 1 commento · 1 assegnatario ·
-
question
Difficoltà 3/5 1-2 giorni Idoneità per principianti 32/100
assertj/assertj-db#292 · 1 commento ·
-
row(index).column("ABC") and row().row().row().column("ABC") always referring to row 0 itself Apertaquestion
Difficoltà 3/5 1-2 giorni Idoneità per principianti 35/100
assertj/assertj-db#290 · 1 commento ·
-
Difficoltà 4/5 3-5 giorni Idoneità per principianti 30/100
assertj/assertj-db#259 · 1 commento ·
-
Support R2DBC connection Aperta
Difficoltà 5/5 Più di una settimana Idoneità per principianti 25/100
assertj/assertj-db#206 ·
Tutte le issue di assertj/assertj-db
Issue simili
-
awaiting triage bug Causes friction Hop Gui P1 P2 Transforms
Difficoltà 2/5 1-3 ore Idoneità per principianti 75/100
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 75/100
apache/flink-agents#1152 ·
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 75/100
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 70/100
jenkinsci/blueocean-plugin#5417 ·
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 75/100
objectionary/eo-graphs#75 ·