Методы объекта
Методы объекта
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