Skip to content

Commit 16afed7

Browse files
authored
Clarify javadoc for creation time
1 parent 54ee477 commit 16afed7

File tree

4 files changed

+14
-6
lines changed

4 files changed

+14
-6
lines changed

driver/src/main/java/oracle/nosql/driver/ops/DeleteResult.java

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,8 @@ public MapValue getExistingValue() {
6363
* {@link DeleteRequest#setReturnRow} are met.
6464
*
6565
* Note: If the row was written by a version of the system older than 25.3
66-
* the creation time will not be available at all and will be zero.
66+
* the creation time will be equal to the modification time, if it was
67+
* written by a system older than 19.5 it will be zero.
6768
*
6869
* @return the creation time in milliseconds since Jan 1, 1970 GMT
6970
*

driver/src/main/java/oracle/nosql/driver/ops/GetResult.java

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,7 @@ public Version getVersion() {
6666
* row does not expire. This value is valid only if the operation
6767
* successfully returned a row ({@link #getValue} returns non-null).
6868
*
69-
* @return the expiration time in milliseconds since January 1, 1970 GMT,
69+
* @return the expiration time in milliseconds since January 1, 1970, GMT,
7070
* or zero if the row never expires or the row does not exist
7171
*/
7272
public long getExpirationTime() {
@@ -79,9 +79,10 @@ public long getExpirationTime() {
7979
* successfully returned a row ({@link #getValue} returns non-null).
8080
*
8181
* Note: If the row was written by a version of the system older than 25.3
82-
* the creation time will not be available at all and will be zero.
82+
* the creation time will be equal to the modification time, if it was
83+
* written by a system older than 19.5 it will be zero.
8384
*
84-
* @return the creation time in milliseconds since January 1, 1970 GMT,
85+
* @return the creation time in milliseconds since January 1, 1970, GMT,
8586
* or zero if the row does not exist
8687
*
8788
* @since 5.4.18
@@ -100,7 +101,7 @@ public long getCreationTime() {
100101
* This value is valid only if the operation
101102
* successfully returned a row ({@link #getValue} returns non-null).
102103
*
103-
* @return the modification time in milliseconds since January 1, 1970 GMT,
104+
* @return the modification time in milliseconds since January 1, 1970, GMT,
104105
* or zero if the row does not exist
105106
*
106107
* @since 5.3.0

driver/src/main/java/oracle/nosql/driver/ops/PutResult.java

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -75,8 +75,10 @@ public MapValue getExistingValue() {
7575
* Returns the existing creation time if available. This value will
7676
* only be available if the conditions specified in
7777
* {@link PutRequest#setReturnRow} are met.
78+
*
7879
* Note: If the row was written by a version of the system older than 25.3
79-
* the creation time will not be available at all and will be zero.
80+
* the creation time will be equal to the modification time, if it was
81+
* written by a system older than 19.5 it will be zero.
8082
*
8183
* @return the creation time in milliseconds since Jan 1, 1970 GMT
8284
*

driver/src/main/java/oracle/nosql/driver/ops/WriteMultipleResult.java

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -219,6 +219,10 @@ public MapValue getExistingValue() {
219219
/**
220220
* Returns the creation time associated with the key if
221221
* available.
222+
* Note: If the row was written by a version of the system older than
223+
* 25.3 the creation time will be equal to the modification time, if it
224+
* was written by a system older than 19.5 it will be zero.
225+
*
222226
* @return the creation time if set, in milliseconds sine Jan 1, 1970
223227
* GMT
224228
*

0 commit comments

Comments
 (0)