Глава
№22.
Справочник
по JDBC
Пакет java.sql
содержит весь JDBC API. Впервые он был включен в ядро библиотек Java в версии
1.1. Классы, добавленные в JDK 1.2, отмечены в заголовке «Доступность».
Методы, не рекомендуемые к использованию, предваряются символом «решетки»
(#). Методы JDK 1.2 в старых классах JDK 1.1 выделены полужирным шрифтом. На
рис. 22-1 показан весь пакет Java. sql.
Рис. 22-1.
Классы и интерфейсы пакета java.sql
Array
Краткий обзор
Имя класса: Java. sql. Array
Надкласс:
нет
Непосредственные подклассы: нет
Реализованные интерфейсы: нет
Доступность:
введен в JDK 1.2
Описание
Интерфейс
Array добавлен в JDBC для поддержки объектов массивов, введенных в SQL 3. По
умолчанию ссылка на массив SQL существует в течение срока жизни транзакции,
в которой она была создана.
Сводка
методов класса
public interface Array { Object getArray() throws SQLException;
Object getArray(Map map) throws SQLException;
Object getArray(long
index, int count)
throws SQLException;
Object getArray(long
index, int count, Map map)
throws SQLException;
int getBaseType() throws SQLException;
String getBaseTypeName() throws SQLException;
ResultSet getResultSet() throws SQLException;
ResultSet getResultSet(Map map) throws SQLException;
ResultSet getResultSet(long
index, int count)
throws SQLException;
ResultSet getResultSet(long
index, int count, Map map) throws SQLException
}
Методы
объекта
getArray()
public Object getArray() throws SQLException
public Object getArray(Map map) throws SQLException
public Object
getArray(long index, int count)
throws SQLException
public Object
getArray(long index, int count, Map map)
throws SQLException
Описание.
Помещает содержимое массива SQL в массив Java или тип Java, определяемый
передаваемым отображением Map. Если задано отображение, но в нем не найдено
соответствия, используется
отображение в массив Java по умолчанию. Две версии метода, которые принимают
индекс массива и количество, элементов, позволяют поместить в массив подмножество
элементов.
getBaseType(
)
public int getBaseType()
throws SQLException
Описание.
Позволяет получить JDBC-тип элементов в массиве. getBaseTypeNamef )
public String
getBaseTypeName() throws SQLException
Описание.
Позволяет получить SQL-тип элементов в массиве. getResultSet( )
public ResultSet getResultSet() throws SQLException
public ResultSet
getResultSet(Map map)
throws SQLException
public ResultSet getResultSet(long index, int count)
throws SQLException
public ResultSet
getResultSet(long index, int count, Map map)
throws SQLException
Описание.
Позволяет получить результирующий набор, содержащий элементы массива в виде
строк. Соответствие типов, если это возможно, определяется отображением, установленным
для соединения с базой данных, или переданным в качестве аргумента. В каждой
строке две колонки: первая колонка - индекс, начинающийся с единицы, вторая
колонка - фактическое значение.
Blob
Краткий
обзор
Имя класса: java.sql.Blob
Надкласс:
нет
Непосредственные подклассы: нет
Реализованные интерфейсы: нет
Доступность:
введен в JDK 1.2
Описание
Интерфейс
JDBC Blob представляет тип SQL BLOB. BLOB - акроним для «binary large
object» («большой двоичный объект»)- представляет в реляционной
базе данных двоичные данные большого объема. Ценность использования BLOB в том,
что с ним можно работать как с объектом
Java, не навлекая из базы все его данные. Объект BLOB действует в продолжение
той транзакции, в которой он был создан.
Сводка
методов класса
public interface
Blob {
InputStream getBinaryStream()
throws SQLException;
byte[] getBytes(long
pos, int count)
throws SQLException;
long length() throws SQLException;
long position(byte[]
pattern, long start)
throws SQLException;
long position(Blob
pattern, long start)
throws SQLException;
}
Методы
объекта
getBinary
Stream ( )
public InputStream
getBinaryStream() throws SQLException
Описание.
Позволяет извлекать из базы данные двоичного объекта в виде потока.
getBytes()
public byte[]
getBytes(long pos, int count) throws SQLException
Описание.
Возвращает все данные двоичного объекта или их часть в виде массива байтов.
Подмножество двоичных данных можно получить, указав ненулевой начальный индекс
и количество байтов, меньшее, чем размер объекта.
length()
public long
length() throws SQLException
Описание.
Возвращает количество байтов в объекте BLOB.
position
()
public long
position(byte[] pattern, long start)
throws SQLException
public long position(Blob pattern, long start)
throws SQLException
Описание.
Ищет в Blob заданную последовательность байтов и возвращает найденную позицию
либо, в случае неуспеха, —1.
CallableStatement
Краткий
обзор
Имя класса:
j ava. sql. CallableStatement Надкласс: java.sql.PreparedStatement Непосредственные
подклассы: нет Реализованные интерфейсы: нет Доступность: JDK1.1
Описание
CallableStatement
расширяет интерфейс PreparedSt-atement, обеспечивая поддержку хранимых процедур
SQL. Он описывает методы привязки выходных параметров. JDBC предписывает стандартную
форму представления хранимых процедур, независимо от используемой СУБД. Формат
следующий:
{? = call ...}
{call ...}
Каждый вопросительный
знак замещает входной или выходной параметр. В первом синтаксисе есть один результирующий
параметр. Во втором синтаксисе результирующих параметров нет. Ссылка на параметры
производится последовательно, при этом первый вопросительный знак соответствует
параметру номер 1.
Перед выполнением
хранимой процедуры все выходные параметры должны быть зарегистрированы методом
registerOutParameter(). Затем входные параметры привязываются с помощью каких-либо
методов set, и выполняется хранимая процедура.
Сводка
методов класса
public interface CallableStatement extends PreparedStatement {
Array getArray(int index) throws SQLException;
BigDecimal getBigDecimal(int
index)
throws SQLException;
#BigDecimal getBigDecimal(int
index, int scale)
throws SQLException;
Blob getBlob(int index) throws SQLException;
boolean getBoolean(int index) throws SQLException;
byte getByte(int index) throws SQLException;
byte[] getBytes(int index) throws SQLException;
Clob getClob(int-index), throws SQLException;
Java.sql.Date
getDate(int index, Calendar cal)
throws SQLException; Java.sql.Date getDate(int index)
throws SQLException;
double getDouble(int index) throws SQLExceptlon;
float getFloat(int index) throws SQLException;
int getlnt(int index) throws SQLException;
long getLong(int index) throws SQLException;
Object getObject(int index) throws SQLException;
Object getObject(int
index, Map map)
throws SQLException;
Ref getRef(int index) throws SQLException;
short getShort(int index) throws SQLException;
String getString(int index) throws SQLException;
Java.sql.Time getTime(int index) throws SQLException;
Java.sql.Time
getTime(int index, Calendar cal)
throws SQLException;
Java.sql.Timestamp getTimestamp(int index)
throws SQLException;
Java.sql.Timestamp getTimestamp(int index,
Calendar cal)
throws SQLException;
void registerOutParameter(int index, int type)
throws SQLException;
void registerOutParameter(int
index, int type,
int scale)
throws SQLException;
void registerOutParameter(int
index, int type,
String typename)
throws SQLException;
boolean wasNull() throws SQLException; }
Методы
объекта
get
BigDecimal( )
public BigDecimal
getBigDecimal(int index)
throws SQLException
#public BigDecimal
getBigDecimal(int index, int scale)
throws SQLException
Описание.
Возвращает значение параметра, заданного аргументом index, как тип Java
BigDecimal с масштабом, определяемым аргументом scale. Масштаб есть неотрицательное
число, задающее количество цифр правее десятичной точки. Параметры нумеруются
с 1, поэтому для первого параметра index равен 1.
getArray(),
getBlobf), getBoolean(), getByte(), getBytes(), getClob(), getDouble(), getFloat(),
getlnt(), getLongf), getRef(), getShort() и get-String()
public Array
getArray(int index)
throws SQLException
public Blob
getBlob(int index) throws SQLException public boolean getBoolean(int index)
throws SQLException
public byte getByte(int index) throws SQLException
public byte[] getBytes(int index) throws SQLException
public Clob getClob(int index) throws SQLException
public double getOouble(int index) throws SQLException
public float getFloat(int index) throws SQLException
public int getlntdnt index) throws SQLException
public long getLong(int index) throws SQLException
public Ref getRef(int index) throws SQLException
public short getShort(int index) throws SQLException
public String
getString(int index) throws SQLException
Описание.
Возвращает значение параметра, заданного аргументом index, как тот тип данных
Java, который определен именем метода.
getDate(
), getTime( ) и getTimestamp()
public Date getDate(int index) throws SQLException
public Date getDate(int
index, Calendar cal)
throws SQLException
public Time getTime(int index) throws SQLException
public Time getTime(int
index, Calendar cal)
throws SQLException
public Timestamp
getTimestamp(int index)
throws SQLException
public Timestamp
getTimestamp(int index, Calendar cal)
throws SQLException
Описание.
JDBC обеспечивает уточнение базового объекта java.util.Date, более подходящее
для работы с базами данных. Эти методы обеспечивают доступ к значениям, возвращаемым
CallableStatement, в виде объектов Date, Time или Timestamp. Варианты, добавленные
в JDK 1.2, позволяют задавать календарь.
getObject()
public Object getObject(int index) throws SQLException
public Object
getObject(int index, Map map) throws SQLException
Описание.
Как и все прочие методы getXXX(), этот метод возвращает значение указанного
выходного параметра. Но в случае getObject() драйвер JDBC выбирает класс Java,
соответствующий типу SQL, зарегистрированному для этого параметра с помощью
registerOutPa-rameter() или согласно указанному отображению типов.
registerOutParameter(
)
public void
registerOutParameter(int index, int type)
throws SQLException
public void
registerOutParameter(int index, int type, int scale)
throws SQLException
public void registerOutParameter(int index, int type,
String typename)
throws SQLException
Описание.
Перед выполнением любой хранимой процедуры с помощью CallableStatement необходимо
зарегистрировать все выходные параметры. Этот метод регистрирует тип java.sql.Type
выходного параметра хранимой процедуры. Первый аргумент задает регистрируемый
выходной параметр, а второй- тип java.sql.Type, который нужно зарегистрировать.
Версия с тремя аргументами служит для типов BigDecimal, которым требуется масштаб.
Выходные параметры читаются затем с помощью соответствующего метода getXXX()
или getObject(). Третья версия этого метода введена в JDK 1.2 и позволяет отображать
REF-типы SQL или пользовательские типы SQL.
wasNull()
public boolean
wasNull() throws SQLException
Описание.
Если последнее значение, прочтенное при обращении к getXXX(), было SQL NULL,
то этот метод возвращает true.
Clob
Краткий
обзор
Имя класса: Java. sql. Glob
Надкласс:
нет
Непосредственные подклассы: нет
Реализованные интерфейсы: нет
Доступность:
введен в JDK 1.2
Описание
CLOB - это
тип SQL3, означающий «character large object» (большой символьный
объект). Как и BLOB, CLOB представляет очень большой кусок данных в базе. В
отличие от BLOB, тип CLOB представляет текст, хранимый с использованием какой-либо
кодировки символов. Смысл использования CLOB вместо CHAR или VARCHAR заключается
в том, что данные CLOB, как и данные BLOB, можно извлекать не сразу целиком,
а в виде потока.
Сводка
методов класса
public interface
Clob {
InputStream getAsciiStream()
throws SQLException;
Reader getCharacterStream()
throws SQLException;
String getSubStringdong
pos, int count)
throws SQLException;
long length()
throws SQLException;
long position(String
pattern, long start)
throws SQLException;
long position(Clob
pattern, long start)
throws SQLException;
}
Методы
объекта
getAsciiStream
( )
public InputStream
getAsciiStream() throws SQLException
Описание.
Позволяет осуществлять доступ к данным Clob через поток ASCII.
getCharacterStream(
)
public Reader
getCharacterStream() throws SQLException
Описание.
Позволяет осуществлять доступ к данным Clob через поток Unicode.
getSubString(
)
public String
getSubString(long pos, int count) throws SQLException
Описание.
Возвращает подстроку Clob, начиная с указанной позиции, длиной, определяемой
значением count.
length(
)
public long length() throws SQLException
Описание.
Возвращает количество символов в Clob. position( )
public long
position(String pattern, long start) throws SQLException;
public long
position(Clob pattern, long start) throws SQLException;
Описание.
Ищет в Clob заданную строку, начиная с указанной позиции. Если строка найдена,
возвращается индекс первого ее вхождения в Clob. Если строка не найдена, метод
возвращает —1.
Connection
Краткий
обзор
Имя класса: java.sql.Connection
Надкласс:
нет
Непосредственные подклассы: нет
Реализованные интерфейсы: нет
Доступность:
JDK 1.1
Описание
Класс Connection
представляет в JDBC сеанс работы с базой данных. Он предоставляет приложению
объекты Statement (и его подклассы) для этого сеанса. Он также управляет транзакциями
для этих команд. По умолчанию каждая команда выполняется в отдельной транзакции.
Объект Connection позволяет отключить функцию Autocommit автоматического завершения
транзакции. В этом случае требуется явно завершить транзакцию, иначе результаты
выполнения всех команд.будут потеряны.
Сводка
методов класса
public interface Connection {
static public final int TRANSACTION_NONE;
static public final int TRANSACTION_READ_UNCOMMITTED;
static public final int TRANSACTION_READ_COMMITTED;
static public final int TRANSACTION_REPEATABLE_READ;
static public
final int TRANSACTION_SERIALIZABLE;
void clearWarnings()
throws SQLException;
void close()
throws SQLException;
void commit()
throws SQLException;
Statement createStatement()
throws SQLException;
Statement createStatement(int
type, int concur)
throws SQLException;
boolean getAutoCommit() throws SQLException;
String getCatalog() throws SQLException;
Map gettypeMap() throws SQLException;
DatabaseMetaData getMetaData() throws SQLException;
int getTransactionIsolation() throws SQLException;
SQLWarning getWarnings() throws SQLException;
boolean isClosed() throws SQLException;
boolean isReadOnly() throws SQLException;
String nativeSQL(String sql) throws SQLException;
CallableStatement
prepareCall(String sql)
throws SQLException;
CallableStatement prepareCall(String sql, int type,
int concur)
throws SQLException;
PreparedStatement
prepareStatement(String sql)
throws SQLException;
PreparedStatement
prepareStatement(String sql,
int type, int
concur)
throws SQLException;
void rollback() throws SQLException;
void setAutoCommit(boolean ac) throws SQLException;
void setCatalog(String catalog) throws SQLException;
void setReadOnly(boolean ro) throws SQLException;
void setTransactionIsolation(int
level)
throws SQLException;
void setTypeMap(Map
map) throws SQLException; }
Атрибуты
класса
TRANSACTION_NONE
static public final int TRANSACTION_NONE
Описание.
Транзакции не поддерживаются.
TRANSACTION_READ_UNCOMMITTED
static public
final int TRANSACTION_READ_UNCOMMITTED
Описание.
Этот уровень изоляции транзакций разрешает чтение незавершенных изменений
одной транзакции другими транзакциями.
TRANSACTION_READ_COMMITTED
static public
final int TRANSACTION_READ_COMMITTED
Описание.
Этот уровень изоляции транзакций предотвращает «грязное» чтение.
Иными словами, изменения, сделанные в транзакции TRANSACTION_READ_COMMITTED,
невидимы другим транзакциям до ее завершения.
TRANSACTION_REPEATABLE_READ
static public
final int TRANSACTION_REPEATABLE_READ
Описание.
Этот уровень изоляции транзакций предотвращает «грязное» чтение
и неповторяемое чтение. Неповторяемое чтение происходит, когда одна транзакция
читает строку, вторая транзакция изменяет ее, а затем первая транзакция повторно
читает строку, получая во второй раз другие значения.
Методы
объекта
clearWarnings(
)
public void
clearWarnings() throws SQLException
Описание.
Очищает список предупреждений, связанный с Connection, вследствие чего getWarnings()
возвращает null, пока не возникнет новое предупреждение.
close
()
public void
close() throws SQLException
Описание.
Этот метод позволяет вручную освободить все ресурсы, такие как сетевые соединения
и блокировки базы данных, связанные с данным объектом Connection. Этот метод
автоматически вызывается при сборке мусора; лучше, однако, вручную закрыть Connection,
если вы в нем больше не нуждаетесь.
commit
()
public void
commit() throws SQLException
Описание.
Этот метод делает постоянными изменения, произведенные всеми командами,
связанными с данным соединением и выполненными вслед за последней командой завершения
или отката транзакции. Использовать его следует только при отключенном автозавершении.
Он не завершает изменения, сделанные командами, которые связаны с другими объектами
Connection.
createStatement(
)
public Statement createStatement() throws SQLException public
Statement createStatement(int
type, int concur) throws SQLException
Описание.
Метод создает объект Statement, связанный с сеансом Connection. Версия без
аргументов создает объект Statement, для которого экземпляры ResultSet имеют
тип только для чтения и перемещения в прямом направлении.
getAutoCommit()
и setAutoCommit( )
public boolean getAutoCommit() throws SQLException
public void setAutoCommit(boolean
ac) throws SQLException
Описание.
По умолчанию все объекты Connection находятся в режиме автозавершения. В
этом режиме каждая команда завершается сразу после выполнения. Может оказаться
предпочтительнее вручную завершить серию команд в приложении как единую транзакцию.
В этом случае метод setAutoCommit() используется для отключения автозавершения.
Затем, после выполнения своих команд, вы вызываете commit() или rollback(),
в зависимости от успеха или неуспеха транзакции.
В режиме
автозавершения команда завершается, когда она выполнена, или выполняется следующая
команда, в зависимости от того, что произойдет раньше. Команда, возвращающая
ResultSet, выполнена, когда извлечена последняя строка или закрыт объект ResultSet.
Если команда возвращает множественные результирующие набо-
ры, завершение
происходит после извлечения последней строки последнего объекта ResultSet.
getCatalog()
и setCatalog()
public String
getCatalog() throws SQLException
public void
setCatalog(String catalog) throws SQLException
Описание.
Если драйвер поддерживает каталоги, то setCatalog() используется для выбора
подпространства базы данных с заданным именем каталога. Если драйвер каталоги
не поддерживает, запрос игнорируется.
getMetaData(
)
public OatabaseMetaData
getMetaDataQ
throws SQLException
Описание.
Класс DatabaseMetaData предоставляет методы, описывающие таблицы базы данных,
поддержку SQL, хранимые процедуры и другие сведения, относящиеся к базе данных
и данному Connection, которые не относятся непосредственно к выполнению команд
и извлечению результирующих наборов. Метод создает экземпляр класса DatabaseMetaData
для данного Connection.
getTransactionlsolution()
и setTransactionlsolution()
public int getTransactionlsolation() throws SQLException
public void setTransaction!solation(int
level) throws SQLException
Описание.
Устанавливает для объекта Connection текущий уровень изоляции транзакций,
используя один из атрибутов класса для интерфейса Connection. Эти уровни называются
TRANSACTION_NONE, TRANSACTION_READ_UNCOMMITTED, TRANSACTION_READ_COMMITTED и
TRANSACTION, REPEATABLE_READ.
get
TypeMap ( ) и set TypeMap ( )
public Map getTypeMap()
throws SQLException
public void
setTypeMap(Map map) throws SQLException
Описание.
С помощью этих методов можно задать или получить специальное отображение
структурированных типов SQL и индивидуальных (distinct) типов для всех
команд, связанных с этим соединением.
getWarnings(
)
public SQLWarning
getWarnings() throws SQLException
Описание.
Возвращает первое предупреждение из списка, связанного с данным объектом
Connection.
isClosed()
public boolean
isClosed() throws SQLExxeption
Описание.
Возвращает true, если соединение Connection закрыто.
isReadOnly()
и setReadOnly()
public boolean
IsReadOnly() throws SQLException
public void
setReadOnly(boolean ro) throws SQLException
Описание.
Некоторые базы данных оптимизированы для осуществления доступа только для
чтения. Метод setReadOnly() позволяет задать для Connection режим только для
чтения, чтобы произошла такая оптимизация. Нельзя вызывать метод setReadOnly()
во время транзакции.
nativeSQL()
public String
nativeSQL(String sql) throws SQLException
Описание.
Многие базы данных могут не поддерживать в действительности тот SQL, который
требуется для JDBC. Этот метод позволяет приложению получить «родной»
SQL базы данных для заданной строки JDBC SQL.
prepareCall()
public CallableStatement
prepareCall(String sql)
throws SQLException
public CallableStatement
prepareCall(String sql, int type, int concur) throws SQLException
Описание.
По заданной отдельной строке SQL этот метод создает объект CallableStatement,
связанный с данным сеансом Connection. Это предпочтительный способ работы с
хранимыми процедурами. Версия по умолчанию (без аргументов) создает CallableStatement,
который возвращает экземпляры ResultSet типа только для чтения с перемещением
только вперед.
prepareStatemeni()
public PreparedStatement
prepareStatement(String sql)
throws SQLException
public PreparedStatement
prepareStatement(String sql, int type, int concur) throws SQLException
Описание.
Создает объект PreparedStatement, связанный с данным сеансом Connection.
Это предпочтительный способ работы с преком-пилированными командами SQL. Версия
по умолчанию (без аргументов)
создает PreparedStatement, который возвращает экземпляры ResultSet типа только
для чтения с перемещением только вперед.
rollback
()
public void
rollback() throws SQLException
Описание.
Отменяет все изменения, произведенные командами, связанными с данным Connection
и выполненными вслед за последней командой завершения или отката. Если позднее
вы захотите произвести эти изменения, приложению придется заново выполнить все
осуществляющие их команды. Следует использовать только в режиме отключенного
автозавершения.
DatabaseMetaData
Краткий
обзор
Имя класса: java. sql. DatabaseMetaData
Надкласс:
нет
Непосредственные подклассы: нет
Реализованные интерфейсы: нет
Доступность:
введен в JDK 1.1
Описание
Этот класс
предоставляет обширную информацию о базе данных, с которой связан объект Connection.
Во многих случаях данные возвращаются в виде объектов JDBC ResultSet. Если база
данных не поддерживает метаданные некоторого типа, DatabaseMetaData возбуждает
SQLException.
Методы DatabaseMetaData
принимают в качестве аргументов строковые шаблоны, в которых специальные символы
имеют определенное значение. % соответствует любой подстроке длиной 0 или более
символов, а символ _ соответствует одному любому символу. Вместо строковых шаблонов
возможна передача null в качестве аргументов, что означает исключение критерия
аргумента из поиска.
Сводка
методов класса
public interface
DatabaseMetaData {
static public
final int bestRowTemporary;
static public
final int bestRowTransaction;
static public
final int bestRowSession;
static public
final int bestRowUnknown;
static public
final int bestRowNotPseudo;
static public
final int bestRowPseudo;
static public final int columnNoNulls;
static public final int columnNullable;
static public final int columnNullablellnknown;
static public final int importedKeyCascade;
static public final int importedKeyRestrict;
static public final int importedKeySetNull;
static public final int importedKeyNoAction;
static public final int importedKeySetDefault;
static public final int importedKeylnitiallyDeferred;
static public final int importedKeylnitiallylmmediate;
static public final int importedKeyNotDeferrable;
static public final int procedureResultUnknown;
static public final int procedureNoResult;
static public final int procedureReturnsResult;
static public final int procedureColumnUnknown;
static public final int procedureColumnln;
static public final int procedureColumnOut;
static public final int procedureColumnReturn;
static public final int procedureColumnResult;
static public final int procedureNoNulls;
static public final int procedureNullable;
static public final int procedureNullableUnknown;
static public final short tablelndexStatistic;
static public final short tablelndexClustered;
static public final short tablelndexHashech;
static public final short tablelndexOther;
static public final int typeNoNulls;
static public final int typeNullable;
static public final int typeNullablellnknown;
static public final int typePredHet;
static public final int typePredChar;
static public final int typePredBasic;
static public final int typeSearchable;
static public final int versionColumnUnknown;
static public final int versionColumnNotPseudo;
static public
final int versionColumnPseudo;
boolean allProceduresAreCallable()
throws SQLException;
boolean allTablesAreSelectable() throws SOLException;
boolean dataDefinitionCausesTransactionCommit()
throws SQLException;
boolean dataDefinitionIgnoredlnlransactions()
throws SQLException;
ResultSet getBestRowIdentifier(String
catalog,
String schema,
String table, int scope,
boolean nullable)
throws SQLException;
ResultSet getCatalogs() throws SQLException;
String getCatalogSeparator() throws SQLException;
String getCatalogTerm()
throws SQLException;
ResultSet getColumnPriveleges(String catalog, String spat. String table, String cpat) throws SQLException;
ResultSet getColumns(String catalog, String spat. String tpat, String cpat) throws SQLException;
ResultSet getCrossReference(String primaryCatalog, String primarySchema, String primaryTable, String foreignCatalog, String foreignSchema, String foreignTable) throws SQLException;
String getDatabaseProductName() throws SQLException;
String getDatabaseProductVersion()throws SQLException;
int getDefaultTransactionIsolation()throws SQLException;
int getDriverMajorVersion();
int getDriverMinorVersion();
String getDriverName() throws SQLException;
String getDriverVersion() throws SQLException;
ResultSet getExportedKeys(String
catalog,String schema,
String .table)throws
SQLException;
String getExtraNameCharacters() throws SQLException;
String getldentifierQuoteString() throws SQLException;
ResultSet getImportedKeys(String catalog,String schema, String table) throws SQLException;
ResultSet getIndex!nfo(String catalog,String schema, String table, boolean unique,boolean approximate) throws SQLException;
int getMaxBinaryLiteralLength() throws SQLException;
int getMaxCatalogNameLength() throws SQLException;
int getMaxCharLiteralLengthO throws SQLException;
int getMaxcnameLength() throws SQLException;
int getMaxColumnsInGroupBy() throws SQLException;
int getMaxColumnsInIndex() throws SQLException;
int getMaxColumns!nOrderBy() throws SQLException;
int getMaxColumnsInSelect() throws SQLException;
int getMaxColumnsInTable() throws SQLException;
int getMaxConnections() throws SQLException;
int getMaxIndexLength() throws SQLException;
int getMaxProcedureNameLength()
throws SQLException;
int getMaxRowSize() throws SQLException;
int getMaxRowSizelncludeBlobs()
throws SQLException;
int getMaxSchemaNameLength() throws SQLException;
int getMaxStatementLength() throws SQLException;
int getMaxStatements() throws SQLException;
int getMaxTableNameLength() throws SQLException;
int getMaxTablesInSelect() throws SQLException;
int getMaxUserNameLength()
throws SQLException;
String getNumericFunctions() throws SQLException;
ResultSet getPrimaryKeys(String catalog,String schema, String table) throws SQLException;
ResultSet getProcedureColumns(String catalog,String schemePattern, String procedureNamePattern,String cnamePattern) throws SQLException;
String getProcedureTerm() throws SQLException;
ResultSet getProcedures(String
catalog,String schemaPattern,
String procedureNamePattern)throws
SQLException;
public abstract ResultSet getSchemas() throws SQLException;
public abstract String getSchemaTern() throws SQLException;
String getSearchStringEscape() throws SQLException;
String getSQLKeywords() throws SQLException;
String getStringFunctions() throws SQLException;
String getSystemFunctions() throws SQLException;
ResultSet getTablePriveleges(String
catalog,String schemaPattern,
String tableNamePattern)throws
SQLException;
ResultSet getTableTypes() throws SQLException;
ResultSet getTables(String catalog,String schemaPattern, String tableNamePattern,String types[]) throws SQLException;
String getTimeDateFunctions() throws SQLException;
ResultSet getTypelnfo() throws SQLException;
String getURL() throws SQLException;
String getUserName() throws SQLException;
ResultSet getVersionColumns(String catalog,String schema, String-table) throws SQLException;
boolean isCatalogAtStart() throws SQLException;
boolean isReadOnly() throws SQLException;
boolean nullPlusNonNullIsNull() throws SQLException;
boolean nullsAreSortedHigh() throws SQLException;
boolean nullsAreSortedLow() throws SQLException;
boolean nullsAreSortedAtStart() throws SQLException;
boolean nullsAreSortedAtEnd() throws SQLException;
boolean storesLowerCaseIdentifiers()throws SQLException;
boolean storesLowerCaseQuotedIdentifiers()throws SQLException;
boolean storesMixedCaseldentifiers()throws SQLException;
boolean storesMixedCaseQuotedldentifiers()throws SQLException;
boolean storesUpperCaseldentifiers()throws SQLException;
boolean storesUpperCaseQuotedldentifiers()throws SQLException;
boolean supportsAlterTableWithAddColumn()throws SQLException;
boolean supportsAlterTableWlthDropColumn()throws
SQLException;
boolean supportsANSI92FullSQL() throws SQLException;
boolean supportsANSI92IntermediateSQL()throws SQLException;
boolean supportsCatalogsInDataManipulation()throws SQLException;
boolean suppportsCatalogsInIndexDefinitions()throws SQLException;
boolean supportsCatalogsInPrivelegeDefinitions()throws SQLException;
boolean supportsCatalogsInProcedureCalls()throws SQLException;
boolean supportsCatalogsInTableDefinitions()throws
SQLException;
boolean supportsColumnAliasing() throws SQLException;
boolean supportsConvert() throws SQLException;
boolean supportsConvert(int
fromType, int toType)throws
SQLException;
boolean supportsCoreSQLGrammar() throws SQLException;
boolean supportsCorrelatedSubqueries()throws SQLException;
boolean supportsDataDefinitionAndDataManipulationTransactions()
throws SQLException;
boolean supportsDataManipulationTransactionsOnly()
throws SQLException;
boolean supportsDifferentTableCorrelationNames()
throws SQLException;
boolean supportsExpressions!nOrderBy()
throws SQLException;
boolean supportsExtendedSQLGrammar()
throws SQLException;
boolean supportsFullOuterJoins() throws SQLException;
boolean supportsGroupBy() throws SQLException;
boolean supportsGroupByBeyondSelect()
throws SQLException;
boolean supportsGroupByUnrelated()
throws SQLException;
boolean supports!ntegrityEnhancementFacility()
throws SQLException;
boolean supportsLikeEscapeClause()
throws SQLException;
boolean supportsLimitedOuterJoins()
throws SQLException;
boolean supportsMinimumSQLGrammar()
throws SQLException;
boolean supportsMixedCaseldentifiers()
throws SQLException;
boolean supportsMixedCaseQuotedldenfitiers()
throws SQLException;
boolean supportsMultipleResultSets()
throws SQLLxception;
boolean supportsMultipleTransactions()
throws SQLException;
boolean supportsNonNullableColumns()
throws SQLException;
boolean supportsOpenCursorsAcrossCommit()
throws SQLException;
boolean supportsOpenCursorsAcrossRollback()
throws SQLException;
boolean supportsOpenStatementsAcrossCommit()
throws SQLException;
boolean supportsOpenStatementsAcrossRollback()
throws SQLException;
boolean supportsOrderByUnrelated()
throws SQLException;
boolean supportsOuterJoins() throws SQLException;
boolean supportsPositionedDelete()
throws SQLException;
boolean supportsPositionedUpdate()
throws SQLException;
boolean supportsSchemasInDataManipulation()
throws SQLException;
boolean supportsSchemasInlndexDefinitions()
throws SQLException;
boolean supportsSchemasInPrivelegeOefinitions()
throws SQLException;
boolean supportsSchemasInProcedureCalls()
throws SQLException;
boolean supportsSchemasInTableDefinitions()
throws SQLException;
boolean supportsSelectForllpdate()
throws SQLException;
boolean supportsStoredProcedures()
throws SQLException;
boolean supportsSubqueriesInComparisons()
throws SQLException;
boolean supportsSubqueriesInExists()
throws SQLException;
boolean supportsSubqueriesIn!ns()
throws SQLException;
boolean supportsSubqueriesInQuantifieds()
throws SQLException;
boolean supportsTableCorrelationNames()
throws SQLException;
boolean supportsTransactionIsolationLevel(int level)
throws SQLException;
boolean supportsTransactions() throws SQLException;
boolean supportsUnion() throws SQLException;
boolean supportsUnionAll() throws SQLException;
boolean usesLocalFilePerTable()
throws SQLException;
boolean usesLocalFiles()
throws SQLException; }
Date
Краткий
обзор
Имя класса:
java.sql.Date Надкласс: java.util.Date Непосредственные подклассы: нет Реализованные
интерфейсы: нет Доступность: JDK 1.1
Описание
Этот класс
поддерживает подмножество функций класса java. util. Date. Он ориентирован на
работу с датами, игнорируя часы, минуты и секунды.
Сводка
методов класса
public class
Date extends Java.util.Date {
static public
Date valueOf(String s);
#public Date(int
year, int month, int day);
public Date(long
date);
public void
setTime(long date);
public String
toString(); }
Методы класса
valueOf()
static public
Date valueOf(String
s)
Описание.
Получив строку String в виде yyyy-mm-dd, возвращает соответствующий экземпляр
класса Date, представляющий эту дату.
Конструкторы
объекта
Date()
public Date(long
date)
#public Date(int
year, int month, int day)
Описание.
Создает новый экземпляр Date. Правильный путь создания Date- использование
нового конструктора Date(long) из JDK1.2. Аргумент задает число миллисекунд,
прошедших с 00:00:00 GMT 1 января 1970. Отрицательное число задает количество
миллисекунд до этой даты. Второй, нерекомендованный конструктор не следует использовать,
поскольку он не учитывает календарь и часовой пояс.
Методы
объекта
setTime()
public void
setTime(long date)
Описание.
Устанавливает время, представленное объектом Date, в заданное число миллисекунд,
прошедших с 00:00:00 GMT 1 января 1970. Отрицательное число задает количество
миллисекунд до этой даты.
toString()
public String
toString()
Описание.
Возвращает строку, представляющую Date в формате yyyy-mm-dd.
Driver
Краткий обзор
Имя класса: java.sql. Driver
Надкласс:
нет
Непосредственные подклассы: нет
Реализованные интерфейсы: нет
Доступность:
JDK1.1
Описание
Класс представляет
специфическую реализацию JDBC. При загрузке Driver должен создать экземпляр
себя и зарегистрировать его в классе DriverManager. Это позволит приложениям
создавать экземпляры драйвера, вызывая для его загрузки Class. forName().
Объект Driver
позволяет приложению соединяться с одной или несколькими базами данных. Когда
поступает запрос на соединение с определенной базой данных, DriverManager передает
запрос источника данных всем драйверам, зарегистрированным как URL. Будет использован
первый Driver, который соединяется с источником данных через этот URL.
Сводка
методов класса
public interface
Driver {
boolean acceptsURL(String url) throws SQLException;
Connection connect(String
url, Properties info)
throws SQLException;
int getMajorVersion();
int getMinorVersion();
DriverPropertyInfo[]
getProperty!nfo(String url,
Properties info) throws SQLException;
boolean jdbcCompliant();
}
Методы
объекта
acceptsURL
( )
public boolean
acceptsURL(String url) throws SQLException
Описание.
Возвращает t rue, если указанный URL соответствует субпротоколу URL, который
используется этим драйвером.
connect
( )
public Connection
connect(String url, Properties info) throws SQLException
Описание.
Этот метод пытается установить соединение с использованием заданного URL
и данных Property (обычно содержащих имя пользователя и пароль). Если URL не
верен для этого драйвера, соnnect() возвращает null. Если URL правильный, но
во время соединения происходит ошибка, возбуждается SQLException.
getMajorVersion
( )
public int getMajorVersion()
Описание. Возвращает основной номер версии драйвера.
getMinorVersion(
)
public int getMinorVersion()
Описание. Возвращает дополнительный номер версии драйвера.
getPropertyInfo(
)
public DriverPropertyInfo[]
getPropertyInfo(String
url,Properties info) throws SQLException;
Описание.
Этот метод позволяет средствам RAD в графическом интерфейсе определить,
какие свойства требуются драйверу для соединения, чтобы выдать пользователю
приглашение к вводу этих свойств.
jdbcCompliant()
public boolean
jdbcCompliant()
Описание.
Этот метод возвращает true, только если проходят тесты на совместимость
с JDBC. Это означает, что реализация драйвера полностью поддерживает JDBC API
и входной уровень SQL 92.
DriverManager
Краткий обзор
Имя класса:
Java. sql. DriverManager Надкласс: Java. lang. Object Непосредственные подклассы:
нет Реализованные интерфейсы: нет
Доступность:
JDK 1.1
Описание
DriverManager
содержит главный список зарегистрированных в системе драйверов JDBC. При инициализации
он загружает все классы, указанные в свойстве jdbc. drivers. Поэтому можно задать
любую информацию времени выполнения относительно используемой приложением базы
данных в командной строке.
Во время
выполнения программы другие драйверы могут регистрироваться в DriverManager,
вызывая метод registerDriver(). DriverManager использует JDBC URL при поиске
выбранного приложением драйвера, когда запросы делаются через getConnection().
Класс DriverManager,
вероятно, прекратит свое существование, поскольку новый JDBC 2.0 Standard Extension
предоставляет значительно более дружественный способ получения соединения с
базой данных.
Сводка
методов класса
public class
DriverManager { static void deregisterDriver(Driver driver)
throws SQLException;
static public
synchronized Connection getConnection(String url, Properties info) throws SQLException;
static public synchronized Connection getConnection(String url, String user, String password) throws SQLException;
static public
synchronized Connection getConnection(String url) throws SQLException;
static public Driver getDriver(String url) throws SQLException;
static public Enumeration getDrivers();
static public int getLoginTimeout();
#static public PrintStrean getLogStream();
static public
PrintWriter getLogWriter();
static public
void println(String message);
static public
synchronized void registerDriver(Driver driver)
throws SQLException;
#static public void setl_ogStream(PrintStream out);
static public void setl_ogWriter(PrintWriter out);
static
public void setloginTimeout(int seconds); }
Методы
класса
deregisterDriver(
)
static public void deregisterDriver(Driver driver) throws SQLException
Описание. Удаляет Driver из списка зарегистрированных драйверов.
getConnection(
)
static public
synchronized Connection getConnection(String url,
Properties info)
throws SQLException static public synchronized Connection getConnection(String
url,
String user,
String password) throws SQLException static public synchronized Connection getConnection(String
url)
throws SQLException
Описание.
Устанавливает соединение с хранилищем данных, указанным в заданном URL.
OriverManager просматривает список зарегистрированных Driver в поисках соответствующего
заданному URL. Если таких драйверов не найдено, возбуждается SQLException. В
противном случае возвращается экземпляр Connection, создаваемый методом connect()
класса Driver.
getDriver(
)
static public
Driver getDriver(String url) throws SQLException
Описание.
Возвращает драйвер, который может обработать заданный URL.
getDrivers(
)
static public
Enumeration getDrivers()
Описание. Возвращает список всех зарегистрированных драйверов.
getLoginTimeout(
) and setLoginTimeout( )
static public int getLoginTimeout()
static public
int setLoginTimeout()
Описание.
Тайм-аут регистрации - максимальное время в секундах, в течение которого
драйвер ждет регистрации в базе данных.
getLogStream()
и setLogStream( )
#static public PrintStream getl_ogStream()
#static public void setLogStream(PrintStream out)
static public PrintWriter getLogWriter()
static public
void setLogWriter(PrintWriter out)
Описание.
Устанавливает поток, используемый DriverManager и всеми драйверами. Вариант
LogStream является устаревшей версией JDK 1.1, которой следует избегать.
println()
static public
void println(String message)
Описание. Выводит сообщение в текущий поток журнала.
registerDriver(
)
static public
synchronized void registerDriver(Driver driver) throws SQLException
Описание.
Позволяет вновь загруженному Driver зарегистрироваться в классе DriverManager.
DriverPropertyInfo
Краткий
обзор
Имя класса:
Java. sql. DriverPropertylnfo Надкласс: java. lang. Object Непосредственные
подклассы: нет Реализованные интерфейсы: нет Доступность: JDK 1.1
Описание
Класс предоставляет
сведения, необходимые драйверу для соединения с базой данных. Он может потребоваться
только средствам разработки приложений. У него нет методов, только список открытых
атрибутов.
Сводка
методов класса
public class
DriverPropertyInfo {
public String[]
choices;
public String
description;
public String
name;
public boolean
required;
public String
value;
public DriverPropertyInfo(String
name, String value); }
Атрибуты
объекта
choices
public String[]
choices
Описание.
Список вариантов, которые могут предоставляться пользователю для выбора
значения этого свойства. Значение может быть null.
description
public String
description
Описание. Краткое описание свойства или null.
пате
public String name
Описание.
Имя свойства.
required
public boolean
required
Описание.
Определяет обязательность задания этого свойства для установления соединения.
value
public String
value
Описание.
Текущее значение свойства или null, если значение не установлено.
Конструкторы
объекта
DriverPropertyInfо
( )
public OriverPropertyInfo(String
name, String value)
Описание.
Создает новый объект DriverPropertylnfo с атрибутами name и value, установленными
равными указанным аргументам. Все остальные атрибуты устанавливаются равными
значениям по умолчанию.
PreparedStatement
Краткий
обзор
Имя класса:
Java. sql. PreparedStatement
Надкласс:
java.sql.Statement
Непосредственные
подклассы: Java. sql. CallableStatement
Реализованные интерфейсы: нет
Доступность:
JDK1.1
Описание
Этот класс
представляет прекомпилированную команду SQL.
Сводка
методов класса
public interface PreparedStatement extends Statement {
void addBatch()
throws SQLException;
void clearParameters() throws SQLException;
boolean execute() throws SQLException;
ResultSet executeQuery() throws SQLException;
int executeUpdate() throws SQLException;
ResultSetMetaData getMetaData() throws SQLException;
void setArray(int index, Array arr)throws SQLException;
void setAsciiStream(int index, InputStream is,int length) throws SQLException;
void setBigDecimal(int index, BigDecimal d)throws SQLException;
void setBinaryStream(int index, InputStream is,int length) throws SQLException;
void setBlob(int
index, Blob b) throws SQLException; void setBoolean(int index, boolean b)throws
SQLException;
void setByte(int index, byte b) throws SQLException; void setBytes(int index, byte[] bts)throws SQLException;
void setCharacterStream(int index, Reader rdr,int length) throws SQLException;
void setClob(int index, Clob c) throws SQLException;
void setDate(int index, Date d) throws SQLException;
void setDate(int
index, Date d, Calendar cal)throws
SQLException; void setDouble(int index, double x)throws
SQLException;
void setFloat(int index, float f) throws SQLException;
void setlnt(int index, int x) throws SQLException;
void setLong(int index, long x) throws SQLException;
void setNull(int index, int type) throws SQLException;
void setNull(int index, int type, String tname)throws SQLException;
void setObject(int index, Object ob)throws SQLException;
void setObject(int index, Object ob, int type)throws SQLException;
void setObject(int
index, Object ob, int type,
int scale) throws
SQLException;
void setRef(int index, Ref ref) throws SQLException;
void setShort(int index, short s) throws SQLException;
void setString(int
index, String str)throws
SQLException;
void setTime(int index, Time t) throws SQLException;
void setTime(int index, Time t, Calendar cal)throws SQLException;
void setTimestamp(int index, Timestamp ts)throws SQLException;
void setTimestamp(int index, Timestamp ts, Calendar cal)throws SQLException;
void setUnicodeStream(int
index, InputStream is,int
length) throws SQLException; }
Методы
объекта
addBatch()
public void
addBatch() throws SQLException
Описание.
Добавляет к пакету набор параметров для пакетной обработки.
clearParameters(
)
public abstract
void clearParameters() throws SQLException
Описание.
Будучи установленным, значение параметра остается предельным, пока не будет
установлено новое значение или вызван метод clearParameters(). Этод метод удаляет
все параметры, связанные с PreparedStatement.
execute(
), executeQuery( ) и executeUpdate()
public abstract boolean executeO throws SQLException
public abstract ResultSet executeQueryO throws SQLException
public abstract
int executeUpdateO throws SQLException
Описание.
Выполняет PreparedStatement. Первый метод, execute(), позволяет выполнить
PreparedStatement, если вам неизвестно, запрос это или обновление. Возвращает
true, если команда возвратила результирующий набор для обработки.
Метод executeQuery()
используется для выполнения запросов. Он возвращает результирующий набор для
обработки.
Команда executeUpdate()
используется для осуществления обновлений. Она возвращает число обновленных
строк.
getMetaData()
public ResultSetMetaData
getMetaOata() throws SQLException;
Описание.
Возвращает число, типы, а также свойства колонок объекта ResultSet.
set
Array (), setAsciiStrearn ( ), setBigDecimal( ), setBlnary Sir earn (), setBlob(),
setBoolean( ), setByte(), setBytes( ), setCharacterStream( ), setClob(), setDate(),
setDouble(), setFloat(), setlnt(), setLong(), setNull(), setObject(), setRef(),
setShort(), setString(), setTime(), setTimestamp() и setUnicodeStream( )
public void setArray(int index, Array arr)throws SQLException
public void setAsciiStream(int
index, InputStream is,int
length) throws SQLException public void setBigOecimal(int index, BigDecimal
d)
throws SQLException
public void setBinaryStream(int index, InputStream is,
int length)
throws SQLException public void setBlob(int index, Blob b)
throws SQLException
public void setBoolean(int index, boolean b)
throws SQLException
public void setByte(int index, byte b)
throws SQLException
public void setBytes(int index, byte[ ] bts)
throws SQLException
public void setCharacterStream(int index, Reader rdr,
int length)
throws SQLException public void setClob(int index, Clob c)
throws SQLException
public void setDate(int index, Date d)
throws SQLException
public void setDate(int index, Date d, Calendar cal)
throws SQLException
public void setDouble(int index, double d)
throws SQLException
publio void setFloat(int index, float f)
throws SQLException
public void setlnt(int index, int x)
throws SQLException
public void setLong(int index, long x)
throws SQLException
public void setNull(int index, int type)
throws SQLException
public void setNull(int index, int type, String tname)
throws SQLException
public void setObject(int index, Object ob)
throws SQLException
public void setObject(int index, Object ob, int type)
throws SQLException
public void setObject(int index, Object ob, int type,
int scale) throws
SQLException
public void
setRef(int index, Ref ref)
throws SQLException
public void setShort(int index, short s)
throws SQLException
public void setString(int index, String str)
throws SQLException
public void setTime(int index, Tine t)
throws SQLException
public void setTime(int index, Time t, Calendar cal)
throws SQLException
public void setTimestamp(int index, Timestamp ts)
throws SQLException
public void setTimestamp(int index, Timestamp ts,
Calendar cal)
throws SQLException «public void setUnicodeStream(int index, InputStream
is,
int length)
throws SQLException
Описание.
Привязывает значение к указанному параметру.
Ref
Краткий
обзор
Имя класса: java.sql.Ref
Надкласс;
нет
Непосредственные подклассы: нет
Реализованные интерфейсы: нет
Доступность:
введен в JDK 1.2
Описание
Ref является
ссылкой на величину структурированного типа SQL в базе данных. Разрешить ссылку
Ref можно путем передачи ее в качестве параметра команде SQL и выполнением этой
команды.
Сводка
методов класса
public interface
Ref {
String getBaseTypeName()
throws SQLException; }
Методы
объекта
getBaseTypeName(
)
public String
getBaseTypeName() throws SQLException
Описание.
Возвращает имя структурированного типа SQL объекта, на который ссылается.
ResultSet
Краткий обзор
Имя класса: Java. sql. ResultSet
Надкласс:
нет
Непосредственные подклассы: нет
Реализованные интерфейсы: нет
Доступность:
JDK1.1
Описание
Этот класс
представляет результирующий набор базы данных. Он обеспечивает приложению построчный
доступ к результатам запросов в базе данных. Во время обработки запроса ResultSet
поддерживает указатель на текущую обрабатываемую строку. Приложение последовательно
перемещается по результатам, пока они не будут все обработаны или не будет закрыт
ResultSet. Объект ResultSet закрывается автоматически, если создавший его Statement
закрывается, выполняется снова или используется для извлечения следующего ResultSet
в запросе с множественными результирующими наборами.
Сводка
методов класса
public interface ResultSet { static public final int CONCUR_READ_ONLY;
static public final int CONCUR_UPDATABLE;
static public final int FETCH_FORWARD;
static public final int FETCH_REVERSE;
static public final int FETCH_UNKNOWN;
static public final int TYPE_FORWARD_ONLY;
static 'public final int TYPE_SCROLL_INSENSITIVE;
static public final int TYPE_SCROLL_SENSITIVE;
boolean absolute(int row) throws SQLException;
void Pafterl_ast() throws SQLException;
void beforeFirst() throws SQLException;
void cancelRowUpdates() throws SQLException;
void clearWarnings() throws SQLException;
void close() throws SQLException;
void deleteRow() throws SQLException;
int findColumn(String cname) throws SQLException;
boolean first() throws SQLException;
Array getArray(int index) throws SQLException;
Array getArray(String cname) throws SQLException;
InputStream getAsciiStream(int index)throws SQLException;
InputStream getAsciiStream(String cname)throws SQLException;
InputStream getBinaryStream(int index)throws SQLException;
InputStream getBinaryStream(String cname)throws SQLException;
BigDecimal getBigDecimal(int index)throws SQLException;
#BigDecimal getBigDecimal(int index, int scale)throws SQLException;
BigDecimal getBigDecimal(String
cname)throws SQLException;
#BigDecimal getBigDecimal(String cname, int scale)throws SQLException;
InputStream getBinaryStream(int index)throws SQLException;
InputStream getBinaryStream(String
cname)throws SQLException;
Blob getBlob(int index) throws SQLException;
Blob getBlob(String cname) throws SQLException;
boolean getBoolean(int index) throws SQLException;
boolean getBoolean(String cname) throws SQLException;
byte getByte(int index) throws SQLException;
byte getByte(String cname) throws SQLException;
byte[] getBytes(int index) throws SQLException;
byte[] getBytes(String cname) throws SQLException;
Reader getCharacterStream(int index)throws SQLException;
Reader getCharacterStream(String
cname)throws SQLException;
Clob getClob(int index) throws SQLException;
Clob getClob(String cname) throws SQLException;
int getConcurrency() throws SQLException;
String getCursorName() throws. SQLException;
Date getDate(int index) throws SQLException;
Date getDate(int
index, Calendar cal)throws
SQLException;
Date getDate(String cname) throws SQLException;
Date getDate(String
cname, Calendar cal)throws
SQLException;
double getDouble(int index) throws SQLException;
double getDouble(String cname) throws SQLException;
int getFetchDirection() throws SQLException;
int getFetchSize() throws SQLException;
float getFloat(int index) throws SQLException;
float getFloat(String cname) throws SQLException;
int getInt(int index) throws SQLException;
int getInt(String cname) throws SQLException;
long getLong(int index) throws SQLException;
long getLong(String cname) throws SQLException;
ResultSetMetaData getMetaData() throws SQLException;
Object getObject(int
index) throws SQLException;
Object getObject(int
index, Map map)throws
SQLException;
Object getObject(String cname) throws SQLException;
Object getObject(String
cname, Map map)throws
SQLException;
Ref getRef(int index) throws SQLException;
Ref getRef(String cname) throws SQLException;
int getRow() throws SQLException;
short getShort(int index) throws SQLException;
short getShort(String cname) throws SQLException;
Statement getStatement() throws SQLException;
String getString(int index) throws SQLException;
String getString(String cname) throws SQLException;
Time getTime(int index) throws SQLException;
Time getTime(int
index, Calendar cal)throws
SQLException;
Time getTime(String cname) throws SQLException;
Time getTime(String
cname, Calendar cal)throws
SQLException;
Timestamp getTimestamp(int index) throws SQLException;
Timestamp getTimestamp(int
index, Calendar cal)throws
SQLException;
Timestamp getTimestamp(String cname) throws SQLException;
Timestamp getTimestamp(String cname, Calendar cal)throws SQLException;
int getType() throws SQLException;
#InputStream getUnicodeStream(int index)throws SQLException;
#InputStream
getUnicodeStream(String cname)throws
SQLException;
SQLWarning getWarnings() throws SQLException;
void insertRow() throws SQLException;
boolean isAfteriast() throws SQLException;
boolean isBeforeFirst() throws SQLException;
boolean isFirst() throws SQLException;
boolean isLast() throws SQLException;
boolean last() throws SQLException;
void moveToCurrentRow() throws SQLException;
void moveToInsertRow() throws SQLException;
boolean next() throws SQLException;
boolean previous() throws SQLException;
void refreshRow() throws SQLException;
boolean relative(int rows) throws SQLException;
boolean rowDeleted() throws SQLException;
boolean rowlnserted() throws SQLException;
boolean rowllpdated() throws SQLException;
void setFetchDirection(int dir) throws SQLException;
void setFetchSize(int rows) throws SQLException;
void updateAsciiStream(int index, InputStream is,int length) throws SQLException;
void updateAsciiStream(String cname, InputStream is,int length) throws SQLException;
void updateBigDecimal(int index, BigDecimal d)throws SQLException;
void updateBigDecimal(String cname, BigDecimal d)throws SQLException;
void updateBinaryStream(int index, InputStream is)throws SQLException;
void updateBinaryStream(String cname, InputStrean is)throws SQLException;
void updateBoolean(int index, boolean b)throws SQLException;
void updateBoolean(String cname, boolean b)throws SQLException;
void updateByte(int index, byte b)throws SQLException;
void updateByte(String cname, byte b)throws SQLException;
void updateBytes(int index, byte[] bts)throws SQLException;
void updateBytes(String cname, byte[] bts)throws SQLException;
void updateCharacterStream(int index, Reader rdr,int length) throws SQLException;
void updateCharacterStream(String cname, Reader rdr,int length) throws SQLException;
void updateDate(int index, Date d)throws SQLException;
void updateOate(String cname, Date d)throws SQLException;
void updateDouble(int index, double d)throws SQLException;
void updateDouble(String cname, double d)throws SQLException;
void updateFloat(int index, float f)throws SQLException;
void updateFloat(String
cname, float f)throws
SQLException;
void updateInt(int index, int x) throws SQLException;
void updateInt(String cname, int x)throws SQLException;
void updateLong(int index, long x)throws SQLException;
void updateLong(String
cname, long x)throws
SQLException;
void updateNull(int index) throws SQLException;
void updateNull(String cname) throws SQLException;
void updateObject(int
index, Object ob)throws
SQLException;
void updateObject(int index, Object ob, int scale);
void updateObject(String
cname, Object ob)throws
SQLException;
void updateObject(String cname, Object ob, int scale)throws SQLException;
void updateRow() throws SQLException;
void updateShort(int index, short s)throws SQLException;
void updateShort(String cname, short s)throws SQLException;
void updateString(int index, String str)throws SQLException;
void updateString(String cname, String str)throws SQLException;
void updateTime(int index, Time t)throws SQLException;
void updateTime(String cname, Time t)throws SQLException;
void updateTimestamp(int index, Timestamp ts)throws SQLException;
void updateTimestamp(String cname, Timestamp ts)throws SQLException;
boolean wasNull()
throws SQLException; }
Атрибуты
класса
CONCUR_READ_ONLY
static public
final int CONCUR_READ_ONLY
Описание.
Режим доступа, означающий, что результирующий набор нельзя обновлять.
CONCUR_UPDATABLE
static public
final int CONCUR_UPDATABLE
Описание.
Режим доступа, означающий, что результирующий набор можно обновлять.
FETCH_FORWARD
static public
final int FETCH_FORWARD
Описание.
Определяет выборку данных в прямом направлении, от первой записи к последней.
FETCH_REVERSE
static public
final int FETCH_REVERSE
Описание.
Определяет выборку данных в обратном направлении, от последней записи к
первой.
FETCH_UNKNOWN
static public
-final int FETCH_UNKNOWN
Описание.
Эта величина показывает, что направление обработки данных результирующего
набора неизвестно.
TYPE_FORWARD_ONLY
Static public
final int TYPE_FORWARD_ONLY
Описание.
Результирующий набор этого типа допускает перемещение только в прямом направлении.
TYPE_SCROLL_INSENSITIVE
Static public
final int TYPE_SCROLL_INSENSITIVE
Описание.
Результирующий набор этого типа допускает перемещение в любом направлении,
но изменения, сделанные другими пользователями, невидимы.
TYPE_SCROLL__SENSITIVE
static public
final int TYPE_SCROLL_SENSITIVE
Описание.
Результирующий набор этого типа допускает перемещение в любом направлении,
при этом показываются изменения, сделанные другими пользователями.
Методы
объекта
absolute
()
public boolean
absolute(int row) throws SQLException
Описание.
Метод перемещает курсор на заданное число строк от начала, если число положительно,
и от конца - если отрицательно.
afterLast(
)
public void
afterLast() throws SQLException
Описание.
Этот метод перемещает курсор в конец результирующего набора за последнюю
строку.
beforeFirst(
)
public void
beforeFirst() throws SQLException
Описание.
Этот метод перемещает курсор в начало результирующего набора перед первой
строкой.
cancelRowUpdates()
public void cancelRowUpdates() throws SQLException
Описание. Отменяет обновления, сделанные в данной строке.
clearWarnings
( )
public void
clearWarnings() throws SQLException
Описание.
Удаляет все предупреждения из цепочки SQLWarning. Последующие обращения
к getWarnings() возвращают null, пока не возникнет новое предупреждение.
close
()
public void
close() throws SQLException
Описание.
Осуществляет немедленное закрытие ResultSet вручную. Обычно этого не требуется,
так как закрытие Statement, связанного с ResultSet, автоматически закрывает
ResultSet.
deleteRow(
)
public void
deleteRow() throws SQLException
Описание.
Удаляет текущую строку из результирующего набора и базы данных.
findColumn(
)
public int findColumn(String cname) throws SQLException
Описание. Метод возвращает номер колонки с заданным именем.
first()
public boolean
first() throws SQLException
Описание.
Перемещает курсор на первую строку результирующего набора.
getAsciiStream(),
getBinaryStream(), getCharacterStream() и getUnicodeStream()
public InputStream
getAsciiStream(int index)
throws SQLException
public InputStream getAsciiStream(String cnane)
throws SQLException
public InputStream getBinaryStream(int index)
throws SQLException
public InputStream getBinaryStream(String cname)
throws SQLException
public Reader getCharacterStream(int index)
throws SQLException
public ReadeT getCharacterStream(String cname)
throws SQLException
#public InputStream getUnicodeStream(int index)
throws SQLException
#public InputStream getUnicodeStream(String cname)
throws SQLException
Описание.
В некоторых случаях удобнее извлекать из базы большие порции данных с помощью
входного потока Java InputStream. Эти методы позволяют приложению извлекать
данные установленной колонки текущей строки указанным способом. Заметьте, что
устаревшему методу getUnicodeStream() следует предпочесть метод
getCharacterStream().
getArray(),
getBlob(), getBoolean(), getByte(), getBytes(), getClob(), getDate(), getDouble(),
getFloat(), getlnt(), getLong(), getRef(), getShort(),getString(),getTime()ugetTimestamp()
public Array getArray(int index) throws SQLException
public Array getArray(String cname) throws SQLException
public Blob getBlob(int index) throws SQLException
public Blob getBlob(String cname) throws SQLException
public boolean getBoolean(int index) throws SQLException
public boolean getBoolean(String cname) throws SQLException
public byte getByte(int index) throws SQLException
public byte getByte(String cname) throws SQLException
public byte[] getBytes(int index) throws SQLException
public byte[] getBytes(String cname) throws SQLException
public Clob getClob(int index) throws SQLException
public Clob getClob(String cname) throws SQLException
public Date getOate(int index) throws SQLException
public Date getDate(String cname) throws SQLException
public double getDouble(int index) throws SQLException
public double getDouble(String cname) throws SQLException
public float getFloat(int index) throws SQLException
public float getFloat(String cname) throws SQLException
public int getlnt(int index) throws SQLException
public int get!nt(String cname) throws SQLException
public long getLong(int index) throws SQLException
public long getLong(String cname) throws SQLException
public Ref getRef(int index) throws SQLException
public Ref getRef(String cname) throws SQLException
public short getShort(int index) throws SQLException
public short getShort(String cname) throws SQLException
public String getString(int index) throws SQLException
public String getString(String cname) throws SQLException
public Time getTime(int index) throws SQLException
public Time getTime(String cname) throws SQLException
public Timestamp
getTimestamp(int index)
throws SQLException
public Timestamp getTimestamp(String cname)
throws SQLException
Описание.
Эти методы возвращают значение заданной колонки текущей строки с типом данных,
соответствующим имени метода.
getConcurrency(
) и setConcurrencyf )
public int getConcurrency()
throws SQLException
Описание.
Эти методы служат для получения и установления режима доступа к данным результирующего
набора. Начальное значение определяется командой, породившей результирующий
набор.
getCursorName(
)
public String
getCursorName() throws SQLException
Описание.
Некоторые базы данных допускают позиционируемые обновления,
для их выполнения приложению требуется имя курсора, связанного с ResultSet.
Данный метод предоставляет имя курсора.
getMetaData(
)
public ResultSetMetaData
getMetaData() throws SQLException
Описание.
Предоставляет объект метаданных для данного ResultSet.
getFetchDirection(),
setFetchDirection( ), getFetchSize() и setFetchSize()
public int getFetchDirection()
throws SQLException
public void
setFetchDirection(int dir) throws SQLException
public int getFetchSize()
throws SQLException
public void
setFetchSize(int rows) throws SQLException
Описание.
Эти методы предоставляют драйверу данные, способные помочь оптимизации.
Использовать их драйвер не обязан. Драйверу предлагается при каждом извлечении
данных из базы выбирать указанное количество строк (fetch size). Направление
(direction) подсказывает драйверу, в каком направлении вы собираетесь
перемещаться.
getObject()
public Object getObject(int index) throws SQLException
public Object
getObject(int index, Map map)throws
SQLException
public Object getObject(String cname) throws SQLException
public Object
getObject(String cname, Map map)throws
SQLException
Описание.
Возвращает значение заданной колонки текущей строки как объект Java. Возвращаемый
тип будет Java-объектом, наиболее соответствующим SQL-типу колонки. Полезно
использовать для колонок со специфическими типами конкретной базы данных.
getRow(
)
public int getRow() throws SQLException
Описание.
Возвращает номер текущей строки.
getStatement()
public Statement
getStatement() throws SQLException
Описание.
Возвращает экземпляр Statement, который произвел данный результирующий набор.
getType()
public int getType()
throws SQLException
Описание.
Возвращает тип данного результирующего набора.
getWarnings()
public SQLWarning
getWarnings() throws SQLException
Описание.
Возвращает первый объект SQLWarning в цепочке предупреждений.
insertRow(
)
public void
insertRow() throws SQLException
Описание.
Вставляет содержимое строки в результирующий набор и базу данных.
isAfterLast(
)
public boolean
isAfterLast() throws SQLException
Описание.
Возвращает true, если результирующий набор позиционирован за его последней
строкой.
isBeforeFirst(
)
public boolean
isBeforeFirst() throws SQLException
Описание.
Возвращает true, если результирующий набор позиционирован перед первой строкой.
isFirst()
public boolean
isFirst() throws SQLException
Описание.
Возвращает true, если результирующий набор позиционирован на первой строке.
isLast(
)
public boolean
isLast() throws SQLException
Описание.
Возвращает true, если результирующий набор позиционирован на последней строке.
last
()
public boolean
last() throws SQLException
Описание.
Перемещает курсор на последнюю строку результирующего набора.
moveToCurrent
Row( )
public void
moveToCurrentRow() throws SQLException
Описание.
Перемещает курсор на текущую строку. Выполняется после вставки строки.
moveTo!nsertRow(
)
public void
moveToInsertRow() throws SQLException
Описание.
Перемещает курсор на вновь вставляемую строку. Для возврата к текущей строке
нужно вызвать moveToCurrentRow().
next()
uprevious( )
public boolean next() throws SQLException
public boolean
previous() throws SQLException
Описание.
Эти методы позволяют переместиться в результирующем наборе на одну строку
вперед или назад. Во вновь созданном результирующем наборе курсор устанавливается
перед первой строкой, поэтому первое обращение к методу next() влечет позиционирование
на первую строку. Эти методы возвращают true, если остается строка для дальнейшего
перемещения. Если строк для обработки больше нет, возвращается false. Если открыт
поток InputStream для предыдущей строки, он закрывается. Также очищается цепочка
предупреждений SQLWarning.
refreshRow(
)
public void
refreshRow() throws SQLException
Описание.
Обновляет данные текущей строки самыми новыми данными из базы.
relative(
)
public boolean
relative(int rows) throws SQLException
Описание.
Перемещает курсор вперед или назад на заданное число строк. Положительное
число указывает на перемещение вперед, а отрицательное — на перемещение назад.
rowDeleted(),
rowlnserted() и rowUpdated()
public boolean rowDeleted() throws SQLException
public boolean rowlnserted() throws SQLException
public boolean
rowUpdated() throws SQLException
Описание.
Возвращают true, если текущая строка удалена, вставлена или обновлена.
updateAsciiStreamf
), updateBigDecimal( ), updateBinaryStream( ), updateBoolean(), updateByte(),
updateBytes(), updateCharacterStreamf ), updateDate(), updateDouble(), updateFloat(),
updatelntf ), updateLong(),
updateNull( ), updateObject(), updateShort( ), updateString(), updateTime( )
и updateTimestampf )
public void updateAsciiStream(int index, InputStream is,int length) throws SQLException
public void updateAsciiStream(String cname, InputStream is,int length) throws SQLException
public void updateBigDecimal(int
index, BigDecimal d)
throws SQLException
public void updateBigDecimal(String cname, BigDecimal d)
throws SQLException
public void updateBinaryStream(int index, InputStream is)
throws SQLException
public void updateBinaryStream(String cname, InputStream is)
throws SQLException
public void updateBoolean(int index, boolean b)
throws SQLException
public void updateBoolean(String cname, boolean b)
throws SQLException
public void updateByte(int index, byte b)
throws SQLException
public void updateByte(String cname, byte b)
throws SQLException
public void updateBytes(int index, byte[] bts)
throws SQLException
public void updateBytes(String cname, byte[] bts)
throws SQLException public void updateCharacterStream(int index, Reader rdr,int length) throws SQLException
public void updateCharacterStream(String
cname, Reader rdr,
int length)
throws SQLException public void updateDate(int index, Date d)
throws SQLException
public void updateDate(String cname, Date d)
throws SQLException
public void updateDouble(int index, double d)
throws SQLException
public void updateDouble(String cname, double d)
throws SQLException
public void updateFloat(int index, float f)
throws SQLException
public void updateFloat(String cname, float f)
throws SQLException
public void updateInt(int index, int x)
throws SQLException
public void updatoInt(String cname, int x)
throws SQLException
public void updateLong(int index, long x)
throws SQLException
public void updateLong(String cname, long x)
throws SQLException
public void updateNull(int index)
throws SQLException public void updateNull(String cname)
throws SQLException
public void updateObject(int index, Object ob)
throws SQLException
public void updateObject(int index, Object ob, int scale)
throws SQLException
public void updateObject(String cname, Object ob)
throws SQLException
public void updateObject(String cname, Object ob, int scale)
throws SQLException
public void updateShort(int index, short s)
throws SQLException
public void updateShort(String cname, short s)
throws SQLException
public void updateString(int index, String str)
throws SQLException
public void updateString(String cname, String str)
throws SQLException
public void updateTime(int index, Time t)
throws SQLException
public void updateTime(String cname, Time t)
throws SQLException
public void updateTimestamp(int index, Timestamp ts)
throws SQLException
public void updateTimestamp(String cname, Timestamp ts)
throws SQLException
Описание.
Эти методы обновляют значения в колонках текущей строки, если результирующий
набор допускает обновления. Закончив обновление строки, вы можете вызвать insertRow()
или update Row(), чтобы сохранить изменения в базе данных.
updateRow(
)
public void
updateRow() throws SQLException
Описание.
Обновляет базу данных изменениями, сделанными в текущей строке.
wasNull(
)
public boolean
wasNull() throws SQLException
Описание.
Возвращает true, если значение последней прочитанной колонки было null;
в противном случае возвращает false.
ResultSetMetaData
Краткий обзор
Имя класса: Java. sql. ResultSetMetaData
Надкласс:
нет
Непосредственные подклассы: нет
Реализованные интерфейсы: нет
Доступность:
JDK 1.1
Описание
Этот класс
предоставляет метаданные о типах и свойствах колонок в экземпляре ResultSet.
Сводка
методов класса
public interface ResultSetMetaData {
static public final int columnNoNulls;
static public final int columnNullable;
static public final int columnNullableUnknown;
String getCatalogName(int index)throws SQLException;
String getColumnClassName(int
index)throws SQLException;
public int getColumnCount() throws SQLException;
public int getColumnDisplaySize(int index)throws SQLException;
public String getColumnLabel(int index) throws SQLException;
public String
getColumnName(int index)throws
SQLException;
public int getColumnType(int index) throws SQLException;
public String
getColumnTypeName(int index)throws
SQLException;
public int getPrecision(int index) throws SQLException;
public int getScale(int index) throws SQLException;
public String getSchemaName(int index)throws SQLException;
public String getTableName(int index)throws SQLException;
public boolean isAutoIncrement(int index)throws SQLException;
public isCaseSensitive(int index)throws SQLException;
public boolean isCurrency(int index)throws SQLException;
public boolean
isDefinitelyWritable(int index)throws
SQLException;
public int isNullable(int index) throws SQLException;
public boolean isReadOnly(int index)throws SQLException;
public boolean
isSearchable(int index)throws
SQLException;
public boolean isSigned(int index) throws SQLException;
public boolean
isWritable(int index)throws
SQLException; }
Атрибуты
класса
columnNoNulls
static public
final int columnNoNulls
Описание.
В рассматриваемой колонке недопустимы значения NULL.
columnNullable
static public
final int columnNullable
Описание.
В рассматриваемой колонке допустимы значения NULL.
columnNullableUnknown
static public
final int columnNullableUnknown
Описание.
Неизвестно, допустимы ли значения NULL в рассматриваемой колонке.
Методы
объекта
getCatalogName(
)
public String
getCatalogName(int index) throws SQLException
Описание.
Возвращает имя каталога, связанного с таблицей, в которой находится заданная
колонка.
getColumnClassName(
)
public String
getColumnClassName(int index) throws SQLException
Описание.
Возвращает полностью квалифицированное имя класса Java, который будет создан
при вызове ResultSet. getObject() для заданной колонки.
getColumnCount(
)
public int getColumnCount()
throws SQLException
Описание.
Возвращает количество колонок в результирующем наборе.
getColumnDisplaySize(
)
public int getColumnDisplaySize(int
column) throws SQLException
Описание.
Возвращает максимальную ширину вывода данных колонки.
getColumnLabel(
)
public String
getColumnLabel(int column) throws SQLException
Описание.
Возвращает заголовок, с которым выводится колонка.
get
ColumnName( )
public String
getcname(int column) throws SQLException
Описание.
Возвращает имя, под которым колонка хранится в базе данных.
getColumnType(
)
public int getColumnType(int
-column) throws SQLException
Описание.
Возвращает SQL-тип заданной колонки как значение из java.sql.Types.
getColumnTypeName(
)
public String.
getColumnTypeName(int column) throws SQLException
Описание.
Возвращает имя SQL-типа заданной колонки. getPrecision( )
public int getPrecision(int
column) throws SQLException
Описание.
Возвращает число десятичных знаков для заданной колонки.
get
Scale ()
public int getScale(int
column) throws SQLException
Описание.
Возвращает число десятичных знаков правее десятичной точки для заданной
колонки.
getSchemaName(
)
public String getSchemaName(int column) throws SQLException
Описание. Возвращает имя схемы таблицы с заданной колонкой.
getTableName(
)
public String getTableName(int column) throws SQLException
Описание. Возвращает имя таблицы с заданной колонкой.
isAuto!ncrement(
)
public boolean
isAuto!ncrement(int column) throws SQLException
Описание.
Возвращает true, если числовое значение колонки устанавливается автоматически
и поэтому доступно только для чтения.
isCaseSensitive(
)
public boolean
isCaseSensitive(int column) throws SQLException
Описание.
Возвращает true, если верхний или нижний регистр данных в колонке имеет
значение.
isCurrency()
public boolean
isCurrency(int column) throws SQLException
Описание.
Возвращает true, если в заданной колонке представлены денежные значения.
isDefinitelyWritable(
)
public boolean
isDefinitelyWritable(int column) throws SQLException
Описание.
Возвращает true, если запись в данную колонку наверняка будет успешной.
IsNullable()
public int isNullable(int
column) throws SQLException
Описание.
Возвращает true, если в данной колонке допустимы значения null.
isReadOnly()
public boolean
isReadOnly(int column) throws SQLException
Описание.
Возвращает true, если колонка имеет тип только для чтения.
isSearchable(
)
public boolean
isSearchable(int column) throws SQLException
Описание.
Возвращает t rue, если колонка может быть использована в предложении WHERE.
isSigned(
)
public boolean
isSigned(int column) throws SQLException
Описание.
Возвращает true, если колонка содержит число со знаком.
isWritable(
)
public boolean
isWritable(int column) throws SQLException
Описание.
Возвращает true, если запись в колонку может оказаться успешной.
Statement
Краткий
обзор
Имя класса:
java. sql. Statement
Надкласс:
нет
Непосредственные
подклассы: java. sql. PreparedStatement
Реализованные
интерфейсы: нет Доступность: JDK 1.1
Описание
Класс представляет
встроенную команду SQL и используется приложением для доступа к базе данных.
При закрытии Statement автоматически закрываются все связанные с ним открытые
объекты ResultSet.
Сводка
методов класса
public interface
Statement { void addBatch(String sql) throws SQLException; void cancel() throws
SQLException; void clearBatch() throws SQLException; void clearWarnings() throws
SQLException; void close() throws SQLException; boolean execute(String sql)
throws SQLException; int[] executeBatch() throws SQLException; ResultSet executeQuery(String
sql)
throws SQLException;
int executeUpdate(String sql) throws SQLException;
Connection getConnection() throws SQLException;
int getFetchDirection() throws SQLException;
int getFetchSize() throws SQLException;
int getMaxFieldSize() throws SQLException;
int getMaxRows() throws SQLException;
boolean getMoreResults() throws SQLException;
int getQueryTimeout() throws SQLException;
ResultSet getResultSet() throws SQLException;
int getResultSetConcurrency() throws SQLException;
int getResultSetType() throws SQLException;
int getUpdateCount() throws SQLException;
SQLWarning getWarnings() throws SQLException;
void setCursorName(String name) throws SQLException;
void setEscapeProcessing(boolean
enable)throws SQLException;
void setFetchDirection(int dir) throws SQLException;
void setFetchSize(int rows) throws SQLException;
void setMaxFieldSize(int max) throws SQLException;
void setMaxRows(int max) throws SQLException;
void setQueryTimeout(int
seconds)throws SQLException;
}
Методы
объекта
addBatch()
public void
addBatch(String sql) throws SQLException
Описание.
Добавляет заданную команду SQL к текущему пакету команд.
сапсеl(
)
public void
cancel() throws SQLException
Описание.
В многопоточной среде с помощью этого метода можно потребовать прекращения
всякой обработки, связанной с данным Statement. В этом смысле метод аналогичен
методу stop() для объектов Thread.
clearBatch()
public void clearBatch() throws SQLException
Описание. Удаляет все команды пакета.
clearWarnings()
и getWarnings( )
public void clearWarnings() throws SQLException
public SQLWarning
getWarnings() throws SQLException
Описание.
Метод clearWarnings() позволяет удалить все предупреждения из цепочки, связанной
с данным классом. getWarnings() возвращает первое предупреждение в цепочке.
Все последующие предупреждения в цепочке можно получить, извлекая первое.
close
()
public void
close() throws SQLException
Описание.
Вручную закрывает объект Statement. Обычно этого не требуется, так как Statement
автоматически закрывается при закрытии связанного с ним объекта Connection.
execute(),
executeQuery() и executeUpdate( )
public boolean execute(String sql) throws SQLException
public ResultSet executeQuery(String sql) throws SQLException
public int executeUpdate(String
sql) throws SQLException
Описание.
Выполняет Statement, передавая базе данных заданную SQL-строку. Первый метод,
execute(), позволяет вам выполнить Statement, когда неизвестно заранее, является
SQL-строка запросом или обновлением. Метод возвращает true, если команда создала
результирующий набор.
Метод executeQuery()
используется для выполнения запросов (на извлечение данных). Он возвращает для
обработки результирующий набор.
Метод executeUpdate()
используется для выполнения обновлений. Он возвращает количество обновленных
строк.
executeBatch(
)
public int[
] executeBatch(String sql) throws SQLException
Описание.
Посылает базе данных пакет SQL-команд для выполнения. Возвращает массив
чисел, описывающих количество строк, затронутых каждой командой SQL.
getConnection(
)
public Connection
getConnection() throws SQLException
Описание.
Возвращает объект Connection, связанный с данным Statement.
getFetchDirection(),
setFetchDirection( ), getFetchSize( ) и setFetchSizef)
public int getFetchDirection()
throws SQLException
public void
setFetchDirection(int dir) throws SQLException
public int getFetchSize()
throws SQLException
public void
setFetchSize(int rows) throws SQLException
Описание.
Эти методы предоставляют драйверу данные, помогающие оптимизации. Использовать
их драйвер не обязан. Драйверу предлагается при каждом извлечении данных из
базы выбирать указанное количество строк (fetch size). Направление (direction)
подсказывает драйверу, в каком направлении вы собираетесь перемещаться.
getMaxFieldSize()
и setMaxFieldize( )
public int getMaxFieldSize()
throws SQLException
public void
setMaxFieldSize(int max) throws SQLException
Описание.
Эти методы поддерживают работу с атрибутом максимального размера поля, определяющим
максимальный размер данных для значений в колонках типов BINARY, VARBINARY,
LONGVARBINARY, CHAR, VARCHAR и LONGVARCHAR. При превышении пределов излишки
отбрасываются без сообщений.
getMaxRows(
) и setMaxRows()
public int getMaxRows()
throws SQLException
public void
setMaxRows(int max) throws SQLException
Описание.
Эти методы поддерживают работу с атрибутом максимально допустимого числа
строк в объекте ResultSet. При превышении этого числа лишние строки отбрасываются
без сообщений.
getMoreResults(
)
public boolean
getMoreResults() throws SQLException
Описание.
Этот метод перемещает к следующему результату и возвращает true, если этот
результат является объектом ResultSet.
Все прежние
ResultSet для данного Statement неявным образом закрываются. Если следующий
результат не является ResultSet или результатов больше нет, метод возвращает
false. Явную проверку отсутствия результатов дает выражение:
(!getMoreResults()
&& (getUpdateCount() == -1) getQueryTimeoutf ) и setQueryTimeoutf
)
public int getQuerylimeout()
throws SQLException
public void
setQueryTimeout(int seconds) throws SQLException
Описание.
Эти методы возвращают и устанавливают длительность времени, в течение которого
драйвер ожидает выполнения команды Statement. При превышении предела возбуждается
SQLException.
getResultSet(
)
public ResultSet
getResultSet() throws SQLException
Описание.
Метод возвращает текущий ResultSet. Для каждого результата его следует вызывать
только однажды. Его не нужно вызывать после обращения к executeQuery(), возвращающему
единственный результат.
getResultSetConcurrency(
)
public int getResultSetConcurrency()
throws SQLException
Описание.
Возвращает метод доступа к результирующим наборам, созданным данным Statement.
getResultSetType(
)
public int getResultSetType()
throws SQLException
Описание.
Возвращает тип результирующего набора для всех результирующих наборов, созданных
данным Statement.
getUpdateCount(
)
public int getUpdateCount()
throws SQLException
Описание.
Если текущий результат является обновлением, возвращает число строк, затронутых
обновлением. Если результат является ResultSet или результатов больше нет, возвращается
-1. Как и getResultSet(), этот метод для каждого результата вызывается только
один раз.
getWarnings(
)
public SQLWarning
getWarnings() throws SQLException
Описание.
Возвращает первое предупреждение, связанное с данным объектом.
setCursorName(
)
public void
setCursorName(String name) throws SQLException
Описание.
Этот метод задает имя курсора, которое должно использоваться при выполнении
последующих Statement. Для баз данных, поддерживающих позиционируемые обновления
и удаления, имя этого курсора можно использовать в сочетании с любыми объектами
ResultSet, возвращаемыми методами execute() или executeQuery() для задания текущей
строки позиционируемому обновлению или удалению. Для выполнения этих обновлений
и удалений нужно использовать другой объект Statement. Этот метод ничего не
выполняет в базах данных, где нет поддержки позиционируемых обновлений и удалений.
setEscapeProcessing(
)
public void
setEscapeProcessing(boolean enable) throws SQLException
Описание.
По умолчанию обработка управляющих символов включена. При этом драйвер производит
замену, прежде чем послать строку SQL базе данных.
Struct
Краткий
обзор
Имя класса: Java. sql. Struct
Надкласс:
нет
Непосредственные подклассы: нет
Реализованные интерфейсы: нет
Доступность:
введен в JDK 1.2
Описание
Этот класс
производит отображение в структурированный тип SQL3. Экземпляр Struct содержит
значения, которые отображаются в каждый атрибут в связанном структурном значении
базы данных.
Сводка
методов класса
public interface
Struct {
Object[] getAttributes()
throws SQLException;
Object[] getAttributes(Map
map) throws SQLException;
String getSQLTypeNane()
throws SQLException; }
Методы
объекта
getAttributes()
public Object[] getAttributes() throws SQLException
public Object[]
getAttnbutes(Map map) throws SQLException
Описание.
Возвращает значения атрибутов в структурированном типе SQL по порядку. Если
задано соответствие типов (тар), то оно будет использоваться для создания
значений Java-типов.
get
SQL TypeName()
public String
getSQLTypeName() throws SQLException
Описание.
Возвращает имя типа SQL для данного структурированного типа.
Time
Краткий
обзор
Имя класса:
Java. sql.Time Надкласс: Java. util. Date Непосредственные подклассы: нет Реализованные
интерфейсы: нет Доступность: JDK 1.1
Описание
Эта версия
класса java.util.Date производит отображение на тип данных SQL TIME.
Сводка
методов класса
public class
Time extends Java.util.Date {
static public
Time valueOf(String s);
public Time(int
hour, int minute, int second);
public Time(long
time);
#public int
getDate();
#public int
getDay();
#public int
getMonth();
#public int
getYear();
#public int
setDate(int i);
#public int
setMonth(int i);
public void
setTime(long time);
#public void
setYear(int i);
public String
toString(); }
Конструкторы
объекта
Time()
public Timestamp(int
hour, int minute, intsecond) public Timestamp(long time)
Описание.
Создает новый объект Time. Первый прототип создает Time с заданием часов,
минут и секунд. Второй прототип использует количество секунд, прошедшее с 12:00:00
GMT 1 января 1970.
Методы
объекта
getDate(),
setDate(), getDay(), getMonth(), setMonth(), getYear() и setYear( )
#public int
getDate()
#public int
getDay()
#public int
getMonth()
#public int
getYear()
#public int
setDate(int i)
#public int setMonth(int i)
#public void
setYear(int i)
Описание. Эти атрибуты представляют отдельные части объекта Time.
setTime()
public void
setTime(long time)
Описание.
Этот метод устанавливает для объекта Time количество секунд, прошедшее с
12:00:00 GMT 1 января 1970.
toString()
public String
toString()
Описание. Форматирует Time как строку в формате hh: mm: ss.
valueOf()
static public
Timestamp valueOf(String s)
Описание.
Создает новый объект Time на основе строки в формате hh:mm:ss.
Timestamp
Краткий обзор
Имя класса: Java. sql.Timestamp
Надкласс: Java. util.Date
Непосредственные
подклассы: нет
Реализованные интерфейсы: нет
Доступность:
JDK 1.1
Описание
Этот класс
служит SQL-представлением класса Java Date, специально созданного, чтобы служить
как метка времени SQL TIMESTAMP. Он позволяет хранить наносекунды, как это требуется
в значениях SQL TIMESTAMP. Следует помнить, что этот класс использует версию
hashcode() из java.'util. Date. Это означает, что для двух временных меток,
различающихся только в наносекундах, hashcode() будет возвращать одинаковые
значения.
Сводка
методов класса
public class
Timestamp extends Java.util.Date {
static public
Timestamp valueOf(String s);
public Timestamp(int
year, int month, int date, int hour, int minute, int second, int nano);
public Timestamp(long
time);
public boolean
after(Timestamp t);
public boolean
before(Timestamp t);
public boolean
equals(Timestamp t);
public int getNanos();
public void
setNanos(int n);
public String
toString(); }
Конструкторы
объекта
Timestamp()
#public Timestamp(int
year, int month, int date, int hour, int minute,
int second,
int nano) public Timestamp(long time)
Описание.
Создает новый объект Timestamp. Первый прототип создает Timestamp по заданным
году, месяцу, дню, часу, минуте, секундам и наносекундам. Второй прототип использует
количество секунд, прошедшее с 12:00:00 GMT 1 января 1970.
Методы
объекта
after
()
public boolean
after(Timestamp t)
Описание.
Возвращает true, если Timestamp более поздний, чем аргумент.
before
()
public boolean
before(Timestamp t)
Описание.
Возвращает true, если Timestamp более ранний, чем аргумент.
equals
( )
public boolean
equals(Timestamp t)
Описание. Возвращает true, если оба объекта равнозначны.
getNanos()
и setNanos( )
public int getNanos()
public void setNanos(int n)
Описание.
Атрибут представляет число наносекунд для данного объекта Timestamp.
toString()
public String
toString()
Описание.
Преобразует Timestamp в строку в формате yyyy-mm-dd hh:mm:ss.fffffffff.
valueOf()
static public
Timestamp valueOf(String s)
Описание.
Создает новый объект Timestamp по строке в формате yyyy-mm-dd hh:mm:ss.fffffffff.
Types
Краткий
обзор
Имя класса:
java. sql. Types Надкласс: java. lang. Object Непосредственные подклассы: нет
Реализованные интерфейсы: нет Доступность: JDK 1.1
Описание
Этот класс
содержит статические атрибуты, представляющие типы данных SQL. Эти значения
являются действительными значениями констант, определенными в спецификации XOPEN.
Сводка
методов класса
public class
Types {
static public
final int ARRAY;
static public
final int BIGINT;
static public
final int BINARY;
static public
final int BIT;
static public
final int BLOB;
static public
final int CHAR;
static public
final int CLOB;
static public
final int DATE;
static public
final int DECIMAL;
static public
final int DISTINCT;
static public
final int DOUBLE;
static public
final int FLOAT;
static public
final int INTEGER;
static public
final int JAVA_OBJECT;
static public
final int LONGVARBINARY;
static public
final int LONGVARCHAR;
static public
final int NULL;
static public
final int NUMERIC;
static public
final int OTHER;
static public
final int REAL;
static public
final int REF;
static public
final int SMALLINT;
static public
final int STRUCT;
static public
final int TIME;
static public
final int TIMESTAMP;
static public
final int TINYINT;
static public
final int VARBINARY;
static public
final int VARCHAR; }
