Document "data snapshot" aspect/intent of AbstractDbData and subclasses more explicitly
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 2/5
- Thời gian dự kiến
- 1-3 giờ
- Mức phù hợp với người mới
- 42/100
- Loại issue
- Tài liệu
- Độ rõ ràng
- Khá rõ ràng
- Mức độ hoạt động
- Đình trệ
- Công nghệ
- java
- Lĩnh vực
- documentation
Hướng nghiên cứu
Bắt đầu với tài liệu Concepts / Elements of the Database và JavaDoc cho AbstractDbData cùng các lớp con của nó. Làm rõ mục đích của data-snapshot và hướng dẫn tạo một Table mới sau khi cơ sở dữ liệu được cập nhật; hoàn thành khi khó có khả năng người đọc diễn giải Table là một đối tượng dữ liệu có thể tải lại.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
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.
- Ngôn ngữ chính
- Java
- Star
- 130
- Fork
- 21
- Chỉ số merge pull request
- Không có pull request nào được merge trong 30 ngày
Hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của assertj/assertj-db
-
Add toString() and equals() implementations for core domain types (Table, Row, Value, Column) Đang mở
assertj/assertj-db#324 · 1 bình luận · 1 người được giao ·
-
question
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 32/100
assertj/assertj-db#292 · 1 bình luận ·
-
row(index).column("ABC") and row().row().row().column("ABC") always referring to row 0 itself Đang mởquestion
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 35/100
assertj/assertj-db#290 · 1 bình luận ·
-
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 30/100
assertj/assertj-db#259 · 1 bình luận ·
-
Support R2DBC connection Đang mở
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 25/100
assertj/assertj-db#206 ·
Tất cả issue của assertj/assertj-db
Issue tương tự
-
awaiting triage bug Causes friction Hop Gui P1 P2 Transforms
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
apache/flink-agents#1152 ·
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 70/100
jenkinsci/blueocean-plugin#5417 ·
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
objectionary/eo-graphs#75 ·