-
Notifications
You must be signed in to change notification settings - Fork 44
/
ResultSet.java
86 lines (76 loc) · 3.4 KB
/
ResultSet.java
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
/*
* Copyright (C) 2013 - 2018 Oracle and/or its affiliates. All rights reserved.
*/
package oracle.pgql.lang;
/**
* A table of data representing the result of a PGQL query. The cursor is initially positioned before the first row.
* After the first call to the function `next()`, the cursor will be located at the first row and you can retrieve
* the data in the columns with one of suitable get methods.
*/
public interface ResultSet extends AutoCloseable, ResultAccess {
/**
* Moves the cursor forward one row from its current position.
*
* @return <code>true</code> if the new current row is valid; <code>false</code> if the new cursor is positioned
* after the last row
* @throws PgqlException if a connection error occurs or when this method is called on a closed result set
*/
public boolean next() throws PgqlException;
/**
* Moves the cursor to the previous row from its current position.
*
* @return <code>true</code> if the new current row is valid; <code>false</code> if the new cursor is positioned
* before the first row
* @throws PgqlException if a connection error occurs or when this method is called on a closed result set
*/
public boolean previous() throws PgqlException;
/**
* Place the cursor before the first row.
*
* @throws PgqlException if a connection error occurs or when this method is called on a closed result set
*/
public void beforeFirst() throws PgqlException;
/**
* Place the cursor after the last row.
*
* @throws PgqlException if a connection error occurs or when this method is called on a closed result set
*/
public void afterLast() throws PgqlException;
/**
* Moves the cursor to the first row in the result set.
*
* @return <code>false</code> if there are no rows in the result set; <code>true</code> otherwise
* @throws PgqlException if a connection error occurs or when this method is called on a closed result set
*/
public boolean first() throws PgqlException;
/**
* Moves the cursor to the last row in the result set.
*
* @return <code>false</code> if there are no rows in the result set; <code>true</code> otherwise
* @throws PgqlException if a connection error occurs or when this method is called on a closed result set
*/
public boolean last() throws PgqlException;
/**
* Places the cursor to the given row number in this ResultSet object.
*
* @return <code>true</code> if the cursor is moved to a position in the ResultSet object; <code>false</code> if
* the cursor is moved before the first or after the last row
* @throws PgqlException if a connection error occurs or when this method is called on a closed result set
*/
public boolean absolute(long row) throws PgqlException;
/**
* Moves the cursor a relative number of row with repect to the current position. A negative number will move the
* cursor backwards.
*
* @return <code>true</code> if the cursor is moved to a position in the ResultSet object; <code>false</code> if
* the cursor is moved before the first or after the last row
* @throws PgqlException if a connection error occurs or when this method is called on a closed result set
*/
public boolean relative(long rows) throws PgqlException;
/**
* Releases this result set's resources. Calling the method close on a ResultSet object that is already closed has no
* effect.
*/
@Override
void close() throws PgqlException;
}