01: /*
02:
03: Derby - Class org.apache.derby.iapi.sql.Row
04:
05: Licensed to the Apache Software Foundation (ASF) under one or more
06: contributor license agreements. See the NOTICE file distributed with
07: this work for additional information regarding copyright ownership.
08: The ASF licenses this file to you under the Apache License, Version 2.0
09: (the "License"); you may not use this file except in compliance with
10: the License. You may obtain a copy of the License at
11:
12: http://www.apache.org/licenses/LICENSE-2.0
13:
14: Unless required by applicable law or agreed to in writing, software
15: distributed under the License is distributed on an "AS IS" BASIS,
16: WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
17: See the License for the specific language governing permissions and
18: limitations under the License.
19:
20: */
21:
22: package org.apache.derby.iapi.sql;
23:
24: import org.apache.derby.iapi.types.DataValueDescriptor;
25:
26: import org.apache.derby.iapi.error.StandardException;
27:
28: /**
29: * The Row interface provides methods to get information about the columns
30: * in a result row.
31: * It uses simple, position (1-based) access to get to columns.
32: * Searching for columns by name should be done from the ResultSet
33: * interface, where metadata about the rows and columns is available.
34: * <p>
35: *
36: * @see ResultSet
37: *
38: * @author Jeff Lichtman
39: * @see org.apache.derby.iapi.sql.execute.ExecRow
40: */
41:
42: public interface Row {
43: public int nColumns();
44:
45: /**
46: * Get a DataValueDescriptor in a Row by ordinal position (1-based).
47: *
48: * @param position The ordinal position of the column.
49: *
50: * @exception StandardException Thrown on failure.
51: * @return The DataValueDescriptor, null if no such column exists
52: */
53: DataValueDescriptor getColumn(int position)
54: throws StandardException;
55:
56: /**
57: * Set a DataValueDescriptor in a Row by ordinal position (1-based).
58: *
59: * @param position The ordinal position of the column.
60: */
61: void setColumn(int position, DataValueDescriptor value);
62:
63: }
|