Меню Рубрики

Установка derby в eclipse

Step 1: Install Software


This tutorial requires the Java Development Kit (JDK) and the Apache Derby software.

First, this section describes which JDK release is required, asks you to install it if you haven’t already, then shows you how to configure and verify your installation.

Next, it shows you how to install the Apache Derby software, configure your environment to use the Derby Embedded JDBC driver, and verify your installation with the Derby sysinfo tool.

Java Development Kit (JDK)

Derby requires Java 2 Standard Edition (J2SE) 9 or higher. Only the Java Runtime Environment (JRE) is required to run Derby, but this tutorial compiles a Java application, so it requires the Java Development Kit (JDK).

If you already have a JDK installed, verify you are configured to use it, then proceed to the Apache Derby installation section.

Install JDK

If you have not already installed a JDK, download and install it now. No specific vendor implementation is required; the only requirement is that it be certified for J2SE 9 or higher. Java’s reference implementation is at http://www.oracle.com/technetwork/java/javase/downloads/index.html. After installing the JDK of your choice, proceed to the next section.

Configure JDK

Set the JAVA_HOME environment variable to the root location of the JDK installation directory. The examples below use C:\jdk1.9 for Windows and /opt/jdk1.9 for UNIX, but be sure to use the actual location on your system. (e.g. The default installation location used by the JDK installer might be something like C:\Program Files\Java\jdk1.9.0_11-b21)

Windows: C:\> set JAVA_HOME=C:\jdk1.9

UNIX Korn Shell: $ export JAVA_HOME=/opt/jdk1.9

Next set the PATH environment variable to include the JDK bin directory. The PATH variable tells the operating system where to find the java interpreter and the javac compiler.

Windows: C:\> set PATH=%PATH%;%JAVA_HOME%\bin

In Windows, these environment variables can also be set from — right click «My Computer» -> Advanced -> Environment Variables.

UNIX Korn Shell: $ export PATH=$JAVA_HOME/bin:$PATH

Verify JDK

Use the java -version command, as shown below, to verify the installed release:

java -version java version «9» Java(TM) SE Runtime Environment (build 9+181) Java HotSpot(TM) 64-Bit Server VM (build 9+181, mixed mode)

The output you see may be different from what is shown above because the java -version command outputs vendor-specific information; however, if you don’t see what looks like valid version information, then STOP! And don’t proceed until you resolve that problem.

Apache Derby

Download Derby

Download the binary Apache Derby distribution from the Derby web site at http://db.apache.org/derby/derby_downloads.html. These tutorial instructions use version and assume you downloaded one of the binary distribution files listed in the table below:

Operating System Download File
Windows db-derby-
UNIX, Linux, and Mac db-derby-

If a more recent release is available, download that, then substitute that version number for in the following instructions.

Install Derby

Choose the directory into which you want to install the Derby software. You must have write permissions to this directory. The sample instructions below use C:\Apache for Windows and /opt/Apache for UNIX; be sure to use your actual location. Copy the software distribution to the location you choose, then extract it as shown below.

Windows (use your extraction tool e.g. WinZip — these instructions use mks unzip): mkdir C:\Apache copy db-derby- C:\Apache cd C:\Apache unzip db-derby-

UNIX: mkdir /opt/Apache cp db-derby- /opt/Apache cd /opt/Apache tar xzvf db-derby-

In both cases, the software will now be extracted into a subdirectory named db-derby- .


Set the DERBY_INSTALL variable to the location where you installed Derby. Examples are shown below, but be sure to use the actual location on your system:

Windows: C:\> set DERBY_INSTALL=C:\Apache\db-derby-

Читайте также:  Установка датчика заднего хода на камаз

UNIX Korn Shell: $ export DERBY_INSTALL=/opt/Apache/db-derby-

Configure Embedded Derby

To use Derby in its embedded mode set your CLASSPATH to include the jar files listed below:

  • derby.jar : contains the Derby engine and the Derby Embedded JDBC driver
  • derbytools.jar : optional, prov >ij tool that is used by a couple of sections in this tutorial

You can set your CLASSPATH explicitly with the command shown below:

Notice that multiple entries in the class path are separated by a semicolon (;) on Windows and a colon (:) on UNIX.

The Derby software prov >CLASSPATH , using shell scripts (UNIX) and batch files (Windows). This tutorial shows how to set CLASSPATH explicitly and also how to use the Derby scripts to set it.

Change directory now into the DERBY_INSTALL/bin directory. The setEmbeddedCP.bat (Windows) and setEmbeddedCP (UNIX) scripts use the DERBY_INSTALL variable to set the CLASSPATH for Derby embedded usage. You can edit the script itself to set DERBY_INSTALL , or you can let the script get DERBY_INSTALL from your environment. Since you already set DERBY_INSTALL in the «Set DERBY_INSTALL» section above, you don’t need to edit the script, so go ahead and execute it as shown below:

Windows: C:\> cd %DERBY_INSTALL%\bin C:\Apache\db-derby-\bin> setEmbeddedCP.bat

UNIX: $ cd $DERBY_INSTALL/bin $ . setEmbeddedCP

Verify Derby

Run the sysinfo command, as shown below, to output Derby system information:

Successful output will look something like this:

—————— Java Information —————— Java Version: 9 Java Vendor: Oracle Corporation Java home: /Library/Java/JavaVirtualMachines/jdk-9.jdk/Contents/Home Java classpath: /Users/rhillegas/sw/zzz/db-derby- OS name: Mac OS X OS architecture: x86_64 OS version: 10.11.6 Java user name: rh161140 Java user home: /Users/rh161140 Java user dir: /Users/rhillegas/sw/zzz/db-derby- java.specification.name: Java Platform API Specification java.specification.version: 9 java.runtime.version: 9+181 ——— Derby Information ——— [/Users/rhillegas/sw/zzz/db-derby-] — (1853019) [/Users/rhillegas/sw/zzz/db-derby-] — (1853019) [/Users/rhillegas/sw/zzz/db-derby-] — (1853019) [/Users/rhillegas/sw/zzz/db-derby-] — (1853019) [/Users/rhillegas/sw/zzz/db-derby-] — (1853019) [/Users/rhillegas/sw/zzz/db-derby-] — (1853019) —————————————————— —————— Locale Information —————— Current Locale : [English/United States [en_US]] Found support for locale: [cs] version: — (1853019) Found support for locale: [de_DE] version: — (1853019) Found support for locale: [es] version: — (1853019) Found support for locale: [fr] version: — (1853019) Found support for locale: [hu] version: — (1853019) Found support for locale: [it] version: — (1853019) Found support for locale: [ja_JP] version: — (1853019) Found support for locale: [ko_KR] version: — (1853019) Found support for locale: [pl] version: — (1853019) Found support for locale: [pt_BR] version: — (1853019) Found support for locale: [ru] version: — (1853019) Found support for locale: [zh_CN] version: — (1853019) Found support for locale: [zh_TW] version: — (1853019) ——————————————————

The output on your system will probably be somewhat different from the output shown above, but it should reflect the correct location of jar files on your machine and there shouldn’t be any errors. If you see an error like the one below, it means your class path is not correctly set:

$ java org.apache.derby.tools.sysinfo Exception in thread «main» java.lang.NoClassDefFoundError: org/apache/derby/tools/sysinfo

Echo your CLASSPATH , as shown below, then double check each entry in your class path to verify that the jar file is where you expect it:

Windows: C:\> echo %CLASSPATH% C:\Apache\DB-DER

UNIX: $ echo $CLASSPATH /opt/Apache/db-derby-

If sysinfo outputs valid information, you’re ready to move to «Step 2: ij Basics».


Установка derby в eclipse

**Apache Derby – open source инструмент для работы с реляционными базами данных в Java. Распространяется по лицензии Apache v 2.0.**

Когда перед Вами стоит задача написать небольшое приложение, работающее с реляционной базой данных (относительно небольшой) Apache Derby может и не идеальный, но удобный инструмент для выполнения поставленной задачи. Об основных преимуществах Derby можно прочитать на офсайте. Но если в двух словах, то:

  • Apache Derby основан на стандартах Java, JDBC и SQL;
  • для платформы Eclipse распространяется в виде плагина;
  • для полноценной работы программы на стороне клиента не требует дополнительной установки сервера (грубо говоря, сервер будет “зашит” в программу);
  • прост в использовании;
Читайте также:  Установка кнопки для крышки багажника калина


Для написания простой программы (чтение/запись из/в БД) необходимо скачать плагин для Eclipse. На момент написания статьи последним официальным релизом Derby является версия (Скачать). На данной странице присутствуют различные раздачи Derby. Нас же интересует плагин для Eclipse. Ищем на странице слова “There are two separate Eclipse plugins for Derby:” все, что находится ниже (2 файла: derby_core_plugin и _derby_ui_docplugin )-качаем. Прямые ссылки на скачивания:

На странице загрузок можно посмотреть список всех доступных версий, а также последний официальный релиз Derby.

Установка Derby-плагина для Eclipse

Скачанные ранее файлы ( derby_core_plugin и derby_ui_doc_plugin ) необходимо распаковать в ** …/Eclipse/plugins`

Запускаем локальный сервер Derby

Создаем новый Java-проект в Eclipse. Далее правой кнопкой мыши (ПКМ) по созданному проекту. Если правильно установили (распаковали) плагин Derby, то по нажатию ПКМ по проекту в контекстном меню должна появится строчка вида:

Для того, чтобы добавить поддержку в наш проект, выбираем Add Apache derby nature. Теперь, если опять нажать ПКМ по нашему проекту, то в контекстное меню для Derby будет выглядеть следующим образом:

  1. контекстное меню Derby;
  2. запуск локального сервера Derby;
  3. остановка сервера Derby;
  4. командная строка Derby;

Выбираем пункт 2 — запускаем локальный сервер Derby. Если все прошло удачно-появится диалоговое окно следующего содержания:

Если данное окно не появилось по каким-либо причинам – читаем ошибки в Console.

Создаем базу данных

Теперь займемся созданием базы данных. Создавать БД будем при помощи командной строки Derby — ij (Interactive SQL) – п. 4. ПКМ по нашему проекту—>Apache Derby –>ij. В результате в консоли появится сообщение:

Данная команда создает БД с именем userDB. Параметр create=true как раз-таки и отвечает за создание новой базы. В результате данных манипуляций в Package Explorer в Eclipse появятся папка с именем нашей БД и папка с именем “Derby Library”:

Создадим в нашей БД таблицу users с полями first_name, last_name. us_id:

Заполним нашу таблицу следующими записями (записи в консоли вводятся поочередно, каждая команда заканчивается точкой с запятой ):

Для того, чтобы просмотреть нашу таблицу вводим команду:

В результате в консоли будет выведен результат:

Пишем программу

В данном примере будем рассматривать простую программу. Создаем класс, например Main (при создании класса ставим галочку напротив public static void main ).

Для работы с нашей БД необходимо зарегистрировать в нашей программе драйвер JDBC, установить соединение к нашей БД, указать путь (URL) к БД . Для этого пишем следующий код:

Пробуем запустить нашу программу. Если ошибок не возникает – едем дальше – пишем оставшуюся часть кода, которая будет считывать/записывать из/в нашу БД. Для этого пишем следующий код (его необходимо вставить до или после слов “ /* остальная часть кода будет туту*/ “).

Данный код добавит в таблицу users пользователя _“Adam Smyth_” с >

Считаем записи из нашей БД и выведем результат в консоль:

В результате в консоли будет выведено сообщение:

Полный код программы приведен ниже:

Как видно, ничего сложного. Для более серьезных проектов – соответствующее решение поставленной задачи.


Технология Клиент-Сервер 2008’1
Home Поиск Издания Контакты k-press.ru

Авторы: Илья Платонов
Артем Папков
Джим Смит
Терри Финч

Опубликовано: 22.04.2008

Apache Derby и плагины Eclipse

Eclipse – это мощная интегрированная среда разработки (IDE), которая поддерживает множество оболочек (framework) для создания графических компонентов пользовательского интерфейса (например, SWT или JFaces) или для работы с данными (например, Eclipse Modeling Framework). Одной из наиболее интересных особенностей среды Eclipse является ее способность к расширению возможностей платформы разработки с помощью создания новых плагинов. В Eclipse есть поддержка разработки плагинов для всех вышеперечисленных и многих других распространенных платформ, включая базу данных Apache Derby.

Читайте также:  Установка бортового компьютера штат лада гранта

В этой статье авторы показывают, как использовать индексацию ресурсов с базой данных Apache Derby для разработки плагинов для Eclipse. Встроенная в Eclipse база данных Derby позволяет создать SQL-базу данных на стороне клиента и избежать таким образом проблем с безопасностью или сетью, таких как неустойчивое соединение или длительные задержки. База данных SQL и интерфейс JDBC обеспечивают простой способ хранения информации и быстрый поиск ранее сохраненных данных.

Вы познакомитесь со следующими темами:

  • Интеграция базы данных Derby в платформу Eclipse
  • Управление данными в Eclipse при помощи базы данных Derby
  • Индексация ресурсов с использованием оболочки Eclipse Builder

Начало работы

Чтобы начать использовать базу данных Derby в Eclipse, нужно загрузить плагин Derby для Eclipse (http://db.apache.org/derby/derby_downloads.html). Выберите подходящую ссылку в секции Latest Official Release (последние официальные выпуски). В пакете вы найдете три следующих плагина:

  • Модуль ядра Derby, который обеспечивает поддержку Derby платформой Eclipse
  • Модуль Derby UI plug-in, предоставляющий компоненты пользовательского интерфейса для работы с базой данных Derby в Eclipse
  • Документация к плагину пользовательского интерфейса Derby

Модуль Derby позволяет использовать клиентские и серверные библиотеки Derby. Поэтому вы можете как создать новую базу данных Derby в Eclipse, так и подсоединиться к существующей базе данных. Плагин пользовательского интерфейса (Derby UI plug-in) предоставляет компоненты и средства, которые могут пригодиться при разработке приложения, использующего базу данных Derby. Например, этот модуль позволяет вам установить соединение с существующей базой данных и посылать ей SQL-запросы (см. ссылку в разделе Ресурсы).

Для того чтобы установить эти модули, выполните следующие шаги:

  1. Извлеките файлы из загруженного пакета в каталог с плагинами Eclipse (например, /eclipse/plugins).
  2. Запустите (или перезагрузите) Eclipse и проверьте, что плагины были успешно установлены: нажмите Help > About Eclipse SDK > Plug-in details . Вы должны увидеть в списке плагины Derby, как показано на рисунке 1.

Рисунок 1. Плагины Derby в списке плагинов Eclipse.

Примечание: Если вы хотите опробовать примеры приложений, которые сопровождают данную статью, вам понадобится по крайней мере модуль ядра Derby (Derby core plug-in).

Простой код для тестирования функциональности плагина для работы с базой данных Derby

Плагин индексации ресурсов

Менеджер пула соединений с источником данных

Уровень выполнения операций с базой данных

Использование компоновщика (builder) для индексации ресурсов

Тестирование примера приложения


Eclipse и Apache Derby на сегодняшний день являются хорошо известными проектами с открытым исходным кодом. Платформа Eclipse позволяет создавать различные приложения с графическим интерфейсом пользователя, в особенности IDE-приложения. При помощи Apache Derby можно создать локальную базу данных SQL для любого Java-приложения. И как было показано в данной статье, Eclipse и Derby могут легко использоваться вместе.

Важный пример использования базы данных Derby для разработки плагинов Eclipse — индексация ресурсов. Используя только оболочку Eclipse Builder, вы можете сохранять информацию в базе данных SQL, а потом использовать эту информацию посредством запросов. Так как база данных Derby оптимизирована для SQL-запросов, вы получите значительный выигрыш в производительности при доступе к ресурсному индексу.


  • Оригинал статьи «Use Apache Derby to develop Eclipse plug-ins: A demo using resource indexing» (EN) – http://www.ibm.com/developerworks/library/os-ad-eclipse/index.html
  • Взгляните на пользовательскую документацию «Getting Started with the Derby plug-ins for Eclipse» (EN) – http://db.apache.org/derby/integrate/plugin_help/start_toc.html?S_TACT=105AGX99&S_CMP=CP.
  • В популярной статье «Introducing Eclipse» (EN) (developerWorks, декабрь 2005) описывается использование Eclipse – http://www.ibm.com/developerworks/opensource/edu/os-dw-os-ad-intro.html?S_TACT=105AGX99&S_CMP=CP.
  • Статья «Project Builders and Natures» (EN) – http://www.eclipse.org/articles/ArticleBuilders/builders.html
  • Загрузить дистрибутив Apache Derby – http://db.apache.org/derby/
  • Инструментs Eclipse – http://www.eclipse.org
  • базе данных IBM Cloudscape, которая создана с использованием кода, лежащего в основе Apache Derby – http://www.ibm.com/developerworks/db2/zones/cloudscape/?S_TACT=105AGX99&S_CMP=CP

«С полным содержанием данной статьи можно ознакомиться в печатной версии журнала»

Copyright © 1994-2016 ООО «К-Пресс»