FileDocCategorySizeDatePackage
Array.javaAPI DocAndroid 1.5 API6410Wed May 06 22:41:06 BST 2009java.sql

Array

public interface Array
A Java representation of the SQL {@code ARRAY} type.
since
Android 1.0

Fields Summary
Constructors Summary
Methods Summary
public java.lang.ObjectgetArray()
Retrieves the contents of the SQL {@code ARRAY} value as a Java array object.

return
A Java array containing the elements of this Array
throws
SQLException if there is a database error.
since
Android 1.0

public java.lang.ObjectgetArray(long index, int count)
Returns part of the SQL {@code ARRAY} associated with this array, starting at a particular {@code index} and comprising up to {@code count} successive elements of the SQL array.

param
index the start position in the array where the values are retrieved.
param
count the number of elements to retrieve.
return
A Java array containing the desired set of elements from this Array
throws
SQLException if there is a database error.
since
Android 1.0

public java.lang.ObjectgetArray(long index, int count, java.util.Map map)
Returns part of the SQL {@code ARRAY} associated with this array, starting at a particular {@code index} and comprising up to {@code count} successive elements of the SQL array.

param
index the start position in the array where the values are retrieved.
param
count the number of elements to retrieve.
param
map the map defining the correspondence between SQL type names and Java types.
return
A Java array containing the desired set of elements from this Array
throws
SQLException if there is a database error.
since
Android 1.0

public java.lang.ObjectgetArray(java.util.Map map)
Returns the data from the underlying SQL {@code ARRAY} as a Java array.

param
map the map defining the correspondence between SQL type names and Java types.
return
A Java array containing the elements of this array
throws
SQLException if there is a database error.
since
Android 1.0

public intgetBaseType()
Returns the JDBC type of the entries in this array's underlying SQL array.

return
An integer constant from the {@code java.sql.Types} class
throws
SQLException if there is a database error.
since
Android 1.0

public java.lang.StringgetBaseTypeName()
Returns the SQL type name of the entries in this array's underlying SQL array.

return
The database specific name or a fully-qualified SQL type name.
throws
SQLException if there is a database error.
since
Android 1.0

public java.sql.ResultSetgetResultSet(java.util.Map map)
Returns a {@code ResultSet} object which holds the entries of the SQL {@code ARRAY} associated with this array.

param
map the map defining the correspondence between SQL type names and Java types.
return
the array as a {@code ResultSet}.
throws
SQLException if there is a database error.
since
Android 1.0

public java.sql.ResultSetgetResultSet()
Returns a ResultSet object which holds the entries of the SQL {@code ARRAY} associated with this array.

return
the elements of the array as a {@code ResultSet}.
throws
SQLException if there is a database error.
since
Android 1.0

public java.sql.ResultSetgetResultSet(long index, int count)
Returns a {@code ResultSet} object that holds the entries of a subarray, beginning at a particular index and comprising up to {@code count} successive entries.

param
index the start position in the array where the values are retrieved.
param
count the number of elements to retrieve.
return
the elements of the array as a {@code ResultSet}.
throws
SQLException if there is a database error.
since
Android 1.0

public java.sql.ResultSetgetResultSet(long index, int count, java.util.Map map)
Returns a {@code ResultSet} object that holds the entries of a subarray, beginning at a particular index and comprising up to {@code count} successive entries.

param
index the start position in the array where the values are retrieved.
param
count the number of elements to retrieve.
param
map the map defining the correspondence between SQL type names and Java types.
return
the {@code ResultSet} the array's custom type values. if a database error has occurred.
throws
SQLException if there is a database error.
since
Android 1.0