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.