Spec-Zone .ru
спецификации, руководства, описания, API
|
|
Spec-Zone .ru
спецификации, руководства, описания, API
|
Пример кода, который идет с этим учебным руководством, создает базу данных, которая используется владельцем небольшой кофейни под названием Перерыв на кофе, где кофейные зерна продаются фунтом, и варивший кофе продается чашкой.
Следующие шаги конфигурируют среду разработки JDBC, с которой можно скомпилировать и выполнить учебные выборки:
build.xml файлУстановите последнюю версию Java SDK SE на Вашем компьютере.
Гарантируйте что полный путь к каталогу Java SDK SE bin каталог находится в Вашем PATH переменная окружения так, чтобы можно было выполнить компилятор Java и средство запуска приложения Java из любого каталога.
Можно использовать DB Java, который идет с последней версией Java SDK SE. Это учебное руководство было протестировано на следующий DBMS:
Отметьте, что, если Вы используете другой DBMS, Вам, возможно, придется изменить код учебных выборок.
Если Вы используете DB Java, он уже идет с драйвером JDBC. Если Вы используете MySQL, устанавливаете последнюю версию .
Свяжитесь с поставщиком своей базы данных, чтобы получить драйвер JDBC для Вашего DBMS.
Есть много возможных реализаций драйверов JDBC. Эти реализации категоризируются следующим образом:
Тип 1: Драйверы, которые реализуют API JDBC как отображение на другой API доступа к данным, такой как ODBC (Открытая Связь Базы данных). Драйверы этого типа обычно зависят от собственной библиотеки, которая ограничивает их мобильность. Мост JDBC-ODBC является примером драйвера Типа 1.
Отметьте: Мост JDBC-ODBC нужно считать транзитным решением. Это не поддерживается Oracle. Рассмотрите использование этого, только если Ваш DBMS не предлагает драйвер JDBC только для Java.
Тип 2: Драйверы, которые пишутся частично в языке программирования Java и частично в собственном коде. Эти драйверы пользуются собственной клиентской библиотекой, определенной для источника данных, с которым они соединяются. Снова, из-за собственного кода, их мобильность ограничивается. OCI Oracle (Интерфейс Вызова Oracle) клиентский драйвер является примером драйвера Типа 2.
Тип 3: Драйверы, которые используют чистый клиент Java и связываются с сервером промежуточного программного обеспечения, используя независимый от базы данных протокол. Сервер промежуточного программного обеспечения тогда передает запросы клиента к источнику данных.
Тип 4: Драйверы, которые являются чистым Java и реализуют сетевой протокол для определенного источника данных. Клиент соединяется непосредственно с источником данных.
Проверьте, какие типы драйвера идет с Вашим DBMS. DB Java идет с двумя драйверами Типа 4, Встроенным драйвером и Сетевым Клиентским Драйвером. MySQL, Connector/J, является драйвером Типа 4.
Установка драйвера JDBC обычно состоит из копирования драйвера к Вашему компьютеру, затем добавляя расположение этого к Вашему пути class. Кроме того, много драйверов JDBC кроме драйверов Типа 4 требуют, чтобы Вы установили клиентский API. Никакая другая специальная конфигурация не обычно необходима.
Эти шаги используют Муравья Apache, основанный на Java инструмент, чтобы создать, скомпилировать, и выполнить учебные выборки JDBC. Пойдите в ссылку, чтобы загрузить Муравья Apache:
Гарантируйте, что исполняемый файл Муравья Apache находится в Вашем PATH переменная окружения так, чтобы можно было выполнить это из любого каталога.
Выборка RSSFeedsTable.java, то, который описывается в Использовании Объектов SQLXML, требует Apache Xalan, если Ваш DBMS является DB Java. Выборка использует Xalan-Java Apache. Пойдите в ссылку, чтобы загрузить это:
Пример кода, JDBCTutorial.zip, состоит из следующих файлов:
properties
javadb-build-properties.xmljavadb-sample-properties.xmlmysql-build-properties.xmlmysql-sample-properties.xmlsql
javadb
create-procedures.sqlcreate-tables.sqldrop-tables.sqlpopulate-tables.sqlmysql
create-procedures.sqlcreate-tables.sqldrop-tables.sqlpopulate-tables.sqlsrc/com/oracle/tutorial/jdbc
CachedRowSetSample.javaCityFilter.javaClobSample.javaCoffeesFrame.javaCoffeesTable.javaCoffeesTableModel.javaDatalinkSample.javaExampleRowSetListener.javaFilteredRowSetSample.javaJdbcRowSetSample.javaJDBCTutorialUtilities.javaJoinSample.javaProductInformationTable.javaRSSFeedsTable.javaStateFilter.javaStoredProcedureJavaDBSample.javaStoredProcedureMySQLSample.javaSuppliersTable.javaWebRowSetSample.javatxt
colombian-description.txtxml
rss-coffee-industry-news.xmlrss-the-coffee-break-blog.xmlbuild.xmlСоздайте каталог, чтобы содержать все файлы выборки. Эти шаги ссылаются на этот каталог как <JDBC tutorial directory>. Разархивируйте содержание JDBCTutorial.zip в <JDBC tutorial directory>.
build.xml файл является файлом типа "build" что использование Муравья Apache, чтобы скомпилировать и выполнить выборки JDBC. Файлы properties/javadb-build-properties.xml и properties/mysql-build-properties.xml содержите дополнительные свойства Ant Apache, требуемые для DB Java и MySQL, соответственно. Файлы properties/javadb-sample-properties.xml и properties/mysql-sample-properties.xml содержите свойства, требуемые выборкой.
Измените эти XML-файлы следующим образом:
В build.xml файл, измените свойство ANTPROPERTIES обратиться к также properties/javadb-build-properties.xml или properties/mysql-build-properties.xml, В зависимости от Вашего DBMS. Например, если Вы используете DB Java, Ваш build.xml файл содержал бы это:
<property
name="ANTPROPERTIES"
value="properties/javadb-build-properties.xml"/>
<import file="${ANTPROPERTIES}"/>
Точно так же, если Вы используете MySQL, Ваш build.xml файл содержал бы это:
<property
name="ANTPROPERTIES"
value="properties/mysql-build-properties.xml"/>
<import file="${ANTPROPERTIES}"/>
В properties/javadb-build-properties.xml или properties/mysql-build-properties.xml файл (в зависимости от Вашего DBMS), измените следующие свойства, как описано в следующей таблице:
| Свойство | Описание |
|---|---|
JAVAC |
Имя полного пути Вашего компилятора Java, javac |
JAVA |
Имя полного пути Вашей исполнимой программы Среды выполнения Java, java |
PROPERTIESFILE |
Имя файла свойств, также properties/javadb-sample-properties.xml или properties/mysql-sample-properties.xml |
MYSQLDRIVER |
Имя полного пути Вашего драйвера MySQL. Для Connector/J это обычно <Connector/J installation directory>/mysql-connector-java-version-number.jar. |
JAVADBDRIVER |
Имя полного пути Вашего драйвера DB Java. Это обычно <Java DB installation directory>/lib/derby.jar. |
XALANDIRECTORY |
Имя полного пути каталога, который содержит Apache Xalan. |
CLASSPATH |
Путь class, который использует учебное руководство JDBC. Вы не должны изменить это значение. |
XALAN |
Имя полного пути файла xalan.jar. |
DB.VENDOR |
Значение также derby или mysql в зависимости от того, используете ли Вы DB Java или MySQL, соответственно. Учебное руководство использует это значение, чтобы создать URL, требуемый соединиться с DBMS и идентифицировать специфичный для DBMS код и SQL-операторы. |
DB.DRIVER |
Полностью определенное имя class драйвера JDBC. Для DB Java это org.apache.derby.jdbc.EmbeddedDriver. Для MySQL это com.mysql.jdbc.Driver. |
DB.HOST |
Имя хоста компьютера, размещающего Ваш DBMS. |
DB.PORT |
Номер порта компьютера, размещающего Ваш DBMS. |
DB.SID |
Имя базы данных учебное руководство создает и использует. |
DB.URL.NEWDATABASE |
Соединение URL, используемый, чтобы соединиться с Вашим DBMS, создавая новую базу данных. Вы не должны изменить это значение. |
DB.URL |
Соединение URL, используемый, чтобы соединиться с Вашим DBMS. Вы не должны изменить это значение. |
DB.USER |
Имя пользователя, у которого есть доступ, чтобы создать базы данных в DBMS. |
DB.PASSWORD |
Пароль пользователя, определенного в DB.USER. |
DB.DELIMITER |
Символ, используемый, чтобы разделить SQL-операторы. Не изменяйте это значение. Это должен быть символ точки с запятой (;). |
Учебные выборки используют значения в любом properties/javadb-sample-properties.xml файл или properties/mysql-sample-properties.xml файл (в зависимости от Вашего DBMS), чтобы соединиться с DBMS и инициализировать базы данных и таблицы, как описано в следующей таблице:
| Свойство | Описание |
|---|---|
dbms |
Значение также derby или mysql в зависимости от того, используете ли Вы DB Java или MySQL, соответственно. Учебное руководство использует это значение, чтобы создать URL, требуемый соединиться с DBMS и идентифицировать специфичный для DBMS код и SQL-операторы. |
jar_file |
Имя полного пути файла JAR, который содержит все файлы class этого учебного руководства. |
driver |
Полностью определенное имя class драйвера JDBC. Для DB Java это org.apache.derby.jdbc.EmbeddedDriver. Для MySQL это com.mysql.jdbc.Driver. |
database_name |
Имя базы данных учебное руководство создает и использует. |
user_name |
Имя пользователя, у которого есть доступ, чтобы создать базы данных в DBMS. |
password |
Пароль пользователя, определенного в user_name. |
server_name |
Имя хоста компьютера, размещающего Ваш DBMS. |
port_number |
Номер порта компьютера, размещающего Ваш DBMS. |
Отметьте: Для простоты в демонстрации API JDBC учебный пример кода JDBC не выполняет методы управления паролями, которые обычно использует развернутая система. В продуктивной среде можно следовать за направляющими линиями управления паролями Базы данных Oracle и отключить любые демонстрационные учетные записи. См., что раздел в в для направляющих линий управления паролями и других рекомендациях безопасности.
В командной строке измените текущий каталог на <JDBC tutorial directory>. Из этого каталога, выполненного следующая команда, чтобы скомпилировать выборки и упаковать их в файле фляги:
ant jar
Если Вы используете MySQL, то выполненный следующая команда, чтобы создать базу данных:
ant create-mysql-database
Отметьте: Никакая соответствующая цель Муравья не существует в build.xml файл, который создает базу данных для DB Java. База данных URL для DB Java, который используется, чтобы установить соединение с базой данных, включает опцию, чтобы создать базу данных (если это уже не существует). См.
Если Вы используете или DB Java или MySQL, то из того же самого каталога, выполняет следующую команду, чтобы удалить существующие таблицы базы данных-образца, воссоздать таблицы, и заполнить их. Для DB Java эта команда также создает базу данных, если это уже не существует:
ant setup
Отметьте: следует выполнить команду ant setup каждый раз прежде, чем Вы выполните один из классов Java в выборке. Многие из этих выборок ожидают определенные данные в содержании таблиц базы данных выборки.
Каждая цель в build.xml файл соответствует Java class или сценарий SQL в выборках JDBC. Следующая таблица приводит цели в build.xml файл, который class или сценарий каждая цель выполняют, и другие классы или файлы каждая цель, требует:
| Цель муравья | Класс или Сценарий SQL | Другие Необходимые Классы или Файлы |
|---|---|---|
javadb-create-procedure |
javadb/create-procedures.sql; см. build.xml файл, чтобы просмотреть другие SQL-операторы, которые выполняются |
Никакие другие необходимые файлы |
mysql-create-procedure |
mysql/create-procedures.sql. |
Никакие другие необходимые файлы |
run |
JDBCTutorialUtilities |
Никакие другие необходимые классы |
runct |
CoffeesTable |
JDBCTutorialUtilities |
runst |
SuppliersTable |
JDBCTutorialUtilities |
runjrs |
JdbcRowSetSample |
JDBCTutorialUtilities |
runcrs |
CachedRowSetSample, ExampleRowSetListener |
JDBCTutorialUtilities |
runjoin |
JoinSample |
JDBCTutorialUtilities |
runfrs |
FilteredRowSetSample |
JDBCTutorialUtilities, CityFilter, StateFilter |
runwrs |
WebRowSetSample |
JDBCTutorialUtilities |
runclob |
ClobSample |
JDBCTutorialUtilities, txt/colombian-description.txt |
runrss |
RSSFeedsTable |
JDBCTutorialUtilities, XML-файлы, содержавшиеся в xml каталог |
rundl |
DatalinkSample |
JDBCTutorialUtilities |
runspjavadb |
StoredProcedureJavaDBSample |
JDBCTutorialUtilities, SuppliersTable, CoffeesTable |
runspmysql |
StoredProcedureMySQLSample |
JDBCTutorialUtilities, SuppliersTable, CoffeesTable |
runframe |
CoffeesFrame |
JDBCTutorialUtilities, CoffeesTableModel |
Например, чтобы выполнить class CoffeesTable, измените текущий каталог на <JDBC tutorial directory>, и из этого каталога, выполненного следующая команда:
ant runct
|
