Пример кода, который идет с этим учебным руководством, создает базу данных, которая используется владельцем небольшой кофейни под названием Перерыв на кофе, где кофейные зерна продаются фунтом, и варивший кофе продается чашкой.

Следующие шаги конфигурируют среду разработки JDBC, с которой можно скомпилировать и выполнить учебные выборки:

  1. Установите последнюю версию Java SDK SE на Вашем компьютере.

    Гарантируйте что полный путь к каталогу Java SDK SE bin каталог находится в Вашем PATH переменная окружения так, чтобы можно было выполнить компилятор Java и средство запуска приложения Java из любого каталога.

  2. Установите свою систему управления базами данных (DBMS) если нужно.

    Можно использовать DB Java, который идет с последней версией Java SDK SE. Это учебное руководство было протестировано на следующий DBMS:

    Отметьте, что, если Вы используете другой DBMS, Вам, возможно, придется изменить код учебных выборок.

  3. Установите драйвер JDBC от поставщика Вашей базы данных.

    Если Вы используете DB Java, он уже идет с драйвером JDBC. Если Вы используете MySQL, устанавливаете последнюю версию Connector/J.

    Свяжитесь с поставщиком своей базы данных, чтобы получить драйвер JDBC для Вашего DBMS.

    Есть много возможных реализаций драйверов JDBC. Эти реализации категоризируются следующим образом:

    Проверьте, какие типы драйвера идет с Вашим DBMS. DB Java идет с двумя драйверами Типа 4, Встроенным драйвером и Сетевым Клиентским Драйвером. MySQL, Connector/J, является драйвером Типа 4.

    Установка драйвера JDBC обычно состоит из копирования драйвера к Вашему компьютеру, затем добавляя расположение этого к Вашему пути class. Кроме того, много драйверов JDBC кроме драйверов Типа 4 требуют, чтобы Вы установили клиентский API. Никакая другая специальная конфигурация не обычно необходима.

  4. Муравей Apache установки.

    Эти шаги используют Муравья Apache, основанный на Java инструмент, чтобы создать, скомпилировать, и выполнить учебные выборки JDBC. Пойдите в ссылку, чтобы загрузить Муравья Apache:

    http://ant.apache.org/

    Гарантируйте, что исполняемый файл Муравья Apache находится в Вашем PATH переменная окружения так, чтобы можно было выполнить это из любого каталога.

  5. Apache установки Xalan.

    Выборка RSSFeedsTable.java требует Apache Xalan, если Ваш DBMS является DB Java. Выборка использует Xalan-Java Apache. Пойдите в ссылку, чтобы загрузить это:

    http://xml.apache.org/xalan-j/

  6. Загрузите пример кода.

    Пример кода, JDBCTutorial.zip, состоит из следующих файлов:

    Создайте каталог, чтобы содержать все файлы выборки. Эти шаги ссылаются на этот каталог как <JDBC tutorial directory>. Разархивируйте содержание JDBCTutorial.zip в <JDBC tutorial directory>.

  7. Измените build.xml файл.

    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-файлы следующим образом:

    1. В build.xml файл, измените свойство ANTPROPERTIES обратиться к также properties/javadb-build-properties.xml или properties/mysql-build-properties.xml, В зависимости от Вашего DBMS. Например, если Вы используете DB Java, Ваш build.xml файл содержал бы это:

      <имя свойства = "ANTPROPERTIES" оценивают = "properties/javadb-build-properties.xml"/> <файл импорта =" $ {ANTPROPERTIES}"/>

      Точно так же, если Вы используете MySQL, Ваш build.xml файл содержал бы это:

      <имя свойства = "ANTPROPERTIES" оценивают = "properties/mysql-build-properties.xml"/> <файл импорта =" $ {ANTPROPERTIES}"/>

    2. В 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-операторы. Не изменяйте это значение. Это должен быть символ точки с запятой (;).

  8. Измените учебный файл свойств.

    Учебные выборки используют значения в любом 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 и отключить любые демонстрационные учетные записи. См., что раздел "Защищает Пароли в Проектировании приложений" в Главе 5, "Управляя Безопасностью для Разработчиков приложений" в Руководстве по обеспечению безопасности Базы данных Oracle для направляющих линий управления паролями и других рекомендациях безопасности.

  9. Скомпилируйте и упакуйте выборки.

    В командной строке измените текущий каталог на <JDBC tutorial directory>. Из этого каталога, выполненного следующая команда, чтобы скомпилировать выборки и упаковать их в файле фляги:

    ant jar

  10. Создайте базы данных, таблицы, и заполните таблицы.

    Если Вы используете MySQL, то выполненный следующая команда, чтобы создать базу данных:

    ant create-mysql-database

    Если Вы используете или DB Java или MySQL, то из того же самого каталога, выполняет следующую команду, чтобы удалить существующие таблицы базы данных-образца, воссоздать таблицы, и заполнить их:

    ant setup

    Отметьте: следует выполнить команду ant setup каждый раз прежде, чем Вы выполните один из классов Java в выборке. Многие из этих выборок ожидают определенные данные в содержании таблиц базы данных выборки.

  11. Выполните выборки.

    Каждая цель в 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