Справочник по Python


Методы объекта



Методы объекта


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









Начало  Назад  Вперед