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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
|
/*-
* See the file LICENSE for redistribution information.
*
* Copyright (c) 2002, 2015 Oracle and/or its affiliates. All rights reserved.
*
* $Id$
*/
package com.sleepycat.db;
import com.sleepycat.db.internal.DbConstants;
import com.sleepycat.db.internal.DbUtil;
/**
A DatabaseEntry that holds multiple data items returned by a single
{@link com.sleepycat.db.Database Database} or {@link com.sleepycat.db.Cursor Cursor} get call.
*/
public class MultipleDataEntry extends MultipleEntry {
/**
Construct an entry with no data. The object must be configured
before use with the {@link com.sleepycat.db.MultipleEntry#setUserBuffer MultipleEntry.setUserBuffer} method.
*/
public MultipleDataEntry() {
super(null, 0, 0);
}
/**
Construct an entry with a given byte array. The offset is
set to zero; the size is set to the length of the array. If null
is passed, the object must be configured before use with the
{@link com.sleepycat.db.MultipleEntry#setUserBuffer MultipleEntry.setUserBuffer} method.
<p>
@param data
Byte array wrapped by the entry.
*/
public MultipleDataEntry(final byte[] data) {
super(data, 0, (data == null) ? 0 : data.length);
}
/**
Constructs a DatabaseEntry with a given byte array, offset and size.
<p>
@param data
Byte array wrapped by the DatabaseEntry.
@param offset
Offset in the first byte in the byte array to be included.
@param size
Number of bytes in the byte array to be included.
*/
public MultipleDataEntry(final byte[] data,
final int offset,
final int size) {
super(data, offset, size);
}
/**
* Return the bulk retrieval flag and reset the entry position so that the
* next set of key/data can be returned.
*/
/* package */
int getMultiFlag() {
pos = 0;
return DbConstants.DB_MULTIPLE;
}
/**
Get the next data element in the returned set. This method may only
be called after a successful call to a {@link com.sleepycat.db.Database Database} or
{@link com.sleepycat.db.Cursor Cursor} get method with this object as the data parameter.
<p>
When used with the Queue and Recno access methods,
<code>data.getData()<code> will return <code>null</code> for deleted
records.
<p>
@param data
an entry that is set to refer to the next data element in the returned
set.
<p>
@return
indicates whether a value was found. A return of <code>false</code>
indicates that the end of the set was reached.
*/
public boolean next(final DatabaseEntry data) {
if (pos == 0)
pos = ulen - INT32SZ;
final int dataoff = DbUtil.array2int(this.data, pos);
// crack out the data offset and length.
if (dataoff < 0) {
return (false);
}
pos -= INT32SZ;
final int datasz = DbUtil.array2int(this.data, pos);
pos -= INT32SZ;
data.setData(this.data);
data.setSize(datasz);
data.setOffset(dataoff);
return (true);
}
/**
Append an entry to the bulk buffer.
<p>
@param data
an array containing the record to be added.
@param offset
the position in the <b>data</b> array where the record starts.
@param len
the length of the record, in bytes, to be copied from the <b>data</b> array.
<p>
@return
indicates whether there was space. A return of <code>false</code>
indicates that the specified entry could not fit in the buffer.
*/
public boolean append(final byte[] data, int offset, int len)
throws DatabaseException {
return append_internal(data, offset, len);
}
/**
Append an entry to the bulk buffer.
<p>
@param data
the record to be appended, using the offset and size specified in the
{@link com.sleepycat.db.DatabaseEntry DatabaseEntry}.
<p>
@return
indicates whether there was space. A return of <code>false</code>
indicates that the specified entry could not fit in the buffer.
*/
public boolean append(final DatabaseEntry data)
throws DatabaseException {
return append_internal(data.data, data.offset, data.size);
}
/**
Append an entry to the bulk buffer.
<p>
@param data
an array containing the record to be added.
<p>
@return
indicates whether there was space. A return of <code>false</code>
indicates that the specified entry could not fit in the buffer.
*/
public boolean append(final byte[] data)
throws DatabaseException {
return append_internal(data, 0, data.length);
}
}
|
