DataSource определяет некоторое количество атрибутов (см. таблицу
15.1). В таблице указаны имя, описание и тип каждого атрибута.
Таблица 15.1. Атрибуты DataSource
Имя атрибута Описание атрибута Тип атрибута
databaseName Имя базы данных (Oracle SID). String
dataSourceName Имя базового класса источника данных. String
description Описание источника данных. String
networkProtocol Сетевой протокол, используемый для поддержания
связи с базой данных. Применимо только для драйверов
JDBC OCI Oracle и протоколом по умолчанию является
tcp. Дополнительные сведения можно найти в руководстве
Oracle Database Net Services Administrator’s
Guide, публикуемом корпорацией Oracle.
String
password Пароль для предложенного имени пользователя. String
portNumber Номер порта, на котором программа прослушивания
Oracle Net ожидает запросы на подключение к базе
данных. Значение по умолчанию -1521.
int
serverName Машина сервера базы данных (адрес TCP/IP или псевдоним
DNS).
String
user Имя пользователя базы данных. String
Класс oracle.jdbc.pool.Oracle.DataSource обеспечивает
ный набор атрибутов (см. таблицу 15.2).
Таблица 15.2. Атрибуты OracleDataSource
дополнитель-
Имя атрибута Описание атрибута Тип атрибута
driverType Используемый драйвер JDBC. При использовании тонкого
драйвера на стороне сервера устанавливается значение
kprb, все другие установки атрибутов игнорируются.
String
url Может быть использован для определения URL базы данных
Oracle, который можно использовать в качестве альтернативы
для определения места нахождения базы данных.
Об URL базы данных можно прочесть выше.
String
558 Глава 15
Таблица 15.2. Атрибуты OracleDataSource (окончание)
Имя атрибута Описание атрибута Тип атрибута
tnsEntryName Может быть использован для определения строки
TNSNAMES Oracle Net, которая может быть также использована
для определения места нахождения базы данных,
если используются драйверы 0CI.
String
Для чтения из каждого из этих атрибутов, перечисленных в таблицах
15.1 и 15.2, и записи в них можно использовать целый ряд методов. Методы,
используемые для чтения, известны как методы получения (get), а методы,
используемые для записи, - как методы создания (set).
Имена методов создания и получения легко запоминаются: нужно взять
имя атрибута, конвертировать первую его букву в верхний регистр и добавить
перед ним слово «set» или «get». Например, для установки имени базы
данных (хранится в атрибуте databaseName) следует использовать метод
SETDatabaseName(), а для получения ранее созданного имени базы
данных - метод getDatabaseName(). Из этого правила имеется одно исключение:
отсутствует MCKW'getPasswordO. Это сделано по соображениям безопасности
- вы ведь не хотите, чтобы кто-то мог программным путем узнать
ваш пароль!
Большинство атрибутов являются объектами Java типа String, так что
практически все методы создания принимают на вход один параметр типа
String, а большинство методов получения возвращают один параметр
String. Исключением из этого правила является атрибут portNumber, который
имеет тип int. Следовательно, метод его создания (setPortNumber)
принимает на вход число типа int, а метод получения (getPortNumber) возвращает
значение int.
Следующие примеры иллюстрируют применение методов создания записываемых
атрибутов объекта OracleDataSource myDataSource, созданного
ранее на шаге 1:
□ myDataSource.setServerName(«localhost»);
myDataSou r c e . setDatabaseName( “ORCL” );
myDataSource.setDriverType(“o c i" ) ;
myDataSource.setNetworkProtocol(“t c p ” ):
tmyDataSource.setPortNumber(1521);
myDataSource.setUser(“ s c o t t ” );
myDataSource.setPassword(“t ig e r " ) ;
Следующие примеры иллюстрируют использование методов получения
для чтения атрибутов, предварительно установленных для myDataSource.
□ S t r in g serverName = myDataSource.getServerName();
S t r in g databaseName = myDataSource.getDatabaseName();
S t r in g driverType = myDataSource.getDriverType();
S t r in g networkProtocol = myDataSource.getNetworkProtocol(),
in t portNumber = myDataSource.getPortNumber();
После создания атрибутов объекта DataSource их можно использовать
для подключения к базе данных.
Выполнение SQL с использованием Java 559
Ш а г 3: Подключение к базе данных с помощью объекта
источника данных Oracle
Третий шаг состоит в подключении к базе данных с помощью объекта
OracleDataSource, для чего вызывается метод getConnec tion() объекта
OracleDataSource. Метод getConnec tion( ) возвращает объект JDBC
Connection, который должен быть сохранен.
В следующем примере показано, как вызвать метод g e tC o n n e c t io n ( ),
используя для этого объект myDataSource, заполненный на предыдущем
шаге:
□ Connection myConnection = myDataSource.getConnection();