Глава №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; }